[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 3
lscomg Command
Purpose
Lists
information about the communication groups of a peer domain.
Syntax
lscomg [-l | -t | -d | -D delimiter] [-x] [-i] [-h] [-TV] [communication_group]
Description
The lscomg command lists information about the communication groups
defined to the online peer domain on which the command runs. When a communication
group name is specified, the information is limited to that communication
group's information only.
Some of the communication group information that is listed follows:
- Name
- Specifies the name of the communication group.
- Sensitivity
- Specifies the number of missed heartbeats that constitute a failure.
- Period
- Specifies the number of seconds between heartbeats.
- Priority
- Specifies the relative priority of the communication group.
- Broadcast
- Indicates whether broadcast should be used if it is supported by the
underlying media.
- SourceRouting
- Indicates whether source routing should be used if it is supported by
the underlying media.
- NIMPath
- Specifies the the path to the Network Interface Module (NIM) that supports
the adapter types in the communication group.
- NIMParameters
- Specifies the NIM start parameters.
The -i flag is
used to display the interface resource information for those interface resources
that refer to the communication group specified by the communication_group parameter. When the -i flag is specified, the following information is listed:
- Name
- Specifies the name of the resource interface that refers to this communication
group.
- NodeName
- Specifies the host name of the resource interface that refers to this
communication group.
- IPAddr
- Specifies the IP address of the resource interface that refers to this
communication group.
- SubnetMask
- Specifies the subnet mask of the resource interface that refers to this
communication group.
- Subnet
- Specifies the subnet of the resource interface that refers to this communication
group.
Flags
- -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).
- -i
- Lists information about the interface resource that refers to the specified
communication group.
- -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
- communication_group
- Specifies the name of the communication group to be listed. communication_group can be a communication group name or a substring of a communication
group name. When it is a substring, any defined communication group name that
contains the substring will be listed.
Security
The user of the lscomg command needs read permission for the IBM.CommunicationGroup resource class. Read permission for the IBM.NetworkInterface resource class is required to list the network
interface information. By default, root on any node in the peer
domain has read and write access to these resource classes 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 communication group 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 a node that is defined and online to the peer
domain on which the communcation group exists.
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
In these examples, nodeA is defined and online to peer domain ApplDomain.
- To list general information about the communication groups for ApplDomain, run this command on nodeA:
lscomg
The output
will look like this:
Name Sensitivity Period Priority Broadcast SourceRouting NIMPath NIMParameters
ComG1 2 2 1 no yes /usr/sbin/rsct/bin/hats_nim -l 5
- To list the interface information for the interface resources that refer
to the communication group ComGrp1 for the peer domain ApplDomain, run this command on nodeA:
lscomg -i ComGrp1
The
output will look like this:
Name NodeName IPAddr SubnetMask Subnet
eth0 n24 9.234.32.45 255.255.255.2 9.235.345.34
eth0 n25 9.234.32.46 255.255.255.2 9.235.345.34
Location
- /usr/sbin/rsct/bin/lscomg
- Contains the lscomg command
Related Information
Commands: chcomg, lsrpnode, lsrpdomain, mkcomg, preprpnode, rmcomg
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]