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 of absolute LPAR group * * capping limits on the IBM z13 and * * z13s servers and support of WLM OPT * * parameter ABSMSUCAPPING. * * * * Following RMF reports are extended: * * - Postprocessor CPU Activity report * * - Monitor II OPT report * * - Monitor III CPC Capacity report * * * * Following SMF record is extended: * * - SMF 70 subtype 1 CPU Activity * * * * New overview conditions are added * * based on SMF record 70 subtype 1. * **************************************************************** * RECOMMENDATION: * **************************************************************** This new function APAR provides RMF support for the gathering and reporting of absolute hardware group capping limits on the IBM z13 and z13s servers. It also adds support for reporting the new WLM OPT parameter ABSMSUCAPPING. RMF adds support to report on the new absolute hardware group (aka LPAR group) capping limits. The Postprocessor CPU Activity report and the Monitor III CPC Capacity report display whether an Initial Capping option, an absolute LPAR capping limit or an absolute hardware group capping limit was active during a reporting interval. New RMF Postprocessor overview conditions based on SMF record 70-1 are provided. WLM introduces a new OPT parameter ABSMSUCAPPING which, if it is set, enforces capping of a partition at the defined capacity. RMF adds a new flag to SMF record 70-1 and reports the value of this OPT parameter in the Postprocessor Partition Data report, the Monitor II OPT report and the Monitor III CPC report. +--------------------------------------------------------------+ >>> POSTPROCESSOR CPU ACTIVITY REPORT <<< The Postprocessor Partition Data report section is enhanced to reflect the hardware capping options of a partition. New header fields are INITIAL CAP This field indicates whether the operator has set Initial Capping ON in the logical partition controls of the Hardware Management Console (HMC) for the partition. LPAR HW CAP This field indicates whether an absolute physical hardware capping limit has been defined in the logical partition controls of the HMC for any processor type of the partition. HW GROUP CAP This field indicates whether an absolute hardware group capping limit has been defined in the logical partition group controls of the HMC for any processor type of the partition. ABS MSU CAP This field indicates whether the ABSMSUCAPPING parameter has been set in the active IEAOPTxx parmlib member for the partition. Affected fields are CAPPING Shows capping information for a partition. DEF The hardware capping option of the partition. Each DEF value is a three position character string denoting which hardware capping mechanisms have or have not been applied in the logical partition controls of HMC for the partition. The values in the first, second and third position of the string are either Y (Yes) or N (No) and have the following meaning: 1. The first character (Y or N) indicates whether Initial Capping ON has been set. 2. The second character (Y or N) indicates whether an absolute physical hardware capping limit (maximal number of CPUs) has been defined. 3. The third character (Y or N) indicates whether an absolute hardware group capping limit (maximal number of CPUs) has been defined. The field is only useful to logical partitions with shared processors. ... The IMAGE CAPACITY header field takes the hardware group capping limits into account when reporting about the CPU activity available to the MVS image (measured in MSUs per hour). The TOTAL line now also contains the sum of the current weightings of the shared processor resources. A new Hardware Group Report section is added to the CPU Activity Report. This report displays hardware group capping settings of the hardware groups and their partitions. The Hardware Group Report contains the following fields HW GROUP NAME Name of the hardware group. PARTITION Name of the logical partition. SYSTEM Name of the z/OS system. HW GROUP LIMIT Absolute limit on partition usage of all CPs / zIIPs / ICFs / IFLs which are members of the same hardware group, in terms of numbers of CPUs. If the hardware group name or the limit changed during the reporting interval, an '*' is appended. +--------------------------------------------------------------+ >>> MONITOR II OPT REPORT <<< The RMF Monitor II OPT Settings report is enhanced to display the information about the new IEAOPTxx parmlib parameter ABSMSUCAPPING. +--------------------------------------------------------------+ >>> MONITOR III CPC CAPACITY REPORT <<< The Monitor III CPC Capacity report is modified to provide complete information about the hardware capping mechanisms defined for a partition. A new header field (CPCHAMSU) is inserted which lists the value of the ABSMSUCAPPING OPT parameter setting (Y / N). If ABSMSUCAPPING=YES and the partition has a defined capacity limit set, then the 'remaining time until capping' (CPCHRMSU) is zero. The 'Image Capacity' header field takes the hardware group capping limits into account when reporting about the processor capacity available to the z/OS image (measured in MSUs per hour). The meaning of field 'Cap Def' has changed: Cap Def The hardware capping option of the partition. Each 'Cap Def' value is a three position character string denoting which hardware capping mechanisms have or have not been applied in the logical partition controls of HMC for the partition. The values in the first, second and third position of the string are either Y (Yes) or N (No) and have the following meaning: 1. The first character (Y or N) indicates whether Initial Capping ON has been set. 2. The second character (Y or N) indicates whether an absolute physical hardware capping limit (maximal number of CPUs) has been defined. 3. The third character (Y or N) indicates whether an absolute hardware group capping limit (maximal number of CPUs) has been defined. An asterisk (*) to the right of a value indicates that the capping status is currently changing. New tabular report table ERBCPCT3 fields: - CPCPHWGN: hardware group name if the partition is member of such a group - CPCPHWGC: hardware group capping limit in numbers of CPUs New CPC report header fields: - CPCHCPCN: CPC name The RMF Distributed Data Server lists the values of CPCPHWGN and CPCPHWGC when a request for LPAR resource details is issued. The value of CPCHAMSU will be listed as a MVS_IMAGE attribute and the value of CPCHCPCN as a CPC resource attribute. +--------------------------------------------------------------+ >>> SMF RECORD TYPE 70 TO 79 - RMF PRODUCT SECTION <<< The SMF record level change number SMFxxSRL at offset 51 (x33) changes to 120 (x78). >>> SMF RECORD TYPE 70 SUBTYPE 1 - CPU ACTIVITY <<< The CPU Control Section is changed. OFFSET NAME LEN FORMAT DESCRIPTION ... 94 x5E SMF70HHF 1 binary Additional flags. Bit Meaning When Set 0-3 ... 4 Absolute MSU capping is active for this partition. 5-7 Reserved. The PR/SM Partition Data Section is changed. OFFSET NAME LEN FORMAT DESCRIPTION ... 72 x48 SMF70HWGr_Name 8 EBCDIC Name of the hardware group this partition belongs to. The PR/SM Logical Processor Data Section is changed. OFFSET NAME LEN FORMAT DESCRIPTION ... 12 xC SMF70VPF 1 binary Logical processor flags. Bit Meaning When Set 0-6 ... 7 SMF70HWGrName or SMF70HWGr_Cap_Limit has changed during the interval ... 76 x4C SMF70HWGr_Cap_Limit 4 binary If not zero, absolute limit on partition usage of all CPUs of the type indicated in SMF70CIX which are members of the same hardware group, in terms of a number specified in hundredths of a CPU. +--------------------------------------------------------------+ >>> POSTPROCESSOR OVERVIEW CONDITIONS <<< Following new and changed overview conditions are provided for SMF record type 70 subtype 1: CONDITIONS CONDITION SOURCE ALGORITHM NAME ------------------------+--------+----------+----------------- Absolute physical HGCCP SMF70HWGr_ HWGr_Cap_Limit/100 hardware group capping Cap_Limit limit in numbers of CPUs for general purpose processors ------------------------+--------+----------+----------------- Absolute physical HGCIIP SMF70HWGr_ Same as HGCCP, hardware group capping Cap_Limit but applied to limit in numbers of CPUs zIIPs for zIIP processors ------------------------+--------+----------+----------------- Absolute physical HGCICF SMF70HWGr_ Same as HGCCP, hardware group capping Cap_Limit but applied to limit in numbers of CPUs ICFs for ICF processors ------------------------+--------+----------+----------------- Absolute physical HGCIFL SMF70HWGr_ Same as HGCCP, hardware group capping Cap_Limit but applied to limit in numbers of CPUs IFLs for IFL processors ------------------------+--------+----------+----------------- The Overview conditions can be used with qualifier 'group'.
Problem conclusion
KEYWORDS: E2964/K E2965/K D/T2965 D/T2964
Temporary fix
Comments
KEYWORDS: E2964/K ×**** PE16/05/24 FIX IN ERROR. SEE APAR OA50380 FOR DESCRIPTION
APAR Information
APAR number
OA48688
Reported component name
RMF
Reported component ID
566527404
Reported release
790
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-08-18
Closed date
2016-02-25
Last modified date
2016-05-24
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA80441 UA80442 UA80443 UA80444
Modules/Macros
ERBCPCT3 ERBDUCPU ERBEXCIT ERBEXCPU ERBFMTS3 ERBHDRS3 ERBMFBSR ERBMFDCP ERBMFIZS ERBMFLCV ERBMFLIV ERBMFLJV ERBMFL3J ERBMFL3V ERBMFRCR ERBPCTBL ERBPPASS ERBPPCOM ERBPPCON ERBRMFPP ERBSMFI ERBSMF70 ERB2GWOP ERB2RWOP ERB3CPC0 ERB3CPC2 ERB3CPC4 ERB3CPC7 ERB3GCPC ERB3GCTC ERB3GGSS ERB3GINI ERB3GISS ERB3GSMF ERB3GSMM ERB3GXCF ERB3RACC ERB3RACS ERB3RCCP ERB3RCDC ERB3RCPC ERB3RENC ERB3RGRT ERB3ROTC ERB3RPUT ERB3RSDC ERB3RSYS ERB3RTBR ERB3RWAC ERB3RWFX ERB3SMP2 GPMDDSRV GPMHTC GPMQRYC
SC342667XX | SC342665XX | SC342664XX | SA380667XX |
Fix information
Fixed component name
RMF
Fixed component ID
566527404
Applicable component levels
R7AJ PSY UA80442
UP16/03/08 P F603
R7A0 PSY UA80441
UP16/03/08 P F603
R79J PSY UA80444
UP16/03/08 P F603
R790 PSY UA80443
UP16/03/08 P F603
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:
24 May 2016