IBM Support

OA47042: NEW FUNCTION: WLM Reporting Enhancements for Mobile Pricing

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: All users of z/OS 2.1 (HBB7790) and          *
    *                 above.                                       *
    ****************************************************************
    * PROBLEM DESCRIPTION: NEW FUNCTION: WLM Reporting             *
    *                      Enhancements for Mobile Pricing         *
    *                                                              *
    *                      Mobile Workload Pricing is an IBM       *
    *                      Software Pricing Option, announced in   *
    *                      May 2014. It offers a discount on MSUs  *
    *                      consumed by transactions that           *
    *                      originated on a mobile device.  To take *
    *                      advantage of this discount, customers   *
    *                      need a process, agreed upon by IBM, to  *
    *                      identify (tag and track) their          *
    *                      mobile-sourced transactions and their   *
    *                      consumption.                            *
    *                                                              *
    *                      Today, this type of mobile workload     *
    *                      reporting requires product-specific     *
    *                      tooling from high-volume transaction    *
    *                      level accounting data, which induces    *
    *                      significant overhead both for customers *
    *                      and product development.                *
    *                                                              *
    *                      This APAR introduces WLM enhancements   *
    *                      to simplify the identifying and         *
    *                      reporting of the mobile-sourced         *
    *                      transactions and their processor        *
    *                      consumption.                            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    In order to simplify tracking of mobile workload consumption,
    and reduce data volume and analysis complexity, WLM is
    introducing a new transaction level attribute in the WLM
    classification rules that will allow for the identification of
    mobile transactions and the reporting of their processor
    consumption.
    
    With this support, there is no need to restructure the existing
    service or report class structure, so that existing reporting
    processes are not affected.  Mobile processor consumption data
    by service class or report class period is reported in the
    IWMWRCAA answer area provided by the IWMRCOLL service.  WLM also
    aggregates the system-wide mobile processor consumption data and
    reports it in the System Resource Manager Resource Control Table
    IRARCT.  The support is only available for IBM defined
    subsystems.
    
    Two additional issues are being addressed in this APAR:
    - A compiler message in IWM4MXFR is caused by a register that is
      not unrestricted on all code paths in time.
    - Sampling overhead in IRASASRV that is caused by unnecessary
      MVCL instructions.
    

Problem conclusion

Temporary fix

Comments

  • This APAR introduces a new transaction level attribute in the
    WLM classification rules that will allow for the identification
    of mobile transactions and the reporting of their processor
    consumption.
    
    The WLM Administrative Application is extended to support the
    new attribute. The classification rules panel now contains a new
    column "Reporting Attribute".  Four values of the new reporting
    attribute are possible:
    
    - NONE, for all work. This is the default.
    - MOBILE, for mobile work.
    - CATEGORYA, for a first general purpose subset of work. This
      is provided for future use.
    - CATEGORYB, for a second general purpose subset of work. This
      is provided for future use.
    
    A non-default value can be specified for all IBM-supplied
    subsystem types.
    
    The new reporting attribute is stored in the WLM service
    definition classification rule mapping IWMSVDCR.
    
    Classification can be based on any currently supported work
    qualifier. To help identify mobile transactions, two new
    qualifiers are introduced for CICS:
    - Connection Type (CT): The name of the TCP/IP Service that
      received the request for this transaction.
    - Transaction Class (TC): The name of the transaction class to
      which this transaction, or transid belongs.
    
    Similarly, two new qualifiers are introduced for IMS:
    - Connection Type (CT): The port number of the TCP/IP
      Service that received the request for this transaction.
    - Client Transaction Name (CTN): The name of the Transaction
      Pipe (TPIPE).
    
    The IWM4RPT and IWM4MNTF services are extended with new
    parameters that allow exploiters of the WLM Execution Delay
    Monitoring Services like CICS or IMS to provide CPU and offload
    times for all their transactions.
    
    For enclave and address space transactions, CPU and offload
    times are already available today.
    
    WLM now gathers and accumulates the CPU and offload times for
    all transactions and also separately accumulates the CPU and
    offload times for transactions flagged as MOBILE, CATEGORYA or
    CATEGORYB. For service and report classes, the data for all four
    categories (all transactions, MOBILE, CATEGORYA, CATEGORYB) is
    reported separately in the IWMWRCAA answer area provided by the
    IWMRCOLL service.
    
    WLM also aggregates system-wide consumption data for all
    transactions, and also separately for transactions flagged as
    MOBILE, CATEGORYA or CATEGORYB. It accumulates the values into a
    rolling 4 hour average, and reports them in the System Resource
    Manager Resource Control Table IRARCT.
    
    The CPU and offload times are also reported in SMF record type
    99, subtype 2, in the period data section and the address space
    expanded storage access policy section.
    
    For gathering and accumulating the CPU and offload times,
    interim results are stored in the Resources Manager User Control
    Block Extension IRAOUCBX.
    
    The Special Reporting support is indicated in a new flag,
    SRMSTSPR, in the answer area of SYSEVENT REQSRMST which is
    mapped by IRASRMST.  SRMSTSPR=ON indicates that the Special
    Reporting function is available.
    
    Additionally, for this new function, the WLM Administrative
    Application level changes from 29 to 30.  The WLM Administrative
    Application level 30 is only available with z/OS V2R1 and above
    when APAR OA47042 is applied.
    
    The functionality level of a service definition changes to 30 as
    soon as a non-default value of the new reporting attribute is
    specified for classification rules.  The new functionality level
    30 for the WLM service definitions is introduced into mapping
    macros IWMSVAEA, IWMSVDCR, IWMSVDEF, IWMSVNPA and IWMSVPOL.
    
    A WLM service definition with functionality level LEVEL030 can
    not be extracted, displayed, modified, installed or activated
    from a z/OS V1R13 system or from a z/OS V2R1 or V2R2 system
    without APAR OA47042 applied.  Once the functionality level of
    the WLM service definition increases to LEVEL030, all actions
    must be taken from a z/OS V2R1 or z/OS V2R2 system with APAR
    OA7042 applied.
    
    Once a functionaltiy LEVEL030 service definition is installed
    and activated, it will run on all systems in a mixed sysplex.
    However, the new reporting attribute will not be honored for
    workload reporting and classification on a z/OS V1R13 system or
    on a z/OS V2R1 or z/OS V2R2 system without APAR OA47042 applied.
    The new functionality is tolerated on the back-level systems,
    but not exploited.
    
    For the documentation updates related to this APAR, please
    refer to:
     http://publibz.boulder.ibm.com/zoslib/pdf/OA47042.pdf
    
    In addition to the new function being added the following minor
    updates were made:
    - The code generated by macro IWM4MXFR is fixed so that
      restricted registers are unrestricted on all code paths in
      time.
    - IRASASRV is changed to use MVC instead of MVCSK to copy
      Performance Blocks for sampling.
    - The comment for field RCAEVARTIMEATPDP in the IWMWRCAA answer
      area is updated with the unit of measurement.
    

