Technical Reference: Base Operating System and Extensions, Volume 1

chssys Subroutine

Purpose

Modifies the subsystem objects associated with the SubsystemName parameter.

Library

System Resource Controller Library (libsrc.a)

Syntax

#include <sys/srcobj.h>
#include <spc.h>

int chssys( SubsystemName, SRCSubsystem) char *SubsystemName; struct SRCsubsys *SRCSubsystem;

The chssys subroutine modifies the subsystem objects associated with the specified subsystem with the values in the SRCsubsys structure. This action modifies the objects associated with subsystem in the following object classes:

Subsystem Environment
Subserver Type
Notify

The Subserver Type and Notify object classes are updated only if the subsystem name has been changed.

The SRCsubsys structure is defined in the /usr/include/sys/srcobj.h file.

The program running with this subroutine must be running with the group system.

Parameters

SRCSubsystem	Points to the SRCsubsys structure.
SubsystemName	Specifies the name of the subsystem.

Return Values

Upon successful completion, the chssys subroutine returns a value of 0. Otherwise, it returns a value of -1 and the odmerrno variable is set to indicate the error, or a System Resource Controller (SRC) error code is returned.

Error Codes

The chssys subroutine is unsuccessful if one or more of the following are true:

SRC_NONAME	No subsystem name is specified.
SRC_NOPATH	No subsystem path is specified.
SRC_BADNSIG	Invalid stop normal signal.
SRC_BADFSIG	Invalid stop force signal.
SRC_NOCONTACT	Contact not signal, sockets, or message queues.
SRC_SSME	Subsystem name does not exist.
SRC_SUBEXIST	New subsystem name is already on file.
SRC_SYNEXIST	New subsystem synonym name is already on file.
SRC_NOREC	The specified SRCsubsys record does not exist.
SRC_SUBSYS2BIG	Subsystem name is too long.
SRC_SYN2BIG	Synonym name is too long.
SRC_CMDARG2BIG	Command arguments are too long.
SRC_PATH2BIG	Subsystem path is too long.
SRC_STDIN2BIG	stdin path is too long.
SRC_STDOUT2BIG	stdout path is too long.
SRC_STDERR2BIG	stderr path is too long.
SRC_GRPNAM2BIG	Group name is too long.

Security

Privilege Control: This command has the Trusted Path attribute. It has the following kernel privilege:

SET_PROC_AUDIT kernel privilege

Files Accessed:

Mode	File
644	/etc/objrepos/SRCsubsys
644	/etc/objrepos/SRCsubsvr
644	/etc/objrepos/SRCnotify
Auditing Events:
Event	Information
SRC_Chssys

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Files

/etc/objrepos/SRCsubsys	SRC Subsystem Configuration object class.
/etc/objrepos/SRCsubsvr	SRC Subserver Configuration object class.
/etc/objrepos/SRCnotify	SRC Notify Method object class.
/dev/SRC	Specifies the AF_UNIX socket file.
/dev/.SRC-unix	Specifies the location for temporary socket files.

Related Information

The addssys (addssys Subroutine) subroutine, delssys (delssys Subroutine) subroutine.

The chssys command, mkssys command, rmssys command.

System Resource Controller Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

Defining Your Subsystem to the SRC, List of SRC Subroutines, System Resource Controller (SRC) Overview for Programmers in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.