Change HA Policy (CHGHAPCY)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Change High Availability (HA) Policy (CHGHAPCY) command is used to change an existing HA policy in an HA environment. Policies control specific behaviors related to clustering and high availability environments. Policy information is distributed to all nodes in a cluster.
To change the domain or qualifier for a policy, use the Remove HA Policy (RMVHAPCY) command, followed by the Add HA Policy (ADDHAPCY) command specifying the new policy domain and policy qualifier.
Restrictions:
- You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
- The cluster must not be in a partitioned state.
- The node must have a status of Active in the cluster.
- The policy with the specified policy name (PCY), policy domain (PCYDMN) and policy qualifier (QUAL) must exist.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CLUSTER | Cluster | Name, * | Required, Positional 1 |
| PCY | Policy name | Name | Required, Positional 2 |
| PCYDMN | Policy domain | Name | Required, Positional 3 |
| QUAL | Policy qualifier | Character value, *NONE | Required, Positional 4 |
| VALUE | Policy value | Character value, *SAME, *NONE | Optional |
| Top |
Cluster (CLUSTER)
Specifies the name of the cluster.
This is a required parameter.
- *
- The cluster that has been configured on this system is used.
- name
- Specify the name of the cluster for the policy.
| Top |
Policy name (PCY)
Specifies the name of the policy. Additional information on policies may be found in the PowerHA documentation: http://www.ibm.com/developerworks/ibmi/ha/.
This is a required parameter.
- name
- Specify the name of the policy.
| Top |
Policy domain (PCYDMN)
Specifies the name of the domain to which the policy applies. For example, if the policy is for an administrative domain, the policy domain would specify an administrative domain name.
- name
- Specify the name of the domain that the policy pertains to.
| Top |
Policy qualifier (QUAL)
Specifies additional information about the policy to distinguish the instance of the policy from similar policy. The possible values in this field are different for each policy, but the format of the information in many policies is very similar to the CL command line parameter format. Additional information on policy qualifiers may be found in the PowerHA documentation: http://www.ibm.com/developerworks/ibmi/ha/.
This is a required parameter.
- *NONE
- No qualifier is associated with this policy. This is only applicable to certain policies.
- character value
- Specify the policy qualifier in the format required for the policy.
| Top |
Policy value (VALUE)
Specifies the policy value. The possible values in this field are different for each policy. Additional information on policy values may be found in the PowerHA documentation: http://www.ibm.com/developerworks/ibmi/ha/.
- *SAME
- The policy value is not changed.
- *NONE
- No value is associated with this policy. This is only applicable to certain policies.
- character value
- Specify the value of the policy. The value must be enclosed in apostrophes if it contains any non-alphanumeric character or blanks. If an apostrophe is intended, two apostrophes must be used ('').
| Top |
Examples for CHGHAPCY
Example 1: Changing an High Availability (HA) policy for automatically adding job descriptions to the admin domain when they are created
CHGHAPCY CLUSTER PCY(QCST_AD_CREATE) PCYDMN(AD1)
QUAL('RSCTYPE(*JOBD)') VALUE('LIB(*ALL)')
This command changes an HA policy for the cluster containing the current node. The policy configures the behavior of PowerHA to add monitored resource entries automatically for job descriptions in all libraries to the admin domain AD1 when the resources are created on the system.
| Top |
| Top |