The QCST_AD_CREATE policy specifies which resources will be automatically added to the specified cluster administrative domain when the resource is created. Normally, resources must be manually added to the cluster administrative domain after they are created. If a QCST_AD_CREATE policy is specified for a resource type and a resource of that type is created, a monitored resource entry (MRE) will be automatically added for the resource. This MRE will monitor all of the attributes for the resource.
Adding a PowerHA policy for administrative domain resources
Each PowerHA administrative domain policy is defined by the cluster administrative domain name specified in the domain name field and the resource type specified in the RSCTYPE keyword in the policy qualifier field. The name of any defined cluster administrative domain resource type may be specified. In addition the special value *ALL
can be specified for the resource type, indicating all resource types supported by that policy.
When adding a PowerHA policy for the cluster administrative domain you need:
The name of the administrative domain the policy will apply to.
The names of the resource type or types that the policy will create resource entries for.
Note: Depending on the resource type, a list of libraries may be required for the policy.
The PowerHA administrative domain resource policies qualifiers and values
PowerHA policies for administrative domain resources contain policy qualifiers designated as resource types (RSCTYPE). Supported resource types and the associated policy values are listed in the table below:
Policy Qualifier | Policy Value |
---|---|
RSCTYPE(*ALL) | LIB(*ALL) LIB(NAME1 NAME2 …) |
RSCTYPE(*ASPDEV) | *BLANK |
RSCTYPE(*AUTL) | *BLANK |
RSCTYPE(*CLS) | LIB(*ALL) LIB(NAME1 NAME2 …) |
RSCTYPE(*ETHLIN) | *BLANK |
RSCTYPE(*JOBD) | LIB(*ALL) LIB(NAME1 NAME2 …) |
RSCTYPE(*OPTDEV) | *BLANK |
RSCTYPE(*PRTDEV) | *BLANK |
RSCTYPE(*SBSD) | LIB(*ALL) LIB(NAME1 NAME2 …) |
RSCTYPE(*TAPDEV) | *BLANK |
RSCTYPE(*USRPRF) | *BLANK |
Policy value definitions
LIB(*ALL) indicates that the resource type can be created in any library. *BLANK indicating that the resource type does not require any library. LIB(NAME1 NAME2...) using only resources contained in the specified libraries.
Important:
If LIB(*ALL) is specified with the RSCTYPE(*ALL) policy qualifier, the policy will cover all resource types, whether or not the resource type requires a library.
Objects restored to the system are not covered under the QCST_AD_CREATE PowerHA policy.
Examples
Example 1 - Default Policies Created by PowerHA
PowerHA now automatically creates default policies when CFGPCY(*YES)
is specified on the Create Cluster Admin Domain (CRTCAD) command. The following lists the example commands to add the same policies in an administrative domain, ADMDMN:
ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*ASPDEV)') VALUE(*BLANK) ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*AUTL)') VALUE(*BLANK) ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*CLS)') VALUE('LIB(*ALL)') ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*JOBD)') VALUE('LIB(*ALL)') ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*SBSD)') VALUE('LIB(*ALL)') ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*USRPRF)') VALUE(*BLANK)
These policies specify to automatically add resources of *ASPDEV, *AUTL, *CLS, *JOBD, *SBSD, and *USRPRF to the administrative domain when they are created on any node in the administrative domain. If the cluster is inactive or partitioned at the time of the creation of the resource, the resource is added when clustering is started or the partition condition is resolved.
Tip: The CFGPCY(*YES) parameter on CRTCAD also adds policies of type QCST_AD_DELETE, and QCST_AD_RESTORE.
Example 2 - Changing an existing policy to specify a list of Libraries
Previously, a policy was added for Job Descriptions (*JOBD) using the following command:
ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*JOBD)') VALUE('LIB(*ALL)')
This policy indicated that any job description created in any library is automatically added in the administrative domain. It is now desired to limit the scope of this policy to only resources created in libraries APP1 and DEVLIB. The policy can be changed with the following command:
CHGHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*JOBD)') VALUE('LIB(APP1 DEVLIB)')
Example 3 - Changing the resource type for an existing policy
The resource type for an existing policy cannot be changed. Instead, the policy must be removed and a new policy added. For example, if a policy was added for *ALL resource types and the desire is to change the policy so that it is only for user profiles, the following commands would be required for administrative domain ADMDMN.
Existing Policy:
ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*ALL)') VALUE('LIB(*ALL)')
Changing Policy:
RMVHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*ALL)') ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMDMN) QUAL('RSCTYPE(*USRPRF)') VALUE(*BLANK)
The above commands remove the existing policy for all resource types and add a new policy specific to user profiles.