Remove Cluster Monitor (RMVCLUMON)

The Remove Cluster Monitor (RMVCLUMON) command is used to remove a monitor from the cluster. The monitor was previously added with the Add Cluster Monitor (ADDCLUMON) command. The monitor that was configured to run on a specific cluster node is removed from that node.

Restrictions:

• You must have input/output system configuration (*IOSYSCFG) special authority on all nodes in the cluster to run this command.
• This command cannot be called from a cluster resource group exit program.
• The command will fail if any node in the cluster has a status of Partition.
• This command can only be used with a cluster at cluster version 7 or greater.
• To remove cluster monitors for CIM servers:
  • The 5770-UME Licensed Product (IBM Universal Manageability Enablement for i) must be installed and configured on the node from which the monitor is being removed.
  • The 5733-SC1 Licensed Product (IBM Portable Utilities for i5/OS) must be installed on the node from which the monitor is being removed.
  • Operating system option 33 (Portable Application Solution Environment (PASE)) must be installed on the node from which the monitor is being removed.
  • The HMC version must be V8R8.5.0 or earlier.
• To remove cluster monitors for Representational State Transfer (REST) servers:
  • The Extended Base Directory Support (Option 3 of the IBM i operating system) must be installed on the node from which the monitor is being removed.
  • The HMC version must be V8R8.5.0 or later.

Parameters

Cluster (CLUSTER)

Specifies the cluster from which the monitor is being removed.

This is a required parameter.

name

Specify the name of the cluster from which the node monitor is being removed.

Node identifier (NODE)

Specifies the node on which the monitor is configured.

This is a required parameter.

name

Specifies the node on which the monitor is configured.

Monitor type (TYPE)

Specifies the type of monitor to be removed.

*CIMSVR

The type of monitor to be removed is a CIM server.

*RESTSVR

The type of monitor to be removed is a Representational State Transfer (REST) server.

CIM server host name (CIMSVR)

Specifies the name of the CIM server host.

The name must match the name that was used on the Add Cluster Monitor or Change Cluster Monitor command. If the monitor was added with the complete domain name such as NYCHMC1.ABCCOMPANY.COM, that is what must be specified for the CIM server host name. If the monitor was added with a short name such as NYCHMC1, that is what must be specified for the CIM server host name.

character-value

Specify the name of the CIM server host.

REST server host name (RESTSVR)

Specifies the name of the Representational State Transfer (REST) server host.

The name must match the name that was used on the Add Cluster Monitor or Change Cluster Monitor command. If the monitor was added with the complete domain name such as NYCHMC1.ABCCOMPANY.COM, that is what must be specified for the REST server host name. If the monitor was added with a short name such as NYCHMC1, that is what must be specified for the REST server host name.

character-value

Specify the name of the REST server host.

Examples

RMVCLUMON   CLUSTER(MYCLUSTER)  NODE(NODE2) TYPE(*RESTSVR)
            RESTSVR(NYHMC)

This command removes the Representational State Transfer (REST) monitor for NYHMC which was configured to run on node NODE2 in the cluster MYCLUSTER.

RMVCLUMON   CLUSTER(MYCLUSTER)  NODE(NODE2) TYPE(*CIMSVR)
            CIMSVR(NYHMC)

This command removes the CIM monitor for NYHMC which was configured to run on node NODE2 in the cluster MYCLUSTER.

Error messages

*ESCAPE Messages

HAE0041

Cluster monitor not removed from node &1 in cluster &2.