A fix is available
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:
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