Create Cluster Admin Domain (CRTCAD)

The Create Cluster Administrative Domain (CRTCAD) command creates a peer cluster resource group object which represents the cluster administrative domain. The cluster administrative domain provides synchronization of monitored resources across the active nodes in the domain. The cluster nodes which are defined within the cluster administrative domain will participate in the synchronization process. The cluster administrative domain name is the name of the cluster resource group which is being created. The nodes defined in the domain node list are the nodes in the recovery domain of the cluster resource group. Successful completion of this command results in a new job started as a system job. This job has the same name as the name of the cluster administrative domain being created.

To add nodes to the cluster administrative domain, use the Add Cluster Admin Domain Node Entry (ADDCADNODE) command. To remove nodes from the cluster administrative domain, use the Remove Cluster Admin Domain Node Entry (RMVCADNODE) command. To start the cluster administrative domain, use the Start Cluster Admin Domain (STRCAD) command. To end the cluster administrative domain use the End Cluster Admin Domain (ENDCAD) command.

This command will do the following:

• Create the cluster administrative domain on all nodes in the defined administrative domain. The cluster administrative domain may be accessed by a cluster resource group command running on any node in the cluster.
• Provide users a single system image of the cluster administrative domain. That is, any changes made to any monitored resources defined in the cluster administrative domain will be made on all nodes in the administrative domain.
• The cluster resource group (CRG) is owned by the QCLUSTER user profile. The user who is running the command is granted *all authority to the cluster resource group object. 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.

Restrictions:

• You must have input/output system configuration (*IOSYSCFG) special authority on all nodes in the recovery domain to run this command.
• The cluster administrative domain name cannot begin with QCST.
• Cluster Resource Services must be active on the node processing the request.
• All nodes in the administrative domain must be in the cluster with a status of Active.
• Each node can be specified only once in the administrative domain.
• A node can only be specified in one cluster administrative domain within a cluster.

Parameters

Cluster (CLUSTER)

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

This is a required parameter.

name

Specify the name of the cluster.

Cluster administrative domain (ADMDMN)

Specifies the cluster administrative domain to be created.

This is a required parameter.

name

Specify the name of the cluster administrative domain.

Admin domain node list (DMNNODL)

Specifies the list of nodes that compose the administrative domain. Nodes in the administrative domain must be unique cluster nodes. Each node must be active in the cluster.

You can specify up to 128 nodes for the administrative domain.

This is a required parameter.

name

Specify the name of an active cluster node.

Synchronization option (SYNCOPT)

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

• If all changes to monitored resources should be applied to the cluster administrative domain, *LASTCHG should be specified. When a node joins the cluster, the most recent change made to each monitored resource will be applied to all active nodes in the domain. If the most recent change was made on the node that is joining, it will be propagated to the active domain.
• If only changes to monitored resources are allowed from active nodes, the *ACTDMN option should be specified. Changes made to monitored resources on inactive nodes will be discarded when the node joins the domain.
• The *ACTDMN option does not apply to network server storage spaces (*NWSSTG). Synchronization of *NWSSTG resources is always based on the last change made.

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

Examples

Creating a Cluster Administrative Domain With a Three-Node Administrative Domain

CRTCAD   CLUSTER(MYCLUSTER)  ADMDMN(MYDOMAIN)
         DMNNODL(NODE01 NODE02 NODE03)
         SYNCOPT(*LASTCHG)

This command creates a cluster administrative domain called MYDOMAIN in the cluster called MYCLUSTER. The administrative domain consists of three nodes, NODE01, NODE02 and NODE03. The last change to monitored resources will be applied when a node joins the cluster administrative domain.

Error messages

*ESCAPE Messages

HAE0024

Cluster administrative domain &1 not created.