PK91190: EYUTS0063E TOPOLOGY ERROR DURING STARTUP RESULTING ABEND IN TSEC

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The following message is issued repeatedly in the CMAS during
  startup:
  .
    EYUTS0063E applid Topology encountered an error processing
    a change to a CICS system group.
  .
  The stack for the abending task is: XLOP, TIST, TSLA, TSEC, XZPT
  and the trace shows an exception entry with debug test RecurGrp
  trace point ID 6.  The exception occurs on function EXTPSGC.
  This error occurs as CMASes are starting up and receiving
  updates to the DREP that occurred while they were down.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: A CMAS which is a non-maintenance point *
  *                      CMAS for at least one CICSplex may      *
  *                      receive error message EYUTS0063E during *
  *                      startup when processing data repository *
  *                      updates from the maintenance point      *
  *                      CMAS.  The text of this message will be *
  *                      as follows:                             *
  *                                                              *
  *                        EYUTS0063E  Topology encountered an   *
  *                                    error processing a change *
  *                                    to a CICS system group.   *
  *                                                              *
  *                      This may be followed by message         *
  *                      EYUXZ0910I indicating that a dump was   *
  *                      taken.  The dump title displayed by the *
  *                      message will be similar to the          *
  *                      following:                              *
  *                                                              *
  *                        EYU0XZPT Dump,<cmasjobn>,<cmasname>,  *
  *                        <lpar>,CMAS,TIST,<tasknum>,           *
  *                        TRAC,EYU0TSEC,<date>,<time>           *
  ****************************************************************
  * 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.                               *
  ****************************************************************
  When a CMAS initializes, method EYU0TIML (TIML) is called to
  perform initialization for the Topology component.  As part of
  this processing, TIML calls method EYU0TIPC (TIPC) to read all
  Topology records for each CICSplex from the data repository, and
  create data structures for them.
  
  If records are added after initialization, then after the record
  is written to the data repository, method EYU0XDCR (XDCR) will
  generate an event to the Topology long running task TIST, which
  will then cause the appropriate data structures to be built for
  the record.
  
  If a CMAS is the maintenance point for a CICSplex, then it is
  not possible for records to be added to the data repository for
  the CICSplex until the CMAS completes initialization.  However,
  if a CMAS is a non-maintenance point CMAS, then it could receive
  updates for the data repository from the maintenance point CMAS
  while it is performing Topology initialization.  When this
  occurs, it is possible for TIST to attempt to build data
  structures for records that have already been processed by TIPC,
  which can result in the errors described above.
  

Problem conclusion

• A non-maintenance point CMAS receives data repository updates
  from the maintenance point CMAS through method EYU0XDRS (XDRS).
  On entry, XDRS acquires a lock exclusively to serialize
  processing of all XDRS executions.  Method TIML has been updated
  to acquire this lock exclusively prior to calling TIPC, and to
  free if after TIPC completes processing.  This will ensure that
  records processed by TIPC are not also processed by TIST.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK82035

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

  UK48629

Modules/Macros

• EYUTXLPD EYU0TIML EYU0XDIN
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK48629

     UP09/07/28 P F907

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.