Add Device Domain Entry (ADDDEVDMNE)

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

The Add Device Domain Entry (ADDDEVDMNE) command is used to add a cluster node to the membership list of a device domain. There is no command to create a device domain. The device domain will be created when the first cluster node is added to it. Once the node is a member of a device domain, it can be added to the recovery domain of device cluster resource groups.

This command can be called from a program running on any node in the cluster which has a status of Active.

This command requires that Operating System option 41, HA Switchable Resources, is installed and a valid license key exists on all cluster nodes that will be in the device domain.

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 node to be added and at least one current member of the device domain must be Active. On certain conditions, all current members of the device domain must be Active.
  4. A node can only be a member of one device domain.
  5. This command will fail if any member of the device domain to which the node being added has a status of Partition.
  6. The command will fail if it is the first node being added to the device domain and any node in the cluster has a status of Partition.
Top

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Positional 1
DEVDMN Device domain Name Required, Positional 2
NODE Node identifier Name Required, Positional 3
Top

Cluster (CLUSTER)

Specifies the cluster that contains the node.

This is a required parameter.

name
Specify the name of the cluster which contains the node.
Top

Device domain (DEVDMN)

Specifies the device domain to which the node is being added. If the device domain does not currently exist, it will be created.

This is a required parameter.

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

Node identifier (NODE)

Specifies the cluster node to be added to the device domain.

This is a required parameter.

name
Specify the name of the cluster node.
Top

Examples

ADDDEVDMNE   CLUSTER(MYCLUSTER)  DEVDMN(MYDOMAIN)
             NODE(NODE01)

Consider a cluster with a cluster membership list of NODE01, NODE02, and NODE03 and no existing device domains. This command creates the device domain MYDOMAIN and adds node NODE01 to the device domain membership list. Nodes NODE02 and NODE03 do not belong to any device domain.

Top

Error messages

*ESCAPE Messages

CPF1999
Errors occurred on command.
Top