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

Keyword	Description	Choices	Notes
ADMDMN	Cluster administrative domain	Name, *GEN	Optional, Positional 1
DMNNODL	Admin domain node list	Single values: *ALL Other values (up to 128 repetitions): Name	Optional, Positional 2
START	Start indicator	*YES, *NO	Optional
CFGPCY	Configure policies	*YES, *NO	Optional
SYNCOPT	Synchronization option	*LASTCHG, *ACTDMN	Optional
CLUSTER	Cluster	Name, *	Optional

Cluster administrative domain (ADMDMN)

Specifies the cluster administrative domain to be created.

This is a required parameter.

*GEN

The cluster administrative domain name will be generated by PowerHA.

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.

*ALL

Add all nodes in the cluster that are not currently in a cluster administrative domain.

name

Specify the name of an active cluster node.

Start indicator (START)

Specifies whether or not the administrative domain is to be started after the creation of the administrative domain.

*YES

The administrative domain will be started.

*NO

The administrative domain will not be started.

Configure policies (CFGPCY)

Specifies whether or not recommended policies are automatically configured for the administrative domain after the creation of the administrative domain.

*YES

Recommended policies will configured for the administrative domain. Policies can be modified with the Change High Availability Policy (CHGHAPCY) command.

The following policies will be configured:

Policy           Qualifier         Value
QCST_AD_CREATE   RSCTYPE(*ASPDEV)  *BLANK
QCST_AD_CREATE   RSCTYPE(*AUTL)    *BLANK
QCST_AD_CREATE   RSCTYPE(*CLS)     LIB(*ALL)
QCST_AD_CREATE   RSCTYPE(*JOBD)    LIB(*ALL)
QCST_AD_CREATE   RSCTYPE(*SBSD)    LIB(*ALL)
QCST_AD_CREATE   RSCTYPE(*USRPRF)  *BLANK
QCST_AD_DELETE   RSCTYPE(*ALL)     LIB(*ALL)
QCST_AD_RESTORE  RSCTYPE(*ALL)     LIB(*ALL)

*NO

Recommended policies will not be configured. Policies can be configured with the Add High Availability Policy (ADDHAPCY) command.

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.

Cluster (CLUSTER)

Specifies the name of the cluster.

*

The cluster that has been configured on this system is used.

name

Specify the name of the cluster.

Examples for CRTCAD

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 for CRTCAD

*ESCAPE Messages

HAE0024

Cluster administrative domain

Cluster administrative domain &1 not created.amp;1 not created.