IBM Support

OA40539: NEW FUNCTION - RMF SUPPORT

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • New function:
    RMF support of WLM Group Capacity enhancements
    and absolute LPAR capacity limits on the IBM
    zEnterprise EC12 and BC12 servers (D/T2827).
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:          RMF user's .                        *
    ****************************************************************
    * PROBLEM DESCRIPTION: RMF support of WLM Group Capacity       *
    *                      enhancements and absolute LPAR          *
    *                      capacity limits on the IBM zEnterprise  *
    *                      EC12 and BC12 servers (D/T2827).        *
    *                                                              *
    *                      Following RMF reports are extended:     *
    *                      - Postprocessor Partition Data report   *
    *                      - Postprocessor Group Capacity report   *
    *                      - Monitor III CPC Capacity report       *
    *                                                              *
    *                      Following SMF record is extended:       *
    *                      - SMF 70 subtype 1 CPU Activity         *
    *                                                              *
    *                      New overview conditions are added       *
    *                      based on SMF record 70 subtype 1.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    New function APAR to provide RMF support for the gathering and
    reporting of WLM Group Capacity enhancements and absolute LPAR
    capacity limits on the IBM zEnterprise EC12 and BC12 servers.
    
    WLM uses initial weights to distribute the group capping limit
    when it becomes necessary to enforce the group limits. RMF adds
    new fields to SMF record 70-1 and takes the new WLM
    functionality into account when reporting about capacity
    groups.
    
    RMF adds support to report on the new absolute LPAR capacity
    limit that can be defined via the logical partition controls of
    the Hardware Management Console (HMC). The Postprocessor
    Partition Data report and the Monitor III CPC Capacity report
    display whether either Initial Capping or an absolute LPAR
    capacity limit was active during a reporting interval. New RMF
    Postprocessor overview conditions based on SMF record 70-1 can
    be used to do a more detailed analysis of the hardware capping
    options.
    
    +--------------------------------------------------------------+
    
    >>>>>> POSTPROCESSOR CPU ACTIVITY REPORT <<<<<<
    
    The Postprocessor Partition Data report section is enhanced to
    reflect the hardware capping option of a partition.
    
    Affected fields are
    CAPPING       Shows capping information for a partition.
                  DEF  The hardware capping option of the
                       partition: YES or NO.
                       This field indicates whether the operator
                       has applied any hardware capping mechanism
                       in the logical partition controls of the
                       Hardware Management Console (HMC) for the
                       partition. The value 'YES' identifies that
                       either 'Initial Capping ON' or an absolute
                       physical hardware capacity limit (maximal
                       number of CPUs) has been defined. The field
                       is only useful to logical partitions with
                       shared processors. Dedicated partitions can
                       be thought of as automatically capped.
                  ...
    
    The Postprocessor Group Capacity report section takes into
    account the partition's weighting of the shared processor
    resources which is used for WLM Group Capacity decisions.
    
    Affected fields are
    WGT                  The partition's weighting of the shared
                         processor resources which is used for WLM
                         Group Capacity decisions. In case of hard
                         capped partitions (see field CAPPING DEF),
                         dashes (---) are displayed.
    MINIMUM ENTITLEMENT  The minimum share of the MSU limit defined
                         for the capacity group that the partition
                         receives, even if all other partitions
                         within the capacity group are running high
                         workload. N/A is displayed for hard capped
                         partitions.
    
    +--------------------------------------------------------------+
    
    >>>>>> MONITOR III CPC CAPACITY REPORT <<<<<<
    
    The Monitor III CPC Capacity report is modified to provide
    complete information about the hardware capping mechanisms
    defined for a partition.
    
    The meaning of field 'Cap Def' has changed:
    Cap Def   The hardware capping option of the partition:
              YES or NO.
              This field indicates whether the operator has applied
              any hardware capping mechanism in the logical
              partition controls of the Hardware Management Console
              (HMC) for the partition. The value 'YES' identifies
              that either 'Initial Capping ON' or an absolute
              physical hardware capacity limit (maximal number of
              CPUs) has been defined.
    
    A new field CPCPHWCC is declared for use with the RMF utility.
    It provides the absolute physical hardware capacity limit in
    numbers of CPUs. The already existing field CPCPCAPI is now
    declared for the utility. It reflects whether Initial Capping
    was defined for a partition.
    
    The RMF Distributed Data Server lists the values of CPCPCAPI
    and CPCPHWCC when a request for LPAR resource details is
    issued.
    
    +--------------------------------------------------------------+
    
    >>>>> SMF RECORD TYPE 70 TO 79 - RMF PRODUCT SECTION <<<<<
    
    The SMF record level change number SMFxxSRL at offset 51 (x33)
    changes to 104 (x68).
    
    >>>>> SMF RECORD TYPE 70 SUBTYPE 1 - CPU ACTIVITY <<<<<
    
    The PR/SM Partition Data Section is changed.
    
    OFFSET  NAME     LEN FORMAT DESCRIPTION
    ...
    56 x38  SMF70PFL  2  binary Additional partition flags.
                                Bit Meaning When Set
                                ...
                                3 Initial weight instead of
                                  current weight should be used
                                  to project usage of the members
                                  in the capacity group.
                                4-15 Reserved.
    
    The PR/SM Logical Processor Data Section is changed.
    
    OFFSET  NAME     LEN FORMAT DESCRIPTION
    ...
    12  xC  SMF70VPF  1  binary Logical processor flags.
                                Bit Meaning When Set
                                ...
                                3 'Initial Capping' was set to 'ON'
                                  on the Hardware Management
                                  Console
                                4 'Initial Capping' status has
                                  changed during the interval
                                5 ...
                                6 SMF70HW_Cap_Limit has changed
                                  during the interval
                                7 Reserved.
    ...
    72 x48  SMF70HW_Cap_Limit
                       4 binary If not zero, absolute limit on
                                partition usage of all CPUs of the
                                type indicated in SMF70CIX in terms
                                of numbers of hundredth of CPUs.
    76 x4C             4        Reserved.
    
    +--------------------------------------------------------------+
    
    >>>>>> POSTPROCESSOR OVERVIEW CONDITIONS <<<<<<
    
    Following new and changed overview conditions are provided for
    SMF record type 70 subtype 1:
    
    CONDITIONS          CONDITION QUAL.  SOURCE   ALGORITHM
                        NAME
    -------------------+---------+------+---------+-----------------
    Group weight        GCWEIGHT  group  SMF70PFL  Sum(BPS) if
                                         SMF70BPS  PFL(Bit 3) is
                                         SMF70ACS  set for all
                                                   partitions in
                                                   capacity group,
                                                   otherwise
                                                   Sum(ACS)
    -------------------+---------+------+---------+-----------------
    Minimum             MINENT    lpar   SMF70PFL  MIN(MSU,GMU*BPS/
    entitlement                          SMF70BPS  Sum(BPS)) if
                                         SMF70ACS  PFL(Bit 3) is
                                         SMF70GMU  set for all
                                         SMF70MSU  partitions in
                                                   capacity group,
                                                   otherwise
                                                   MIN(MSU,GMU*ACS/
                                                   Sum(ACS))
    -------------------+---------+------+---------+-----------------
    Initial Capping     INICAP    lpar   SMF70VPF  1 if VPF(Bit 3)
    for general                                    is set,
    purpose processors                             otherwise 0
    -------------------+---------+------+---------+-----------------
    Absolute physical   LIMCPU    lpar   SMF70HW_  HW_Cap_Limit/100
    hardware capacity                    Cap_Limit
    limit in numbers of
    CPUs for general
    purpose processors
    -------------------+---------+------+---------+-----------------
    

