nlssrc Command
Purpose
Gets the status of a subsystem or a group of subsystems in canonical form.
Syntax
nlssrc [ -h host] -g group_name
nlssrc [ -h host] [-l] [-c] -s subsystem_name
nlssrc [ -h host] [-l] [-c] -p subsystem_pid
The syntax for the first two usages of nlssrc will generate the exact same output as lssrc. The syntax for the last two usages will generate the output in the canonical form as lssrc.
Description
Use the nlssrc command to get the status of a subsystem or a group of subsystems in canonical form. For the AIX® platform, use the nlssrc -c command to get language-independent output for supported subsystems from the lssrc command. The status is displayed in English regardless of the installed language locale. If the -c flag is not present, the nlssrc command will invoke the lssrc command that uses the daemon's locale.
Flags
Item | Description |
---|---|
-a | Lists the current status of all defined subsystems |
-c | Requests the canonical lssrc output of the supported subsystems. |
-g group_name | Specifies a group of subsystems to get status for. The command is unsuccessful if the group_name parameter is not contained in the subsystem object class. |
-h host | Specifies the foreign host on which this status action is requested. The local user must be running as root. The remote system must be configured to accept remote System Resource Controller (SRC) requests. That is, the srcmstr daemon (see /etc/inittab) must be started with the -r flag and the /etc/hosts.equiv file or the .rhosts file must be configured to allow remote requests. |
-l | Requests that a subsystem send its current status in long form. Long status requires that a status request be sent to the subsystem; it is the responsibility of the subsystem to return the status. |
-p subsystem_pid | Specifies a particular instance of the subsystem_pid parameter to get status for, or a particular instance of the subsystem to which the status subserver request is to be taken. |
-s subsystem_name | Specifies a subsystem to get status for. The subsystem_name parameter can be the actual subsystem name or the synonym name for the subsystem. The command is unsuccessful if the subsystem_name parameter is not contained in the subsystem object class. |
Security
You do not need root authority to run this command.
Exit Status
- 0
- Command has run successfully.
- 1
- Command was not successful.
Restrictions
This command applies to the cthags and cthats subsystems only.
Standard Output
When the -h flag is specified, this command's usage statement is written to standard output.
Standard Error
Error messages are written to standard error (and to the ctsnap.host_name.nnnnnnnn.log file).
Examples
- To get nlssrc output in English from
a subsystem called ctsubsys, enter:
nlssrc -c -ls ctsubsys
- The following example shows the same information in different
formats:
nlssrc -ls ctsubsys (locale-dependent) Subsystem Group PID Status ctsubsys ctsubsys 6334 active 2 locally-connected clients. Their PIDs: 15614 23248 HA Subsystem domain information: Domain established by node 5 Number of groups known locally: 1 Number of Number of local Group Name providers providers/subscribers ha_filesys 7 1 0
nlssrc -ls ctsubsys -c (canonical form) Number of local clients: 2 PIDs: 15614 23248 HA Subsystem domain information: Domain established by node 5. Number of known local groups: 1 Group Name: ha_filesys Providers: 7 Local Providers: 1 Local Subscribers: 0
Location
- /opt/rsct/bin/nlssrc
- Contains the nlssrc command
Files
- /tmp/ctsupt
- Location of the default directory that contains the output files.
- /tmp/ctsupt/ctsnap.host_name.nnnnnnnn.log
- Location of the log file of the command execution, where nnnnnnnn is a timestamp and host_name is the name of the host on which the command is running.
- tmp/ctsupt/ctsnap.host_name.nnnnnnnn.tar.Z
- Location of the compressed tar file that contains the collected data, where nnnnnnnn is a timestamp and host_name is the name of the host on which the command is running.