Displaying an overview of the active policy


Use the following procedure to display an overview of the active policy in the POLOVER view. You can access the POLOVER view to assess how the active policy is managing the specified LPARs and capacity groups. From the POLOVER view, you can also access the SUBPOLO view, which shows details about the subpolicies in your active policy.

If iCap is managing an active policy, this view displays only the LPARs and groups in the policy. If there is no active policy, this view displays all LPARs and groups on all discovered CPCs.

On this view, you can also see:

  • 4HRA
  • DCs of LPARs and GCLs
  • Percentage of MSU limit that each LPAR and capacity group is using, and the total usage for the entire policy
  • Whether the policy is using dynamic entitlement
  • Specified cost limit
  • Percentage of cost limit used by each LPAR and group, and the total usage for the policy
  • Maximum and monthly MSU limits if iCap is executing a dynamic MSU limit 
  • Specified adjusted MSU limit percentage and increment if iCap is executing a dynamic MSU limit
  • Subsystems that are running on an LPAR or group
  • Percentage of elapsed time during the current sample period that the LPAR or group was capped
  • CPC identification number for each LPAR
  • Status of the 4HRA of an LPAR or group compared to the assigned DC or GCL
  • (PTF BQY2794 applied) Minimum amount of MSUs assigned to the managed LPARs
  • (PTF BQY2794 applied) Whether an LPAR is unmanaged
  • (PTF BQY2860 applied) MLC savings for the current and previous month
  • (BMC.AMIOPS.SPE2210) Absolute capping value

To display an overview of the active policy

  1. Use one of the following methods:

    • On EZICAP, hyperlink on Policy Overview.
    • Type POLOVER on the COMMAND line.

    The POLOVER view is displayed:

    (BMC.AMIOPS.SPE2301)

    >W1 =POLOVER===========RQPLSJSD=*========01DEC2022==05:40=25S===ICAP=====D===13
    -                                                                              
       Policy Name........ DYNAML                Sum of Cost Entitlement N/A        
       MSULIMIT........... 1133                  WLM Tuning............. COMBINED   
       Mode............... Msg                   Dynamic Entitlement.... YES        
       Peak 4HRA.......... 1165                  Manage Cost............ NO         
       Peak Time.......... 01DEC2022 02:28:15    Combined 4HRA.......... 1019       
       Activated.......... 29NOV2022 08:45:30    Combined 4HRA%......... 94         
       Maximum MSULIMIT... 1300                  Increment MSULIMIT..... 26         
       AdjMSULIMIT%....... 15(2)                 Minimum MSUs........... N/A        
       Current MLC Savings 0                     Prior MLC Savings...... 0          
                                                                                   
      Name     T CPCID Prio Cap%  4HRA   Low-Imp   Adj Low 4HRA DefCap Min(4HRA, % M
                       rity       %DCGCL   Wkld% Imp Wkld%      or GCL   DC|GCL) Lim
      ADDM     L 334D8    3                                          0              
      DB2A     I 7A498    3         81.0      43        43  110    135       110   9
      DB2B     I 7A498    3         69.0      33        33   65     94        65   5
      ESAJ     I 7A498    4         85.0      40        48  115    135       115  10
      IMSA     L 7A498    2         93.0      59        47  124    133       124  10
      SJSC     I 7A498    2         96.0      90        72  197    204       197  17

    For more information, see Field descriptions for the POLOVER view.

    Tip

    You can scroll right to view the following items:

    • Data for LPAR container designation
    • The following fields that show the contribution of mobile and container MSUs and the corresponding MSU adjustment:
      • containerMSUs field
      • mobileMSUs field
      • adjustMSUs field
  2. (Optional if the policy contains any subpolicies) Hyperlink on a subpolicy name.

    Tip

    Subpolicies are identified by P in the Type field.

    The SUBPOLO view is displayed.

  3. (Optional) Hyperlink on the CPCID.
    A filtered CPCLPARS view is displayed, showing details about the LPARs and groups that are running on the CPC.

Field descriptions for the POLOVER view

The following table describes the fields on the POLOVER view:

Field name

Description

Policy Name

Name of the active policy

MSULIMIT

This value has one of the following meanings:

  • If iCap is executing a dynamic MSU limit, this is the initial starting MSU limit. For more information about using a dynamic MSU limit, see Overview-of-MSU-limit-CPCMSU-limit-and-cost-limit.
  • If iCap is not executing a dynamic MSU limit, this value is the maximum MSU limit for the active policy.

Mode

Mode in which iCap is running

Peak 4HRA

Peak 4HRA for the active policy

Peak Time

Date and time that the peak 4HRA occurred

Activated

Date and time that the policy was activated

Maximum MSULIMIT

If iCap is executing a dynamic MSU limit, this is the maximum number of allowable MSUs to be consumed collectively by all LPARs and capacity groups that the policy or subpolicy manages.

For more information about using a dynamic MSU limit, see Overview-of-MSU-limit-CPCMSU-limit-and-cost-limit .

AdjMSULIMIT%

If iCap is executing a dynamic MSU limit, this is the percentage of low importance work in the policy (or subpolicy) at which iCap starts to increase the MSU limit.

