OA37826: NEW FUNCTION - RMF SUPPORT FOR COUPLING FACILITY CHANNEL PATH TYPES CIB OR CFP ON THE IBM ZENTERPRISE EC12 (ZEC12) SERVER.

A fix is available

Subscribe

You can track all active APARs for this component.

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

  • 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.



Rate this page:

(0 users)Average rating

Document information


More support for:

z/OS family

Software version:

770

Operating system(s):

MVS, z/OS

Reference #:

OA37826

Modified date:

2013-07-30

Translate my page

Machine Translation

Content navigation