rmcomg Command

Purpose

Removes a communication group that has already been defined from a peer domain.

Syntax

rmcomg [-q] [-h] [-TV] communication_group

Description

The rmcomg command removes the definition of the existing communication group with the name specified by the communication_group parameter for the online peer domain. The communication group is used to define heartbeat rings for use by topology services and to define the tunables for each heartbeat ring. The communication group determines which devices are used for heartbeating in the peer domain.

The rmcomg command must be run on a node that is currently online in the peer domain where the communication group is defined. More than half of the nodes must be online to remove a communication group from the domain.

The communication group must not be referred to by an interface resource. Use the chcomg command to remove references made by interface resources to a communication group.

Flags

-q
Specifies quiet mode. The command does not return an error if the communication group does not exist.
-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 defined communication group that is to be removed from the peer domain.

Security

The user of the rmcomg command needs write permission for the IBM.CommunicationGroup resource class. 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 communication group 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 where the communication group is to be removed.

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 this example, nodeA is defined and online to ApplDomain. To remove the communication group definition ComGrp1 for the peer domain ApplDomain, run this command on nodeA:
rmcomg ComGrp1

Location

/usr/sbin/rsct/bin/rmcomg