Defining Your Subsystem to the SRC

Subsystems are defined to the SRC object class as subsystem objects. Subservers are defined in the SRC configuration data base as subserver type objects. The structures associated with each type of object are predefined in the sys/srcobj.h file.

A subsystem object is created with the mkssys command or the addssys subroutine. A subserver type object is created with the mkserver command. You are not required to specify all possible options and parameters using the configuration commands and subroutines. The SRC offers pre-set defaults. See the Subsystem Object Descriptor and Default Value table in "Subsystem Object Class" in "SRC Objects" for a list of subsystem and subserver default values. You must specify only the required fields and any fields in which you want some value other than the default.

Descriptors can be added or modified at the command line, by writing a shell script. They can also be added or modified using the C interface. Commands and subroutines are available for configuring and modifying the SRC objects.

Note: The choice of programming interfaces is provided for convenience only.

At the command line:

• Use the mkssys command to configure subsystem objects.
• Use the mkserver command to configure subserver type objects.
• Use the chssys command to modify subsystem objects.
• Use the chserver command to modify the subsystem name in the subserver objects.
• Use the rmssys command to remove subsystem objects.
• Use the rmserver command to remove subserver type objects.

When using the C interface:

• Use the defssys and addssys subroutines to configure subsystem and subserver type objects to the subsystem object class.
• Use the getssys and chssys subroutines to modify subsystem objects.
• Use the delssys subroutine to remove subsystem and subserver type objects.

  Note: The object code running with the chssys subroutine must be running with the group system.

The mkssys and mkserver commands call the defssys subroutine internally to determine subsystem and subserver default values prior to adding or modifying any values entered at the command line.

The getssys and getsubsvr subroutines are used when the SRC master program or a subsystem program needs to retrieve data from the SRC configuration files.

Related Information

System Resource Controller (SRC) Overview for Programmers.

Understanding SRC Objects.

Programming Subsystem Communication with the SRC.

List of SRC Object-Definition Commands.

List of SRC Subroutines.

System Resource Controller Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.

TCP/IP Protocols in AIX Version 4.3 System Management Guide: Communications and Networks.

Sockets Overview in AIX Communications Programming Concepts.

Reading Internet Datagrams Example Program in AIX Communications Programming Concepts.

Message Queue Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.

Checking for Pending Connections Example Program in AIX Communications Programming Concepts.

The srcmstr daemon in AIX Version 4.3 Commands Reference.

The spc.h file, srcobj.h file in AIX Version 4.3 Files Reference.

The select subroutine, getsockname subroutine, recvfrom subroutine, msgget subroutine, msgrcv or msgxrcv subroutine in AIX Version 4.3 Technical Reference.