chserver Command

Purpose

Changes a subserver definition in the subserver object class.

Syntax

chserver -t OldSubserver [  -c CodePoint ] [  -s NewSubsystem ] [ -t NewSubserver ]

Description

The chserver command modifies an existing subserver definition in the subserver object class. It can change subserver types, the owning subsystem, or the subserver code point.

Flags

Item Description
-c CodePoint Specifies the CodePoint integer that identifies the subserver. This is the value used by the subsystem to recognize the subserver. The chserver command is unsuccessful if the CodePoint already exists for the existing subsystem name and no new subsystem name is entered. It is also unsuccessful if the NewSubsystem name and subserver CodePoint exist in the subserver object class. The limit for the CodePoint storage is the same as a short integer (1 through 32,768).
-s NewSubsystem Specifies the name that uniquely identifies the NewSubsystem to the subserver it belongs to. The chserver command is unsuccessful if one of the following occurs:
  • The NewSubsystem name is not known in the subsystem object class.
  • The NewSubsystem name is known in the subsystem object class but uses signals as its communication method.
  • The NewSubsystem name already exists with the existing subserver CodePoint value in the Subserver Type object class, and no subserver CodePoint value is entered.
  • A new subserver CodePoint is entered, with the NewSubsystem name and subserver CodePoint already existing in the Subserver Type object class.
-t NewSubserver Specifies the name that uniquely identifies the NewSubserver. The chserver command is unsuccessful if the NewSubserver type is already known in the subserver object class.
-t OldSubserver Specifies the name that uniquely identifies the existing subserver. The chserver command is unsuccessful if the OldSubserver type is not known in the subserver object class.

Security

Auditing Events

If the auditing subsystem is properly configured and is enabled, the chserver command generates the following audit record (event) every time the command is run:

Event Information
SRC_Chserver Lists in an audit log the name of the subsystem and the fields that have been changed.

Attention RBAC users and Trusted AIX® users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

  1. To change the subserver type, enter:
    chserver  -t old  -t new
    This changes the subserver type from the old subserver type to the new subserver type.
  2. To change the owning subsystem, enter:
    chserver  -t old  -s srctest
    This changes the owning subsystem to srctest.
  3. To change the subserver type, subsystem, and subserver code point, enter:
    chserver  -t old  -t new  -s srctest  -c 1234
    This changes the subserver type from the old to the new subserver type, the owning subsystem to srctest, and the subserver code point to 1234.

Files

Item Description
/etc/objrepos/SRCsubsys Specifies the SRC Subsystem Configuration object class.
/etc/objrepos/SRCsubsvr Specifies the SRC Subserver Configuration object class.