Add Cluster Node Entry (ADDCLUNODE)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Add Cluster Node Entry (ADDCLUNODE) command is used to add a node to the membership list of an existing cluster.

If the START parameter is set to *NO, the node that is being added will have a status of New and Cluster Resource Services will not be started on that node. The Start Cluster Node (STRCLUNOD) command can be called from a program running on one of the active nodes in the cluster to start Cluster Resource Services on a node that does not have a status of Active.

If the START parameter on this command is set to *YES, Cluster Resource Services will be started on the node that is being added. If Cluster Resource Services is successfully started, the status for the added node will be set to Active. Successful completion of this command results in Cluster Resource Services jobs (QCSTCTL, QCSTCRGM, and a job for each cluster resource group object in the cluster) started in the QSYSWRK subsystem. If the Cluster Resource Services cannot be started, the status of the added node will be set to New.

During the activation of Cluster Resource Services, the allow add to cluster (ALWADDCLU) network attribute is checked to see whether the node being added should be part of the cluster and whether to validate the cluster request through the use of X.509 digital certificates. If validation is required, the requesting node and the node being added must have the following installed on the systems:

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. This command cannot be issued on the node being added. You must issue the command from a node in the cluster that has a status of Active. If Cluster Resource Services has not been started on any of the nodes in the cluster, you must issue this command from the node where the cluster was originally created, and the START parameter must be set to *NO.
  4. The node being added to the cluster must not already be a member of this or any other cluster. A node can be a member of only one cluster.
  5. If the START parameter is set to *YES, the node must be IP reachable (TCP/IP active and the INETD server started).
  6. The command will fail if any node in the cluster has a status of Partition.
  7. If the START parameter is set to *YES, the potential node version of the node being added must be equal to the current cluster version or up to one level higher than the current cluster version. The potential node version and the current cluster version can be retrieved by using the Display Cluster Information (DSPCLUINF) command.
Top

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Positional 1
NODE Node list 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
Top

Cluster (CLUSTER)

Specifies the cluster to which the node is being added.

This is a required parameter.

name
Specify the name of the cluster to which the node is being added.
Top

Node identifier (NODE)

Specifies information about the node which will be placed in the cluster membership list.

This is a required parameter.

Element 1: Node identifier

A name that uniquely identifies a node.

node-identifier
Specify a name for the system.

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 an IP address to be used to communicate with other nodes in the cluster. The address is in dotted decimal format.
Top

Start indicator (START)

Specifies whether or not Cluster Resource Services is to be started on the node being added.

*YES
Cluster Resource Services will be started on the node.
*NO
Cluster Resource Services will not be started on any node.
Top

Examples 

ADDCLUNODE   CLUSTER(MYCLUSTER)  NODE(NODE1 ('2.5.35.117'))
             START(*YES)

This command adds node NODE1 to the cluster MYCLUSTER. Node NODE1 is added to the cluster membership list and Cluster Resource Services is started on NODE1. Interface address 2.5.35.117 will be used by Cluster Resource Services to communicate with the new node.

Top

Error messages

*ESCAPE Messages

CPF1999
Errors occurred on command.
Top