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