lscomg Command

Purpose

Displays 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 displays information about the communication groups that are defined to the online peer domain on which the command runs. If you specify the name of a communication group, the lscomg command displays information about that communication group only.

Some of the communication group information that is displayed follows:
Field Description
Name The name of the communication group
Sensitivity The number of missed heartbeats that constitute a failure
Period The number of seconds between heartbeats
Priority 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 The path to the Network Interface Module (NIM) that supports the adapter types in the communication group
NIMParameters The NIM start parameters

Interface resources

Use the -i flag to display information about the interface resources that refer to communication_group.

For IP communication groups (MediaType = 1), lscomg -i displays the following information:
Field Description
Name The name of the interface resource that refers to communication_group.
NodeName The host name of the interface resource that refers to communication_group.
IPAddress The IP address of the interface resource that refers to communication_group.
SubnetMask The subnet mask of the interface resource that refers to communication_group.
Subnet The subnet of the interface resource that refers to communication_group
For disk heartbeating (MediaType = 2) and other non-IP types of communication groups (MediaType = 0), lscomg -i displays the following information:
Field Description
Name The name of the interface resource that refers to communication_group.
NodeName The host name of the interface resource that refers to communication_group.
DeviceInfo Information about the device.
MediaType The type of interfaces that make up 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
Displays information about the interface resource that refers to 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 about which you want to display information. You can specify a communication group name or a substring of a communication group name for this parameter. If you specify a substring, the command displays information about any defined communication group with a name that contains the substring.

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 display 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.
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 a node that is defined and online to the peer domain on which the communication group exists.

Implementation Specifics

This command is part of the Reliable Scalable Cluster Technology (RSCT) fileset for AIX®.

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

In these examples, nodeA is defined and online to peer domain ApplDomain.
  1. To display general information about the communication groups for ApplDomain, run this command on nodeA: 
    lscomg
    The following output is displayed:
    Name  Sensitivity  Period  Priority  Broadcast  SourceRouting  NIMPath                      NIMParameters  
ComG1      2          2        1        no          yes        /opt/rsct/bin/hats_nim      -l 5 
 
  2. To display information about the interface resources that refer to the communication group ComGrp1 for the peer domain ApplDomain, run this command on nodeA: 
    lscomg -i ComGrp1
    The following output is displayed:
    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

/opt/rsct/bin/lscomg