IBM Support

OA50760: NEW FUNCTION - SUPPORT FOR NEW WLM POLICY ATTRIBUTES FOR SPECIALTY ENGINES CONTAINMENT AND MEMORY CAPPING

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • new function
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: RMF users.                                   *
    ****************************************************************
    * PROBLEM DESCRIPTION: RMF support for new WLM policy          *
    *                      attributes for Specialty Engines        *
    *                      Containment and Memory Capping (aka     *
    *                      Honor Priority by Service Class),       *
    *                      as well as new swap reason Memory Pool  *
    *                      Shortage.                               *
    *                                                              *
    *                      Following RMF reports are enhanced:     *
    *                      - Postprocessor WLMGL report            *
    *                      - Monitor II ASD/ASDJ report            *
    *                      - Monitor III GROUP report              *
    *                      - Monitor III RG report                 *
    *                                                              *
    *                      Following SMF records are changed:      *
    *                      - SMF 72 subtype 3:                     *
    *                          Workload Manager Control section    *
    *                          Resource Group Data section         *
    *                      - SMF 72 subtype 4                      *
    *                          Swap Reason Data section            *
    *                      - SMF 79 subtype 1                      *
    *                          ASD and ASDJ Data section           *
    *                      - SMF 79 subtype 2                      *
    *                          ARD and ARDJ Data section           *
    *                                                              *
    *                      The Monitor III Reporter Table          *
    *                      ERBSUMT3 is enhanced.                   *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This new function APAR provides RMF support for the gathering
    and reporting of new WLM policy attributes for Specialty
    Engines Containment and Memory Capping, as well as new swap
    reason Memory Pool Shortage.
    
    
    +--------------------------------------------------------------+
    >>> POSTPROCESSOR WORKLOAD ACTIVITY REPORT <<<
    
    The Postprocessor Workload Activity report (WLMGL) is enhanced
    to now show new WLM policy attributes for Specialty Engines
    Containment (aka Honor Priority by Service Class) and for
    Memory Capping.
    
    New field in the Service Class report and the Service Class
    Period report:
    
    HONOR PRIORITY=NO     This indication is reported for service
                          classes that do not allow to overflow to
                          regular CPs when there is insufficient
                          zIIP or zAAP capacity.
    
    New column in the Resource Groups table on the Service Policy
    page:
    
    MEMORY LIMIT          Resource group memory limit in GB.
                          Memory consumption of work running in
                          address spaces associated with this
                          resource group is limited to this size.
                          The value has system scope.
    
    
    +--------------------------------------------------------------+
    >>>>>> MONITOR II ASD/ASDJ REPORT <<<<<<
    Changes to the Monitor II ASD/ASDJ report:
    - Column R LS may show new swap reason Memory Pool Shortage
      (MP).
    
    Changed field:
    R LS                  The field showing the reason for the last
                          swap out associated with the job. ...
                          The possible contents and their meanings
                          are:
                          :
                          MP       Memory pool shortage
                          :
    
    
    +--------------------------------------------------------------+
    >>>>>> MONITOR III GROUP RESPONSE TIME REPORT <<<<<<
    Changes to the Monitor III Group Response Time report (GROUP):
    - OUTR Swap Reason section may show new swap reason Memory Pool
      Shortage (MP).
    
    Changed field:
    OUTR Swap Reason      A breakdown of the STOR Delay OUTR field
                          into the average number of users delayed
                          for specific swap reasons. ...
                          Swap reasons include:
                          :
                          MP       Memory pool shortage
                          :
    
    >>>>>> MONITOR III RESOURCE GROUP DATA REPORT <<<<<<
    Changes to the Monitor III Resource Group Data report (RG):
    - Length of columns Capacity/Min and Capacity/Max is
      reduced from 8 to 7 characters.
    - Length of column Capacity/Act is reduced from 8 to 5
      characters.
    - New column Mem Limit is added.
    
    New field:
    Mem Limit             Memory consumption of work running in
                          address spaces associated with this
                          resource group is limited to this size.
                          The value has system scope.
    
    
    +--------------------------------------------------------------+
    >>>>>> SMF RECORD TYPES 70 TO 79 - RMF PRODUCT SECTION <<<<<<
    The SMF record level change number SMFxxSRL at offset 51 (x33)
    changes to 126 (x7E).
    
    
    >>>>>> SMF RECORD TYPE 72 SUBTYPE 3 (WORKLOAD ACTIVITY) <<<<<<
    
    The Workload Manager Control Section is changed.
    OFFSET   NAME     LEN FORMAT DESCRIPTION
    1    1   R723MFLG 1   binary Flags.
                                 Bit  Meaning when set
                                 :
                                 4    Indicator that service class
                                      is not eligible for honor
                                      priority processing. When on,
                                      specialty engine eligible
                                      work in this service class
                                      will not be offloaded to CPs
                                      for help processing.
                                 5-7  Reserved
    
    The Resource Group Data Section is changed.
    OFFSET   NAME     LEN FORMAT DESCRIPTION
    40  28   R723GGLT 1   binary Resource group flags.
                                 Bit  Meaning when set
                                 :
                                 4    Memory limit was specified
                                 5-7  Reserved
    :
    52  34   R723GGML 4   binary If bit 4 of R723GGLT is ON, memory
                                 limit (in GB) of the resource
                                 group. The scope of the resource
                                 group is system-wide.
    
    
    >>>>>> SMF RECORD TYPE 72 SUBTYPE 4 (STORAGE DATA) <<<<<<
    
    The Swap Reason Data Section is changed.
    OFFSET   NAME     LEN FORMAT DESCRIPTION
    24  18   R724OR7  4   binary STOR/OUTR delay samples for swap
                                 reason 7: Requested swap.
                                 No longer used - refer to R724OR7A
    :
    72  48   R724OR7A 4   binary STOR/OUTR delay samples for swap
                                 reason 7: Memory pool shortage
    
    
    >>>>> SMF RECORD TYPE 79 SUBTYPE 1 (ADDRESS SPACE STATE) <<<<<
    
    The ASD and ASDJ Data Section is changed.
    OFFSET   NAME     LEN FORMAT DESCRIPTION
    24  18   R791SRC  2   EBCDIC Reason for last swap-out
                                 Contents Meaning
                                 TO       Terminal output
                                 TI       Terminal input
                                 LW       Long wait
                                 XS       Auxiliary storage
                                          shortage
                                 RS       Central storage shortage
                                 DW       Detected wait
                                 MP       Memory Pool shortage
                                 NQ       CAP enqueue
                                 EX       CAP exchange
                                 US       CAP uni-swap
                                 TS       Transition swap
                                 IC       Improve central storage
                                          usage
                                 IP       Improve system paging
                                          rate
                                 MR       Make room for a user who
                                          has been swapped out too
                                          long
                                 AW       APPC WAIT (swapped out,
                                          because waiting for APPC
                                          services)
                                 IW       OMVS input wait
                                 OW       OMVS output wait
                                 SR       In-real swap
                                 00       Unknown.
    :
    69  45   R791FLG2 1   binary Additional bits.
                                 Bit  Meaning when set
                                 :
                                 7    Honor priority ineligibility
                                      was assigned either to the
                                      address space or to
                                      transaction service classes
                                      being served by the space.
    
    
    >>>> SMF RECORD TYPE 79 SUBTYPE 2 (ADDRESS SPACE RESOURCE) <<<<
    
    The ARD and ARDJ Data Section is changed.
    OFFSET   NAME     LEN FORMAT DESCRIPTION
    111 6F   R792FLG2 1   binary Additional bits.
                                 Bit  Meaning when set
                                 :
                                 7    Honor priority ineligibility
                                      was assigned either to the
                                      address space or to
                                      transaction service classes
                                      being served by the space.
    
    
    +--------------------------------------------------------------+
    >>>>>> MONITOR III REPORTER TABLE ERBSUMT3 <<<<<<
    
    NAME      T   DESCRIPTION OF THE VARIABLE               REPORT
    ---------+---+-----------------------------------------+-------
    SUMCRIT   N   Indicator whether Storage Critical        Util
                  and/or CPU Critical (S, C, or SC)
    ---------+---+-----------------------------------------+-------
    SUMHONP   N   Indicator whether speciality engine       Util
                  eligible work in this service class will
                  be prevented from being offloaded to CPs
                  for help processing (N)
    ---------+---+-----------------------------------------+-------
    SUMMLIM   N   Maximum memory limit in GB                Util
    ---------+---+-----------------------------------------+-------
    

