OA38312: NEW FUNCTION - ENHANCED COUPLING CHANNEL CONFIGURATION INFORMATION 13/11/08 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • New function - provide enhanced information about coupling
    channel configuration for display, IPCS, and accounting and
    measurement.
    PE Information :
    -User Affected :
     Customers with PTF UA66418 applied without UA59908 in HBB7770,
     and UA66419 applied without UA59909 in HBB7780.
    -User Impact :
    APAR OA37550 provided the intended new function but introduced
    a new problem.
    
    OA37550 provided performance and RAS enhancements for
    coupling facility cache structure exploiters.
    
     ABEND026-0C0E1026 occurs with CACHE structure related access.
     If ECS structure was utilized in the plex, Catalog address
     space could suffer failure with its access of str and LPAR
     could NOT operate normally.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Installations exploiting parallel sysplex at *
    *                 z/OS V1R12 (HBB7770) and above.              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Provide enhanced information about      *
    *                      coupling channel configuration for      *
    *                      display, IPCS, and accounting and       *
    *                      measurement.                            *
    *                                                              *
    *                      SYSPLEXDS E2827/K                       *
    ****************************************************************
    * RECOMMENDATION: Install the applicable PTF on each system in *
    *                 the sysplex.  A rolling IPL is sufficient to *
    *                 activate the fix.                            *
    ****************************************************************
    This APAR enhances display, IPCS, and accounting and measurement
    output to provide additional information about coupling facility
    message channels, including protocol in use, operational status,
    and physical configuration.
    

Problem conclusion

Temporary fix

