ENDCRG (End Cluster Resource Group)

ENDCRG Command syntax diagram

 

Purpose

The End Cluster Resource Group (ENDCRG) command disables resiliency of the specified cluster resource group. The cluster resource group status is set to Inactive. The resources associated with the cluster resource group are no longer resilient. That is, there is no failover or switchover action provided for these resources while the cluster resource group is ended.

Ending a device cluster resource group will not change the ownership of devices. The devices remain on whatever nodes owns them at the time the command is run. Also, the devices are not varied off when the cluster resource group is ended.

If an exit program is specified for the cluster resource group, it is called with an action code of End on each active node in the recovery domain. When the exit program is called, the cluster resource group status is set to End Cluster Resource Group Pending. Successful completion of the exit program sets the cluster resource group status to Inactive. In addition, for an application cluster resource group:

• the current application exit program job on the primary node will be cancelled with the *IMMED option
• the takeover IP interface for the cluster resource group will be ended.

If the exit program fails and the original state of the cluster resource group cannot be recovered, the cluster resource group status is set to Indoubt.

Restrictions

1. To use this command have *IOSYSCFG authority.
2. This command cannot be called from a cluster resource group exit program.
3. Cluster Resource Services must be started on the node processing the request.
4. The status of the cluster resource group being ended must be Active or Indoubt.

 

Required Parameters

CLUSTER

Specifies the name of the cluster containing the cluster resource group.

cluster-name: Specify the name of the cluster.

CRG

Specifies the name of the cluster resource group which will be ended.

cluster-resource-group-name: Specify the name of the cluster resource group to end.

 

Optional Parameters

EXITPGMDTA

Specifies up to 256 bytes of data that is passed to the cluster resource group exit program when it is called. This parameter may contain any scalar data except pointers. For example, it can be used to provide state information. This data will be stored with the specified cluster resource group and copied to all nodes in the recovery domain. Pointers in this area will not resolve correctly on all nodes and should not be placed in the data. The data specified will replace the existing exit program data stored with the cluster resource group. This parameter must be set to *SAME if no exit program is specified for the cluster resource group.

*SAME: The exit program data stored with the cluster resource group specified will be passed to the exit program.

exit-program-data: Specify the data that is to be passed to the exit program.

Example for ENDCRG

ENDCRG CLUSTER(MYCLUSTER) CRG(MYCRG) EXITPGMDTA('important information') 

This command ends resiliency of the cluster resource group called MYCRG in the cluster called MYCLUSTER. When the cluster resource group exit program is called, it will be passed the exit program data 'important information' on all active nodes in the recovery domain.

Error messages for ENDCRG

*ESCAPE Messages

CPF0001

Error found on &1 command.