Creating a basic policy
Use the following procedure to build a basic policy, accepting mostly default values.
If you are new to building policies, BMC recommends that you start by running iCap in observe or message mode and by using test LPARs or groups in the policy. This approach helps you understand how iCap works without affecting your high-importance workloads.
To create a policy
- On EZICAP, hyperlink on Policy Admin UI.
On the Policy Administration UI (POLICIES view), type NEW on the COMMAND line.
In the Create a Policy for iCap dialog box, enter values for the parameters that have no defaults, as follows:
Parameter
Action
Policy Name
Enter a unique name for the policy.
Description
Enter up to 32 characters to describe the policy.
Initial MSULIMIT
Enter one of the following values:
If you want iCap to execute a dynamic MSU limit, specify the initial MSU limit value.
For iCap to execute a dynamic MSU limit, you must also specify values for Max MSULIMIT, Inc MSULIMIT, and Adj MSULIMIT.For more information about using a dynamic MSU limit, see Overview of dynamic MSU limit (PTF BQY2177 applied).
- If you do not want iCap to execute a dynamic MSU limit, specify the maximum allowable MSUs to be consumed collectively by all LPARs and capacity groups that the policy or subpolicy manages.
Possible values are 1 through 99999.
Max MSULIMIT
If you want
iCap
to execute a dynamic MSU limit, enter the maximum allowable MSUs to be consumed collectively by all LPARs and capacity groups that the policy manages.Possible values are 1 through 99999.
Inc MSULIMIT
If you want iCap to execute a dynamic MSU limit, enter the number of MSUs by which the initial MSU limit increases every ADJTIME.
Adj MSULIMIT
If you want iCap to execute a dynamic MSU limit, enter the percentage of low-importance work in the policy at which iCap starts to increase the MSU limit.
For the other parameters, you can accept the default values; you can change them later, if needed. For detailed descriptions, see Policy-level-and-subpolicy-level-parameters.
Sample Create a Policy for iCap dialog box (PTFs BQY1973 and BQY2177 applied)
-------------------------- Create a Policy for iCap ---------------------------
| COMMAND ===> SCROLL ===> PAGE |
| |
| Policy Name TESTPOL Member name |
| Description TEST POLICY Description |
| Initial MSULIMIT 600 Range 1-99999 |
| Max MSULIMIT 1021 Range 1-99999 |
| Inc MSULIMIT 50 Range 1-999 |
| Adj MSULIMIT 95 Range 1-99 |
| WLM Tuning COMBINED Defaults to COMBINED |
| AdjFac Priority 1 0.6 Defaults to .6 |
| AdjFac Priority 2 0.8 Defaults to .8 |
| AdjFac Priority 3 1.0 Defaults to 1.0 |
| AdjFac Priority 4 1.2 Defaults to 1.2 |
| AdjFac Priority 5 1.4 Defaults to 1.4 |
| Low Importance 5 Defaults to 5 |
| Manage Cost NO Defaults to NO |
| Dynamic Entitlement YES Defaults to YES |
| Mobile Adjust NO Defaults to NO |
| Container Adjust NO Defaults to NO |
| |
| |
| END to exit saving changes |
| CANCEL to exit without saving changes |
| HELP to view related help |
| RESET to reset to initial data |
-------------------------------------------------------------------------------Press F3 to save the changes (or in MainView Explorer, click OK).
The POLDSPLY view shows details of the new policy. From POLDSPLY you can add, update, or delete the LPARs, subbpolices, and CPCIDs in a policy.Sample POLDSPLY view (PTFs BQY1973 and BQY2177 applied)
>W1 =POLDSPLY==========DYCM=====*========21AUG2019==05:45:08====ICAP=====D===19
CMD Type SubPolicy LPAR or CPCID Initial_ Maximum Inc Adj LPAR/ Group
--- ---- --------- Cap Group ----- MSULIMIT MSULIMIT MSUL MSU Type Name
POLICY 600 1021 50 95
LPAR/GRP SYSM FA817 LPAR DEFAUL
LPAR/GRP IMSA FA817 LPAR
LPAR/GRP ESAJ FA817 LPAR DEFAUL
CPCID FA817
CPCID DCE07
SUBPOLICY DYNSUB1 146 200 11 90
LPAR/GRP DYNSUB1 DB2A FA817 LPAR DB2GRO
LPAR/GRP DYNSUB1 SYSN FA817 LPAR DB2GRO
LPAR/GRP DYNSUB1 DB2B FA817 LPAR DB2GRO
SUBPOLICY DYNSUB2 125 150 7 87
LPAR/GRP DYNSUB2 SJSC FA817 LPAR SJTEST
LPAR/GRP DYNSUB2 SJSD FA817 LPAR SJTESTIf you are building a new policy from scratch, the POLDSPLY view will be empty, except for the CPCID. By default, iCap inserts the CPC on which the master PAS is running. If you want to manage LPARs and groups on multiple CPCs, you can add CPCIDs.
- On EZICAP, hyperlink on Policy Admin UI.
On the Policy Administration UI (POLICIES view), type NEW on the COMMAND line.
In the Create a Policy for iCap dialog box, enter values for the parameters that have no defaults, as follows:
Parameter
Action
Policy Name
Enter a unique name for the policy.
Description
Enter up to 32 characters to describe the policy.
MSU Limit
Enter the maximum allowable MSUs (any value from 1 through 99999) to be consumed collectively by all LPARs and capacity groups that the policy will manage.
If you are building a policy for the first time, you can set this value to the sum of combined 4HRAs for all of the managed LPARs.
For the other parameters, you can accept the default values; you can change them later, if needed. For detailed descriptions, see Policy-level-and-subpolicy-level-parameters.
Sample Create a Policy for iCap dialog box (PTF BQY1973 applied)
-------------------------- Create a Policy for iCap ---------------------------
| COMMAND ===> SCROLL ===> PAGE |
| |
| Policy Name TESTPOL Member name |
| Description TEST POLICY Description |
| MSU Limit 1000 Range 1-99999 |
| WLM Tuning COMBINED Defaults to COMBINED |
| AdjFac Priority 1 0.6 Defaults to .6 |
| AdjFac Priority 2 0.8 Defaults to .8 |
| AdjFac Priority 3 1.0 Defaults to 1.0 |
| AdjFac Priority 4 1.2 Defaults to 1.2 |
| AdjFac Priority 5 1.4 Defaults to 1.4 |
| Low Importance 5 Defaults to 5 |
| Manage Cost NO Defaults to NO |
| Dynamic Entitlement YES Defaults to YES |
| Mobile Adjust NO Defaults to NO |
| Container Adjust NO Defaults to NO |
| |
| |
| END to exit saving changes |
| CANCEL to exit without saving changes |
| HELP to view related help |
| RESET to reset to initial data |
-------------------------------------------------------------------------------Press F3 to save the changes (or in MainView Explorer, click OK).
The POLDSPLY view shows details of the new policy. From POLDSPLY you can add, update, or delete the LPARs, subbpolices, and CPCIDs in a policy.Sample POLDSPLY view (PTF BQY1973 applied)
>W1 =POLDSPLY==========EWILSJSD=*========09/06/2018=14:31:55====ICAP=====D====6===
CMD Type SubPolicy LPAR or CPCID MSULimit LPAR/ Group System LPAR LPAR
--- ---- --------- Cap Group ----- -------- Type Name Name Prty Prop
POLICY 1000
LPAR/GRP BMCA FA817 LPAR BMCA 3 100
LPAR/GRP SJSD FA817 LPAR SJTEST3 SJSD 3 50
LPAR/GRP SJTEST FA817 GROUP 3 100
LPAR/GRP SJSC FA817 LPAR SJTEST3 SJSC 3 23
CPCID FA817If you are building a new policy from scratch, the POLDSPLY view will be empty, except for the CPCID. By default, iCap inserts the CPC on which the master PAS is running. If you want to manage LPARs and groups on multiple CPCs, you can add CPCIDs.
Where to go from here
After you have built a basic policy, you can proceed as follows:
- Add CPCIDs, subpolicies, and LPARs or groups to the policy. For more information, see Adding-elements-to-a-policy.
- (If required) Update the parameters for CPCIDs, subpolicies, or LPARs and groups to the policy. For more information, see Updating-the-elements-in-a-policy.
- Validate the policy definition. For more information, see Validating-a-policy-definition.
- Activate the policy. For more information, see Activating-a-policy.
Related topic