Managing a policy

To manage a policy, you can use the Policy page. To define, view, or modify a policy, use the New, View, or Modify actions provided in the Policies page.

A provisioning policy contains a set of provisioning rules and provisioning scopes which define provisioning limits for different types of capacity. The provisioning rules define the time periods in which additional capacity can be provisioned and the work which can trigger the provisioning of this capacity. The provisioning scopes restrict the capacity that can be provisioned by the rules in the policy:

The maximum processor scope restricts the temporary processor resources which can be activated for CPCs.
The logical processor scope defines the z/OS® systems on which Capacity Provisioning monitors the number of logical processors.
The maximum defined capacity scope restricts the increase of the Defined Capacity of z/OS systems.
The maximum group capacity scope restricts the capacity increase for capacity groups.

In the Policy page you define the details of a policy. A policy is identified by the name in the Policy name field and is described in more detail by the text in the Description field.

A complete policy must contain at least one processor limit in the maximum processor scope, or one capacity limit in the maximum defined capacity scope or one in the maximum group capacity scope, and at least one rule. Optionally, you can define the logical processor scope.

Table 1. Policy entry fields
Field	Description
Policy name	Policies are identified by name. Policy names must be unique.
Description	Description of the policy for your reference.

Refer to Naming Conventions in order to find out which values are allowed for Policy name and Description.

Maximum Processor Scope tab

A policy contains a maximum processor scope element which defines the total amount of temporary processor resources that can be activated for CPCs by all the rules contained in the policy.

Only resources that are activated through a Capacity Provisioning policy are considered in this limit. Resources that are activated manually, by using either Provisioning Manager commands or the interfaces available on the HMC, are not managed by the Provisioning Manager.

For each CPC in the table, the following resources are bound:

The general purpose capacity in MSU.
The number of Application Assist Processors (zAAPs).
The number of Integrated Information Processors (zIIPs).

Note: At least one processor limit in the maximum processor scope or one capacity limit in the maximum defined capacity scope or in the maximum group capacity scope must be specified.

To manage the maximum processor scope of a policy, you can use the Maximum Processor Scope tab. To define, view, or modify a processor limit, use the New, View, or Modify actions or in the table click on a CPC for which the processor limit is defined to follow the link. When clicked, the Maximum Processor Limit page is opened for the CPC and processor limit details are displayed. See help topic Managing the maximum processor scope.

Table 2. Columns in the Maximum Processor Scope table
Columns	Description
CPC	Name of the CPC. This name is the logical name by which it is identified at the support element (SE) of that processor complex.
Max. Activation (MSU)	Maximum amount of MSU to be activated.
Max. zAAP Processors	Maximum number of zAAP processors to be activated.
Max. zIIP Processors	Maximum number of zIIP processors to be activated.
Primary Activation (MSU)	Minimum amount of MSU to be activated with the first activation.
Secondary Activations (MSU)	Minimum amount of MSU to be activated with the second and all following activations.

Logical Processor Scope tab

A policy contains a logical processor scope element, which defines the z/OS systems where the number of logical processors is monitored. For each system you can either specify a maximum number of processors or specify that the limit of the LPAR definition applies. Specifying a logical processor limit is optional. If a limit is defined for a system the Provisioning Manager monitors the number of logical processors for this system and informs you when changes are required. When a limit is reached the Provisioning Manager stops to recommend on additional logical processors.

To manage the logical processor scope of a policy, you can use the Logical Processor Scope tab. To define, view, or modify a processor limit, use the New, View, or Modify actions or in the table click on the system for which the processor limit is defined to follow the link. When clicked, the Logical Processor Limit page is opened for the system and processor limit details are displayed. See help topic Managing the logical processor scope.

Table 3. Columns in the Logical Processor Scope table
Columns	Description
System	Name of the z/OS system for which recommendations to change the number of logical processors are issued.
Sysplex	Name of the sysplex to which this z/OS system belongs.
Max. CP Processors	Maximum number of logical general purpose processors.
Max. zAAP Processors	Maximum number of logical zAAP processors.
Max. zIIP Processors	Maximum number of logical zIIP processors
Action	System where to send a message to when a need for more or less processors is detected. Possible values: Message on runtime system. Message on managed system.

Maximum Defined Capacity Scope tab

A policy contains a maximum defined capacity scope element which restricts the increase of the Defined Capacity of z/OS systems. For each system in the table, it defines the maximum amount of MSU by which the Defined Capacity for the z/OS system can be increased by all the contained rules.

Only increases of Defined Capacity that are performed through a Capacity Provisioning policy are considered in this limit. Increases that are performed manually, by using either Provisioning Manager commands or the interfaces available on the HMC, are not managed by the Provisioning Manager.

Note: At least one processor limit in the maximum processor scope or one capacity limit in the maximum defined capacity scope or in the maximum group capacity scope must be specified.

To manage the maximum defined capacity scope of a policy, you can use the Maximum Defined Capacity Scope tab. To define, view, or modify a capacity limit, use the New, View, or Modify actions or in the table click on the system for which the capacity limit is defined to follow the link. When clicked, the Maximum Defined Capacity Limit page is opened for the system and capacity limit details are displayed. See help topic Managing the maximum defined capacity scope.

Table 4. Columns in the Maximum Defined Capacity Scope table
Columns	Description
System	Name of the z/OS system.
Sysplex	Name of the sysplex to which this z/OS system belongs.
Max. Increase (MSU)	Maximum amount of MSU by which the Defined Capacity of the system can be increased.
Primary Increment (MSU)	Minimum amount of MSU by which the Defined Capacity of the system can be increased with the first increment.
Secondary Increments (MSU)	Minimum amount of MSU by which the Defined Capacity of the system can be increased on the second increment and all subsequent increments.

