CL Command Reference - CHGCRG
CL Command List > CHGCRG Reference
Description:
The Change Cluster Resource Group (CHGCRG) command changes some of the attributes of a cluster resource group. The cluster resource group object is changed on all active nodes in the recovery domain. Recovery domain nodes that are not active at the time of the change will have the change made when they become active again.
For primary-backup model cluster resource groups, changing the node role to primary or changing the takeover IP address can only be done when the cluster resource group status is Inactive or Indoubt. If the cluster resource group is active, the Change Cluster Resource Group Primary (CHGCRGPRI) command can be used to assign the primary role to the first backup node.
For peer model cluster resource groups:
. The recovery domain role can be changed from peer to replicate or replicate to peer by specifying one or more recovery domain nodes. The full recovery domain does not need to be specified.
. If the cluster resource group is Active (10) and:
¨C The role is changed from peer to replicate, the node becomes an inactive access point.
¨C The role is changed from replicate to peer, the node becomes an active access point.
. There must be at least one node designated as peer if the cluster resource group is Active (10).
The following fields may be changed without causing the cluster resource group exit program to be called:
. text description
. exit program data
. user profile v takeover IP address
. job name
. allow application restart
. number of restarts
. the cluster resource group exit program
. failover message queue
. failover wait time
. failover default action
. cluster resource group exit program format name
. application identifier
This command will do the following for all cluster resource group types:
. Call the cluster resource group exit program with an action code of Change on all active nodes in the recovery domain when either the preferred or current role is changed, if an exit program is specified for the cluster resource group. The cluster resource group status is set to Change 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.
. Change the cluster resource group without calling the exit program if neither node role, site name nor data port IP addresses are changed.
. Change the name to be used for batch jobs submitted by cluster resource group. If the cluster resource group status is Active, batch jobs already submitted will not be changed. Any jobs submitted after the change will use the new name. This is true for other attributes associated with a submitted exit program such as the user profile, the restart count and so on. Changes to the cluster resource group will not affect an exit program that was previously submitted and is either on a job queue or is running.
. For primary-backup model cluster resource groups, if the current node role in the recovery domain is changed and the cluster resource group is active and it has more than one backup node and some backup nodes are not active, the recovery domain may be reordered so that all active backup nodes are ordered before inactive backup nodes.
This command will do the following for application cluster resource groups:
. If the Cluster Resource Services configures the takeover IP address, it will remove the current address and add the new address when the takeover IP address is changed. If either the add or remove address function fails, the command will fail.
. If the cluster resource group is active and the role of a node is being changed from replicate to backup, verify the takeover IP address exists and is not active on the node being changed. If the takeover IP address does not exist or is active on the node being changed, the command will fail.
This command will do the following for device cluster resource groups:
. If the role of the current primary node is being changed, ownership of the devices specified in the cluster resource group is switched from the current primary to the new primary if the current primary has none of the devices varied on. If any devices are varied on, an error message is returned. In addition, the new primary node must be active. All members of an auxiliary storage pool group must be configured in the cluster resource group before ownership can be changed. Devices are not varied on after the ownership is switched.
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. Cluster Resource Services must be active on the node processing the request.
4. Primary-backup model cluster resource groups must have a status of Inactive or Indoubt to designate a new primary node.
5. If defined, the exit program must exist on all nodes in the recovery domain when the cluster resource group exit program is changed.
6. There must be at least one active node in the recovery domain.
7. If defined, the failover message queue must exist on all nodes in the recovery domain when the cluster resource group is changed.
Examples:
Example 1: Changing the Exit Program Data
CHGCRG CLUSTER(MYCLUSTER) CRG(MYCRG) CRGTYPE(*DATA)
EXITPGMDTA(¡¯replace this data¡¯)
TEXT(¡¯CRG FOR PAYROLL APPLICATION DATA¡¯)
This command changes a data cluster resource group called MYCRG in the cluster called MYCLUSTER. The exit program data is replaced with the character string specified. The text description for the cluster resource group object is also changed to the value specified. All other fields are unchanged.
Example 2: Changing the Recovery Domain
CHGCRG CLUSTER(MYCLUSTER) CRG(MYCRG) CRGTYPE(*DEV)
EXITPGMFMT(*SAME) TEXT(¡¯CRG FOR CROSS SITE MIRRORING¡¯)
RCYDMN((*SAME *SAME *LAST MYSITE *ADD (¡¯1.1.1.1¡¯)))
This command changes a device cluster resource group called MYCRG in the cluster called MYCLUSTER. The text description for the cluster resource group object is changed to the value specified. The recovery domain is added to the site MYSITE, with 1 data port IP address.