Comments

  • Updated the following to report additional channel path
    characteristics for directly-connected and remotely-connected
    (i.e., peer-to-peer linked) coupling facilities (CFs).
    
    o DISPLAY CF (directly- and remotely-connected CFs)
    
    o DISPLAY M=CHP (directly-connected CFs)
    
    o The IXLMG accounting and measurement API (directly- and
      remotely-connected CFs)
    
    o The IPCS XESDATA FACILITY report (directly- and remotely-
      connected CFs).
    
    The enhanced subchannel reporting function is provided by the
    zEnterprise EC12 (zEC12) processor (D/T 2827).
    
    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).
    
         +--- PUBLICATIONS AFFECTED -------------------------------+
         |                                                         |
         | o z/OS MVS System Messages, Vol 10 (IXC-IZP) - SA22-7640|
         +---------------------------------------------------------+
    
    Update message IXL150I:
    -----------------------
      IXL150I hh.mm.ss DISPLAY CF
      COUPLING FACILITY type.mfg.plant.sequence
                        PARTITION: partition side  CPCID: cpcid
    |                   LP NAME: lparname   CPC NAME: cpcname
                        CONTROL UNIT ID: cuid
      NAMED cfname
      . . .
    
          DYNAMIC CF DISPATCHING: ON|OFF
    |     COUPLING FACILITY IS standalonestate
       COUPLING FACILITY HAS ONLY ONE ONLINE SENDER PATH
    
    | mtofstatus
    |  REASON: mtofreason
    
      COUPLING FACILITY SPACE CONFIGURATION
                            IN USE            FREE          TOTAL
      CONTROL SPACE:      inusespace u    cfreespace u  ctotspace u
      NON-CONTROL SPACE:  ncinusespace u  ncfreespace u nctotspace u
       NO COUPLING FACILITY SPACE DATA AVAILABLE
    
    | PATH          PHYSICAL   LOGICAL   CHANNEL TYPE      AID  PORT
    | chpid /pchid  phystatus  logstatus chtype  pathmode  aid  port
    
      . . .
    
      REMOTELY CONNECTED COUPLING FACILITIES
           CFNAME      COUPLING FACILITY
           --------    --------------------------
           rfcfname    rftype.rfmfg.rfplant.rfsequence
                       PARTITION: partition rfside CPCID: rfcpcid
                       CHPIDS ON LF01 CONNECTED TO REMOTE FACILITY
                       RECEIVER: CHPID    TYPE
    |                             rfchpid  rfchtype  rfpmode
                       SENDER:   CHPID    TYPE
    |                             rfchpid rfschtype  rfspmode
    |                  * = PATH OPERATING AT REDUCED CAPACITY
    
      Explanation: The message provides the output for a DISPLAY CF
      command.
    
      . . .
    
      cpcid
        Node Central Processor Complex (CPC) ID (See ndecpcid in
        IXLYNDE).
    
    | lparname
    |   Name assigned to the logical partition in which the CF is
    |   running.  "N/A" indicates that the name is not available.
    
    | cpcname
    |   Name assigned to the CPC on which the CF is running.  "N/A"
    |   indicates that the name is not available.
    
      . . .
    
    | standalonestate
    |
    |   One of the following:
    |
    |   STANDALONE
    |     The CF resides on a CEC with no general-purpose
    |     processors, so that no z/OS image can run on the CEC.
    |
    |   NOT STANDALONE
    |     The CF resides on a CEC with at least one general-purpose
    |     processor, so it is possible to configure a z/OS image on
    |     the same CEC.
    
      . . .
    
      phystatus
        One of the following:
    
        ONLINE
          The path chpid to the coupling facility cfname is
          physically available for use. The chpid is configured
          online and is operating.
    
    |   ONLINE - DEGRADED
    |     The path chpid to the coupling facility cfname is
    |     physically available for use.  The chpid is configured
    |     online and is operating, but at a reduced capacity.
    
        OFFLINE
          The path chpid to the coupling facility cfname is
          configured offline.
    
      . . .
    
    
    | pathmode
    |   H
    |     The channel path supports a 1.0625 Gb/sec data rate (half
    |     rate).
    |
    |   F
    |     The channel path supports a 2.125 Gb/sec data rate (full
    |     rate).  It may operate at either 1.0625 or 2.125 Gb/sec.
    |
    |   1X-IFB
    |     The channel path is operating at 1X bandwidth using the
    |     IFB protocol.
    |
    |   12X-IFB
    |     The channel path is operating at 12X bandwidth using the
    |     IFB protocol.
    |
    |   12X-IFB3
    |     The channel path is operating at 12X bandwidth using the
    |     IFB3 protocol.
    |
    | aid
    |   The adapter identifier associated with path chpid, if
    |   applicable and available.
    |
    | port
    |   The port associated with path chpid, if applicable and
    |   available.
    
      . . .
    
      rfchpid
        CHPID installed on cfname that is being used for a peer
        connection between coupling facility cfname and coupling
    |   facility rfcfname.  An asterisk following the CHPID
    |   indicates that the path is operating at reduced capacity.
    
      . . .
    
    | rfpmode - same as pathmode
    
      . . .
    
    | rfspmode - same as pathmode
    
      . . .
    
    
    Delete message IXL141I
    ----------------------
    Actually issued as IEE174I.
    
    
         +--- PUBLICATIONS AFFECTED -------------------------------+
         |                                                         |
         | o   z/OS MVS System Messages, Vol 7 (IEB-IEE) -         |
         |     SA22-7637                                           |
         +---------------------------------------------------------+
    
    Update message IEE174I format 17:
    ---------------------------------
      COUPLING FACILITY  type.mfg.plant.sequence
                         PARTITION: partition side  CPCID: cpcid
                         CONTROL UNIT ID: cuid
      NAMED cfname
    | PATH          PHYSICAL   LOGICAL   CHANNEL TYPE      AID  PORT
    | chpid /pchid  phystatus  logstatus chtype  pathmode  aid  port
    
    | COUPLING FACILITY SUBCHANNEL STATUS
    | TOTAL: totdev IN USE: usedev NOT USING: nusedev
                    NOT USABLE: unusedev
    |   NOT  OPERATIONAL DEVICES / SUBCHANNELS:
    |      dev / subch   dev / subch   dev / subch   dev / subch
    
      Explanation: A reconfiguration display request (a DISPLAY
      M=CHP(chp) command) asked the system to display the status of
      a channel path and the devices connected to it.
    
      In the message text:
    
      . . .
    
      phystatus
        One of the following:
    
        ONLINE
          The path chpid . . .
    
    |   ONLINE - DEGRADED
    |     The path chpid to the coupling facility cfname is
    |     physically available for use.  The chpid is configured
    |     online and is operating, but at a reduced capacity.
    
        . . .
    
        NOT OPERATIONAL
          The path chpid . . .
    
    |   NOT IN CONFIGURATION
          The path, chpid . . .
    
        FACILITY PAUSED
          The path, chpid . . .
    
    |   PATH NOT AVAILABLE
          The path, chpid . . .
    
      . . .
    
    | chtype
        One of the following:
    
        . . .
    
    | pathmode
    |   H
    |     The channel path supports a 1.0625 Gb/sec data rate (half
    |     rate).
    |
    |   F
    |     The channel path supports a 2.125 Gb/sec data rate (full
    |     rate).  It may operate at either 1.0625 or 2.125 Gb/sec.
    |
    |   1X-IFB
    |     The channel path is operating at 1X bandwidth using the
    |     IFB protocol.
    |
    |   12X-IFB
    |     The channel path is operating at 12X bandwidth using the
    |     IFB protocol.
    |
    |   12X-IFB3
    |     The channel path is operating at 12X bandwidth using the
    |     IFB3 protocol.
    |
    | aid
    |   The adapter identifier associated with path chpid, if
    |   applicable and available.
    |
    | port
    |   The port associated with path chpid, if applicable and
    |   available.
    |
    | totdev
    |   Number of coupling facility subchannels that have been
    |   defined for this system.
    |
    | usedev
    |   Number of coupling facility subchannels that are currently
    |   being used by this system to execute requests to the
    |   coupling facility. This is equal to the number of concurrent
    |   operations that can be initiated to this coupling facility
    |   minus any subchannels that are not being used because of
    |   subchannel tuning actions.
    |
    | nusedev
    |   Number of coupling facility subchannels that are eligible to
    |   be used but are not currently being used by this system to
    |   execute requests to the coupling facility. This is equal to
    |   the number of subchannels that have been taken out of the
    |   pool of usable subchannels by subchannel tuning actions.
    |   This count may temporarily include some number of
    |   subchannels when a readjusting of the IN USE subchannel
    |   count is in progress as a result of configuration actions
    |   against CF Links for this facility.
    |
    | unusedev
    |   Number of coupling facility subchannels that have been
    |   defined for this system but which cannot be used to execute
    |   requests to the coupling facility. Equal to the number of
    |   sub-channels defined that are in excess of the number of
    |   concurrent operations that can be initiated to this coupling
    |   facility. This count also includes the number of
    |   not-operational subchannels, if any.
    |
    | dev
    |   Coupling facility device.
    |
    | subch
    |   Coupling facility subchannel.
    
         +--- PUBLICATIONS AFFECTED -------------------------------+
         |                                                         |
         | o   z/OS MVS Sysplex Services Reference SA22-7618       |
         +---------------------------------------------------------+
    
    Chapter "IXLMG - Coupling Facility Measurement"
    -----------------------------------------------
    
    Added IXLYAMDCFCP and IXLYAMDCFCPINFO DSECTs to the description.
    
         +--- PUBLICATIONS AFFECTED -------------------------------+
         |                                                         |
         | o   z/OS MVS Data Areas Volume 4 GA32-0856              |
         +---------------------------------------------------------+
    
    Updated IXLYAMDA heading and mapping information.
     KEYWORDS: PSIFB/K
    

