lsrpdomain Command

Purpose

Displays peer domain information for the node.

Syntax

lsrpdomain [-o │ -O] [-l │ -t │ -d │ -D delimiter] [-x] [-h] [-TV] [peer_domain]

Description

The lsrpdomain command displays information about the peer domains that the node where the command runs belongs to. Use the command's flags and parameters to specify which information you want to display and how you want to display it. When you specify the name of a peer domain, the command displays information about that peer domain only. The -o and -O flags also limit the information this command displays. The -o flag displays information only about the online peer domain. The -O flag displays information only about peer domains that are offline.

By default, the lsrpdomain command displays information in table format (-t).

Some of the peer domain information that is displayed follows:

Field	Description
Name	The name of the peer domain.
RSCTActiveVersion	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	The topology services port number.
GSPort	The group services port number.
OpState	The current state of the peer domain.

Flags

-o: Displays information about the node's online peer domain.
-O: Displays 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.
-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

peer_domain: Specifies the name of the peer domain about which you want to display information. You can specify a peer domain name or a substring of a peer domain name for this parameter. If you specify a substring, the command displays information about any defined peer domain with a name that contains the substring.

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.
CT_IP_AUTHENT: When the CT_IP_AUTHENT environment variable exists, the RMC daemon uses IP-based network authentication to contact the RMC daemon on the system that is specified by the IP address to which the CT_CONTACT environment variable is set. CT_IP_AUTHENT only has meaning if CT_CONTACT is set to an IP address; it does not rely on the domain name system (DNS) service.

Restrictions

This command must be run on the node for which the peer domain information is requested.

Implementation Specifics

This command is part of the rsct.basic.rte fileset for the AIX® operating system.

Standard Input

When the -f "-" or -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 display 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.5.0.0                  No              12347   12348

To display general information about the peer domains to which nodeA belongs, with the default delimiter (but without the heading), run this command on nodeA:
```
lsrpdomain -xd
```
The output will look like this:
```
ApplDomain:Online:2.5.0.0:No:12347:12348:
```

To display general information about the peer domains to which nodeA belongs, in long format, run this command on nodeA:

lsrpdomain -l

The output will look like this:

Name              = ApplDomain 
OpState           = Online 
RSCTActiveVersion = 2.5.0.0
MixedVersions     = No 
TSPort            = 12347 
GSPort            = 12348

Location

/opt/rsct/bin/lsrpdomain