IBM Support

PK48578: CMAS INITIALIZATION SLOW INEFFICIENT TOP CONNECTION LIST PROCESS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • In a large CICSplex ( 750 to 1000 or more MASes) where the CICS
    regions have many connections, the topology connect / join
    processing which takes place in the CMAS is inefficient
    resulting in elongated topology connect / join processing times.
    .
    Additional Symptom(s) Search Keyword(s): EYUTS0001I EYUTS0003I
    TSSC TSSJ TSCS ADD_ELEMENT ADDE_VIEWNEXT TCTE_CSYSNAME
    CSDB_CSNAME XCLV XCLF MRO ISC IPCONN startup
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V3R2M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: Topology Connect and Join processing    *
    *                      for a MAS may be elongated if the MAS   *
    *                      is a member of a CICSplex that contains *
    *                      a large number of CICS System Groups    *
    *                      (CSYSGRPs) and CICS Systems (CSYSDEFs), *
    *                      and the MAS has a large number of CICS  *
    *                      connection definitions.  This can       *
    *                      result in various problems if a CMAS    *
    *                      must Join and Connect to a great number *
    *                      of MASes when it initializes.           *
    *                                                              *
    *                      Problems seen include, but are not      *
    *                      limited to, the following:              *
    *                                                              *
    *                      -  the CMAS may go maxtask (MXT)        *
    *                      -  the CMAS may go short-on-storage     *
    *                         (SOS).                               *
    *                      -  the CMAS may experience connection   *
    *                         problems with other CMASes.          *
    *                      -  some of the Connect and Join         *
    *                         attempts may fail.                   *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes must be restarted.  Note    *
    *                 that the restarts do not need to occur at    *
    *                 the same time.                               *
    ****************************************************************
    During CMAS initialization, the Topology component builds a
    scope list for the CICSplex.  This list contains an element for
    each Group and System defined in the CICSplex.  Each list
    element contains the Group or System (MAS) name along with a
    pointer to the Topology descriptor block for the Group (SGDB) or
    MAS (CSDB).  When a MAS Connects or Joins to the CMAS, method
    EYU0TSCS (TSCS) uses the scope list to build a connection target
    array for the MAS.  For each connection defined for the MAS,
    TSCS searches the scope list to find a match for the target of
    the connection.  The connection definition only contains the
    APPLID of the target, which may be different from the MAS name.
    As a result, to search the list, TSCS reads an element,
    retrieves the descriptor pointer from the element, and if the
    descriptor is for a MAS (CSDB), compares the APPLID from the
    connection definition to the APPLID in the CSDB.  If the APPLIDs
    match, TSCS can then build the connection array element.  If
    not, it must process the next scope list element.  When there
    are a large number of scope list elements and the MAS contains
    many connection definitions, TSCS must perform a great amount of
    processing to build the connection target array for the MAS.  If
    a CMAS must perform this processing for many MASes during
    initialization, this can result in the problems documented
    above.
    

Problem conclusion

  • To resolve this problem, a new list called the CSDB list is
    built for each CICSplex during CMAS initialization.  This list
    only contains elements for MASes defined in the CICSplex.  Each
    element contains the MAS name, the APPLID for the MAS (as
    defined in the CSYSDEF), and the CSDB pointer for the MAS.
    Additionally, an alternate index is defined on the APPLID field
    in the list.  As a result, TSCS can now perform a direct read to
    find the element for the connection target when building the
    connection array for a MAS.
    
    To affect this change, the following updates have been made:
    
    -  new copybook EYURTICL has been created to map the elements
       for the CSDB list.
    
    -  copybook EYURTIXD, which maps the CICSplex descriptor block
       for a CICSplex, has been updated to contain the list IDs for
       the CSDB list and its alternate index.
    
    -  method EYU0TIPC (TIPC), which allocates data structures for
       a CICSplex during CMAS initialization or CICSplex creation,
       has been updated to allocate the CSDB list and its alternate
       index, and to place the IDs for the lists into the EYURTIXD
       for the CICSplex.
    
    -  method EYU0TISC (TISC), which builds the CSDBs for a
       CICSplex's MASes during CMAS initialization or when a
       CICSplex is added to a CMAS, has been updated to add the
       element to the CSDB list for the MAS.
    
    -  method EYU0TSSA (TSSA), which builds the CSDB for a MAS when
       a new CSYSDEF is created, has been updated to add the element
       to the CSDB list for the MAS.
    
    -  methods EYU0TIST (TIST), EYU0TSRS (TSRS) and EYU0TSUA (TSUA),
       which are called when updates are made to a MAS, have been
       updated to recognize if the APPLID has changed, and if so, to
       update the CSDB list element for the MAS with the new APPLID.
    
    -  method EYU0TSCS (TSCS) has been updated to use the CSDB list
       instead of the scope list when building the connection target
       array for a MAS.
    
    -  method EYU0TSSD (TSSD), which frees the CSDB for a MAS during
       CSYSDEF deletion or CICSplex deletion, has been updated to
       remove the MAS's element from the CSDB list.
    
    -  method EYU0TSPD (TSPD), which frees data structures for a
       CICSplex during CICSplex deletion, has been updated to free
       the CSDB list and its alternate index.
    

Temporary fix

  •             *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK48578

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    50M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-07-09

  • Closed date

    2007-07-30

  • Last modified date

    2007-08-03

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

    PK47822

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

    UK27565

Modules/Macros

  •    EYURTICL EYURTIXD EYU0TIPC EYU0TISC EYU0TIST
    EYU0TSCS EYU0TSPD EYU0TSRS EYU0TSSA EYU0TSSD EYU0TSUA
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R50M PSY UK27565

       UP07/08/01 P F707

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 August 2007