OA66064: UPDATES TO WLM EXECUTION DELAY MONITORING AND BUFFER POOL MGMT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This apar addresses the following WLM Execution Delay
  Monitoring Buffer Pool Management problems:
  
  1. Unable to associate a BPMGMTONLY performance block (PB) with
     an address space.
  2. PBs are only sampled when their owning address space is
     swapped in.
  3. Delay states SESS_NETWORK and SESS_SYSPLEX are switched in
     the WLM sampling code, i.e., the SESS_NETWORK delays are
     reported as SESS_SYSPLEX, and vice versa.  This applies to
     fields RCAEWSS and RCAEWSN in the IWMWRCAA answer area of
     the IWMRCOLL service, and accordingly to fields R723RWSN and
     R723RWSS in SMF record type 72. This causes incorrect SYSP
     and REMT numbers in the STATE SAMPLES BREAKDOWN (%) WAITING
     FOR block of the subsystem data section in the RMF WLMGL
     Service Class Period report.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of z/OS 2.5 (HBB77D0) and above.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * This apar addresses the following WLM                        *
  * Execution Delay Monitoring Buffer                            *
  * Pool Management problems:                                    *
  *                                                              *
  * 1. Unable to associate a BPMGMTONLY                          *
  *    performance block (PB) with an                            *
  *    address space.                                            *
  * 2. PBs are only sampled when their                           *
  *    owning address space is swapped                           *
  *    in.                                                       *
  * 3. Delay states SESS_NETWORK and                             *
  *    SESS_SYSPLEX are switched in the                          *
  *    WLM sampling code, i.e., the                              *
  *    SESS_NETWORK delays are reported                          *
  *    as SESS_SYSPLEX, and vice versa.                          *
  *    This applies to fields RCAEWSS and                        *
  *    RCAEWSN in the IWMWRCAA answer                            *
  *    area of the IWMRCOLL service, and                         *
  *    accordingly to fields R723RWSN and                        *
  *    R723RWSS in SMF record type 72.                           *
  *    This causes incorrect SYSP and                            *
  *    REMT numbers in the STATE SAMPLES                         *
  *    BREAKDOWN (%) WAITING FOR block of                        *
  *    the subsystem data section in the                         *
  *    RMF WLMGL Service Class Period                            *
  *    report.                                                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The problems are caused by the following:
  
  1. The monitoring environment initialization service IWM4MINI
     does not allow a BPMGMTONLY monitoring environment to be
     associated with an address space.
  2. Module IRASASRV samples monitoring environments only when
     their owning address space is swapped in.
  3. Module IRASASRV reports SESS_NETWORK delays as SESS_SYSPLEX,
     and vice versa.
  

Problem conclusion

• This APAR solves above problems as follows:
  
  1. The monitoring environment initialization service IWM4MINI
     is extended to allow associating BPMGMTONLY monitoring
     environments with address spaces.
  2. The WLM connect service IWM4CON is extended with a new
     parameter SAMPLE_OUTQ which indicates whether monitoring
     environments of the connecting address space will also be
     sampled when the address space is swapped out. The default
     value is NO. If set to YES, module IRASASRV is changed to
     always sample the monitoring environments of the address
     space, even when it is swapped out.  This applies only to
     delay monitoring environments allocated in common storage.
  3. Reporting of SESS_NETWORK and SESS_SYSPLEX delays is fixed
     in module IRASASRV.
  
  In addition, this APAR introduces a new MODE=SET_FREE for the
  monitoring environment initialization service IWM4MINI which
  indicates that all previous attributes of the work request
  should be discarded, and the work request disassociated from
  the monitoring environment.  This is required to allow re-using
  the same monitoring environment with enclaves, address spaces,
  and parent monitoring environments in arbitrary order.
  
  Furthermore, this APAR fixes some minor problems in the
  IWM4MRLT and IWM4MXFR macros.
  

Temporary fix

Comments

APAR Information

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

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

  UJ94939 UJ94943

Modules/Macros

• IRASASRV IWMW2CON IWM4MINI IWM4MXFR IWM4MRLT IWMX2REL IWM4CON
  

Fix information

• Fixed component name

  WORK LOAD MANAG

• Fixed component ID

  5752SCWLM

Applicable component levels

• R7D0 PSY UJ94943

     UP24/04/10 P F404

• R7E0 PSY UJ94939

     UP24/04/10 P F404

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.