IBM Support

OA51879: NEW FUNCTION - XES IXLMG ACCOUNTING AND MEASUREMENT ENHANCEMENTS

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • Provide additional coupling facility
    structure accounting and measurement
    usage statistics for list and cache
    structure read and write requests.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Installations exploiting parallel sysplex    *
    *                 at z/OS V2R2 (HBB77A0)                       *
    ****************************************************************
    * PROBLEM DESCRIPTION: Full function small programming         *
    *                      enhancement (SPE) for z/OS V2R2         *
    *                      (HBB77A0) installations that use        *
    *                      coupling facility structures in a       *
    *                      parallel sysplex environment.           *
    *                                                              *
    *                      Provide additional coupling facility    *
    *                      structure accounting and measurement    *
    *                      usage statistics for list and cache     *
    *                      structure read and write requests.      *
    *                                                              *
    *                      SYSPLEXDS                               *
    ****************************************************************
    * RECOMMENDATION: Install the PTF on each system in            *
    *                 the sysplex via rolling IPL.                 *
    ****************************************************************
    Enhancements to the XES accounting and measurement service and
    output are needed to provide additional information related to
    the amount of coupling facility structure data written to and
    read from list and cache structures. Applications want to
    perform cost and predictive analysis using the amount of
    data transferred to and from coupling facility structures.
    

Problem conclusion

Temporary fix

