A fix is available
APAR status
Closed as new function.
Error description
New Function - RMF Reporting of z15 Compression activity
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: RMF users. * **************************************************************** * PROBLEM DESCRIPTION: * * RMF reporting of Compression activity * * on the IBM z15 server * * (E8561/K). * **************************************************************** With this APAR, RMF is enhanced to report performance metrics for asynchronous compression and decompression activity. Compression and decompression requests are directed to the Extended Asynchronous Data Mover (EADM) for execution on an IOP. RMF Monitor I collects utilization information of IOP resources used by EADM-Compression. The returned utilization information is stored into SMF 78 subtype 3 and is used by the RMF Postprocessor to report the percentage of IOP Busy for EADM Compression activity in the I/O Queuing Activity report. In addition, the RMF Postprocessor and Monitor III SCM Activity reports are renamed to EADM Activity reports. Both reports continue to provide RMF users with SCM activity data. The number of Compress and Decompress operations as well as the number of input and output bytes for asynchronous compression and decompression are stored into SMF 74 subtype 10 and into the Monitor III Set-of-Samples. These numbers are used by the RMF Postprocessor and Monitor III to calculate and display compression and decompression request rates, throughput and ratios in the new Compression Activity report section of the Postprocessor EADM Activity report and in the Monitor III EADM Activity report header section. +--------------------------------------------------------------+ >>>>> SMF RECORD TYPE 70 TO 79 - RMF PRODUCT SECTION <<<<< The SMF record level change number SMFxxSRL at offset 51 (x33) changes to 141 (x8D). +--------------------------------------------------------------+ >>>>> SMF RECORD TYPE 78 SUBTYPE 3 - VSTOR ACTIVITY <<<<< Bit 1 of field R783GFLX in the I/O Queueing Global section indicates whether the EADM compression facility is available or not. Two new fields are added to the IOP Initiative Queue and Utilization data section: Offsets Name Len Format Description -------------------------------------------------------------- 80 50 R783ISCB 8 floating Number of times the I/O processor was busy with SCM operations 88 58 R783IECB 8 floating Number of times the I/O processor was busy with compression or decompression 96 60 8 Reserved. +--------------------------------------------------------------+ >>>>> SMF RECORD TYPE 74 SUBTYPE 10 - EADM ACTIVITY <<<<< New fields are added to the EADM device information data section: Offsets Name Len Format Description -------------------------------------------------------------- 32 20 R7410DFLG 1 binary Device information flags Bit Meaning when set 0 EADM-compression facility available 1-7 Reserved 33 21 7 binary Reserved 40 28 R7410DOCC 4 binary Number of compression operations 44 2C R7410DOCD 4 binary Number of decompression operations 48 30 R7410DISC 8 binary Number of 1 MB input blocks consumed for compression 56 38 R7410DOSC 8 binary Number of 1 MB output blocks consumed for compression 64 40 R7410DISD 8 binary Number of 1 MB input blocks consumed for decompression 72 48 R7410DOSD 8 binary Number of 1 MB output blocks consumed for decompression +--------------------------------------------------------------+ >>>>> SCM EADM ? Tabular report data table ERBSCMT3 <<<<< New fields are added to the SCM EADM report header. Name Type Meaning Report SCMHRRC N Compression request rate (EADM) Yes SCMHTPC N Compression throughput (EADM) Yes SCMHRCC N Compression ratio (EADM) Yes SCMHRRD N Decompression request rate (EADM) Yes SCMHTPD N Decompression throughput (EADM) Yes SCMHRCD N Decompression ratio (EADM) Yes +--------------------------------------------------------------+ >>>>> Monitor III data gatherer session options <<<<< Monitor III data gathering options EADM (default) and NOEADM can be used to control data gathering for EADM activity report. They replace existing options SCM and NOSCM. However, SCM and NOSCM can still be used for compatibility purposes. The new EADM option is specified in ERBRMF04 which is the default parmlib member for Monitor III data gatherer sessions. +--------------------------------------------------------------+ >>>>>> POSTPROCESSOR I/O Queuing Activity Report <<<<<< Report section INPUT/OUTPUT PROCESSORS reports the new metric IOP UTILIZATION % CMPR BUSY for all I/O processors. It reflects the ratio of the number of times the IOP was found busy with EADM-compression work (compress or decompress) to the total number of I/O processor samples. # EADM-compression busy samples % CMPR BUSY = --------------------------------- * 100 # Busy samples + # Idle samples +--------------------------------------------------------------+ >>>>>> POSTPROCESSOR EADM Activity Report <<<<<< The EADM Activity Report provides statistics and performance measurements on EADM activity which encompasses Storage Class Memory (SCM) activity and EADM compression activity. To produce the report, specify REPORTS(EADM) Note: The report was formerly called SCM Activity Report. Keyword SCM is accepted with the same meaning as EADM. The EADM Activity Report consists of three segments: 1. EADM Device/subchannel level information. 2. Compression activity information. This segment provides the following metrics: Compression Request Rate: The number of compression requests per second. Compression Throughput: The number of megabytes compressed per second. Compression Ratio: The ratio between input and output bytes compressed within this interval. Decompression Request Rate: The number of decompression requests per second. Decompression Throughput: The number of megabytes decompressed per second. Decompression Ratio: The ratio between input and output bytes decompressed within this interval. 3. Storage Class Memory activity information. In addition, the new Overview condition IOPECB is added to the RMF Postprocessor. Condition Name Qualifier Algorithm Percent IOP busy IOPECB iopid (R783IECB * 100) / busy with EADM (R783IIPB + R783IIPI) compression +--------------------------------------------------------------+ >>> Monitor III EADM Activity Report <<< The EADM Activity report can be used to investigate performance problems that are related to the extended asynchronous data mover facility. To request the EADM Activity Report, select a 3 from the Primary Menu, then select 15 from the Resource Report Selection Menu or enter command EADM. Note: The report was formerly called SCM Activity Report. Command SCM is accepted with the same meaning as EADM. The EADM Activity report provides these types of information: 1. EADM device/subchannel level information. The values cover Storage Class Memory (SCM) activity as well as EADM compression and decompression activity. Furthermore, the section provides statistics on asynchronous compression activity by EADM. The following metrics are reported: Compress: Rate The number of compression requests per second. Compress: Throughput The number of bytes compressed per second. Compress: Ratio The ratio between input and output bytes compressed within this interval. Decompress: Rate The number of decompression requests per second. Decompress: Throughput The number of bytes decompressed per second. Decompress: Ratio The ratio between input and output bytes decompressed within this interval. Synchronous compression activity is not reported. 2. Storage Class Memory activity information +--------------------------------------------------------------+ >>> Modified RMF messages <<< ERB629I EADM activity data is currently not available. Explanation: Within the current report interval, RMF can not report any EADM activity. This could be caused by any of the following reasons: - There was no EADM activity - EADM activity data was not collected (Monitor III Gatherer option NOEADM was specified) - EADM is not supported by the processor - There is backlevel data in the allocated VSAM data set System action: RMF waits for the next input User response: Press END (PF3) to return to the previous panel. GPM0633I No data: EADM activity data is currently not available. Explanation: Within the current report interval, RMF can not report any EADM activity. This could be caused by any of the following reasons: - EADM activity data was not collected (Monitor III Gatherer option NOEADM was specified) - EADM is not supported by the processor System action: None. System programmer response: Start the Monitor III gatherer with the option EADM. KEYWORDS: E8561/K SMFREC/K
Problem conclusion
Temporary fix
Comments
APAR Information
APAR number
OA56684
Reported component name
RMF
Reported component ID
566527404
Reported release
7A0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2018-12-13
Closed date
2019-08-29
Last modified date
2019-10-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UJ00594 UJ00595 UJ00596 UJ00597 UJ00605 UJ00606 UJ00607 UJ00608
Modules/Macros
ERB2GLLI ERB2RDPC ERB3BFN ERB3CCCA ERB3CGAT ERB3GCTC ERB3GISS ERB3GMEM ERB3GMRC ERB3GSMF ERB3GSMM ERB3RCHK ERB3RCTL ERB3RD1 ERB3RD2 ERB3RES ERB3RES0 ERB3RHCY ERB3RPUT ERB3RSCM ERB3RSDC ERB3RTBR ERB3SCM0 ERB3SCM1 ERB3SCM2 ERB3SCMF ERB3SCMP ERB3SMP2 ERB3XPH1 ERB3YPH1 ERB4MAIN ERB62 ERB629I0 ERBCM326 ERBCMDS ERBDUIGQ ERBDUSCM ERBEXCIT ERBEXIGQ ERBFMTS3 ERBGPGSP ERBHDRS3 ERBLEXAN ERBMFDCQ ERBMFDCY ERBMFDGQ ERBMFDPC ERBMFECQ ERBMFINC ERBMFIOQ ERBMFIT1 ERBMFIZS ERBMFL3J ERBMFL3V ERBMFLMV ERBMFLQV ERBMFRGR ERBOPTAB ERBPCTBL ERBPHDS3 ERBPPCON ERBPPRSM ERBR7410 ERBRMF04 ERBRMFPP ERBSCMT3 ERBSMF78 ERBSMFI ERBSTGST GPMCSVM3 GPMDDSRV GPMHTC GPMINI GPMXMLM3
Fix information
Fixed component name
RMF
Fixed component ID
566527404
Applicable component levels
R7C0 PSY UJ00597
UP19/09/07 P F909
R7CJ PSY UJ00608
UP19/09/07 P F909
R790 PSY UJ00594
UP19/09/07 P F909
R7A0 PSY UJ00595
UP19/09/07 P F909
R7B0 PSY UJ00596
UP19/09/07 P F909
R7AJ PSY UJ00606
UP19/09/07 P F909
R7BJ PSY UJ00607
UP19/09/07 P F909
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":"7A0","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":"7A0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 October 2019