Problem conclusion

Temporary fix

Comments

  • Keyword  D/T2827 .
    

APAR Information

  • APAR number

    OA40539

  • Reported component name

    RMF

  • Reported component ID

    566527404

  • Reported release

    770

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2012-10-04

  • Closed date

    2013-09-03

  • Last modified date

    2013-10-03

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UA70637 UA70638 UA70639 UA70640

Modules/Macros

  • ERBDUCPU ERBEXCIT ERBEXCPU ERBFMTS3 ERBMFCLS
    ERBMFDCP ERBMFIZS ERBMFRCR ERBPCTBL ERBRMFPP ERBSMFI  ERBSMF70
    ERB3CPC7 ERB3GCPC ERB3GCTC ERB3GGSS ERB3GSMF ERB3GSMM ERB3RACC
    ERB3RCDC ERB3RPUT ERB3RSDC ERB3RTBR GPMDDSRV GPMHTC
    

Fix information

  • Fixed component name

    RMF

  • Fixed component ID

    566527404

Applicable component levels

  • R77J PSY UA70639

       UP13/09/14 P F309

  • R770 PSY UA70637

       UP13/09/14 P F309

  • R78J PSY UA70640

       UP13/09/14 P F309

  • R780 PSY UA70638

       UP13/09/14 P F309

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"770","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"770","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 October 2013