[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 3
lsrpdomain Command
Purpose
Lists peer domain information for the node.
Syntax
lsrpdomain [-o | -O] [-l | -t | -d | -D delimiter] [-x] [-h] [-TV] [domain_name]
Description
The lsrpdomain command lists information about the peer domains
to which the node where the command runs belongs. The flags and parameters can be used to specify
what is listed. When a domain name is specified, the listed information is
limited to that peer domain information only. The -o or -O flag also limits the listed
information. The -o flag lists only the online peer domain's information. The -O flag lists information
for peer domains that are offline.
The default format of the lsrpdomain command is tabular (-t).
Some of the peer domain information that is listed follows:
- Name
- Specifies the name of the peer domain.
- RSCTActiveVersion
- Specifies the version of RSCT that is active in the peer domain.
- MixedVersions
- Indicates whether more than one version of RSCT is active in the peer
domain.
- TSPort
- Specifies the topology services port number.
- GSPort
- Specifies the group services port number.
- OpState
- Specifies the current state of the peer domain.
Flags
- -o
- Lists information about the online peer domain for the node.
- -O
- Lists information about peer domains that are offline for the node.
- -l
- Displays the information on separate lines (long format).
- -t
- Displays the information in separate columns (table format). This is
the default format.
- -d
- Displays the information using delimiters. The default delimiter is
a colon (:). Use the -D flag if you want to change the default delimiter.
- -D delimiter
- Displays the information using the specified delimiter. Use this flag to specify a delimiter
other than the default colon (:) -- when the information you
want to display contains colons, for example. You can use this flag to specify a delimiter of one or
more characters.
- -x
- Excludes the header (suppresses header printing).
- -h
- Writes the command's usage statement to standard output.
- -T
- Writes the command's trace messages to standard error. For your software
service organization's use only.
- -V
- Writes the command's verbose messages to standard output.
Parameters
- domain_name
- Specifies the name of the peer domain to be listed. domain_name can be a peer domain name or a substring of a domain name. When domain_name is a substring, any defined domain name that contains the
substring will be listed.
Security
The user of the lsrpdomain command needs read permission for
the IBM.PeerDomain resource class on the node on which the command
runs. By default, root on any node in the peer domain has read and
write access to this resource class through the configuration resource manager.
Exit Status
- 0
- The command ran successfully.
- 1
- An error occurred with RMC.
- 2
- An error occurred with a command-line interface script.
- 3
- An incorrect flag was entered on the command line.
- 4
- An incorrect parameter was entered on the command line.
- 5
- An error occurred that was based on incorrect command-line input.
- 6
- The peer domain definition does not exist.
Environment Variables
- CT_CONTACT
- Determines the system where the session with the resource monitoring
and control (RMC) daemon occurs. When CT_CONTACT is set to a host name or
IP address, the command contacts the RMC daemon on the specified host. If
CT_CONTACT is not set, the command contacts the RMC daemon on the local system
where the command is being run. The target of the RMC daemon session and
the management scope determine the resource classes or resources that are
processed.
Restrictions
This command must be run on the node for which the peer domain information
is requested.
Standard Input
When the -f "-" flag is specified, this command reads one or more node names from standard
input.
Standard Output
When the -h flag is specified, this command's usage statement is written to standard
output. All verbose messages are written to standard output.
Standard Error
All trace messages are written to standard error.
Examples
- To list general information about the peer domains to which nodeA belongs, run this command on nodeA:
lsrpdomain
The output will look like this:
Name OpState RSCTActiveVersion MixedVersions TSPort GSPort
ApplDomain Online 2.3.0.0 No 12347 12348
- To list general information with the default delimiter and without the
heading about the peer domains to which nodeA belongs, run this
command on nodeA:
lsrpdomain -xd
The output will look
like this:
ApplDomain:Online:2.3.0.0:No:12347:12348:
- To list in long form general information about the peer domains to which
nodeA belongs, run this command on nodeA:
lsrpdomain -l
The output will look like this:
Name = ApplDomain
OpState = Online
RSCTActiveVersion = 2.3.0.0
MixedVersions = No
TSPort = 12347
GSPort = 12348
Location
- /usr/sbin/rsct/bin/lsrpdomain
- Contains the lsrpdomain command
Related Information
Commands: lsrpnode, mkrpdomain, preprpnode,
rmrpdomain, startrpdomain, stoprpdomain
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]