A fix is available
APAR status
Closed as new function.
Error description
new function
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: RMF users. * **************************************************************** * PROBLEM DESCRIPTION: RMF support for Container Pricing. * * * * Following RMF reports are extended to * * report on WLM tenant resource groups * * and associated tenant report classes: * * - Postprocessor Workload Activity * * report * * - Monitor III Storage Delay Summary * * report * * - Monitor III System Information * * report * * - Monitor III Sysplex Summary report * * * * Following SMF records are extended: * * - SMF 70 subtype 1, CPU Activity * * - SMF 72 subtype 3, Workload Activity * * - SMF 79 subtype 1, Address Space * * State Data * * - SMF 79 subtype 2, Address Space * * Resource Data * * - SMF 79 subtype 5, Address Space SRM * * Data * * * * New Overview conditions that are based * * on SMF record 70 subtype 1 are added. * **************************************************************** * RECOMMENDATION: * **************************************************************** This new function APAR provides RMF support for Container Pricing. +--------------------------------------------------------------+ >>> POSTPROCESSOR WORKLOAD ACTIVITY REPORT <<< The Postprocessor Workload Activity report is modified: - If the report class is a tenant report class, the tenant Resource group name and the tenant ID are displayed in the corresponding Report Class and Report Class period report sections. - The Service Policy page is enhanced to support tenant resource groups as well as traditional resource groups and displays activity data at sysplex and system granularity. Changed and new fields of the Workload Activity report: DISCRETIONARY GOAL MANAGEMENT YES if service class and tenant report class periods that are connected to a resource group and have assigned a discretionary goal are excluded from workload management, otherwise NO. RESOURCE GROUPS A resource group is an amount of processor capacity across one or more MVS systems, a memory limit per system, or a combination of both. NAME Name of resource group or tenant resource group. DESCRIPTION Description of resource group or tenant resource group. SYSTEM Name of a MVS system that is belonging to the sysplex. CPU CONSUMPTION #CPS CPU consumption in terms of number of general purpose processors. The scope of the reported value can be: - this resource group - a particular system in the sysplex - a service class that is associated with this resource group - a tenant report class that is associated with this tenant resource group CPU CONSUMPTION MSU CPU consumption in terms of MSU. The scope of the reported value can be: - this resource group - a particular system in the sysplex - a service class that is associated with this resource group - a tenant report class that is associated with this tenant resource group CPU CONSUMPTION SU/SEC CPU consumption in terms of unweighted CPU and SRB service units per second. The scope of the reported value can be: - this resource group - a particular system in the sysplex - a service class that is associated with this resource group - a tenant report class that is associated with this tenant resource group If an asterisk is placed behind the reported total value, WLM capping considers service units consumed on general purpose and specialty processors. In such a case, the reported value reflects the actual general purpose and specialty processor consumption. Otherwise, only general purpose consumption is reported. CPU CAPACITY Resource group capacity limits. ....... DEFINED AS The method how the resource group's capacity is defined: - SU/SEC: as unweighted CPU and SRB service units per second across the sysplex - % LPAR SHARE: as percentage of the LPAR share on each system in the sysplex - NUMBER OF CPs: as number of general purpose processors on each system in the sysplex - MSU: as MSU/h capacity across the sysplex MEMORY USED Amount of memory used by this resource group on a particular system. MEMORY LIMIT Resource group memory limit for each system in the sysplex. Memory consumption of work running in address spaces associated with this resource group is limited to this size. +--------------------------------------------------------------+ >>> Monitor III Sysplex Summary Report <<< New Monitor III Utility fields are added to Monitor III Sysplex Summary report: Name in ERBSUMR3 Meaning SUMRGTYP Definition of minimum and maximum capacity SUMRGSPC Include specialty processor consumption SUMRCTNT Report class is a tenant report class SUMMEMUS Actual memory consumption The meaning is changed for this Monitor III Utility field: Name in ERBSUMR3 Meaning SUMRES Name of resource group or tenant resource group >>> Monitor III System Information Report <<< New Monitor III Utility fields are added to Monitor III System Information report: Name in ERBSYSR3 Meaning SYSRCTNT Report class is a tenant report class SYSMEMUS Actual memory consumption >>> Monitor III Storage Delay Summary Report <<< A new Monitor III Utility field is added to Monitor III Storage Delay Summary report: Name in ERBSRSR3 Meaning SRSRCTNT Report class is a tenant report class +--------------------------------------------------------------+ >>>>> SMF RECORD TYPE 70 TO 79 - RMF PRODUCT SECTION <<<<< The SMF record level change number SMFxxSRL at offset 51 (x33) changes to 130 (x82). >>>>> SMF RECORD TYPE 70 SUBTYPE 1 - CPU ACTIVITY <<<<< The new Tenant Resource Group data section is added to SMF 70 subtype 1. The section provides SMF exploiters with processor activity data of tenant resource groups. New fields are added to the header/self-defiction section: OFFSET NAME LEN FORMAT DESCRIPTION 92 5Cx SMF70TNS 4 binary Offset to Tenant Resource Group data section from RDW. 96 60x SMF70TNL 2 binary Length of Tenant Resource Group data section. 98 62x SMF70TNN 2 binary Number of Tenant Resource Group data sections. Some field descriptions are changed in the CPU control data section: OFFSET NAME LEN FORMAT DESCRIPTION 268 10Cx SMF70LACM 4 binary Long-term average of CPU service (millions of service units) consumed by transactions classified with reporting attribute MOBILE. If an address space or enclave is part of a tenant resource group, it will not contribute to SMF70LACM. 272 110x SMF70LACA 4 binary Long-term average of CPU service (millions of service units) consumed by transactions classified with reporting attribute CATEGORYA. If an address space or enclave is part of a tenant resource group, it will not contribute to SMF70LACA. 276 114x SMF70LACB 4 binary Long-term average of CPU service (millions of service units) consumed by transactions classified with reporting attribute CATEGORYB. If an address space or enclave is part of a tenant resource group, it will not contribute to SMF70LACB. The new Tenant Resource Group (TRG) Data Section contains general tenant resource group and tenant information as well as processor consumption measurements for the interval. OFFSET NAME LEN FORMAT DESCRIPTION 0 0x SMF70_TRG_NAME 8 EBCDIC Tenant resource group name. 8 8x SMF70_TRG_DESC 32 EBCDIC Tenant resource group description. 40 28x SMF70_TRG_TNTID 8 EBCDIC Tenant identifier. 48 30x SMF70_TRG_TNTNAME 32 EBCDIC Tenant name. 80 50x SMF70_TRG_SBID 64 EBCDIC Solution ID. 144 90x SMF70_TRG_SUCP 8 binary Service units on CPs consumed by TRG. 152 98x SMF70_TRG_SUIFA 8 binary Service units on zAAPs consumed by TRG. 160 A0x SMF70_TRG_SUSUP 8 binary Service units on zIIPs consumed by TRG. 168 A8x SMF70_TRG_LAC 4 binary Long-term average service on general purpose processors in millions of service units per hour consumed by TRG. >>>>> SMF RECORD TYPE 72 SUBTYPE 3 - WORKLOAD ACTIVITY <<<<< The Workload Manager Control data section is extended: OFFSET NAME LEN FORMAT DESCRIPTION 1 1x R723MFLG 1 binary .... 5 Indicator for a tenant report class 6 Service class and tenant report class periods that are associated with a resource group and have assigned a discretionary goal are excluded from workload management. 7 Reserved. 268 10Cx R723CPA_actual 4 binary Physical CPU adjustment factor based on Model Capacity Rating. 272 110x R723CPA_scaling_factor 4 binary Scaling factor for R723CPA_actual. The Resource Group data section is extended: OFFSET NAME LEN FORMAT DESCRIPTION 40 28x R723GGLT 1 binary .... 5 Specification of R723GGMN and R723GGMX is in MSU/h rather than in service units. 6 Specialty processor consumption is included into the WLM capping algorithms, i.e. R723GGMN and R723GGMX limit the combined general purpose and specialty processor consumption 7 Reserved 41 29x R723GGTF 1 binary Tenant Resource Group Flags. Bit Meaning When Set 0 Indicator for a tenant resource group 1-7 Reserved 42 2Ax 2 Reserved. 44 2Cx R723GGMN 4 binary If bit 1 of R723GGLT is ON, minimum capacity of the resource group. If bit 2, bit 3, and bit 5 of R723GGLT are OFF, this value is in unweighted CPU service units per second. In addition, the scope of the resource group is sysplex-wide. If bit 2, bit 3, or bit 5 of R723GGLT is ON, see the description of R723GGLT. 48 30x R723GGMX 4 binary If bit 0 of R723GGLT is ON, maximum capacity of the resource group. If bit 2, bit 3, and bit 5 of R723GGLT are OFF, this value is in unweighted CPU service units per second. In addition, the scope of the resource group is sysplex-wide. If bit 2, bit 3, or bit 5 of R723GGLT is ON, see the description of R723GGLT. 56 38x R723GGTI 8 EBCDIC Tenant identifier. Only valid if bit 0 of R723GGTF is ON. 64 40x R723GGTN 32 EBCDIC Tenant name. Only valid if bit 0 of R723GGTF is ON. 96 60x R723GGKY 64 EBCDIC Solution ID. Only valid if bit 0 of R723GGTF is ON. >>>>> SMF RECORD TYPE 79 SUBTYPE 1 - AS STATE DATA <<<<< The ASD/ASDJ data section is extended: OFFSET NAME LEN FORMAT DESCRIPTION 236 ECx R791FLG3 1 binary .... 2 R791RGRP is the name of a tenant resource group and R791RCL is the name of a tenant report class. 3 General purpose and specialty processor consumption is considered by WLM capping algorithms for this address space. 4-7 Reserved. >>>>> SMF RECORD TYPE 79 SUBTYPE 2 - AS RESOURCE DATA <<<<< The ARD/ARDJ data section is extended: OFFSET NAME LEN FORMAT DESCRIPTION 224 E0x R792FLG3 1 binary .... 2 R792RGRP is the name of a tenant resource group. 3 General purpose and specialty processor consumption is considered by WLM capping algorithms for this address space. 4-7 Reserved. >>>>> SMF RECORD TYPE 79 SUBTYPE 5 - AS SRM DATA <<<<< The ASRM/ASRMJ data section is extended: OFFSET NAME LEN FORMAT DESCRIPTION 60 3Cx R795FLG 1 binary .... 6 R795RGRP is the name of a tenant resource group. 7 Reserved. +--------------------------------------------------------------+ >>>>>> POSTPROCESSOR OVERVIEW CONDITIONS <<<<<< New qualifier trg specifies the name of the tenant resource group for which an Overview report is to be generated. New Overview conditions are provided based on SMF record type 70 subtype 1. The only possible qualifier is trg: CONDITION NAME SOURCE ALGORITHM --------------------------+-----------+--------+-------------- Long-term average of TRGLACS SMF70_TRG_LAC Value or CPU service consumed comparison by a TRG Service units on CPs TRGCP SMF70_TRG_SUCP TRG_SUCP*1000 consumed by a TRG SMF70INT /INT per second Service units on zAAPs TRGAAP SMF70_TRG_SUIFA TRG_SUIFA*1000 consumed by a TRG SMF70INT /INT per second Service units on zIIPs TRGIIP SMF70_TRG_SUSUP TRG_SUSUP*1000 consumed by a TRG SMF70INT /INT per second CP processor TRGCPN SMF70_TRG_SUCP (TRG_SUCP* consumption in terms SMF70ADJ *ADJ) / of 1/100 of a CP SMF70INT (INT*160000) zAAP processor TRGAAPN SMF70_TRG_SUIFA (TRG_SUIFA* consumption in terms SMF70ADJ *ADJ) / of 1/100 of a CP SMF70INT (INT*160000) zIIP processor TRGIIPN SMF70_TRG_SUSUP (TRG_SUSUP* consumption in terms SMF70ADJ *ADJ) / of 1/100 of a CP
Problem conclusion
Temporary fix
Comments
KEYWORDS: SMFREC/K PRICINGINFR/K ×**** PE18/05/29 FIX IN ERROR. SEE APAR OA55602 FOR DESCRIPTION
APAR Information
APAR number
OA52694
Reported component name
RMF
Reported component ID
566527404
Reported release
7B0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2017-04-27
Closed date
2017-12-05
Last modified date
2018-07-26
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA94528 UA94529 UA94530 UA94531
Modules/Macros
ERBCM350 ERBDUCPU ERBEXBLT ERBEXCIT ERBEXCPU ERBFMTS3 ERBGARD0 ERBGASD0 ERBGASRM ERBHDRS3 ERBLISTO ERBMFBSR ERBMFDCP ERBMFDFD ERBMFDWM ERBMFEAY ERBMFICP ERBMFIZS ERBMFTNT ERBMFTRM ERBPCTBL ERBPPASS ERBPPCOM ERBPPCON ERBRMFPP ERBSCAN ERBSMFI ERBSMF70 ERBSMF72 ERBSMF79 ERBSRST3 ERBSTGST ERBSTSGT ERBSUMT3 ERBSYST3 ERB3GADR ERB3GCTC ERB3GISS ERB3GLOK ERB3GMRG ERB3GSCM ERB3GSCV ERB3GSCX ERB3GSIL ERB3GSMF ERB3GSMG ERB3GSMM ERB3GSMT ERB3OSC1 ERB3OSC3 ERB3OSC4 ERB3OSG3 ERB3OSG5 ERB3OSG6 ERB3OYG0 ERB3OYG3 ERB3OYG4 ERB3OYG5 ERB3OYG6 ERB3RCAA ERB3RCA6 ERB3RCA7 ERB3RCHK ERB3RCSU ERB3RDEV ERB3RDPC ERB3RDVR ERB3RENC ERB3RGRT ERB3RGTS ERB3RJDE ERB3RJDJ ERB3RJUS ERB3RMAN ERB3RMDC ERB3ROCG ERB3ROSC ERB3ROSY ERB3RPRC ERB3RPRU ERB3RPUT ERB3RRCV ERB3RRIT ERB3RRTD ERB3RRT2 ERB3RSDC ERB3RSI1 ERB3RSI2 ERB3RSRB ERB3RSRF ERB3RSRG ERB3RSRS ERB3RSR2 ERB3RSTF ERB3RSTM ERB3RSTR ERB3RSUM ERB3RSYS ERB3RTBG ERB3RTBR ERB3RTDJ ERB3RTDR ERB3RTEJ ERB3RTEQ ERB3RTGD ERB3RTHS ERB3RTJU ERB3RTMS ERB3RTMT ERB3RTPJ ERB3RTPU ERB3RTSJ ERB3RTSM ERB3RTXJ ERB3RVDR ERB3RVSR ERB3RWFX ERB3RWIT ERB3RWKM ERB3RWXC ERB3RXCF ERB3XDRI ERB3XDRS ERB3XSCP ERB4MAIN ERB4OUGA ERB4OUGB ERB4OUGD ERB4OUGE ERB4OUG0 ERB4OWL3 ERB4OWL6 ERB4RTDA ERB4SRS8 ERB4SUMI ERB4SYSJ ERB6GRTF ERB6RTDF ERB6SRSF ERB6SUMF ERB6SYSF ERB6WKMF ERB872I0 ERB873I0 ERB888I0 GPMDDSRV GPMHTC HRM77A0J HRM77B0J
| SA380667XX | SC33799203 | SC342667XX | SC342665XX |
Fix information
Fixed component name
RMF
Fixed component ID
566527404
Applicable component levels
R7AJ PSY UA94530
UP17/12/13 P F712
R7A0 PSY UA94528
UP17/12/13 P F712
R7BJ PSY UA94531
UP17/12/13 P F712
R7B0 PSY UA94529
UP17/12/13 P F712
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":"7B0","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":"7B0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
26 July 2018