Change Cluster Monitor (CHGCLUMON)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes
Parameters
Examples
Error messages

The Change Cluster Monitor (CHGCLUMON) command is used to change information about a cluster monitor. The monitor was previously added with the Add Cluster Monitor (ADDCLUMON) command. The name of the HMC or VIOS partition, or the user id, or password used to authenticate to the CIM server can be changed.

When a cluster node is started which has cluster monitors configured, Cluster Resource Services will attempt to connect to each monitor's CIM server. If some error occurs while trying to connect, the cluster node will still be started. Cluster Resource Services can be told to connect again by using the Change Cluster Monitor command and specifying *SAME for the new CIM server host name, the CIM server user id, and the CIM server password. The node whose monitor is being changed must be active in the cluster.

Restrictions:

  1. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
  2. This command cannot be called from a cluster resource group exit program.
  3. The node where the monitor was configured to run must be active within the cluster.
  4. The command will fail if any node in the cluster has a status of Partition and the CIM server name, user id or password is being changed.
  5. This command can only be used with a cluster at cluster version 7 or greater.
  6. The 5770-UME Licensed Product (IBM Universal Manageability Enablement for i) must be installed and configured on the node the monitor is configured on.
  7. The 5733-SC1 Licensed Product (IBM Portable Utilities for i5/OS) must be installed on the node the monitor is being added to.
  8. Operating system option 33 (Portable Application Solution Environment (PASE)) must be installed on the node the monitor is configured.
  9. If the name of the CIM server host is being changed, the CIM server host associated with this monitor must be running and able to communicate with the node the monitor is being changed on.
Top

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Positional 1
NODE Node identifier Name Required, Positional 2
TYPE Monitor type *CIMSVR Required, Positional 3
OLDCIMSVR Old CIM server host name Character value Required, Positional 4
NEWCIMSVR New CIM server host name Element list Optional
Element 1: CIM server host name Character value, *SAME
Element 2: CIM server user id Character value, *SAME
Element 3: CIM server user password Character value, *SAME
Top

Cluster (CLUSTER)

Specifies the cluster on which the monitor is being changed.

This is a required parameter.

name
Specify the name of the cluster on which the node monitor is being changed.
Top

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

Monitor type (TYPE)

Specifies the type of monitor to be changed.

*CIMSVR
The type of monitor to be changed is a CIM server.
Top

Old CIM server host name (OLDCIMSVR)

Specifies the name of the current CIM server host used by the monitor.

The name must match the name that was used on the Add Cluster Monitor or a previous 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 current CIM server host used by the monitor.
Top

New CIM server host name (NEWCIMSVR)

Specifies information about the CIM server which will send information about the system or logical partitions it is monitoring.

This is a required parameter.

Element 1: CIM server host name

A name that uniquely identifies the HMC or VIOS partition and can be found in a domain name server to determine the HMC's or VIOS partition's IP address. The name can be the complete domain name or it can be a short name that can be uniquely found in a domain name server. For example, the domain name may be NYCHMC1.ABCCOMPANY.COM and its short name may be NYCHMC1.

*SAME
The current CIM server host name is not changed.
character-value
Specify a name for the HMC or VIOS partition.

Element 2: CIM server user id

The cluster node running the monitor must authenticate with the HMC or VIOS partition. A user id that is configured on the HMC or VIOS partition must be specified.

*SAME
The current user id is not changed.
character-value
Specify a user id that is configured on the HMC or VIOS partition.

Element 3: CIM server user password

The cluster node running the monitor must authenticate with the HMC or VIOS partition. A password associated with the user id that is configured on the HMC or VIOS partition must be specified.

*SAME
The current password is not changed.
character-value
Specify the password for the user id.
Top

Examples

CHGCLUMON   CLUSTER(MYCLUSTER)  NODE(NODE2) TYPE(*CIMSVR)
            OLDCIMSVR(NYBLADE) NEWCIMSVR(*SAME newUser Secret2)

This command changes the user id and password the monitor authenticates with for the blade system's VIOS partition, NYBLADE. The monitor was configured to run on node NODE2 in the cluster MYCLUSTER.

Top

Error messages

*ESCAPE Messages

HAE0041
Cluster monitor not changed on node &1 in cluster &2.
Top