For more information about using a dynamic MSU limit, see Overview-of-MSU-limit-CPCMSU-limit-and-cost-limit .

Designates the LPARs whose low-importance work is considered when calculating the low-importance workload percentage to determine if iCap needs to increase MSU limit.

For more information, see Scope.

Important

For POLOVER, POLACTV, and POLDEF views, the new Scope parameter is shown within parentheses after the AdjMSULIMIT% parameter.

(PTF BQY2860 applied)

Current MLC Savings

Number of MSUs saved over the current month

This field displays the number of MSUs that iCap has saved during the current month by capping LPARs that would otherwise have exceeded their DCs, and therefore cause the LPARs in the policy to exceed the MSU limit. This number can change due fluctuations in MSU usage over the month.

Sum of Cost Entitlement

Cost limit for the policy

WLM Tuning

Whether WLM Tuning is being used

Dynamic Entitlement

Whether dynamic entitlement is being used

Manage Cost

Whether iCap is considering the cost limit when distributing MSUs

Combined 4HRA

Combined 4HRA for all of the managed LPARs and groups

Combined 4HRA%

Percentage of MSU limit used by the combined 4HRA for the policy

Increment MSULIMIT

If iCap is executing a dynamic MSU limit, this is the number of MSUs by which the MSU limit incrementally increases (every ADJTIME) if the policy is unable to run low importance workloads.

For more information about using a dynamic MSU limit, see Overview-of-MSU-limit-CPCMSU-limit-and-cost-limit .

Minimum MSUs

Minimum number of MSUs that the managed LPARs can use

For more information, see Policy-level-and-subpolicy-level-parameters.

(PTF BQY2860 applied)

Prior MLC Savings

Number of MSUs saved in the previous month

This field displays the number of MSUs that iCap saved in the previous month by capping LPARs that would otherwise have exceeded their DCs, and therefore cause the LPARs in the policy to exceed the MSU limit.

Name

Name of the managed LPAR, group, or subpolicy

You can hyperlink on a subpolicy name to see details about the subpolicy on the SUBPOLO view.

The *Policy row is the totals row for the policy or subpolicy. The fields on this row show the average or the sum for all of the LPARs, groups, and subpolicies in the active policy (type M records are excluded).

T

Type

