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.5 (HBB77D0) and above. * **************************************************************** * PROBLEM DESCRIPTION: * * NEW FUNCTION - IBM z17 support * * * * The IRACPMB programming interface * * information is updated. Channel Path * * Measurement Block CPMB is extended by * * mappings for Channel Measurement * * Group 4 and 5. * * * * The REQLPDAT SYSEVENT allows to * * obtain performance data related to a * * defined capacity. For example, * * defined capacity and group capping * * can be used with Sub-Capacity pricing * * models. The parameter area for * * REQLPDAT is mapped by macro IRALPDAT * * and is extended by model-replacement * * capacity values. * * * * R9175/K * **************************************************************** * RECOMMENDATION: * **************************************************************** New function (1) IRACPMB programming interface information The Channel Path Measurement Block IRACPMB is extended by mappings for Channel Measurement Group 4 and 5. - Field CMC2IOEN is added to the Channel Measurement Characteristics Block. - Additional mappings for the CMC2DATA field are available (CMC2CMG4 and CMC2CMG5) - Additional mappings for the CPM2DATA field are available (CPM2CMG4 and CPM2CMG5) - The Extended Channel Utilization block CPMX is updated by additional mappings for the CPMXDATA field (CPMXCMG4 and CPMXCMG5). OFFSET DEC HEX TYPE LEN NAME (DIM) DESCRIPTION --- ---- -------------- ----------------------------------- 0 (0) STRUCTURE 8192 CMC2 Channel Measurement Characteristics for CPM2 0 (0) CHARACTER 32 CMC2CHANMEASUREMENTCHARBLOCK(0:255) Channel Measurement Characteristics Block ... 7 (7) UNSIGNED 1 CMC2CMG Channel measurement group for this CHPID 8 (8) CHARACTER 1 * Reserved 9 (9) UNSIGNED 1 CMC2IOEN Number of the I/O engine the measurement is for when the CMC2CMG field contains a value of 4 or 5, otherwise reserved ... 12 (C) CHARACTER 20 CMC2DATA Channel measurement characteristics data. The CMC2DATA field is only valid for any Channel Measurement Group (CMC2CMG) of CMG=2-5. CMC2CMG4 maps the CMC2DATA field when the Channel Measurement Group (CMC2CMG) for this CHPID is 4. CMC4MaxBusyCycles Maximum Bus Cycles: Word 3 Contains an unsigned binary integer specifying the maximum internal bus cycles per second, available for I/O operations on the specified channel path. CMC4MaxChannelWorkUnits Maximum Channel Work Units: Word 4 contains an unsigned binary integer specifying the maximum number of channel work units that can be performed per second by the specified channel path. CMC4MaxWriteDataUnits Maximum Write Data Units: Word 5 contains an unsigned binary integer specifying the maximum number of data units that can be written per second using the specified channel path. CMC4MaxReadDataUnits Maximum Read Data Units: Word 6 contains an unsigned binary integer specifying the maximum number of data units that can be read per second using the specified channel path. CMC4NumOfIoeCores Number of IOE Cores: Word 7, byte 0, contains an unsigned nonzero binary integer specifying the number of I/O engine (IOE) cores available. CMC4DataUnitSize Data Unit Size: Word 7, bytes 1-3, contains an unsigned nonzero binary integer specifying the number of bytes of data that are contained in a data unit for the specified channel path. OFFSET DEC HEX TYPE LEN NAME --- ---- ------------- ------------------------------------ 0 (0) STRUCTURE 20 CMC2CMG4 0 (0) UNSIGNED 4 CMC4MAXBUSCYCLES 4 (4) UNSIGNED 4 CMC4MAXCHANNELWORKUNITS 8 (8) UNSIGNED 4 CMC4MAXWRITEDATAUNITS 12 (C) UNSIGNED 4 CMC4MAXREADDATAUNITS 16 (10) UNSIGNED 1 CMC4NUMOFIOECORES 17 (11) UNSIGNED 3 CMC4DATAUNITSIZE CMC2CMG5 maps the CMC2DATA field when the Channel Measurement Group (CMC2CMG) for this CHPID is 5. Format of CMG=5 Channel-Measurement-Characteristics entry (CMC2CMG5) equals format of CMG=4 Channel-Measurement- Characteristics entry (CMC2CMG4). OFFSET DEC HEX TYPE LEN NAME --- ---- ------------- ------------------------------------ 0 (0) STRUCTURE 20 CMC2CMG5 0 (0) UNSIGNED 4 CMC5MAXBUSCYCLES 4 (4) UNSIGNED 4 CMC5MAXCHANNELWORKUNITS 8 (8) UNSIGNED 4 CMC5MAXWRITEDATAUNITS 12 (C) UNSIGNED 4 CMC5MAXREADDATAUNITS 16 (10) UNSIGNED 1 CMC5NUMOFIOECORES 17 (11) UNSIGNED 3 CMC5DATAUNITSIZE CPM2CMG4 maps the CPM2DATA field when the Channel Measurement Group (CMG) for this CHPID is 4. Format of CMG=4 channel-utilization entry (CPM2CMG4) equals format of CMG=2 channel-utilization entry (CPM2CMG2). OFFSET DEC HEX TYPE LEN NAME --- ---- ------------- ----------------------------------- 0 (0) STRUCTURE 28 CPM2CMG4 0 (0) UNSIGNED 4 CMG4TOTALBUSCYCLECOUNT 4 (4) UNSIGNED 4 CMG4TOTALCHANNELWORKUNITCOUNT 8 (8) UNSIGNED 4 CMG4LPARCHANNELWORKUNITCOUNT 12 (C) UNSIGNED 4 CMG4TOTALWRITEDATAUNITS 16 (10) UNSIGNED 4 CMG4LPARWRITEDATAUNITS 20 (14) UNSIGNED 4 CMG4TOTALREADDATAUNITS 24 (18) UNSIGNED 4 CMG4LPARREADDATAUNITS CPM2CMG5 maps the CPM2DATA field when the Channel Measurement Group (CMG) for this CHPID is 5. Format of CMG=5 channel-utilization entry (CPM2CMG5) equals format of CMG=2 channel-utilization entry (CPM2CMG2). OFFSET DEC HEX TYPE LEN NAME --- ---- ------------- ------------------------------------ 0 (0) STRUCTURE 28 CPM2CMG5 0 (0) UNSIGNED 4 CMG5TOTALBUSCYCLECOUNT 4 (4) UNSIGNED 4 CMG5TOTALCHANNELWORKUNITCOUNT 8 (8) UNSIGNED 4 CMG5LPARCHANNELWORKUNITCOUNT 12 (C) UNSIGNED 4 CMG5TOTALWRITEDATAUNITS 16 (10) UNSIGNED 4 CMG5LPARWRITEDATAUNITS 20 (14) UNSIGNED 4 CMG5TOTALREADDATAUNITS 24 (18) UNSIGNED 4 CMG5LPARREADDATAUNITS Extended Channel Utilization block. The extended-channel-utilization block contains 256, 16-word channel-utilization entries corresponding to CHPIDs 0-255, in sequential order. OFFSET DEC HEX TYPE LEN NAME --- ---- --------------- ---------------------------------- 0 (0) STRUCTURE 16384 CPMX Extended Channel Utilization Block 0 (0) CHARACTER 64 CPMXCHANNELUTILIZATIONENTRY(0:255) Extended Channel Utilization Entry 0 (0) CHARACTER 64 CPMXDATA Extended channel measurement group data. The CPMXDATA field is only valid for any Channel Measurement Group (CMC2CMG) of CMG=2, CMG=4, and CMG=5. CPMXCMG4 maps the CPMXDATA field when the Channel Measurement Group (CMC2CMG) for this CHPID is 4. CPMX4ChannelExecTime Channel Execution Time / Cycles: Word 0 contain a 32-bit unsigned binary integer that indicate the channel execution time/cycles for this channel has been active, including the one being initiated, is added to this field. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back zero. CPMX4TotalIoeExecTime Total I/O Engine (IOE) Execution Time / Cycles: Word 1 contain a 32-bit unsigned binary integer that indicate the I/O Engine (IOE) complex execution time/ cycles for this channel has been active, including the one being initiated, is added to this field. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back to zero. Words 2-15 are reserved and set to zero. OFFSET DEC HEX TYPE LEN NAME --- ---- ------------- ---------------------------------- 0 (0) STRUCTURE 64 CPMXCMG4 CMG=4 extended data 0 (0) UNSIGNED 4 CPMX4CHANNELEXECTIME 4 (4) UNSIGNED 4 CPMX4TOTALIOEEXECTIME 8 (8) CHARACTER 56 CPMX4RESERVED CPMXCMG5 maps the CPMXDATA field when the Channel Measurement Group (CMC2CMG) for this CHPID is 5. CPMX5ChannelExecTime Channel Execution Time / Cycles: Word 0 contain a 32-bit unsigned binary integer that indicate the channel execution time/cycles for this channel has been active, including the one being initiated, is added to this field. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back zero. CPMX5TotalIoeExecTime Total I/O Engine (IOE) Execution Time / Cycles: Word 1 contain a 32-bit unsigned binary integer that indicate the I/O Engine (IOE) complex execution time/ cycles for this channel has been active, including the one being initiated, is added to this field. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back to zero. CPMX5TotalCountOps Total Count of FICON Command-Mode Operations (CPC): Word 2 contains a 32-bit unsigned binary integer that specifies the total number of FICON command-mode operations that have been attempted by the channel. Each time a FICON command-mode device-level operation, excluding device reconnections but including device- level control operations, or a FICON link-level operation is initiated, the channel increments this count by one. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back to zero. CPMX5TotalCountOpsDeferred Total Count of Deferred FICON Command-Mode Operations (CPC) : Word 3 contains a 32-bit unsigned binary integer that specifies the total number of FICON command-mode operations that could not be initiated by the channel due to lack of available resources. Each time the channel receives a request to perform a FICON command-mode operation but does not attempt to initiate the operation due to a lack or resources, the channel increments this count by one. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back to zero. CPMX5SummationCountOps Summation Count of FICON Command-Mode Operations (CPC): Words 4-5 contain a 64-bit unsigned binary integer that contains a summation of the FICON command-mode operations that have been attempted by the channel. When word 2 is incremented, the number of FICON command-mode operations active at the channel, including the one being initiated, is added to this field. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(64)-1, it wraps back to zero. CPMX5TotalCountOpsFCX Total Count of FICON Transport-Mode Operations (CPC): Word 6 contains a 32-bit unsigned binary integer that specifies the total number of FICON transport- mode operations that have been attempted by the channel. Each time a FICON transport-mode device-level operation is initiated, the channel increments this count by one. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back to zero. CPMX5TotalCountOpsFCXDeferred Total Count of Deferred FICON Transport-Mode Operations (CPC) : Word 7 contains a 32-bit unsigned binary integer that specifies the total number of transport-mode operations that could not be initiated by the channel due to a lack of available resources. Each time the channel receives a request to perform a FICON transport-mode operation but does not attempt to initiate the operation due to a lack or resources, the channel increments this count by one. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(32)-1, it wraps back to zero. CPMX5SummationCountOpsFCX Summation Count of FICON Transport-Mode Operations (CPC) : Words 8-9 contain a 64-bit unsigned binary integer that indicates the summation of transport- mode operations attempted by the channel. Each time word 6 is incremented, the number of transport-mode operations active at the channel, including the one being initiated, is added to this field. The count is for all logical partitions that have access to the associated channel path. When the count exceeds 2(64)-1, it wraps back to zero. Words 10-15 are reserved and set to zero. OFFSET DEC HEX TYPE LEN NAME --- ---- ------------- ----------------------------------- 0 (0) STRUCTURE 64 CPMXCMG5 CMG=5 extended data 0 (0) UNSIGNED 4 CPMX5CHANNELEXECTIME 4 (4) UNSIGNED 4 CPMX5TOTALIOEEXECTIME 8 (8) UNSIGNED 4 CPMX5TOTALCOUNTOPS 12 (C) UNSIGNED 4 CPMX5TOTALCOUNTOPSDEFERRED 16 (10) CHARACTER 8 CPMX5SUMMATIONCOUNTOPS 24 (18) UNSIGNED 4 CPMX5TOTALCOUNTOPSFCX 28 (1C) UNSIGNED 4 CPMX5TOTALCOUNTOPSDEFERREDFCX 32 (20) CHARACTER 8 CPMX5SUMMATIONCOUNTOPSFCX 40 (28) CHARACTER 24 CPMX5RESERVED (2) IRALPDAT programming interface information The Sysevent REQLPDAT parameter list IRALPDAT is extended by model-replacement capacity values starting at decimal offset 188. In addition, the description of LPDATIMGCAPZCBP, LPDATCECCAPZCBP, and LPDATAVGIMGSERVICEZCBP is updated to indicate that these 3 fields are always zero. OFFSET DEC HEX TYPE LEN NAME DESCRIPTION --- ---- ------------- ----------------------------------- 0 (0) STRUCTURE 208 LPDATMAP 0 (0) CHARACTER 4 LPDATINOUT Input/Output fields 0 (0) UNSIGNED 4 LPDATLEN Length of area. If SYSEVENT REQLPDAT fails with return code of 4, this field can be examined to obtain correct size of the parameter list 4 (4) CHARACTER 204 LPDATOUT Output fields 4 (4) UNSIGNED 1 LPDATVER Version ... 176 (B0) UNSIGNED 4 LPDATIMGCAPZCBP Logical partition zCBP capacity, always zero since zCBP revoked 180 (B4) UNSIGNED 4 LPDATCECCAPZCBP CEC zCBP capacity, always zero since zCBP revoked 184 (B8) UNSIGNED 4 LPDATAVGIMGSERVICEZCBP Long-term average zCBP service used by this logical partition, always zero 188 (BC) CHARACTER 20 LPDATMODELREPLCAP Model-replacement capacity values, available with version 7 188 (BC) CHARACTER 16 LPDATMODELREPLCAPIDENT The 16-character (0-9 or uppercase A-Z) EBCDIC model-replacement capacity identifier of the configuration. The identifier is left justified with trailing blanks if necessary. Valid only if non-zero. 204 (CC) UNSIGNED 4 LPDATMODELREPLCAPRATING When non-zero, an unsigned integer whose value is associated with the model- replacement capacity as identified by the model- replacement capacity identifier. There is no formal description of the algorithm used to generate this integer. 208 (D0) CHARACTER 0 LPDATEND1 End on a word boundary
Problem conclusion
Temporary fix
Comments
APAR Information
APAR number
OA66054
Reported component name
WORK LOAD MANAG
Reported component ID
5752SCWLM
Reported release
7E0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2024-01-25
Closed date
2025-04-22
Last modified date
2025-05-14
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UJ97002 UJ97028
Modules/Macros
IRAEVLPD IRAEVSSI IRASRCPC IRACPMB IRALPDAT
Fix information
Fixed component name
SRM - SYS RSRCE
Fixed component ID
5752SC1CX
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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19O"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"7E0"}]
Document Information
Modified date:
14 May 2025