PK06734: EYUTS0002E DBPECM1R TOPOLOGY CONNECT FAILED NO MAS CAN CONNECT TO CMAS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• All MAS fail to connect to CMAS.
  The CMAS jobslogs has:
  EYUTS0001I DBPECM1R Topology Connect for DBPRCIPM Initiated
  EYUTS0002E DBPECM1R Topology Connect for DBPRCIPM Failed
  .
    The LMAS message log has
  EYUNL0171I DBPRCIPM History Recorder has been terminated
  DFHAP0701 DBPRCIPM An abend (code 0E0/AKEB) has occurred
    in exit program EYU9NMTE at exit point XMNOUT.
  .
  The LMAS AKEB dump has error information in the KE section:
  <><><><><><><><><><><><><><><-><><><><><><><><><><><><><><><><>
   Error happened in program -noheda- at offset 000002E6
   Error happened under the CICS RB.
   CICS Registers and PSW.
     PSW:  078D6000 A19DDF86   Instruction Length: 2
       Interrupt Code: 29
     REGISTERS 0-15
      0000  E4E2C5D9 E3C1C2D3 00000000 A19DDD98
            008FE000 008FE040 20B5C000 00001846
            *USERTABL.......q..\...\ ..{.....*
      0020  20E4005C 216874B0 00000001 0007E004
            00000000 20E402C0 00000002 00001846
            *.U.*..........\......U.{........*
    Data at PSW: A19DDF86    Module: -noheda-   Offset: 000002E6
  PSWDATA 219DDCA0
  >SRVHEAD  EYU9NMTENMTE220 08/18/0415 UQ91876
  <><><><><><><><><><><><><><><-><><><><><><><><><><><><><><><><>
  This is module EYU9NMTE. at label NMTE_DO_DICTIONARY.
  The code loads Reg14 from WHDR_WORKAREA_PTR_O in the MAS
  dataspace which appears to have been overlaid.
  .
  .
  Additional keywords:
  corrupted overlay overlayed data space MASDATASPACE
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a CMAS is terminated while local   *
  *                      MASes that are connected to it remain   *
  *                      active, if an error occurs while the    *
  *                      MASes are disconnected, the MASes may   *
  *                      fail to connect when the CMAS restarts, *
  *                      resulting in message EYUTS0002E.        *
  *                                                              *
  *                      Note that the errors that occur during  *
  *                      CMAS termination may not produce any    *
  *                      external symptoms except for the        *
  *                      connect failure (EYUTS0002E) at CMAS    *
  *                      restart.                                *
  ****************************************************************
  * 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 is terminated, method EYU0CLET (CLET) is called to
  disconnect any local MASes that are still active.  CLET calls
  method EYU0CLFX (CLFX) to RESET the link between the CMAS and
  MAS.  As part of this process, CLFX will call method EYU0XSRU
  (XSRU) to unregister a lock block that is used to control
  communications between the CMAS and the MAS.  If the unregister
  fails, possibly due to the corruption of the MAS dataspace
  storage where the lock block resides, exception traces are
  issued by XSRU and CLFX, but processing continues as if an error
  did not occur.  After all local MASes have been disconnected,
  CLET calls method EYU0XCBR (XCBR) to free the dataspace storage
  where the lock blocks reside, and CMAS termination continues
  until completion.
  
  When the CMAS restarts, CLET will call method EYU0XCBA (XCBA) to
  acquire storage for the lock blocks.  When a local MAS attempts
  to connect to the CMAS, CLET will call CLFX to set the link
  ACTIVE.  As part of this process, CLFX will attempt to register
  the lock block for the connection.  If the storage acquired by
  CLET at CMAS startup is in the same location as the storage that
  was released when the CMAS previously terminated, then since the
  lock block was not unregistered successfully, the register will
  fail, and as a result, the connect will fail.
  

Problem conclusion

• CLET has been updated to check for CLFX RESET errors, and also
  to check if the lock block area is corrupted.  If either
  situation occurs, CLET will request a dump, issue new message
  EYUCL0125E, issue an exception trace with a debug text of
  "EXCEPT" and a trace point ID of 30, and terminate without
  freeing the storage where the lock blocks reside.  This will
  ensure that when the CMAS restarts, the storage allocated for
  the lock blocks will not be the same location as the invalid
  data from the last run of the CMAS.
  
  The title of the dump will be similar to the following:
  
    EYU0XZSD Dump,cmasjobn,cmasname,lpar,CMAS,LEEI,tasknum,TRAC,
    EYU0CLET,mm/dd/yy,hh:mm:ss
  
  The text of new message EYUCL0125E is:
  
    EYUCL0125E  ESSS ICT encountered an error during CMAS
                termination
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• When a CMAS is terminated while local
  MASes that are connected to it remain
  active, if an error occurs while the
  MASes are disconnected, the MASes may
  fail to connect when the CMAS restarts,
  resulting in message EYUTS0002E.
  
  Note that the errors that occur during
  CMAS termination may not produce any
  external symptoms except for the
  connect failure (EYUTS0002E) at CMAS
  restart.
  
  
  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 is terminated, method EYU0CLET (CLET) is called to
  disconnect any local MASes that are still active.  CLET calls
  method EYU0CLFX (CLFX) to RESET the link between the CMAS and
  MAS.  As part of this process, CLFX will call method EYU0XSRU
  (XSRU) to unregister a lock block that is used to control
  communications between the CMAS and the MAS.  If the unregister
  fails, possibly due to the corruption of the MAS dataspace
  storage where the lock block resides, exception traces are
  issued by XSRU and CLFX, but processing continues as if an error
  did not occur.  After all local MASes have been disconnected,
  CLET calls method EYU0XCBR (XCBR) to free the dataspace storage
  where the lock blocks reside, and CMAS termination continues
  until completion.
  
  When the CMAS restarts, CLET will call method EYU0XCBA (XCBA) to
  acquire storage for the lock blocks.  When a local MAS attempts
  to connect to the CMAS, CLET will call CLFX to set the link
  ACTIVE.  As part of this process, CLFX will attempt to register
  the lock block for the connection.  If the storage acquired by
  CLET at CMAS startup is in the same location as the storage that
  was released when the CMAS previously terminated, then since the
  lock block was not unregistered successfully, the register will
  fail, and as a result, the connect will fail.
  
  
  CLET has been updated to check for CLFX RESET errors, and also
  to check if the lock block area is corrupted.  If either
  situation occurs, CLET will request a dump, issue new message
  EYUCL0125E, issue an exception trace with a debug text of
  "EXCEPT" and a trace point ID of 30, and terminate without
  freeing the storage where the lock blocks reside.  This will
  ensure that when the CMAS restarts, the storage allocated for
  the lock blocks will not be the same location as the invalid
  data from the last run of the CMAS.
  
  The title of the dump will be similar to the following:
  
    EYU0XZSD Dump,cmasjobn,cmasname,lpar,CMAS,LEEI,tasknum,TRAC,
    EYU0CLET,mm/dd/yy,hh:mm:ss
  
  The text of new message EYUCL0125E is:
  
    EYUCL0125E  ESSS ICT encountered an error during CMAS
                termination
  

APAR Information

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

  PK06692

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

  UK08250

Modules/Macros

•    EYUTCMM0 EYUUCMEQ EYU0CLET
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK08250

     UP05/10/21 P F510

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.