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

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 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 to 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.

In this example, if you have an existing QCST_AD_CREATE policy that applies to *ALL resource types:

Policy Name	Policy Domain	Policy Qualifier	Policy Value

Policy Name	Policy Domain	Policy Qualifier	Policy Value
QCST_AD_CREATE	ADMDMN	RSCTYPE(*ALL)	LIB(*ALL)

If you want to change it to apply to only user profiles, you need to remove the existing policy and add the new policy:

The above commands add a new policy specific to user profiles and then remove the existing policy for all resource types.

IBM Partnership

QCST_AD_CREATE PowerHA Policy