PK54433: EYUXL0108E MESSAGE ON CMAS START UP - CAS REGISTRATION FAILS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Message EYUXL0108E is issued during start up of the CMAS when
  trying to cancel the timer for the posted timeout ECB.  The
  trace shows a CANCERR occurred due to an INVALID REQID_NOT_FOUND
  condition followed by a TIMEOUT entry.  In EYU0XLCE, the timeout
  ECB will expire after 30 seconds.  If the ECB has been posted,
  the timer will be cancelled.  XLCE started about 35 seconds
  before the failure occurred.  So by the time it got re-dispatch,
  the ECB has been posted and the CICS tmer ECB has expired.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: -  Message EYUXL0108E:                  *
  *                                                              *
  *                           EYUXL0108E CICSPlex registration   *
  *                                      failed                  *
  *                                                              *
  *                         may be issued invalidly instead of   *
  *                         message EYUXL0008I:                  *
  *                                                              *
  *                           EYUXL0008I CICSPlex registration   *
  *                                      complete                *
  *                                                              *
  *                         if the CMAS is busy.  The message    *
  *                         will occur during CMAS               *
  *                         initialization if the CAS address    *
  *                         space is active when the CMAS        *
  *                         starts.  Otherwise the message will  *
  *                         occur when the CAS address space is  *
  *                         started.                             *
  *                                                              *
  *                         Examination of the CMAS's auxtrace   *
  *                         dataset will show the following      *
  *                         exceptions:                          *
  *                                                              *
  *                           Method  TPID  Debug text           *
  *                           ------  ----  ----------           *
  *                           XSCN       4  CANCERR              *
  *                           XLCE      14  TIMEOUT              *
  *                                                              *
  *                         Additionally, in contradiction to    *
  *                         the description of message           *
  *                         EYUXL0108E, no SVC dump will be      *
  *                         issued and CMAS execution will       *
  *                         continue.                            *
  *                                                              *
  *                      -  Message EYUXL0108E:                  *
  *                                                              *
  *                           EYUXL0108E CICSPlex registration   *
  *                                      failed                  *
  *                                                              *
  *                         will be issued instead of message    *
  *                         EYUXL0014I:                          *
  *                                                              *
  *                           EYUXL0014I CAS connection          *
  *                                      terminated              *
  *                                                              *
  *                         when the CAS address space is        *
  *                         terminated while the CMAS is still   *
  *                         active.                              *
  ****************************************************************
  * 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 connects to the CAS address space, module
     EYU9XLEV calls method EYU0XLCE (XLCE) to register all
     CICSplexes managed by the CMAS with the ESSS (to allow MASes
     to CONNECT to the CMAS) and with the CAS (to allow ISPF end-
     user interface (EUI) access to the CMAS and its CICSplexes).
  
     To register with the CAS, XLCE posts module EYU9XLEC, which
     runs under an MVS TCB and communicates with the CAS address
     space.  XLCE then waits for EYU9XLEC to post it back to
     indicate that the request has been completed.  Before posting
     EYU9XLEC, XLCE starts a CICS timer for 30 seconds.  When XLCE
     waits for EYU9XLEC to complete its processing, it also waits
     on the timer, to ensure that it will not wait forever if
     EYU9XLEC encounters a problem servicing the request.  When
     XLCE is posted by EYU9XLEC, it will issue a cancel request
     for the unexpired timer.
  
     If the CMAS is busy and XLCE does not get dispatched until it
     is posted by EYU9XLEC and the timer has expired, XLCE will
     still attempt to cancel the timer, which will result in a
     failure, even though all processing has been completed.  When
     XLCE returns the failure to EYU9XLEV, message EYUXL0108E will
     be issued, even though the registrations completed OK.
  
     Additionally, even though message EYUXL0104E is issued, CMAS
     execution continues and no SVC dump is produced.
  
  -  When the CAS address space is terminated while the CMAS
     remains active, EYU9XLEV calls XLCE to notify internal CPSM
     components that the CAS connection has terminated.  Upon
     return from XLCE, EYU9XLEV incorrectly issues message
     EYUXL0108E instead of EYUXL0014I.
  

Problem conclusion

