Create Cluster (CRTCLU)

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:

You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
This command cannot be called from a cluster resource group exit program.
A node can be a member of only one cluster.
You must include the system on which the command is issued in the cluster membership list.

Keyword	Description	Choices	Notes
CLUSTER	Cluster	Name	Required, Positional 1
NODE	Node list	Values (up to 128 repetitions): Element list	Required, Positional 2
Element 1: Node identifier	Name
Element 2: IP address	Values (up to 2 repetitions): Character value
START	Start indicator	YES, NO	Optional
VERSION	Target cluster version	CUR, PRV	Optional

Node identifier (NODE)

Specifies information about the cluster and the list of nodes which will be placed in the cluster membership list. A maximum of 128 nodes can be in a cluster.

This is a required parameter.

Element 1: Node identifier

name: Specify the name for the system that uniquely identifies a node.

Element 2: IP address

The cluster interface address is an IP address that is used by Cluster Resource Services to communicate with other nodes in the cluster. A maximum of 2 interface addresses per node can be specified.

character-value: Specify the IP address to be used to communicate with other nodes in the cluster. The address is in dotted decimal format.

Target cluster version (VERSION)

Specifies the version the cluster will use in conversation with other nodes in the cluster. This also determines the potential node version of the nodes allowed to join the cluster. The following possible values are based on the node originating the request.

*CUR: The cluster will communicate at the requesting node's potential node version. In addition, nodes with a potential node version less than the requesting node will not be allowed to join the cluster.
*PRV: The cluster will communicate at the requesting node's potential node version minus 1. This allows nodes at a previous potential node version to join the cluster. However, no new cluster function can be used until all nodes have the latest cluster version.

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.