Add HA Policy (ADDHAPCY)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Add High Availability (HA) Policy (ADDHAPCY) command adds a policy to an HA environment. Policies control specific behaviors related to clustering and HA environments. Policy information is distributed to all nodes in a cluster.
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 domain with the name specified in the Policy Domain (PCYDMN) parameter must exist.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| PCY | Policy name | Name | Required, Positional 1 |
| PCYDMN | Policy domain | Name, *NONE | Required, Positional 2 |
| QUAL | Policy qualifier | Character value, *NONE | Required, Positional 3 |
| VALUE | Policy value | Character value, *BLANK |
Optional |
| CLUSTER |
Cluster | Name, * | Optional |
| 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.
- *NONE
- Specify that the policy does not pertain to a specific domain. This value is valid only for policies that do not reference a particular domain.
- 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/.
- *BLANK
- 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 |
Cluster (CLUSTER)
Specifies the name of the cluster.
- *
- The cluster that has been configured on this system is used.
- name
- Specify the name of the cluster for the policy.
| Top |
Examples for ADDHAPCY
Example 1: Adding an High Availability (HA) policy for automatically adding monitored resources of type user profile to the admin domain when they are created
ADDHAPCY CLUSTER(*) PCY(QCST_AD_CREATE) PCYDMN(AD1)
QUAL('RSCTYPE(*USRPRF)') VALUE(*NONE)
This command adds an HA policy for the cluster containing the current node. The policy configures the behavior of PowerHA to add monitored resource entries automatically for user profiles to the admin domain AD1 when the user profiles are created on the system.
Note: This applies to resources created after the policy is defined. Existing user profiles are not added to the admin domain at the time when this policy is added.
| Top |
| Top |