APAR Information

  • APAR number

    OA38312

  • Reported component name

    CROSS SYS.EXT.S

  • Reported component ID

    5752SCIXL

  • Reported release

    770

  • Status

    CLOSED UR1

  • PE

    YesPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / SYSPLXDS

  • Submitted date

    2011-12-12

  • Closed date

    2012-08-28

  • Last modified date

    2013-12-19

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UA66468 UA66469 UA66470 UA66471

Modules/Macros

  •    IXLA1MG  IXLC3ASC IXLC3CRF IXLC3CSC IXLC3DSC
    IXLC3INC IXLC3VSC IXLE1MEV IXLE1SCH IXLF1FAT IXLF1STC IXLF1TF6
    IXLF1VSL IXLIXLEN IXLIXLJP IXLI1SIN IXLM1MST IXLM1MS2 IXLM1TBL
    IXLM2XRQ IXLR3DCH IXLR3DFS IXLR3DSF IXLYAMDA IXLYCON  IXLYCSCS
    IXLYDSCC
    

Publications Referenced
SA227637XX SA227640XX SA227618XX GA320856XX  

Fix information

  • Fixed component name

    CROSS SYS.EXT.S

  • Fixed component ID

    5752SCIXL

Applicable component levels

  • R77J PSY UA66470

       UP12/09/12 P F209

  • R770 PSY UA66468

       UP12/09/12 P F209

  • R78J PSY UA66471

       UP12/09/12 P F209

  • R780 PSY UA66469

       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

Add comments

Document information


More support for:

z/OS family

Software version:

770

Operating system(s):

MVS, z/OS

Reference #:

OA38312

Modified date:

2013-12-19

Translate my page

Machine Translation

Content navigation