confsrc Command

Purpose

The confsrc command configures a subsystem, a group of subsystems, or a subserver.

Syntax

confsrc [[-R] -h Host] [-p SubsystemPID] [-q] [-Q] [-u UserID] [-U Password] -s Subsystem -a ConfigString

Description

The confsrc command sends a request to the System Resource Controller (SRC) to configure a subsystem. When a request to configure the subserver is passed to the SRC and the subsystem to which the subserver belongs is not active, the SRC starts the subsystem and transmits the request to the subsystem.

Note: The configure subserver request is processed only when the subsystem supports the request.

Flags

Item Description
-a ConfigString Specifies a string containing the configuration information. This string is passed from the command line and appended to the command-line arguments from the subsystem object class. If the specified string exceeds 1200 characters, the command is unsuccessful. The command argument is passed by the SRC to the subsystem according to the rules used by the shell. Quoted strings are passed as a single argument, and blanks outside a quoted string delimit an argument. Single and double quotes can be used in the string.
-h Host Specifies the foreign host on which the configure action is requested. The local user must be running as root. The remote system must be configured to accept remote SRC requests by starting the srcmstr daemon (/etc/inittab) with the -r flag and configuring the /etc/hosts.equiv orrhosts file to allow remote requests.
-p SubsystemPID Specifies an instance of the subsystem to which the configure request is passed.
-q Specifies the quiet mode of operation with minimum local output.
-Q Specifies the quiet mode of operation with suppressed output.
-R Uses TCP for remote connections.
Note: This flag is active only when the -h flag is used.
-s Subsystem Specifies the subsystem to be started. The specified Subsystem can be the actual subsystem name or the synonym name for the subsystem. The command is unsuccessful if the specified Subsystem is not contained in the subsystem object class.
-u UserID Specifies the user ID used on the remote host.
Note: This flag is active only when the -h flag is used.
-U Password Specifies the password for the user ID.
Note: This flag is active only when the -u flag is used.

Security

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.

Files

Item Description
/etc/objrepos/SRCsubsys Specifies the SRC Subsystem Configuration Object Class.
/etc/objrepos/SRCsubsvr Specifies the SRC Subserver Configuration Object Class.
/etc/services Defines the sockets and protocols used for Internet services.
/dev/SRC Specifies the AF_UNIX socket file.
/dev/.SRC-unix Specifies the location for temporary socket files.