APAR Information

  • APAR number

    OA47042

  • Reported component name

    WORK LOAD MANAG

  • Reported component ID

    5752SCWLM

  • Reported release

    790

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2015-02-05

  • Closed date

    2015-12-04

  • Last modified date

    2016-01-21

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

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

    UA79989 UA79990

Modules/Macros

  • IEAVNP10 IRABASMF IRABASSI IRACPSRP IRACPUDP
    IRAENASS IRAENELM IRAENOCT IRAENREG IRAENSTA IRAENTRX IRAEVAPC
    IRAEVBPS IRAEVCFG IRAEVCRM IRAEVCTH IRAEVCVL IRAEVDAR IRAEVDMY
    IRAEVECR IRAEVEDL IRAEVENQ IRAEVGDD IRAEVIRS IRAEVJIA IRAEVJID
    IRAEVJII IRAEVJJS IRAEVJJT IRAEVJSO IRAEVMCR IRAEVMDL IRAEVMEA
    IRAEVMIG IRAEVQCN IRAEVQSC IRAEVQUE IRAEVREQ IRAEVRTO IRAEVSSI
    IRAEVSUB IRAEVS97 IRAEVTIM IRAEVWLM IRAOPCAN IRAOPREF IRAPACRM
    IRAPADRV IRAPALCD IRAPALPC IRAPASMF IRAPASM2 IRAPASSB IRAPASS1
    IRAPASS2 IRAPASS3 IRAPASS4 IRAPASS5 IRAPASS6 IRAPASS7 IRAPASS8
    IRAPAS2D IRAPATOP IRARCT   IRARMASC IRARMCAP IRARMCHN IRARMCNS
    IRARMCTL IRARMECL IRARMERR IRARMER4 IRARMEVT IRARMEV2 IRARMFIP
    IRARMFMO IRARMINT IRARMLNK IRARMPRP IRARMRMR IRARMSET IRARMSMF
    IRARMSOP IRARMST2 IRARMST3 IRARMSWP IRARMWL1 IRARMWL2 IRARMWL3
    IRARMWL4 IRARSPL  IRASASRV IRASAWSU IRASMF99 IRASRMST IRASRPST
    IRASTASM IRASTFXS IRAWRARC IRAWRARG IRAWRART IRAWRCOL IRAWRENC
    IRAWRENT IRAWRNZS IRAWRSRV IRAWRUPT IRAWRWR4 IRAWRWR6 IWMAM75
    IWMAPAB  IWMAPLGO IWMAP7D  IWMAP7E  IWMAP7F  IWMAP7J  IWMAP7K
    IWMAP7L  IWMARDCF IWMARIDM IWMARIN1 IWMARI2X IWMARX2I IWMARZFL
    IWMARZFT IWMAR01  IWMAR7D  IWMAS75  IWMATSSE IWMATSSQ IWMA2SD1
    IWMA2SD2 IWMA2SD3 IWMA2SD5 IWMC4SMF IWMH7C5  IWMH7C6  IWMH7DQ
    IWMI2RIM IWMP2ACT IWMP2ECR IWMP2EXT IWMP2FDP IWMP2PRQ IWMP2REQ
    IWMP2RE2 IWMP2RSC IWMP2RSD IWMP2TIN IWMP2TRQ IWMP2VDR IWMP2VPR
    IWMP2VSA IWMP2VSD IWMP2VSP IWMP2VS2 IWMP2WSD IWMSVAEA IWMSVDCR
    IWMSVDEF IWMSVNPA IWMSVPOL IWMWRCAA IWMW2BCL IWMW2BGR IWMW2EVG
    IWMW2EVR IWMW2RPT IWMW2RP4 IWMW2SM  IWMW3BLD IWMW3CO1 IWMW3CST
    IWMW3FRE IWMX2NTF IWMX2NT4 IWMZ2STM IWMZ2VCH IWMZ2VCR IWMZ2VPH
    IWMZ2VPO IWM4MNTF IWM4MXFR IWM4RPT
    

Publications Referenced
SC34266202SC34266301SA38066703GA32093702GA32093802
GA32093902SC34266203SC34266302SA38066704GA32093603
GA32093703    

Fix information

  • Fixed component name

    WORK LOAD MANAG

  • Fixed component ID

    5752SCWLM

Applicable component levels

  • R7A0 PSY UA79989

       UP15/12/16 P F512

  • R790 PSY UA79990

       UP15/12/16 P F512

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:
21 January 2016