Display HA Policy (DSPHAPCY)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Display High Availability (HA) Policy (DSPHAPCY) command displays policies previously created with the Add HA Policy (ADDHAPCY) command as well as policy definition information to assist with defining new policies. Policies control specific behaviors related to clustering and HA environments. Policy information is distributed to all nodes in a cluster.
Restrictions:
- The local node must be a member of the cluster specified in the cluster (CLUSTER) parameter.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CLUSTER | Cluster | Name, * | Optional |
| PCY | Policy name | Name, *ALL | Optional |
| PCYDMN | Policy domain | Name, *ALL | Optional |
| QUAL | Policy qualifier | Character value, *NONE, *ALL | Optional |
| DFN | Show policy definition | *NO, *YES | Optional |
| OUTPUT | Output | Optional |
| 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 |
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/.
- *ALL
- Specify policy information for all policies.
- 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.
- *ALL
- Specify policy information for all policy domains defined with the specified Policy Name (PCY).
- 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/.
- *ALL
- Specify policy information for all policy qualifies defined with the specified Policy Name (PCY) and Policy Domain (PCYDMN).
- *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 |
Show policy definition (DFN)
Specifies whether to show the rules for defining a new policy or to show existing defined policies.
- *NO
- Show existing policies previously defined with the given policy name (PCY), policy domain (PCYDMN), and policy qualifier (QUAL).
- *YES
- Shows policy definition information for rules on the qualifier and value for a given policy.
When *YES is specified, the Policy domain (PCYDMN) and Policy qualifier (QUAL) parameters are ignored.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output.
- *
- Output requested by an interactive job is shown on the display. If the command is run as part of a batch job, the output is printed with the job's spooled output.
- The output prints with the spooled output of the job.
| Top |
Examples for DSPHAPCY
Example 1: Displaying all previously defined policies
DSPHAPCY
This command shows all previously defined policies in the cluster containing the current node.
Example 2: Printing all previously defined policies
DSPHAPCY CLUSTER(*) PCY(*ALL) PCYDMN(*ALL) QUAL(*ALL)
OUTPUT(*PRINT)
This is similar to Example 1, but the command prints all previously defined policies to the job's spooled output.
Example 3: Displaying a specific previously defined policy
DSPHAPCY CLUSTER(*) PCY(QCST_AD_CREATE) PCYDMN(AD1)
QUAL('RSCTYPE(*ALL)')
This command shows a previously defined QCST_AD_CREATE policy for the administrative domain AD1 for a resource type of *ALL.
Example 4: Displaying policy definition information for the a policy
DSPHAPCY PCY(QCST_AD_CREATE) DFN(*YES)
This command shows the policy definition information for the QCST_AD_CREATE policy. It gives the syntax of the qualifier (QUAL) and value (VALUE) parameters that can be used on the Add HA Policy (ADDHAPCY) and Change HA Policy (CHGHAPCY) commands.
| Top |
| Top |