The Create Cluster Administrative Domain (CRTADMDMN) 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 in the QSYSWRK subsystem. 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 CRG Node Entry (ADDCRGNODE) command. To remove nodes from the cluster administrative domain use the Remove CRG Node Entry (RMVCRGNODE) command. To start the cluster administrative domain use the Start Cluster Resource Group (STRCRG) command. To end the cluster administrative domain use the End Cluster Resource Group (ENDCRG) 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 the cluster resource group object representing the cluster administrative domain will be made on all nodes in the administrative domain. Likewise, any changes made to system entities and attributes enrolled to the cluster administrative domain will be propagated to all active nodes in the administrative domain once the cluster resource group is started.
• The cluster resource group CRG is owned by the QCLUSTER user profile. To use the cluster resouce 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:

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 cluster administrative domain name cannot begin with QCST.
4. Cluster Resource Services must be active on the node processing the request.
5. All nodes in the administrative domain must be in the cluster with a status of Active.
6. Each node can be specified only once in the administrative domain.
7. A node can be specified in one cluster administrative domain within a cluster.

Parameters

Keyword	Description	Choices	Notes
CLUSTER	Cluster	Name	Required, Positional 1
ADMDMN	Cluster administrative domain	Name	Required, Positional 2
DMNNODL	Admin domain node list	Values (up to 128 repetitions): Name	Required, Positional 3

Top

Cluster (CLUSTER)

Specifies the cluster containing the cluster administrative domain which will 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.

Examples

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

CRTADMDMN CLUSTER(MYCLUSTER)  ADMDMN(MYDOMAIN)
          DMNNODL(NODE01 NODE02 NODE03)

This command creates a peer cluster resource group object representing the cluster administrative domain called MYDOMAIN in the cluster called MYCLUSTER. The administrative domain consists of three nodes, NODE01, NODE02 and NODE03. The cluster resource group commands can be used to change the attributes of this cluster administrative domain.

Error messages

*ESCAPE Messages

CPFBBB4

Create cluster administrative domain failed.