CL Command Reference - CRTCLU

CL Command List > CRTCLU Reference

Description:

The Create Cluster (CRTCLU) command is used to create a new cluster of one or more nodes. Each node specified on the Node parameter will be placed in the cluster membership list.

If the Start indicator (START) parameter value is *NO, each node that is being added will have a status of New and Cluster Resource Services will not be started on any node. In order to start Cluster Resource Services, the Start Cluster Node (STRCLUNOD) command must be invoked on a node that ran the CRTCLU command. The STRCLUNOD command may be used to start nodes in the cluster membership list.

If the START parameter value is *YES, the cluster can contain only one node. Cluster Resource Services will be started on the node being defined. If Cluster Resource Services is not successfully started, the status of the node remains New.

If the NODE0100 format is chosen, the current cluster version will be set equal to the requesting node¡¯s potential node version.

After Cluster Resource Services has been started on the original node, additional nodes can only be started by calling the Start Cluster Node (STRCLUNOD) command on the original node. If Cluster Resource Services is active on more than one node, additional nodes may be started by invoking the Start Cluster Node (STRCLUNOD) command on any node that has a status of Active.

Once the cluster has been created, the Add Cluster Node Entry (ADDCLUNODE) command can be used to add additional nodes to the cluster membership list. The ADDCLUNODE command can be invoked on any node in the cluster that has a status of Active or from the node on which the cluster was originally created.

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. A node can be a member of only one cluster.

4. You must include the system on which the command is issued in the cluster membership list.


Examples:

CRTCLU CLUSTER(MYCLUSTER)
NODE((NODE01 (¡¯9.5.13.187¡¯)) (NODE02 (¡¯9.5.13.193¡¯)))
START(*NO) VERSION(*PRV)

This command creates cluster MYCLUSTER. The cluster membership list is NODE01 and NODE02. Interface address 9.5.13.187 will be used to communicate with node NODE01. Interface address 9.5.13.193 will be used to communicate with node NODE02. Cluster communications will use the cluster version previous to the requesting nodes potential version level. Cluster Resource Services is not started on the nodes.