Commands Reference, Volume 4

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. The communication group must not be referred to by an interface resource. Use the chcomg command to remove references 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.

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.

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 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

Contains the rmcomg command

Files

The access control list (ACL) file /var/ct/cfg/ctrmc.acls is modified. If this file does not exist, it is created.

Related Information

Commands: chcomg, lscomg, lsrpdomain, lsrpnode, mkcomg, preprpnode