Possible values are:

  • P — subpolicy
  • G — group
  • L — LPAR
  • U — unmanaged LPAR
  • I — group member (also known as individual LPAR)
  • A — available MSUs (MSUs that aren't being used by the policy or subpolicy)
  • R — reserved MSUs (MSUs that are reserved for LPARs or groups that might be down)
  • T — entire policy

Individual LPARs are members of capacity groups and are being individually managed by iCap. That is, iCap manages the LPARs individually instead of as a group. The Group Name field shows the group to which the LPAR belongs.

CPCID

The last five digits of the serial number of the CPC on which the LPAR is running

You can hyperlink on a CPCID to see details about the CPC on the MULTIPLEX view. For more information, see Displaying-CPC-consumption-statistics-for-the-active-policy.

Priority

Specified priority for an LPAR or group

Cap%

During the recent sample, the percentage of elapsed time that the LPAR or group was capped

For LPARs with active agents, this value represents capping over the previous 1-minute sample. (BMC.AMIOPS.SPE2201) For LPARs at sample time, this value represents 100% capping.

4HRA%DCGCL

Percentage of the 4HRA that is being used by the LPAR or group compared to the assigned DC or GCL

An alarm on this field alerts you when the 4HRA exceeds the assigned DC or GCL. Colored thresholds on this field indicate the status of the 4HRA of an LPAR or group compared to the assigned DC or GCL.

Low-Imp Wkld%

Percentage of low importance work running on an LPAR or group

Alarms alert you when the value in this field reaches 5% and 0%.

(BMC.AMIOPS.SPE2110) In MainView Explorer, a hyperlink on this field links to the SUs by Importance chart for the selected LPAR or group. For more information, see iCap-charts-in-MainView-Explorer.

Adj Low Imp Wkld%

Adjusted Low-Importance Workload Percentage

If WLM Tuning is specified as YES or COMBINED, iCap considers the Adjusted Low-Importance Workload Percentage to determine the order that LPARs and groups will receive MSUs when they are competing for MSUs when the MSU limit is approaching.

The Adjusted Low-Importance Workload Percentage is calculated as follows:

 <lowImportanceWorkloadPercentage> × <adjustmentFactors>

4HRA

Current 4HRA for the LPAR or group

A hyperlink on this field links to the LPAR48BK or GRP48BK view that displays the four-hour MSU usage for an LPAR or capacity group. For more information, see Displaying-the-48-5-minute-buckets-for-an-LPAR-or-capacity-group.

DefCap or GCL

Defined capacity for an LPAR, or group capacity limit

Min(4HRA, DC|GCL)

Minimum value for 4HRA, or DC/GCL

This field shows the 4HRA, or the DC/GCL for an LPAR or group, whichever is lower.

% MSU Limit

Percentage of the MIN(4HRA,DC|GCL) compared to the policy's MSU limit

For individual LPARs and groups, this field shows the relative usage among them. For the *Policy row, this field indicates the percentage of the MSU limit that is being consumed by the policy.

Current MSU/hr

Current MSU usage per hour

Excluded Reason

Reason that iCap cannot manage an LPAR or group

Possible values are:

  • H — The LPAR is hard-capped or MSU Absolute Capping is active.
  • W — Wait completion is active
  • D — Dedicated processors for LPAR
  • M — The LPAR is missing (not found in the DIAGNOSE buffer)
  • U — The 4HRA of the LPAR is unknown.
  • N — The LPAR is not active.
  • G — The LPAR belongs to a group that is also specified in the policy/subpolicy. The LPAR is excluded; iCap manages the group.

#Members

Number of LPAR members in a group

#of Agents

Number of agents running on the LPAR or group

Status

Status of the LPAR or group

Possible values are:

  • OK
  • Warn

    A warning status indicates that one of the following conditions exists:

    • The LPAR or group is missing (is not found in the DIAGNOSE buffer).
    • The LPAR is not active, or at least one LPAR member of a group is not active.
  • Error

    An error status indicates that one of the following conditions exists:

    • The LPAR is running without an agent, or at least one LPAR member of a group is running without an agent.

      Important

      For an LPAR, the value of the # of Agents field is 0. For a group, the value is less than the # Members. To view information about the LPAR members in the group, hyperlink on the # Members field for a group to access the GRPMEM view. Use the Status column on GRPMEM to identify any LPARs that are running without agents.

    • The LPAR or group is hard capped.
    • Wait completion is enabled on the LPAR.
    • The LPAR uses dedicated processors.

Max DcGcl

The maximum DC or GCL that an LPAR or group is allowed at any time

An LPAR or group will never receive DCs or GCLs above this limit, even if the MSUs are available. For more information, see the Max DC/GCL parameter description in LPAR-level-and-group-level-parameters.

System Name

Name of the system that is running on the LPAR

Sysplex

Name of the sysplex where an LPAR or group is running

Important

If this field displays _unknwn_, there is no agent running on the LPAR or group. Therefore, the sysplex is unknown.

Group Name

Name of the group to which an individual LPAR belongs

Important

This field applies only to LPARs that are group members (that is, an LPAR that is a member of a group, but has been specified as an individual LPAR). An individual LPAR is identified by I in the Type field.

MSU Cost

Relative cost of one MSU on an LPAR or group

This value is shown in cost units. A cost unit can represent any monetary value, or it can be a relative value. For more information, see the MSU Cost parameter description in LPAR-level-and-group-level-parameters.

Cost Entitlement

Number of cost units to which an LPAR or group is entitled

For more information, see Calculating-cost-limit.

Cost Limit%

Percentage of the cost limit that an LPAR or group is using

Entitlement

Number of MSUs to which an LPAR or group is currently entitled

When dynamic entitlement is enabled this field displays the adjusted entitlement for an LPAR or group, or the lesser of entitlement and adjusted entitlement. That is, if the calculated adjusted entitlement value is less than current entitlement, this field displays the adjusted entitlement value.

For more information, see the Dynamic Entitlement parameter description in Policy-level-and-subpolicy-level-parameters.

Important

The DU column indicates whether the policy is using dynamic entitlement.

DU

Whether the policy is using dynamic entitlement

%M4DCGCL MAXDCGCL

Percentage of DC or GCL compared to the Max DC/GCL

An alarm on this field alerts you when the DC or GCL reaches Max DC/GCL.

Proportion

Specified proportion for an LPAR or group

Cont LPAR

Indicates that the LPAR is designated in the policy as a container

All of the MSUs for container LPARs are container MSUs.

Container 4HRA

4HRA for the container MSUs consumed by an LPAR, capacity group, subpolicy, or policy

Mobile 4HRA

4HRA for the mobile MSUs consumed by an LPAR, capacity group, subpolicy, or policy

Subsys Map

The subsystems that are running on an LPAR or group

Possible values are:

  • D— Db2
  • C— CICS
  • W— WebSphere Transaction Manager
  • I— IMS
  • M— IBM MQ (formerly called IBM WebSphere MQ)

Important

If more than one subsystem is running on the LPAR or group, multiple values are displayed.

Adj 4HRA

Adjusted 4HRA for container and mobile workloads

AdjMSUs

Sum of container MSUs and 60% of mobile MSUs

Adj4HRA %DCGCL

Percentage of the adjusted 4HRA compared to defined capacity or group capacity limit

Min(Adj DCGCL)

Minimum value for the adjusted 4HRA, or DC/GCL

This field shows the adjusted 4HRA or the DC/GCL for an LPAR or group, whichever is lower.

%M4DCGCL MAXDCGCL

Percentage of DC or GCL compared to the Max DC/GCL

An alarm on this field alerts you when the DC or GCL reaches Max DC/GCL.

%Monthly
MaxMSULIMIT

Percentage of the monthly MSU limit compared to the Maximum MSU limit

Unmanaged LPAR

Whether the LPAR is unmanaged.

Absolute cap set for the LPAR

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*