CL Command Reference - CHGCLURCY
CL Command List > CHGCLURCY Reference
Description:
The Change Cluster Recovery (CHGCLURCY) command is used for problem recovery. Use this command only when directed by service provider. It directs a node in a cluster resource group to perform a specific recovery action. The recovery action can cancel the current protocol, force a recovery of the cluster resource group object associated with the cluster resource group, force a rejoin with the cluster resource group, end the job that is associated with the cluster resource group, cause a CRG job to be submitted on the node where the CHGCLURCY command was executed. The CRG job being submitted must not be currently running.
The actions are intended to be used when a cluster resource group is experiencing a problem, and you need to force some recovery action onto the group. The problem may not be due to Cluster Resource Services. For example, Cluster Resource Services submits a job to invoke user exit programs. If the job is held, then it appears to a user that the cluster resource group is hung. A user may not know what exit program job was submitted, and so cannot perform any recovery outside of the cluster. Performing the appropriate recovery action with CHGCLURCY can satisfy Cluster Resource Services so it can fail the protocol that invoked the exit program job and continue.
Restrictions:
1. To use this command you must have job control (*JOBCTL) special authority, and either service (*SERVICE) special authority or be authorized to the Service Trace function of the operating system through iSeries Navigator¡¯s Application Administration support. You must also have change (*CHANGE) authority to any cluster resource group object that is to be acted upon with this command.
2. The cluster must be at version 3 or greater for this command to work remotely (work on any node other than the node issuing the command).
3. Cluster Resource Services must either be active or in the process of starting on the node that this command is issued from.
4. Only nodes that have a job for the desired cluster resource group may particpate in this command.
5. To determine if this command succeeded, check the job logs of the affected cluster jobs for a CPDBB06 message indicating the recovery action performed.
Warning: Use caution with this command, recovery actions cannot be undone or canceled.
Examples:
Example 1: Recovery Action for One Node in One Cluster Resource Group
CHGCLURCY CLUSTER(EXAMPLE) CRG(CRG1) NODE(NODE1)
ACTION(*CANCEL)
This command cancels the current protocol in cluster resource group CRG1 on node NODE1 in cluster EXAMPLE.
Example 2: Recovery Action for a Reserved Cluster Resource Group
CHGCLURCY CLUSTER(EXAMPLE) CRG(QCSTCRGM)
NODE(NODE1) ACTION(*RESTART)
This command causes node NODE1 of cluster resource group QCSTCRGM in cluster EXAMPLE to end clustering on NODE1. Clustering on NODE1 will attempt to automatically restart itself as though NODE1 was started with the Start Cluster Node (STRCLUNOD) command.
Example 3: Recovery Action for All Nodes
CHGCLURCY CLUSTER(EXAMPLE) CRG(CRG1)
NODE(*ALL) ACTION(*END)
This command causes all cluster jobs on all nodes associated with cluster resource group CRG1 in cluster EXAMPLE to end. No further operations on CRG1 can be performed on a given node until that node has clustering ended, and then started. The End Cluster Node (ENDCLUNOD) and STRCLUNOD commands may be used for ending and starting a cluster node.
Example 4: Recovery Action for All Groups
CHGCLURCY CLUSTER(EXAMPLE) CRG(*ALL)
NODE(NODE1) ACTION(*END)
This command causes all cluster jobs on node NODE1 in cluster EXAMPLE to end. This has the effect of ending clustering on NODE1. To start the cluster jobs on NODE1 requires NODE1 to have clustering started on it. The STRCLUNOD command may be used for starting a cluster node.
Example 5: Start CRG1 Job on Node NODE1
CHGCLURCY CLUSTER(EXAMPLE) CRG(CRG1)
NODE(NODE1) ACTION(*STRCRGJOB)
This command will cause cluster resource group job, CRG1, on node NODE1 to be submitted. To start the cluster resource group job on NODE1 requires NODE1 to have clustering started on it. The STRCLUNOD command may be used for starting a cluster node.