Change Cluster Admin Domain (CHGCAD)

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

The Change Cluster Administrative Domain (CHGCAD) command changes an existing cluster administrative domain. The cluster administrative domain provides synchronization of monitored resources across the active nodes in the domain. Synchronization of multiple changes to a monitored resource occurs when a cluster node joins an administrative domain and when the peer cluster resource group (CRG) which represents the cluster administrative domain is started. The synchronization option can be used to indicate how the cluster administrative domain handles changes when an inactive node joins the cluster.

Restrictions:

  1. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
  2. All nodes in the administrative domain must be in the cluster with a status of Active.
  3. This command must run from an active cluster node in the domain node list of the cluster administrative domain.
  4. This command can only be used with a cluster at cluster version 6 or later.
  5. The cluster resource group CRG is owned by the QCLUSTER user profile. To use the cluster resource group commands with the cluster administrative domain you will need to be authorized to the cluster resource group and to the QCLUSTER user profile.
Top

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Key, Positional 1
ADMDMN Cluster administrative domain Name Required, Key, Positional 2
SYNCOPT Synchronization option *SAME, *LASTCHG, *ACTDMN Optional
Top

Cluster (CLUSTER)

Specifies the cluster containing the cluster administrative domain to be changed.

This is a required parameter.

name
Specify the name of the cluster.
Top

Cluster administrative domain (ADMDMN)

Specifies the cluster administrative domain to be changed.

This is a required parameter.

name
Specify the name of the cluster administrative domain.
Top

Synchronization option (SYNCOPT)

Specifies the synchronization behavior when a node joins a cluster administrative domain.

*SAME
The synchronization option is not changed.
*LASTCHG
The last change that was made before the node joined the cluster administrative domain is processed by all nodes in the active domain. The last change could have been made in the active domain or on the joining node while it was inactive.
*ACTDMN
Only changes made on active nodes in an active cluster administrative domain are processed. Changes made on a node while it was inactive are not passed to the active domain. When a node joins the cluster administrative domain, it will be synchronized with the values from the active domain.
Top

Examples

CHGCAD   CLUSTER(MYCLUSTER)  ADMDMN(MYDOMAIN)
         SYNCOPT(*ACTDMN)

This command changes the synchronization behavior of a cluster administrative domain called MYDOMAIN in a cluster called MYCLUSTER. When a node joins MYDOMAIN, any changes made to monitored resources while it was inactive will be discarded and the node will be synchronized with values from the active domain.

Top

Error messages

*ESCAPE Messages

HAE0003
Cluster administrative domain &1 not changed.
Top