A fix is available
APAR status
Closed as new function.
Error description
New function - RMF support for zIIP
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All RMF users. * **************************************************************** * PROBLEM DESCRIPTION: RMF support for the IBM System z9 * * Intergrated Information Processor * * (zIIP) on D/T2094 (z9 EC) and * * D/T2096 (z9 BC). * **************************************************************** * RECOMMENDATION: Sysplex considerations: You may have systems * * in your sysplex with different releases of * * RMF installed. To avoid Monitor III reporter * * problems, always use an RMF reporter version * * that has this APAR installed and that is at * * least equal or higher to the highest RMF * * gatherer version used to collect the data to * * be reported. * **************************************************************** This APAR provides the RMF monitoring support for activity on the IBM System z9 Intergrated Information Processors (zIIP). The support for the zIIP is conceptually similar to the RMF support for the zAAP. Postprocessor and Monitor III reports are extended with measurements about zIIP consumption. SMF record types 70-1, 72-3, 79-1 and 79-2 contain new fields with zIIP measurements. New Postprocessor Overview conditions are provided to watch zIIP activity. A new set of performance metrics for the zIIP is provided which can be displayed by the RMF PM client or via the RMF Monitor III data portal (RMF DDS browser interface). In detail, RMF distinguishes between general purpose CPs and special purpose processors (zAAP and zIIP) where necessary, reports about zIIP consumption and using and delay states for the zIIP. This RMF support becomes active as soon as the hardware requirements are met and the system is running with the IBM zIIP support for z/OS V1.6 (FMID JBB77S9) or z/OS V1.7 (JBB772S) installed. Otherwise, all zIIP fields in SMF record types 70, 72 and 79 have a value of zero and all RMF report fields for zIIP have a value of zero or 'N/A'. Together with this support, RMF provides a consistent naming for zAAPs and zIIPs. The term IFA which was used for the zAAP in all RMF reports, help panels and manuals is now replaced by AAP. That is, AAP is used for the zAAP and IIP is used for the zIIP as report field names. The name change for IFA affects the Postprocessor CPU activity, Partition data and Workload activity (WLMGL) reports, and the Monitor III CPC, System Information and Enclave reports. 1. CHANGED REPORTS 1.1 Postprocessor / Monitor I CPU Activity report The CPU Activity report prints an additional section as soon as zIIPs are available and online. Each zIIP is reported with its online time, LPAR and MVS busy time percentage. In addition, a summary line with the average utilization of all zIIPs is printed. The Partition Data section of the CPU Activity report shows the number of physical zIIPs. If zIIPs are configured, an additional data block is formatted with one line per LPAR exploiting zIIPs followed by the PHYSICAL and TOTAL line for the zIIP resource pool. For zIIPs, the same report columns as for other special purpose processors (zAAPs, IFLs, and ICFs) are printed. Note that the term IFA for zAAPs is replaced by AAP. 1.2 Postprocessor Workload Activity report (WLMGL) The resource consumption section is extended to provide the service time spent on zIIPs (see the IIP field in the SERVICE TIMES block). The APPL% fields for the % of CPU times are moved to a separate block called APPL%. This block is extended by the spent by zIIP eligible work (APPL% IIPCP). This field is a subset of APPL% CP. APPL% IIPCP and IFACP (now called AAPCP) might be reported with values greater zero even without hardware to project zIIP and zAAP consumption (see the PROJECTCPU parmlib option). The Goal versus Actuals section is extended by IIP using and delay state samples. The term IFA for zAAPs is replaced by AAP. In addition, the TCB field of the SERVICE TIMES block is renamed into CPU to better document that the field content is task AND preemptable-class SRB (enclave) time in seconds consumed on standard CPs and special purpose processors. 1.3 Monitor III CPC Capacity Report As soon as zIIPs are configured in the z9 system, additional lines are displayed in the scrollable area of the report. A summary line indicated by *IIP displays the total CPU time percentages for zIIP. The summary line is followed by one line per partition configured with zIIPs and the PHYSICAL line for the zIIP engines. Note that the term IFA for zAAPs is replaced by AAP. 1.4 Monitor III System Information Report (SYSINFO) A new header line is displayed with the number of zIIPs being online and the percentage of CPU time on the zIIPs by all address spaces and enclaves during the report interval (Appl% IIP). In addition, the term IFA is replaced by AAP. ---------------- SYSINFO report header ---------------------- Partition: NP5 2094 Model 716 Appl%: 76 Policy: CPs Online: 5.0 Avg CPU Util%: 82 EAppl%: 76 Date: .. AAPs Online: 1.0 Avg MVS Util%: 82 Appl% AAP: 22 Time: .. IIPs Online: 2.0 Appl% IIP: 72 ------------------------------------------------------------- 1.5 Monitor III Processor Delays Report (PROC) The report displays a new column called CPU TYPE which is the processor type (standard CP, AAP or IIP) to which the delay and using information refers. If the job is using or delayed by different CPU types, a separate line with USG%, DLY%, EAppl% and Holding Job(s) is displayed per type. Because of the limited space on the report screen, the Appl% column (% of CPU time on behalf of the AS) is removed from this report and displayed on the new PROCU report (see below). If you have modified the PROC report by means of the Monitor III utility fields, please consider that following fields are moved from the PROC to the new PROCU report: OLD NAME NEW NAME MEANING PRCPTCBT PRUPTCB TCB time consumed in address space PRCPSRBT PRUPSRB SRB time consumed in address space PRCPPCST PRUPPCS Preemptable or client SRB time PRCPEPST PRUPEPS Preemptable/client SRB and enclave time 1.6 Monitor III Processor Usage Report (PROCU) The new Processor Usage report (PROCU) displays all jobs that were using a general or special purpose processor during the report interval. RMF reports the jobs by descending overall CPU time. The report gives you information about the percentage of CPU time on general purpose CPs consumed on behalf of the job. In addition, the percentage of CPU time used by work that is eligible for being offloaded to a Application Assist (zAAP) or Integrated Information (zIIP) processor is shown. This can be used to understand the benefit of adding a zAAP or zIIP into the configuration. The EAppl fields display the percentage of task, SRB and enclave CPU time consumed within the address space on general (CP) or special (zAAP and zIIP) purpose processors. The report can be selected with option <1A> from the RMF Resource Report Selection Menu or by the command PROCU. For further details about the PROCU report, please refer to the Extended Online Help of this report. The reports looks like the following example: ------------------ PROCU - Processor Usage -------------------- Samples: 60 System: JF0 Date: 06/07/06 Time: 05.00.00 ... Service --- Time on CP % --- ----- EAppl % ----- Jobname CX Class Total AAP IIP CP AAP IIP DBS3DIST SO DB2HIGH 100.6 0.0 0.1 111.0 0.0 21.3 WSWS7 O OMVS 59.4 0.0 0.0 59.4 0.0 0.0 XCFAS S SYSTEM 24.1 0.0 0.0 24.1 0.0 0.0 WSP1S2F SO WASCR 14.0 0.1 0.0 14.0 2.6 0.0 ... --------------------------------------------------------------- 1.7 Monitor III Enclave Report The Enclave Details pop-up panel is extended with information about zAAP and zIIP consumption: - CPU time includes time on the zAAP as well as on the zIIP - Total zAAP/zIIP time consumed by the enclave - zAAP/zIIP time consumed by enclave in Mon III range (Delta) - Percentage of zIIP using and delay samples - Term IFA replaced by AAP in State Sample section ----------------- ENCLAVE pop-up ---------------------------- - CPU Time - -zAAP Time - -zIIP Time - Total 26.78 Total 0.00 Total 6.33 Delta 22.50 Delta 0.00 Delta 1.01 State --- Using% ---- ---- Execution Delays% ---- IDL UNK Samples CPU AAP IIP I/O CPU AAP IIP I/O STO CAP QUE 592 11 0.0 1.0 0.0 88 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.3 Classification Attributes: ... ------------------------------------------------------------- 2. WORKSTATION FEATURES 2.1 SPREADSHEET REPORTER VERSION 5.2.1 A new Spreadsheet Reporter version is shipped which processes the changed layout of the Postprocessor CPU and WLMGL report. Please download and install the new version of the Spreadsheet Reporter as described in the RMF User's Guide. 2.2 NEW RMF PM / DDS PERFORMANCE METRICS The RMF Distributed Data Server (DDS) is extended to provide the same variety of metrics for the zIIP as for the zAAP (IFA). These metrics can be displayed either via an RMF PM client or via the RMF Monitor III Data Portal (RMF DDS Browser Interface). In addition, the term IFA in the description of all zAAP related metrics is replaced by the term AAP. 3. NEW OVERVIEW CONDITIONS Following NEW Postprocessor overview and exception conditions are provided CONDITION NAME QUALIFIER SOURCE & ALGORITHM --------------------+-------+--------+------------------------ + # of zIIPs online NUMIIP cpu_id SMF70SUP + CPU busy% for zIIP IIPBSY cpu_id like CPUBSY + MVS busy% for zIIP IIPMBSY cpu_id like MVSBSY but for + zIIP SUs/second IIPSRV type SUM(R723CSUP) / SMF72INT + zAAP SUs/second AAPSRV type SUM(R723CIFA) / SMF72INT + zIIP on CP SUs/sec IIPCPSRV type SUM(R723CSUC) / SMF72INT + zAAP on CP SUs/sec AAPCPSRV type SUM(R723CIFC) / SMF72INT + zIIP service time IIPSEC type SUM((R723CSUP*R723MADJ) in seconds / (1600*R723MCPU)) + zIIP service time IIPNSEC type IIPSEC * R723NFFS / 256 normalized + zIIP service time IIPSEC type SUM((R723CSUC*R723MADJ) on CPs in seconds / (1600*R723MCPU)) + zIIP APPL% APPLIIP type IIPSEC*100 / SMF72INT + zIIP on CP APPL% APPLIPCP type IIPCPSEC*100 / SMF72INT + zIIP delay % IIPDLYP period R723SUPD*100 / R723CTSA + zIIP using % IIPUSGP period R723SUPU*100 / R723CTSA + zIIP on CP using % IPCUSGP period R723SUCU*100 / R723CTSA For the meaning of qualifiers CPU_ID, TYPE and PERIOD refer to the RMF User's Guide, SC33-7990, chapter 17. To use consistent terms for zIIP and zAAP (IFA) based OVW conditions, an alternate set of condition names for NUMIFA, CPUIBSY, MVSIBSY, IFASEC, IFANSEC, IFACPSEC, APPLIFA, APPLIFCP, IFAUSGP, IFCUSGP, and IFADLYP is provided. The new names are NUMAAP, AAPBSY, AAPMBSY, AAPSEC, AAPNSEC, AAPCPSEC, APPLAAP, APPLAPCP, AAPUSGP, APCUSGP, and AAPDLYP. 4. CHANGED SMF RECORDS 4.1 SMF RECORD TYPES 70 TO 79 RMF PRODUCT SECTION - The SMF record level change number SMFxxSRL at offset 51 (x33) changes to 75 (x4B) - Bit 5 of SMFxxPRF at offset 49 (x31) is added to indicate whether zIIPs are available in the system. 4.2 SMF RECORD TYPE 70 SUBTYPE 1 (CPU ACTIVITY) - The CPU control section is extended to hold the number of zIIPs being online at the end of the measurement interval - Field SMF70TYP of the CPU data section has a value of 2 if the CPU type is a zIIP - There are six CPU identification sections on a z9 EC or BC. The last section holds an EBCDIC name string of 'IIP' for the zIIP. Accordingly, the value range of SMF70CIX (index into CPU identification section) changes. Valid values are 1 (CP), 3 (IFA), 4 (IFL), 5 (ICF), or 6 (IIP). - The CPU identification section is extended by field SMF70CTN which holds the number of physical CPUs of the type described by SMF70CIN. OFFSETS NAME LEN FORMAT DESCRIPTION CPU control section: 64 x40 SMF70SUP 4 Binary Number of zIIPs online at the end of the interval CPU identification section: 0 x00 SMF70CIN 16 EBCDIC CPU-identification name 16 x10 SMF70CTN 2 Binary Number of physical CPUs of type 18 x12 2 Reserved 4.3 SMF RECORD TYPE 72 SUBTYPE 3 (WORKLOAD ACTIVITY) - The control section is extended by the zIIP normalization factor. Multiply zIIP service units with this value and divide by 256 to calculate the CP equivalent value. - The service/report class period data section is extended by zIIP using and delay states as well as zIIP service unit consumptions. - zAAP (IFA) consumption is now also reported in terms of service units (see fields R723CIFA and R723CIFC). Fields R723IFAT (at offest x204) and R723IFCT (at offset x20C), which report zAAP consumption in terms of service time in microseconds are still valid. Workload manager control section: 244 xF4 R723NFFS 4 Binary Normalization factor for zIIP Service / Report class period data section: 532 x214 R723SUPU 4 Binary zIIP using samples 536 x218 R723SUCU 4 Binary zIIP on CP using samples (included in R723CCUS) 540 x21C R723SUPD 4 Binary zIIP delay samples 544 x220 R723CSUP 8 Float zIIP service units 552 x228 R723CSUC 8 Float zIIP service units spent on CPs 560 x230 R723CIFA 8 Float zAAP service units 568 x238 R723CIFC 8 Float zAAP service units spent on CPs 4.4 SMF RECORD TYPE 79 SUBTYPE 1 (ADDRESS SPACE STATE DATA) 208 xD0 R791TSUP 4 Binary CPU time consumed on zIIPs (ASSB_TIME_ON_zIIP) 212 xD4 R791TSUC 4 Binary CPU time consumed on standard CPs by zIIP eligible work (ASSB_TIME_zIIP_ON_CP) 216 xD8 R791NFFS 4 Binray Normalization factor for zIIP 4.5 SMF RECORD TYPE 79 SUBTYPE 2 (ADDRESS SPACE RESOURCE DATA) 196 xC4 R792TSUP 4 Binary CPU time consumed on zIIPs (ASSB_TIME_ON_zIIP) 200 xC8 R792TSUC 4 Binary CPU time consumed on standard CPs by zIIP eligible work (ASSB_TIME_zIIP_ON_CP) 204 xCC R792NFFS 4 Binray Normalization factor for zIIP 5. RMF MONITOR II DATA INTERFACES RMF Monitor II data retrieval services ERBSMFI, ERB2XDGS and ERB2XD64 are extended to return the system's zIIP utilization in addition to the system's zAAP utilization. This new value is the average LPAR busy time percentage of all zIIPs online during the measurement interval: SUM( zIIP Partition Dispatch Time ) zIIP UTIL% = ------------------------------------- x 100 SUM( zIIP Online Time ) For further details about the Monitor II data interfaces, refer to the RMF Programmer's Guide, SC33-7994, chapter 1 and 2. 5.1 ERBSMFI - RMF DATA INTERFACE SERVICE FOR MONITOR II The parameter list passed by the caller to the RMF Monitor II data interface service contains currently up to 10 parameters. With this APAR, the ERBSMFI service accepts an 11th parameter with a new request type of 5 (specified as 1st parameter). Parameter 11 is a fullword which returns the system's zIIP utilization. This is the percentage of CPU time spent on zIIPs. 5.2 ERB2XDGS/ERB2XD64 - MON II SYSPLEX DATA GATHERING SERVICE With this APAR, the answer area's data header is changed. Word 14, which was reserved, returns the zIIP utilization. OFFSETS NAME LEN FORMAT DESCRIPTION : : : : : : 52 x34 ZIP 4 binary System CPU Utilization of zIIPs. If Monitor I CPU gathering is not active, this field has the value -1. 6. CHANGED MONITOR III DATA SET AND TABLE FORMATS The ERBRCDG3 (Resource collection data), the ERBASIG3 (Address space identification table) and the ERBCPUG3 (Processor data) are extended as follows: -OFFSETS-NAME----LEN-FORMAT--DESCRIPTION----------------------- The RCDG3 HEADER is extended at offset 104: 104 x68 RCDNFFS 4 binary Normalization factor for zIIP. Multiply zIIP service units with this value and divide by 256 to calculate the CP equivalent value The RCDG3 PERIOD ENTRY is extended at offset 128: 128 x80 RCDIFASU 8 binary Total zAAP service units 136 x88 RCDIFASUC 8 binary Total zAAP on CP service units 144 x90 RCDSUPSU 8 binary Total zIIP service units 152 x98 RCDSUPSUC 8 binary Total zIIP on CP service units The CPUG3 data control block is changed starting at offset 92: 92 x5C SUCON 4 binary zIIPs online at end of range 96 x60 NUMSUCOL 4 binary Accumulated number of zIIPs online. To get average number, divide by number of samples. 100 x64 NUMPRSUP 8 binary Accumulated online time of zIIPs in microseconds 108 x6C LOGITSUP 8 binary Logical CPU time: The sum of MVS NON_WAIT time of all online logical zIIPs in the time range (in microseconds) 116 x74 PHYSTSUP 8 binary Physical CPU time: The sum of all CPU times used by all online logical zIIPs in the time range (in microseconds) 124 x7C * 4 Reserved The ASIG3 TABLE ENTRY is extended at offset 348: 356 x164 ASISUCCP 2 binary CP using samples (single state) 358 x166 ASISUCSP 2 binary zIIP using samples (single state) 360 x168 ASISUCSC 2 binary zIIP on CP using samples (single state) 362 x16A ASISDCSP 2 binary zIIP delay samples (single state) 364 x16C ASITIIP 4 binary Accumulated zIIP time 368 x170 ASITIIPCP 4 binary Accumulated zIIP on CP time 372 x174 ASIPHTMZA 4 binary Preemptable-class SRB time for zAAPs in microseconds 376 x178 ASIPHTMZI 4 binary Preemptable-class SRB time for zIIPs in microseconds
Problem conclusion
KEYWORDS: ZIIP/K
Temporary fix
Comments
none ž**** PE06/07/06 FIX IN ERROR. SEE APAR OA17089 FOR DESCRIPTION
APAR Information
APAR number
OA13499
Reported component name
RMF
Reported component ID
566527404
Reported release
708
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function
Submitted date
2005-09-23
Closed date
2006-06-16
Last modified date
2008-11-18
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA90251 UA90252 UA90253 UA90254
Modules/Macros
ERBBDCSY ERBBMENU ERBCMDS ERBCPACC ERBCPSMF ERBCPTIM ERBCSCCE ERBDRHDR ERBDSM2S ERBDUCPU ERBEXCIT ERBEXC ***This field was truncated. To obtain the full apar record, please contact your local support center.***
Fix information
Fixed component name
RMF
Fixed component ID
566527404
Applicable component levels
R7J8 PSY UA90252
UP06/06/30 P F606
R708 PSY UA90251
UP06/06/30 P F606
R72J PSY UA90254
UP06/06/30 P F606
R720 PSY UA90253
UP06/06/30 P F606
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.
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.