A fix is available
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
SC34266202 | SC34266301 | SA38066703 | GA32093702 | GA32093802 |
GA32093902 | SC34266203 | SC34266302 | SA38066704 | GA32093603 |
GA32093703 |
Fix information
Fixed component name
WORK LOAD MANAG
Fixed component ID
5752SCWLM
Applicable component levels
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