CHGCRGDEVE (Change Cluster Resource Group Device Entry) Command Description

CHGCRGDEVE Command syntax diagram

 

Purpose

The Change Cluster Resource Group Device Entry (CHGCRGDEVE) command changes information about one or more configuration objects in a device cluster resource group. You can change the configuration action to be taken when the cluster resource group is switched over to a backup system. The entry being changed is found by searching the current entries for a matching configuration object name and configuration object type.

If an exit program is specified for the cluster resource group, the cluster resource group exit program is called with an action code of CHANGE DEVICE ENTRY on all active nodes in the recovery domain. The cluster resource group status is set to Change Device Entry Pending. If the exit program completes successfully, the cluster resource group status is reset to its value at the time the command was called. If the exit program fails and the cluster resource group cannot be restored to its original condition, the cluster resource group status is set to Indoubt.

Restrictions

1. To use this command have *IOSYSCFG authority.
2. This CL command cannot be called from a cluster resource group exit program.
3. Cluster Resource Services must be active on the node processing the request.
4. The number of configuration object entries in the configuration object array cannot exceed 256.
5. At least one node in the recovery domain must be active.
6. If a server takeover IP address is specified, it must exist on all nodes in the recovery domain if the cluster resource group is active. The server takeover IP address must be unique. It can only be associated with a primary auxiliary storage pool.

 

Required Parameters

CLUSTER

Specifies the name of the cluster to which the cluster resource group belongs.

cluster-name: Specify the name of the cluster which contains the cluster resource group.

CRG

Specifies the name of the cluster resource group which is to be changed.

cluster-resource-group-name: Specify the name of the device cluster resource group.

CFGOBJ

Specifies detailed information about the resilient devices to be changed

Element 1: Configuration Object

Specifies the name of the auxiliary storage pool device description which is in the cluster resource group.

configuration-object: Specify the name of the device description.

Element 2: Configuration Object Type

This specifies the type of configuration object specified with configuration object name.

*DEVD: Type of configuration object is device description.

Element 3: Configuration Object Online

Specifies what configuration action to take when the cluster resource group is switched over or failed over to a backup node. The configuration object can be varied on and the server takeover IP address will be started or left varied off and the server takeover IP address is left inactive when a device ownership is moved to another node. This attribute does not vary the device on or off or start the server takeover IP address when the cluster resource group is started or ended.

*SAME: The configuration object online is not changed.

*OFFLINE: Do not vary the configuration object on and do not start the server takeover IP address.

*ONLINE: Vary the configuration object on and start the server takeover IP address.

*PRIMARY: This is a secondary ASP. Vary on processing and starting of the server takeover IP address is determined by the corresponding primary ASP for this ASP group.

Element 4: Server Takeover IP Address

Specifies a takeover IP address for servers associated with the relational database name in the device description for an auxiliary storage pool. This element is optional and can only be specified for a primary auxiliary storage pool. If specified, the addresss must be presented in dotted decimal format. The specified address must exist on all nodes in the recovery domain if the cluster resource group is active. If not specified, or for a secondary or UDFS auxiliary storage pool, the element must be set to *NONE.

*SAME: The server takeover IP address is not changed.

*NONE: There is no server takeover IP address associated with the relational database name in the device description for an auxiliary storage pool.

server-takeover-ip-address: Specify the server takeover IP address for the relational database name.

Example for CHGCRGDEVE

CHGCRGDEVE CLUSTER(MYCLUSTER) CRG(MYCRG) CFGOBJ((IASP01 *DEVD *ONLINE *NONE))

This command changes the device list information for the configuration object IASP01 in the resilient device cluster resource group MYCRG in the cluster MYCLUSTER. The configuration action is now set to vary the configuration object online in the event of a failover or switchover.

Error messages for CHGCRGDEVE

*ESCAPE Messages

CPF0001

Error found on &1 command.