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:

Parameters

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, *CTLD, *LIND, *NWSD
Element 3: Configuration object online *SAME, *OFFLINE, *ONLINE, *PRIMARY
Element 4: Server takeover IP address Character value, *SAME, *NONE

Cluster (CLUSTER)

Specifies the cluster to which the cluster resource group belongs.

This is a required parameter.

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

Cluster resource group (CRG)

Specifies the cluster resource group which is to be changed.

This is a required parameter.

name
Specify the name of the device cluster resource group.

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 configuration 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
Configuration object of type device description.
*CTLD
Configuration object of type controller description.
*LIND
Configuration object of type line description.
*NWSD
Configuration object of type network server 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. Switchover and failover completion may be delayed if the online attribute has a value of *YES for devices that may take a long time to vary on.

*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 address may be an IPv4 address (for any cluster version) or IPv6 address (if current cluster version is 7 or greater).

An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host portion of the address.

An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped). An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. The "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address. IP addresses created by IPv6 stateless address auto-configuration are not valid to be used as server takeover IP addresses.

If the IP address is entered from the command line, the address must be enclosed in apostrophes.

The specified address must exist on all nodes in the recovery domain if the cluster resource group is active. If not specified, or for configuration objects other than a primary 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.

Error messages

*ESCAPE Messages

HAE0020
Request to change device entries in cluster resource group &1 failed.