Maximum Group Capacity Scope tab

A policy contains a maximum group capacity scope element which restricts the capacity increase for capacity groups. For each capacity group in the table, it defines the maximum amount of MSU by which the Group Capacity can be increased by all the rules in the policy.

Only increases of the Group Capacity that are performed through a Capacity Provisioning policy are considered in this limit. Increases that are performed manually, by using either Provisioning Manager commands or the interfaces available on the HMC, are not managed by the Provisioning Manager.

Note: At least one processor limit in the maximum processor scope or one capacity limit in the maximum defined capacity scope or in the maximum group capacity scope must be specified.

To manage the maximum group capacity scope of a policy, you can use the Maximum Group Capacity Scope tab. To define, view, or modify a capacity limit, use the New, View, or Modify actions or in the table or click on the group for which the capacity limit is defined to follow the link. When clicked, the Maximum Group Capacity Limit page is opened for the capacity group and capacity limit details are displayed. See help topic Managing the maximum group capacity scope.

Table 5. Columns in the Maximum Processor Scope table
Columns	Description
Group	Name of the capacity group
CPC	Name of the processor complex on which the capacity group is defined. This name is the logical name by which it is identified at the support element (SE) of that processor complex.
Max. Increase (MSU)	Maximum amount of MSU by which the Group Capacity can be increased.
Primary Increment (MSU)	Minimum amount of MSU by which the Group Capacity can be increased with the first increment.
Secondary Increments (MSU)	Minimum amount of MSU by which the Group Capacity can be increased on the second increment and all subsequent increments.

Actions for processor limits and capacity limits

The actions are described in the following tables:

Targeted actions: Actions that apply to the selected limits. To use a targeted action, you must select one or more limits. If you select more than one limit, only the actions which can be applied to several limits are enabled.
General actions: Actions that apply to limits. No selection is required.
Table actions: Actions that apply to the entire table such as sorting and filtering. No selection is required. For detailed information see Table actions.

A limited set of actions is available until you create the first limit.

Table 6. Targeted actions
Action	Description
View	View the selected limit. The selected limit is opened and details are displayed.
Modify	Modify the selected limit. The selected limit is opened and details can be modified.
Delete	Delete the selected limits.
Copy	Copy the selected limits. The selected limits are copied into the clipboard.

Table 7. General actions
Action	Description
New	Define a new limit. A new limit is opened and details can be specified.
Paste	Paste the copied limits. The limits are pasted from the clipboard.

Rules tab

A policy contains one or more provisioning rules for the provisioning of additional capacity.

To manage the rules of a policy, you can use the Rules tab. To define, view, or modify a rule, use the New, View, or Modify actions or click on the rule in the table to follow the link. When clicked, the Rule page is opened and rule details are displayed. See help topic Managing rules.

Table 8. Columns in the rules table
Columns	Description
Name	Name of the rule.
Description	Description of the rule.
Default status	Indicates if the rule is enabled or disabled by default, when the policy is activated.

Actions for rules

The actions are described in the following tables:

Targeted actions: Actions that apply to the selected rule. To use a targeted action, you must select one or more rules. If you select more than one rule, only the actions which can be applied to several rules are enabled.
General actions: Actions that apply to rules. No selection is required.
Table actions: Actions that apply to the entire table such as sorting and filtering. No selection is required. For detailed information see Table actions.

A limited set of actions is available until you create the first rule.

Table 9. Targeted actions
Action	Description
View	View the selected rule. The selected rule is opened and details are displayed.
Modify	Modify the selected rule. The selected rule is opened and details can be modified.
Delete	Delete the selected rules.
Copy	Copy the selected rules. The selected rules are copied into the clipboard.

Table 10. General actions
Action	Description
New	Define a new rule. A new rule is opened and details can be specified.
Paste	Paste the copied rules. The rules are pasted from the clipboard. New unique names are generated for the pasted rules.

Switch to a different element of the same policy

To switch to a different element of the same policy, you do not have to navigate to it step by step. Instead, you can take the fast path by clicking the Switch to button on the right page border and select a policy element from the displayed policy outline. You may switch to the following element types:

Policy
Rule
Condition
Workload Condition

Procedures to manage a policy

Create a new policy

Select the Capacity Provisioning task under the Performance category in the navigation area. The Capacity Provisioning page is displayed.
In the Overview tab, click the Policies link. The Policies page is displayed.
From the Actions menu, select New. The Policy page containing the new policy is displayed.
Specify a name and description, define the provisioning scopes and add Rules.
Click OK to save the policy. The newly created policy is displayed in the table on the Policies page.

Modify an existing policy

Select the Capacity Provisioning task under the Performance category in the navigation area. The Capacity Provisioning page is displayed.
In the Overview tab, click the Policies link. The Policies page is displayed.
Select the policy you want to modify
From the Actions menu, select Modify. The Policy page containing the selected policy is displayed.
Modify the name and the description and change the provisioning scopes and Rules.
Click OK to save the policy. The modified policy is displayed in the table on the Policies page.

View an existing policy

Select the Capacity Provisioning task under the Performance category in the navigation area. The Capacity Provisioning page is displayed
In the Overview tab, click the Policies link. The Policies page is displayed
Select the policy you want to be viewed.
From the Actions menu, select View. The Policy page containing the selected policy is displayed.