• -  XLCE has been updated as follows:
  
     -  the timer cancel request has been changed such that it
        will not fail if the timer has expired.
  
     -  if the timer cancel request fails, an exception trace
        will be issued and an OK response will be returned to
        EYU9XLEV.
  
     -  if a non-OK response is going to be returned to EYU9XLEV,
        a dump will be requested.  The title of the dump will be
        similar to the following:
  
          EYU0XZPT Dump,<cmasjobn>,<cmasname>,<lpar>,CMAS,XLEV,
          <tasknum>,TRAC,EYU0XLCE,date,time
  
  -  EYU9XLEV has been updated to issue message EYUXL0014I instead
     of message EYUXL0108E when the CAS address space terminates
     while the CMAS is still active.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• -  Message EYUXL0108E:
  
       EYUXL0108E CICSPlex registration
                  failed
  
     may be issued invalidly instead of
     message EYUXL0008I:
  
       EYUXL0008I CICSPlex registration
                  complete
  
     if the CMAS is busy.  The message
     will occur during CMAS
     initialization if the CAS address
     space is active when the CMAS
     starts.  Otherwise the message will
     occur when the CAS address space is
     started.
  
     Examination of the CMAS's auxtrace
     dataset will show the following
     exceptions:
  
       Method  TPID  Debug text
       ------  ----  ----------
       XSCN       4  CANCERR
       XLCE      14  TIMEOUT
  
     Additionally, in contradiction to
     the description of message
     EYUXL0108E, no SVC dump will be
     issued and CMAS execution will
     continue.
  
  -  Message EYUXL0108E:
  
       EYUXL0108E CICSPlex registration
                  failed
  
     will be issued instead of message
     EYUXL0014I:
  
       EYUXL0014I CAS connection
                  terminated
  
     when the CAS address space is
     terminated while the CMAS is still
     active.
  
  
  -  When a CMAS connects to the CAS address space, module
     EYU9XLEV calls method EYU0XLCE (XLCE) to register all
     CICSplexes managed by the CMAS with the ESSS (to allow MASes
     to CONNECT to the CMAS) and with the CAS (to allow ISPF end-
     user interface (EUI) access to the CMAS and its CICSplexes).
  
     To register with the CAS, XLCE posts module EYU9XLEC, which
     runs under an MVS TCB and communicates with the CAS address
     space.  XLCE then waits for EYU9XLEC to post it back to
     indicate that the request has been completed.  Before posting
     EYU9XLEC, XLCE starts a CICS timer for 30 seconds.  When XLCE
     waits for EYU9XLEC to complete its processing, it also waits
     on the timer, to ensure that it will not wait forever if
     EYU9XLEC encounters a problem servicing the request.  When
     XLCE is posted by EYU9XLEC, it will issue a cancel request
     for the unexpired timer.
  
     If the CMAS is busy and XLCE does not get dispatched until it
     is posted by EYU9XLEC and the timer has expired, XLCE will
     still attempt to cancel the timer, which will result in a
     failure, even though all processing has been completed.  When
     XLCE returns the failure to EYU9XLEV, message EYUXL0108E will
     be issued, even though the registrations completed OK.
  
     Additionally, even though message EYUXL0104E is issued, CMAS
     execution continues and no SVC dump is produced.
  
  -  When the CAS address space is terminated while the CMAS
     remains active, EYU9XLEV calls XLCE to notify internal CPSM
     components that the CAS connection has terminated.  Upon
     return from XLCE, EYU9XLEV incorrectly issues message
     EYUXL0108E instead of EYUXL0014I.
  
  
  -  XLCE has been updated as follows:
  
     -  the timer cancel request has been changed such that it
        will not fail if the timer has expired.
  
     -  if the timer cancel request fails, an exception trace
        will be issued and an OK response will be returned to
        EYU9XLEV.
  
     -  if a non-OK response is going to be returned to EYU9XLEV,
        a dump will be requested.  The title of the dump will be
        similar to the following:
  
          EYU0XZPT Dump,<cmasjobn>,<cmasname>,<lpar>,CMAS,XLEV,
          <tasknum>,TRAC,EYU0XLCE,date,time
  
  -  EYU9XLEV has been updated to issue message EYUXL0014I instead
     of message EYUXL0108E when the CAS address space terminates
     while the CMAS is still active.
  

APAR Information

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

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

  UK33711

Modules/Macros

•    EYUTXLM0 EYU0XLCE EYU9XLEV
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK33711

     UP08/02/19 P F802

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.