Problem conclusion

Temporary fix

Comments

  • n/a
     KEYWORDS: APSPARKF/K
    

APAR Information

  • APAR number

    OA50760

  • Reported component name

    RMF

  • Reported component ID

    566527404

  • Reported release

    790

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2016-06-21

  • Closed date

    2017-03-17

  • Last modified date

    2017-04-03

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

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

    UA91369 UA91370 UA91371 UA91372

Modules/Macros

  • ERBFMTS3 ERBGARD0 ERBGASD0 ERBMFBSR ERBMFDPC ERBMFDWM ERBMFIZS
    ERBMFL3J ERBMFL3V ERBPCTBL ERBRMFPP ERBSMFI  ERBSMF72 ERBSMF79
    ERBSUMT3 ERB2ASDH ERB2RDPC ERB3GADR ERB3GCTC ERB3GDAS ERB3GENQ
    ERB3GHSM ERB3GINI ERB3GISG ERB3GISS ERB3GJSX ERB3GJS2 ERB3GJS3
    ERB3GMES ERB3GMRG ERB3GMSU ERB3GRTN ERB3GRTS ERB3GSCM ERB3GSCV
    ERB3GSCX ERB3GSIG ERB3GSIL ERB3GSMF ERB3GSMG ERB3GSML ERB3GSMM
    ERB3GSMS ERB3GSMT ERB3GSTO ERB3GXCC ERB3RADD ERB3RCAA ERB3RCA1
    ERB3RCA2 ERB3RCA3 ERB3RCA4 ERB3RCA5 ERB3RCA6 ERB3RCA8 ERB3RCHK
    ERB3RCSU ERB3RDEV ERB3RDND ERB3RDNJ ERB3RDNV ERB3RDVJ ERB3RDVR
    ERB3RENC ERB3RENQ ERB3REQJ ERB3REQR ERB3RGRT ERB3RGTS ERB3RHJS
    ERB3RJDE ERB3RJDJ ERB3RJHJ ERB3RJUS ERB3RMAN ERB3RMDC ERB3RMSJ
    ERB3RMTJ ERB3RNOJ ERB3ROCG ERB3ROGR ERB3ROJN ERB3ROJS ERB3ROSC
    ERB3ROSY ERB3ROTC ERB3ROWU ERB3RPRC ERB3RPRJ ERB3RPRU ERB3RPUT
    ERB3RRCV ERB3RRIT ERB3RRTD ERB3RRT2 ERB3RSDC ERB3RSI1 ERB3RSI2
    ERB3RSRB ERB3RSRF ERB3RSRG ERB3RSRR ERB3RSRS ERB3RSR2 ERB3RSTF
    ERB3RSTJ ERB3RSTM ERB3RSTR ERB3RSUM ERB3RSYS ERB3RTBR ERB3RTDJ
    ERB3RTDN ERB3RTDR ERB3RTDS ERB3RTEJ ERB3RTEQ ERB3RTHS ERB3RTJU
    ERB3RTMS ERB3RTMT ERB3RTPJ ERB3RTPU ERB3RTSJ ERB3RTSM ERB3RTSR
    ERB3RTXJ ERB3RVDR ERB3RVSR ERB3RWAC ERB3RWFX ERB3RWIT ERB3RWKM
    ERB3RWXC ERB3RWXP ERB3RXCF ERB3XDRS ERB3XEQS ERB3XSCP ERB4MAIN
    ERB4SUUM ERB4SUU0 GPMDDSRV GPMHTC
    

Publications Referenced
SA380667XXSC342667XXSC342665XX  

Fix information

  • Fixed component name

    RMF

  • Fixed component ID

    566527404

Applicable component levels

  • R7AJ PSY UA91371

       UP17/03/29 P F703  

  • R7A0 PSY UA91369

       UP17/03/29 P F703  

  • R79J PSY UA91372

       UP17/03/29 P F703  

  • R790 PSY UA91370

       UP17/03/29 P F703  

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":"790","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":"790","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 April 2017