Change CRG Device Entry (CHGCRGDEVE)

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:

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.
Cluster Resource Services must be active on the node processing the request.
The number of configuration object entries in the configuration object array cannot exceed 256.
At least one node in the recovery domain must be active.
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.

Keyword	Description	Choices	Notes
CLUSTER	Cluster	Name	Required, Positional 1
CRG	Cluster resource group	Name	Required, Positional 2
CFGOBJ	Configuration object list	Values (up to 256 repetitions): Element list	Required, Positional 3
Element 1: Configuration object	Name
Element 2: Configuration object type	*DEVD
Element 3: Configuration object online	SAME, OFFLINE, ONLINE, PRIMARY
Element 4: Server takeover IP address	Character value, SAME, NONE

Configuration object list (CFGOBJ)

Specifies detailed information about the resilient devices to be changed.

This is a required parameter.

Element 1: Configuration object

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

*SAME: The current configuration object is not changed.
name: Specify the name of the configuration object.

Element 2: Configuration object type

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

*DEVD: Type of configuration object.

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 current configuration object online value 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 current 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.
character-value: Specify the server takeover IP address for the relational database name.

Examples

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.