QCST_CRG_CANCEL_FAILOVER PowerHA policy

Automatically prevent a failover operation in a CRG

The QCST_CRG_CANCEL_FAILOVER policy can prevent automatic failovers from taking place.

Each QCST_CRG_CANCEL_FAILOVER policy is uniquely defined by the cluster resource group name specified in the domain name field, and the failover scope specified in the SCOPE keyword in the policy qualifier field. An EVENT value for the policy value field specifies which events that should not cause an automatic failover.

To add a QCST_CRG_CANCEL_FAILOVER policy to a cluster resource group (CRG) supply:

The name of the CRG.
The policy qualifier value for the SCOPE policy qualifier. These values are:

Scope	Description

Scope	Description
*SITE	Indicates that the policy will apply only to failovers where the new primary node is in the same site as the original primary node.
*CRSSITE	Indicates that the policy will apply only to failovers where the new primary node is in a different site than the current primary node.
*CRG	The policy applies to all failovers regardless of where the current and new primary nodes are located.

The policy value field requires a value for the Event. The Event contains a list of event types the QCST_CRG_CANCEL_FAILOVER should cancel. At least one value needs to be specified. Values for EVENT are:

Event	Description

Event	Description
*CLUFAIL	The failover was caused by one of the following cluster events: a CHGCLURCY(*END) ending the RGM or CCTL jobs. a critical job end a node in the cluster crashed.
*CRGFAIL	The failover was caused by one of the following cluster events: a CHGCLURCY(*END) ending jobs other than the RGM or CCTL jobs. a CRG job end a node in the cluster crashed.
*ENDCLUNOD	The failover was caused by the ENDCLUNOD command.
*ENDSYS	The failover was caused by an ENDSYS or an ENDSBS(*ALL) action on the primary cluster node.
*ENDTCP	The failover was caused by invoking the ENDTCP command on the primary cluster node.
*PWRDWNSYS	The failover was caused by the PWRDWNSYS command.
*ALL	All actions listed in the above values that cause failovers.

Example 1 - Disabling automatic failovers for specific events

For example, a QCST_CRG_CANCEL_FAILOVER policy set for a CRG named MYCRG created:

ADDHAPCY PCY(QCST_CRG_CANCEL_FAILOVER) PCYDMN(MYCRG) QUAL('SCOPE(*CRG)')
VALUE('EVENT(*ENDCLUNOD *ENDSYS *ENDTCP *PWRDWNSYS)')

Indicates that if an ENDCLUNOD, ENDSYS, ENDTCP, or PWRDWNSYS event occurs a failover will not be attempted for the CRG MYCRG.

Example 2 - Disabling all listed automatic failovers for a CRG

For example, a QCST_CRG_CANCEL_FAILOVER policy set for a CRG named MYCRG created:

ADDHAPCY PCY(QCST_CRG_CANCEL_FAILOVER) PCYDMN(MYCRG) QUAL('SCOPE(*CRG)')
VALUE('EVENT(*ALL)')

Indicates that if any of the listed failover events occurs a failover will not be attempted for the CRG MYCRG.

Example 3 - Disabling all cross site failovers for a CRG

For example, a QCST_CRG_CANCEL_FAILOVER policy set for a CRG named MYCRG created:

ADDHAPCY PCY(QCST_CRG_CANCEL_FAILOVER) PCYDMN(MYCRG) QUAL('SCOPE(*CRSSITE)')
VALUE('EVENT(*ALL)')

Indicates that if any of the listed failover events occurs and the first active backup node is a node in a different site, a failover will not be attempted for the CRG MYCRG.

This policy is useful to enable automatic failovers within a site (LUN-Level Switching), but disabling failovers that would cause a Metro Mirror or Global Mirror failover to occur.