| 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:
| Top |
| 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 |
Specifies the cluster on which the monitor is being changed.
This is a required parameter.
| Top |
Specifies the node on which the monitor is configured.
This is a required parameter.
| Top |
Specifies the type of monitor to be changed.
| Top |
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.
| Top |
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.
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.
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.
| Top |
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 |
| Top |