PM50245: MAS FAILS TO CONNECT TO CMAS. EYUTS0002E IN CMAS, EYUNL0090W IN CMAS AND MAS. RESOURCE RECORDS OUT OF ORDER ON EYUDREP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your MAS is trying to connect to the CMAS and fails. In the MAS
  you see
  .
  EYUNL0090W LMAS is shutting down because it failed to
             become available to process requests.
  .
  In the CMAS you see
  .
  EYUTS0002E Topology Connect for xxxxxxxx Failed
             - APPLID(yyyyyyyy) CICSplex(zzzzzzzz).
  EYUNL0090W LMAS is shutting down because it failed to
             become available to process requests.
  .
  It may be that resource records are out of sequence on the
  EYUDREP file. If that is the case, the CMAS AUX trace will have
  exception records with debug text XCLAXCL1 and status of
  NOT_SORTED.
  .
  KIXREVSVR
  

Local fix

• To temporarily recover from this issue until the PTF can be
  applied, the user can effectively reorg their EYUDREP file
  using the EYU9XDUT utility. They would allocate a new, empty
  EYUDREP file using IDCAMS, then run JCL similar to the following
  .
     //STEP01  EXEC PGM=EYU9XDUT,
     //             PARM=('TARGETVER=0410')
     //STEPLIB   DD DISP=SHR,DSN=hlq.SEYUAUTH
     //EYUDREP   DD DISP=SHR,DSN=<old.customer.EYUDREP>
     //NEWREP    DD DISP=OLD,DSN=<new.customer.EYUDREP>
     //BYPASS    DD SYSOUT=*
     //SNAP      DD SYSOUT=*
     //SYSPRINT  DD SYSOUT=*
     //
  .
  The value for TARGETVER= would be the same release as they
  currently run. Then they would point their CMAS to the newly
  reorganized EYUDREP file.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Your MAS is trying to connect to the    *
  *                      CMAS and fails. In the MAS you see      *
  *                                                              *
  *                      EYUNL0090W LMAS is shutting down        *
  *                                 because it failed to become  *
  *                                 available to process         *
  *                                 requests.                    *
  *                                                              *
  *                      In the CMAS you see                     *
  *                                                              *
  *                      EYUTS0002E Topology Connect for         *
  *                                 xxxxxxxx Failed -            *
  *                                 APPLID(yyyyyyyy)             *
  *                                 CICSplex(zzzzzzzz).          *
  *                                                              *
  *                      EYUNL0090W LMAS is shutting down        *
  *                                 because it failed to become  *
  *                                 available to process         *
  *                                 requests.                    *
  *                                                              *
  *                      Your MAS is trying to join to the CMAS  *
  *                      and fails. In the CMAS you see          *
  *                      .                                       *
  *                      EYUTS0002E Topology Join for            *
  *                                 xxxxxxxx Failed -            *
  *                                 APPLID(yyyyyyyy)             *
  *                                 CICSplex(zzzzzzzz).          *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick up *
  *                 the changed code.  Note that the restarts do *
  *                 not need to occur at the same time.          *
  ****************************************************************
  The reported problem can be caused by out of sequence topology
  resmap records for the MAS on the EYUDREP file. If this is the
  case, examination of the auxiliary trace data set from the
  connecting CMAS will show the following entries:
  
  TASK  MTD  PREV TRAN OBJ LEVL  PT-ID   DEBUG
  00079 XCL1 XCLA TSSC CHE EXCP     109 NOT_SORT
  00079 XCLA XCRB TSSC CHE EXCP     106 INVSORTD
  00079 XCRB TSSC TSSC CHE EXCP      60 ADDCLSTF
  00079 TSSC XLOP TSSC TOP EXCP       7 TSSCXCRB
  
  Examination of the auxiliary trace data set from the
  joining CMAS will show the following entries:
  
  TASK  MTD  PREV TRAN OBJ LEVL  PT-ID   DEBUG
  00131 XCL1 XCLA TSSJ CHE EXCP     109 NOT_SORT
  00131 XCLA XCRB TSSJ CHE EXCP     106 INVSORTD
  00131 XCRB TSSJ TSSJ CHE EXCP      60 ADDCLSTF
  00131 TSSJ XLOP TSSJ TOP EXCP       4 TSSJXCRB
  

Problem conclusion

• Modified EYU0XCRB to delete the invalid topology resmap records
  for the MAS.  Additionally, a new trace record will be written
  to the CMAS auxiliary trace data set as follows:
  
  MTD  PREV TRAN OBJ LEVL  PT-ID   DEBUG
  XCRB TSSC TSSC CHE EXCP     72 XCLASEQF
  

Temporary fix

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

Comments

APAR Information

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

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

  UK74701 UK74702

Modules/Macros

•    EYU0XCRB
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK74701

     UP11/12/14 P F112

• R70M PSY UK74702

     UP11/12/14 P F112

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.