A fix is available
APAR status
Closed as new function.
Error description
New function: RMF support for coupling facility channel path types CIB or CFP on the IBM zEnterprise EC12 (zEC12) server .
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: RMF users . * **************************************************************** * PROBLEM DESCRIPTION: RMF support for coupling facility * * channel path types CIB or CFP on the * * IBM zEnterprise EC12 (zEC12) * * server . * * * * Following RMF reports are extended: * * - Postprocessor Coupling Facility * * Activity * * - Monitor III CFSYS * * * * Following SMF record is extended: * * - SMF 74 subtype 4 Coupling Facility * * Activity * **************************************************************** * RECOMMENDATION: * **************************************************************** New function APAR to provide RMF support for the gathering and reporting of coupling facility link characteristics for channel paths of type CIB or CFP on IBM zEnterprise EC12 (zEC12) servers. The enhanced subchannel reporting function is provided by the zEnterprise EC12 (zEC12) processor . o To report or display the additional channel path information for directly-connected CFs, z/OS must be running on a zEC12 processor. o To report or display the additional channel path information for remotely-connected CFs, the directly-connected CF must be running on a zEC12 processor (CFLEVEL 18 or higher). For a full exploitation of this new support in a sysplex environment it is necessary to install this APAR on all systems of the sysplex. +-------------------------------------------------------------+ FIXCAT=IBM.Device.Server.zEC12-2827.Exploitation/K keyword E2827/K +--------------------------------------------------------------+ >>>>>> POSTPROCESSOR COUPLING FACILITY ACTIVITY REPORT <<<<<< The Postprocessor Coupling Facility Activity report is enhanced by a new 'CHANNEL PATH DETAILS' section added to - the SUBCHANNEL ACTIVITY report, where it lists each channel path configured in a reported coupling facility by ID and type. For CIB and CFP links its operation mode, degraded status, distance, physical channel ID, HCA ID and port and the IDs of accessible I/O processors is shown. - the CF TO CF ACTIVITY report, where it lists each channel path connnected to a remote coupling facility by ID and type. Operation mode, degraded status and distance are provided for CIB and CFP coupling links. Available fields in CHANNEL PATH DETAILS section: SYSTEM NAME The name of the system attached to the coupling facility ( from IEASYSxx Parmlib member, SYSNAME parameter ). ID The hexadecimal identifier of a channel path (CHPID) that is connected to the coupling facility respectively that is connecting both coupling facilities with each other. TYPE Channel path type. OPERATION MODE Channel path operation mode. It describes the data rate, bandwidth, protocol, and adapter type of the channel path. Data rates for CFP channel paths: - 1GBIT 1.0625 Gbit/sec - 2GBIT 2.125 Gbit/sec Bandwidth for CIB channel paths: - 1x single bandwidth - 12x twelve-fold bandwidth Protocol for CIB channel paths: IFB, IFB3 Adapter types for CIB channel paths: HCA-O, HCA-O LR, HCA3-O, HCA3-O LR Unknown operation mode: UNKNOWN DEGRADED Character Y in this column indicates that the channel path is operating at reduced capacity (degraded) or not operating at all. DISTANCE Estimated distance in kilometers. The value is calculated as follows: Average round-trip path time in microseconds -------------------------------------------- 10 microseconds / kilometer A value of zero means that the time was not measured. PCHID Physical channel identifier. HCA ID The hexadecimal host channel adapter identifier. HCA PORT The hexadecimal host channel adapter port number. IOP IDS The hexadecimal identifiers of I/O processors (System Assist Processors) to which the channel path is accessible. Note: A system which does not have at least one CIB or CFP channel path defined as available is not included in the Channel Path Detail list. +--------------------------------------------------------------+ >>>>>> MONITOR III COUPLING FACILITY SYSTEMS REPORT <<<<<< The 'Subchannels and Paths' pop-up panel of the MONIII CFSYS report is modified to show a scrollable list of all channel paths that are available to the listed coupling facility. For a description of the fields in the pop-ip panel please refer to above field description of the RMF Postprocessor CHANNEL PATH DETAILS section. +--------------------------------------------------------------+ >>>>> SMF RECORD TYPE 70 TO 79 - RMF PRODUCT SECTION <<<<< The SMF record level change number SMFxxSRL at offset 51 (x33) changes to 100 (x64). >>>>> SMF RECORD TYPE 74 SUBTYPE 4 - CF ACTIVITY <<<<< The Header/Self-defining section is extended by new triplet fields (offset/length/number): OFFSET NAME LEN FORMAT DESCRIPTION ... 100 x64 SMF744HO 4 binary Offset to Channel Path data section 104 x68 SMF744HL 2 binary Length of Channel Path data section 106 x6A SMF744HN 2 binary Number of Channel Path data sections The Local Coupling Facility Data Section is changed. New fields start at offset X'B0': OFFSET NAME LEN FORMAT DESCRIPTION ... The following field is available eight times for eight possible channel paths. 176 xB0 R744FIDP 1 binary Channel path identifier. The range of values is X'00' to X'FF'. 184 xB8 R744FCPI 2 binary Index to the first channel path data section associated with this coupling facility. 186 xBA R744FCPN 2 binary Number of channel path data sections for channel paths of type 'CIB' or 'CFP' connected to this coupling facility. This count matches the number of subsequent channel path data sections. The Remote Coupling Facility Data Section is changed. New fields start at offset X'98': OFFSET NAME LEN FORMAT DESCRIPTION ... The following field is available eight times for eight possible channel paths. 152 x98 R744RIDP 1 binary Channel path identifier. The range of values is X'00' to X'FF'. 160 xA0 R744RCPI 2 binary Index to the first channel path data section associated with this remote coupling facility. 162 xA2 R744RCPN 2 binary Number of channel path data sections for channel paths of type 'CIB' or 'CFP' connected to this remote coupling facility. This count matches the number of subsequent channel path data sections. A new Channel Path Data Section is added. There is one section for each channel path of type 'CIB' or 'CFP' associated with a coupling facility. OFFSET NAME LEN FORMAT DESCRIPTION 0 x0 R744HCPI 1 binary Channel path identifier. The range of values is X'00' to X'FF'. 1 x1 R744HTAP 5 EBCDIC Channel path type acronym. 6 x6 R744HFLA 4 binary Validity bit mask. Each bit position represents the validity of a channel path attribute. Bit Meaning When Set 0 HCA ID and port number are valid. 1 Channel path operation mode is valid. 2 Channel path latency time is valid. 3 Degraded status flag is valid. 4-7 The corresponding field in the array of I/O processors is valid. 8 Physical channel ID is valid. 9-31 Reserved. 10 xA R744HOPM 1 binary Channel path operation mode. It describes the channel path type, data rate, protocol and adapter type. Value Meaning X'01' CFP path supporting a 1.0625 Gbit/s data rate X'02' CFP path supporting a 2.125 Gbit/s data rate X'10' CIB path operating at 1x bandwidth using the IFB protocol, adapter type HCA2-O LR X'11' CIB path operating at 12x bandwidth using the IFB protocol, adapter type HCA2-O X'20' CIB path operating at 1x bandwidth using the IFB protocol, adapter type HCA3-O LR X'21' CIB path operating at 12x bandwidth using the IFB protocol, adapter type HCA3-O X'30' CIB path operating at 12x bandwidth using the IFB3 protocol, adapter type HCA3-O Other Unknown 11 xB R744HCHF 1 binary Status flags. Bit Meaning When Set 0 Channel path is operating at reduced capacity (degraded) or is not operating at the end of the interval. 1-7 Reserved. 12 xC R744HLAT 4 binary Channel path latency time. This is the average round-trip path time in microseconds. A value of 0 means that the time was not measured. A value of 1 means a time less than or equal to one microsecond. 16 x10 R744HPCP 2 binary Physical channel ID (PCHID) 18 x12 R744HAID 2 binary Host channel adapter ID 20 x14 R744HAPN 1 binary Host channel adapter port number 21 x15 3 Reserved. The following field is available four times for each I/O processor. 24 x18 R744HSAP 1 binary I/O processor (System Assist Processor) to which this path is accessible. The range of values is X'00' to X'FF'. 28 x1C 4 Reserved.
Problem conclusion
Temporary fix
Comments
. ×**** PE13/01/14 FIX IN ERROR. SEE APAR OA41185 FOR DESCRIPTION ×**** PE13/03/18 FIX IN ERROR. SEE APAR OA41724 FOR DESCRIPTION
APAR Information
APAR number
OA37826
Reported component name
RMF
Reported component ID
566527404
Reported release
770
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2011-10-25
Closed date
2012-09-06
Last modified date
2013-07-30
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA66510 UA66511 UA66512 UA66513
Modules/Macros
ERBMFBSR ERBMFIZS ERBMFL3J ERBMFL3V ERBPCTBL ERBRMFPP ERBR744 ERBSCAN ERBSMFI ERBSMF74 ERB3GCFC ERB3GCFI ERB3GCFS ERB3GCTC ERB3GISS ERB3GSMF ERB3GSMM ERB3GSTH ERB3PC4 ERB3PC40 ERB3RCAB ERB3RCFA ERB3RCFO ERB3RCFS ERB3ROCN ERB3RPUT ERB3RSDC ERB3RSDR ERB3RTBR ERB3XCFI ERB3XEQS ERB4MAIN GPMDDSRV GPMHTC
Fix information
Fixed component name
RMF
Fixed component ID
566527404
Applicable component levels
R77J PSY UA66512
UP12/09/12 P F209
R770 PSY UA66510
UP12/09/12 P F209
R78J PSY UA66513
UP12/09/12 P F209
R780 PSY UA66511
UP12/09/12 P F209
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":"770","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":"770","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
30 July 2013