Comments

  • This APAR enhances the XES IXLMG accounting and measurement
    service and output (mapped by the IXLYAMDA macro) to provide
    additional information related to coupling facility structure
    data written to and read from list and cache structures.
    
    Documentation updates for this APAR are located in a
    pdf file, OA51879.pdf, available at:
    
    http://publibz.boulder.ibm.com/zoslib/pdf/OA51879.pdf
    
    
    Summary of Publication Updates:
    
    +--- PUBLICATION AFFECTED -------------------------------------+
    |                                                              |
    | z/OS MVS Programming: Sysplex Services Reference - SA38-0658 |
    |                                                              |
    +--------------------------------------------------------------+
    
    
    Chapter IXLMG - Coupling facility measurement
    
    Description
    
    . . .
    
      - IXLYAMDCF and IXLYAMDCF1 map coupling facility information
    
    | - IXLYAMDSTRL, IXLYAMDSTRL1, IXLYAMDSTRL2, and IXLAMDSTRL3 map
    |   coupling facility list structure information
    
    |   IXLYAMDSTRC, IXLYAMDSTRC1, IXLAMDSTRC2, and IXLAMDSTRC3 map
    |   coupling facility cache structure information
    
    . . .
    
    Parameter description
    .  .  .
     ,AMDALEVEL=0
     ,AMDALEVEL=amdalevel
    .  .  .
    
      Use IXCQUERY REQINFO=FEATURES to get the QuReqFeatures
      string.
    
    | The QuReqRfWriteReadMetrics bit in the QuReqFeatures
    | string can be used to test for support of AMDALEVEL=3 on the
    | system.
    
      Use IXCQUERY REQINFO=FEATURES to get the QuReqFeatures string
    
    
    +--- PUBLICATION AFFECTED -------------------------------------+
    |                                                              |
    | z/OS MVS Data Areas Volume 3 (ITK - SCE) - GA32-0937         |
    |                                                              |
    +--------------------------------------------------------------+
    
    
    IXLYAMDA Data Area Updates:
    ---------------------------
    
    Common Name:      Accounting and Measurement Data Area
    Macro ID:         IXLYAMDA
    
    New DSECT Names:  IXLYAMDSTRL3
                      IXLYAMDSTRC2
                      IXLYAMDSTRC3
    
    Size:             Variable
                      . . .
                      IXLYAMDSTRL3     -- X'0220' bytes
                      IXLYAMDSTRC2     -- X'0174' bytes
                      IXLYAMDSTRC3     -- X'01D0' bytes
                      . . .
    
    IXLYAMDSTRL3 DSECT (new)
    
    - IXLYAMDSTRL3_WRITEDATAREQUESTS
    
    - IXLYAMDSTRL3_WRITEADJUNCTCOUNT
    
    - IXLYAMDSTRL3_READDATAREQUESTS
    
    - IXLYAMDSTRL3_READADJUNCTCOUNT
    
    - IXLYAMDSTRL3_WRITEENTRYCOUNT
    
    - IXLYAMDSTRL3_READENTRYCOUNT
    
    - IXLYAMDSTRL3_WRITEENTRYDATA
    
    - IXLYAMDSTRL3_WRITEENTRYDATASQR
    
    - IXLYAMDSTRL3_READENTRYDATA
    
    - IXLYAMDSTRL3_READENTRYDATASQR
    
    
    IXLYAMDSTRC2 DSECT (new) same as IXLYAMDSTRC1
    
    IXLYAMDSTRC3 DSECT (new)
    
    - IXLYAMDSTRC3_WRITEDATAREQUESTS
    
    - IXLYAMDSTRC3_WRITEADJUNCTCOUNT
    
    - IXLYAMDSTRC3_READDATAREQUESTS
    
    - IXLYAMDSTRC3_READADJUNCTCOUNT
    
    - IXLYAMDSTRC3_WRITEENTRYCOUNT
    
    - IXLYAMDSTRC3_READENTRYCOUNT
    
    - IXLYAMDSTRC3_WRITEENTRYDATA
    
    - IXLYAMDSTRC3_WRITEENTRYDATASQR
    
    - IXLYAMDSTRC3_READENTRYDATA
    
    - IXLYAMDSTRC3_READENTRYDATASQR
    
    For more information, see the IXLYAMDA mapping macro.
    
    
    IXCYQUAA Heading Information
    ----------------------------
    Common Name:      Query Answer Area
    Macro ID:         IXCYQUAA
                      . . .
    
    Structure QUREQFEATURES
        . . .
      - QUREQFEATURES1D
        . . .
    
      ..1.  ....     QUREQRFASYNCDUPLEX "X 20"
                     Support for system-managed asynchronous
                     duplexing. Includes IXLADUPX, IXLLOCK
                     ADUPREQSEQNUM, IXLLOCK REQVERSION, and IXLMG
                     AMDALEVEL=2.
    
    | ....  1...     QUREQRFWRITEREADMETRICS "X 08"
    |                List and cache structure write/read
    |                measurement metrics and IXLMG
    |                AMDALEVEL=3 supported on this system
    
    
    +--- PUBLICATION AFFECTED -------------------------------------+
    |                                                              |
    | z/OS MVS Programming: Sysplex Services Guide - SA23-1400     |
    |                                                              |
    +--------------------------------------------------------------+
    
    
    Under topic "Using the IXCQUERY Macro":
    
    Information returned inline to IXCQUERY
    
    .  .  .
    
    The information that IXCQUERY returns when you specify
    REQINFO=FEATURES is placed in a storage area that you specify
    with the FEATAREA parameter. The information is mapped by
    QUREQFEATURES in IXCYQUAA and includes the following:
    
    .  .  .
    
    | QuReqRfWriteReadMetrics
    |   List and cache structure write/read measurement metrics and
    |   IXLMG AMDALEVEL=3 supported on this system.
    
    
    Under topic "Using IXLMG":
    
    Types of information available
    
      .  .  .
    
      IXLYAMDCFRF
        Coupling facility remote facility entry
    
    | IXLYAMDSTRL, IXLYAMDSTRL1, IXLYAMDSTRL2, and IXLAMDSTRL3
      .  .  .
    | IXLYAMDSTRC, IXLYAMDSTRC1, IXLYAMDSTRC2, and IXLAMDSTRC3
    
    
    Coupling Facility Information
    
      o If HWSTATISTICS=YES
    
      .  .  .
    
      - AMDSLL and AMDSLL1 (list structure limits) and AMDSLC and
        AMDSLC1 (cache structure limits) are returned.
    
    | - AMDSTRL and AMDSTRL1 - n (list structure entry) and AMDSTRC
    |   and AMDSTRC1 - n (cache structure entry) are returned for
    |   all structures in the coupling facility regardless of
    |   whether there's an active XES connection to that structure
    |   on this system.  AMDSTRL, AMDSTRL1 - n, AMDSTRC, and
    |   AMDSTRC1 - n include configuration data, measurement data,
    |   and control information for all structures.
    
    
    | - Structure usage information in AMDSTRL, AMDSTRL1 - n,
    |   AMDSTRC, and AMDSTRC1 - n is available only for structures
    |   that have an active XES connection to that structure on
    |   this system.
    
      .  .  .
    
      o If HWSTATISTICS=NO
    
      .  .  .
    
      - AMDSLL and AMDSLL1 (list structure limits) and AMDSLC and
        AMDSLC1 (cache structure limits) are returned.
    
    | - AMDSTRL and AMDSTRL1 - n (list structure entry) and AMDSTRC
    |   and AMDSTRC1 - n (cache structure entry) are returned only
    |   for structures that have an active XES connection to that
    |   structure on this system.  AMDSTRL, AMDSTRL1 - n, AMDSTRC,
    |   and AMDSTRC1 - n include configuration data and measurement
    |   data.
    
    | - AMDSTRL, AMDSTRL1 - n, AMDSTRC, and AMDSTRC1 - n do not
    |   contain structure control information.
    
      .  .  .
    
      o If HWSTATISTICS=CF
    
      .  .  .
    
      - AMDSLL and AMDSLL1 (list structure limits) and AMDSLC and
        AMDSLC1 (cache structure limits) are returned.
    
    | - AMDSTRL and AMDSTRL1 - n (list structure entry) and AMDSTRC
    |   and AMDSTRC1 - n (cache structure entry) are returned only
    |   for structures that have an active XES connection to that
    |   structure on this system.  AMDSTRL, AMDSTRL1 - n, AMDSTRC,
    |   and AMDSTRC1 - n include configuration data and measurement
    |   data.
    
    | - AMDSTRL, AMDSTRL1 - n, AMDSTRC, and AMDSTRC1 - n do not
    |   contain structure control information.
    
      .  .  .
    
    Coupling Facility Structure Information
    
    You can request information about a single named structure
    (STRNAME) that is allocated in a coupling facility attached to
    the system on which the IXLMG macro is issued. The data returned
    includes:
    
      .  .  .
    
      - AMDSLL (AMDSLL1) and AMDSLC (AMDSLC1)
    
    | - AMDSTRL (AMDSTRL1 - n)  or  AMDSTRC (AMDSTRC1 - n),
    |   depending on whether the structure is a list or cache
    |   structure.  AMDSTRL (AMDSTRL1 - n) or AMDSTRC (AMDSTRC1 - n)
    |   includes structure control information.
    
    | - AMDSTRL (AMDSTRL1 - n) or AMDSTRC (AMDSTRC1 - n) contain
    |   structure usage information only for structures that have an
    |   active XES connection to that structure on this system.
    
      .  .  .
    

APAR Information

  • APAR number

    OA51879

  • Reported component name

    CROSS SYS.EXT.S

  • Reported component ID

    5752SCIXL

  • Reported release

    7A0

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / SYSPLXDS /

  •  

    Xsystem

  • Submitted date

    2017-01-09

  • Closed date

    2017-06-06

  • Last modified date

    2017-07-05

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

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

    UA92085

Modules/Macros

  • IXCI2PH1 IXCYQUAA IXLA1MG  IXLA1SLM IXLMG
    IXLM1TBL IXLR1CAC IXLR1LST IXLYAMDA
    

Publications Referenced
GA320937XX SA231400XX SA380658XX    

Fix information

  • Fixed component name

    CROSS SYS.EXT.S

  • Fixed component ID

    5752SCIXL

Applicable component levels

  • R7A0 PSY UA92085

       UP17/06/21 P F706

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.



Document information

More support for: z/OS family

Software version: 7A0

Operating system(s): MVS, z/OS

Reference #: OA51879

Modified date: 05 July 2017