IBM Support

OA48659: NEW FUNCTION - Z/OS SUPPORT FOR COUPLING FACILITY OPERATIONAL LEVEL OF CFLEVEL21

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Provide z/OS support to exploit coupling facility
    operational level of CFLEVEL21 (z13s, z13 GA2 processors).
    Coupling facility list structure users can receive (via XES
    List Services) both the number of in-use entries per list
    and the number of in-use data elements per list for
    monitoring individual list storage usage in a list
    structure.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users running z/OS V2R2 (HBB77A0) in a   *
    *                 parallel sysplex configuration               *
    ****************************************************************
    * PROBLEM DESCRIPTION: Full function small programming         *
    *                      enhancement (SPE) for z/OS V2R2         *
    *                      (HBB77A0) systems that use a coupling   *
    *                      facility (CF) at CFLEVEL=21 in a        *
    *                      parallel sysplex configuration.         *
    *                                                              *
    *                      There is a need for z/OS to support a   *
    *                      coupling facility operational level of  *
    *                      CFLEVEL21 which is available on the     *
    *                      z13s and z13 GA2 processors.            *
    *                                                              *
    *                      E2964/K  E2965/K                        *
    *                      SYSPLEXDS                               *
    ****************************************************************
    * RECOMMENDATION: Install PTF on each system in the sysplex    *
    *                 via rolling IPL.                             *
    ****************************************************************
    Applications that use CF list structures manage, monitor and
    limit individual list content by list entries and data elements
    to ensure efficient list structure storage use. Applications
    need in-use counts of list entries and data elements for a list
    returned by the CF and XES List Services on list services
    invocations. Currently only one type of count (list entries or
    data elements, not both) is returned by the CF and XES List
    Services.
    

Problem conclusion

  • KEYWORDS: E2964/K E2965/K
    

Temporary fix

Comments

  • This APAR provides the z/OS support for exploiting new CFCC
    function in coupling facilities (CF) defined on an IBM
    z13s and z13 GA2 processor at CFLEVEL 21.  The following new
    function is available to z/OS V2R2 users of coupling facilities
    at CFLEVEL 21 on z13 GA2 and Z13s processors in a parallel
    sysplex configuration:
    
    Enhancements to XES List Services (IXLLIST, IXLLSTC, IXLLSTE) to
    return both in-use list entry counts and in-use data element
    counts for lists in a coupling facility list structure residing
    in a CF at CFLEVEL=21.  This enhancement allows applications to
    determine both list entry and data element usage for an
    individual list which can be used by the application for storage
    management, reporting and monitoring.
    
    When a z/OS V2R2 system is connected to a CF at CFLEVEL=21, z/OS
    will provide a unique "system name" to the CF for it to identify
    itself as to the CEC. The CFCC will use the provided system name
    in an SCLP Event Type 11 command it issues to identify itself to
    the CEC.
    
    There is no direct installation dependency between this APAR and
    the CFCC support - either can be installed without the presence
    of the other. However, both must be present for list entry and
    data element counts for lists to be returned.
    
    PUBLICATION UPDATES
    
    Documentation updates for this APAR are located in a
    pdf file, OA48659.pdf, available at:
    http://publibz.boulder.ibm.com/zoslib/pdf/OA48659.pdf
    
    Summary of Publication Updates:
    
    +--- PUBLICATION AFFECTED -------------------------------------+
    |                                                              |
    | o z/OS MVS Programming: Sysplex Services Guide -             |
    |   SA23-1400-02                                               |
    |                                                              |
    +--------------------------------------------------------------+
    - Chapter 8. Using List Services (IXLLIST)
    
      A new section titled "Understanding List Counts" is
      inserted under the section "Understanding List
      Controls."
    
    - Receiving Answer Area Information from a WRITE Request
    
      Changes describe new information returned for a WRITE request
      in the List Services Answer Area (IXLYLAA) for list entry and
      data element counts
    
    - Receiving Answer Area Information from a READ Request
    
      Changes describe new information returned for a READ request
      in the List Services Answer Area (IXLYLAA) for list entry and
      data element counts
    
    - Receiving Answer Area Information from a MOVE Request
    
      Changes describe new information returned for a MOVE request
      in the List Services Answer Area (IXLYLAA) for list entry and
      data element counts
    
    - Receiving Answer Area Information from a DELETE request
    
      Changes describe new information returned for a DELETE request
      in the List Services Answer Area (IXLYLAA) for list entry and
      data element counts
    
    - Receiving Answer Area Information from a READ_LCONTROLS
      Request
    
      Changes describe new information returned for a
      READ_LCONTROLS request in the List Services Answer Area
      (IXLYLAA) for list entry and data element counts
    
    - Receiving Answer Area Information from a MONITOR_LIST Request
    
      Changes describe new information returned for a
      MONITOR_LIST request in the List Services Answer Area
      (IXLYLAA) for list entry and data element counts
    
    - Detecting When a List Structure Is Becoming Full
    
      Updates to the decription of LAALISTCNT.
    
    +--- PUBLICATION AFFECTED -------------------------------------+
    |                                                              |
    | o z/OS MVS Diagnosis: Reference - GA32-0904-04               |
    |                                                              |
    +--------------------------------------------------------------+
    
     The example output of the STRDATA report is updated to
     reflect additional data returned in the
     "LIST NUMBER ENTRY POSITION DETAIL REPORT" section.
    
    +--- PUBLICATION AFFECTED -------------------------------------+
    |                                                              |
    | o z/OS V2R2 MVS Data Areas Volume 3 (ITK - SCE) -            |
    |   GA32-0937-03                                               |
    |                                                              |
    +--------------------------------------------------------------+
    
     - Update to IXLYCON to add a constant for CFLEVEL 21.
    
     All of the updates included in this APAR will appear
     in a future refresh of the affected publications.
    

APAR Information

  • APAR number

    OA48659

  • Reported component name

    XCF

  • Reported component ID

    5752SCXCF

  • Reported release

    7A0

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / SYSPLXDS /

  •  

    Xsystem

  • Submitted date

    2015-08-14

  • Closed date

    2016-02-17

  • Last modified date

    2016-04-05

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

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

    UA80730

Modules/Macros

  • IXCI2PH1 IXCL2ATH IXCL2BAP IXCL2SCC IXCL2SCL
    IXLYCON
    

Publications Referenced
SA23140002GA32090404GA32093703  

Fix information

  • Fixed component name

    XCF

  • Fixed component ID

    5752SCXCF

Applicable component levels

  • R7A0 PSY UA80730

       UP16/03/02 P F603

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":"7A0","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":"7A0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
05 April 2016