PM92598: CPSM EOT EOM EXITS NOT CLEANING UP AFTER MAS TERMINATION. EYUCL0107E IN CMAS EYULOG UPON MAS RESTART ATTEMPTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You have a CICS region (Managed Address Space, MAS) that is
  connected to CPSM. Your MAS experiences MVS related storage
  issues such as S878 or S80A. The region either terminates on
  its own or you cancel the region through the console. At this
  point the region terminates, and you may see an S922 return
  code.
  .
  Because CPSM has told MVS that they are to be notified when an
  address space goes away, the CPSM EOT (End Of Task) and EOM
  (End Of Memory) routines are invoked by MVS RTM. These EOT and
  EOM routines are supposed to clean up the CPSM environment when
  a MAS region ends. However, due to the storage shortage, the
  exit routines may not be able to perform their function. This
  may leave the CPSM environment in a state where it believes the
  MAS region is still running, even after it has terminated.
  On the subsequent restarts of the MAS, CICS will initialize but
  the CPSM MAS agent will not connect to the CMAS. You will see
  the following messages in your MAS
  .
  EYUCL0112E <masappl> Protocol Services initialization unable
                       to perform ICT Attach.
  EYUCL0124E <masappl> A failure occurred while attempting to
                       connect to CMAS <cmasname>.
  EYUCL0101E <masappl> Protocol Services initialization failed.
  EYUCI0101E <masappl> Communications initialization failed.
  EYUXM0004I <masappl> Message Services termination complete
  EYUXL0023I <masappl> Trace Services termination requested
  EYUXZ0001I <masappl> Trace Services termination complete
  EYUXL0012I <masappl> ESSS disconnect complete
  EYUXL0112E <masappl> LMAS initialization failed
  .
  .
  While in the EYULOG for the CMAS that it's trying to connect to
  you will see the following:
  .
       Shortly after the previous run of the MAS terminated:
  EYUCS0207W <cmasappl> Connected MAS <masname> is not
                        responding - APPLID(<masname>)
                        CICSplex(plexname).
  .
  .
       and then upon restart attempts for this same MAS, you see:
  EYUCL0008I <cmasappl> ESSS ICT entered for Attach to <masname>.
  EYUCL0107E <cmasappl> ESSS ICT attach to <masname> failed,
                        MAS already exists.
  EYUCL0009I <cmasappl> ESSS ICT entered for Detach from
                        <masname>.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVSCB
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You have a CPSM Managed Address      *
  *                      Space (MAS) which is connected to a     *
  *                      CMAS. Your MAS experiences MVS re-      *
  *                      lated storage issues such as abend      *
  *                      S878 or abend S80A. Either the region   *
  *                      terminated on its own or you cancelled  *
  *                      the region through the system console.  *
  *                      The region terminated and you might     *
  *                      have seen an S922 abend.                *
  *                                                              *
  *                         On the subsequent restarts of the    *
  *                      MAS, CICS will initialize but the CPSM  *
  *                      MAS agent will not connect to the CMAS. *
  *                      You will see the following messages in  *
  *                      your MAS joblog:                        *
  *                      .                                       *
  *                           EYUCL0112E  Protocol Services      *
  *                                initialization unable to      *
  *                                perform ICT Attach.           *
  *                           EYUCL0124E  A failure occurred     *
  *                                while attempting to connect   *
  *                                to CMAS <cmasname>.           *
  *                           EYUCL0101E  Protocol Services      *
  *                                initialization failed.        *
  *                      .                                       *
  *                      and finally:                            *
  *                      .                                       *
  *                           EYUXL0012I  ESSS disconnect        *
  *                                complete                      *
  *                           EYUXL0112E  LMAS initialization    *
  *                                failed                        *
  *                      .                                       *
  *                         In the EYULOG for the CMAS to which  *
  *                      the MAS attempted to connect you will   *
  *                      see the following messages.             *
  *                      .                                       *
  *                      Shortly after the MAS terminated:       *
  *                      .                                       *
  *                           EYUCS0207W  Connected MAS <mas>    *
  *                                is not responding -           *
  *                                APPLID(<masappl>)             *
  *                                CICSplex(<plexname>).         *
  *                      .                                       *
  *                      Then during restart attempts for this   *
  *                      same MAS, you see:                      *
  *                      .                                       *
  *                           EYUCL0008I  ESSS ICT entered for   *
  *                                Attach to <mas>.              *
  *                           EYUCL0107E  ESSS ICT attach to     *
  *                                <mas> failed, MAS already     *
  *                                exists.                       *
  *                           EYUCL0009I  ESSS ICT entered for   *
  *                                Detach from <mas>.            *
  ****************************************************************
  * RECOMMENDATION: After applying this PTF, all CMASes, MASes   *
  *                 and WUI servers must be restarted with the   *
  *                 updated code.                                *
  *                                                              *
  *                 To restart with the updated code, the CPSM   *
  *                 Environment Service System Services (ESSS)   *
  *                 subsystem address space (EYUX310) must be    *
  *                 terminated and the CPSM EYUX subsystem End   *
  *                 of Task (EOT) exit (EYU9XEET) must be re-    *
  *                 loaded on the MVS image if a CMAS has been   *
  *                 started without the updated code, since the  *
  *                 last IPL.                                    *
  *                                                              *
  *                 This can be accomplished in either of two    *
  *                 ways:                                        *
  *                                                              *
  *                   1 - IPL the MVS Image.  This terminates    *
  *                       the ESSS and the EYUX subsystem.  When *
  *                       the first CMAS starts after the IPL,   *
  *                       the ESSS address space and the EYUX    *
  *                       subsystem will be started at the pro-  *
  *                       per level.                             *
  *                                                              *
  *                 Or:                                          *
  *                                                              *
  *                   2 - Stop all CMASes and MASes on an MVS    *
  *                       image.                                 *
  *                                                              *
  *                     - Use EYU9XENF to check that no address  *
  *                       spaces are connected to the ESSS sub-  *
  *                       system.                                *
  *                                                              *
  *                     - Use the EYU9XEUT TERMINATE function to *
  *                       stop the ESSS.                         *
  *                                                              *
  *                     - Use the EYU9XEUT RELOAD function with  *
  *                       the EOT option to reload EYU9XEET,     *
  *                       ensuring that UTILLIB specifies the    *
  *                       SEYUAUTH library updated by the PTF.   *
  *                                                              *
  *                     - Refresh LLA to ensure the updated      *
  *                       version of EYU9X310 is picked up.      *
  *                                                              *
  *                     - Restart any CMASes, MASes, and WUI     *
  *                       servers which execute on the MVS       *
  *                       image, ensuring that the updated       *
  *                       libraries are being picked up.  When   *
  *                       the first CMAS is started the ESSS     *
  *                       address space will be started at the   *
  *                       proper level.                          *
  *                                                              *
  *                 For details on EYU9XENF and the EYU9XEUT     *
  *                 TERMINATE and RELOAD functions, please       *
  *                 refer to "CICS Transaction Server for z/OS   *
  *                 CICSPlex SM Problem Determination Guide      *
  *                 Version 3 Release 1" (GC34-6472-xx).         *
  *                                                              *
  *                    Note that each MVS image can be updated   *
  *                 separately, and systems on an MVS image that *
  *                 are using the new code can communicate with  *
  *                 systems on other MVS images that are not yet *
  *                 using the new code.                          *
  ****************************************************************
     Because CPSM has installed subsystem End of Task and End of
  Memory exits, when an address space terminates modules EYU9XEET
  (XEET - CPSM End Of Task Exit) and EYU9XEEM (XEEM - CPSM End of
  Memory Exit) are invoked by MVS RTM.  These EOT and EOM modules
  are intended to clean up the CPSM environment when a MAS region
  ends.  However, because of the storage shortage, the EOT exit
  might not be called for all ending tasks, or if called, might
  be unable to perform the intended cleanup function.  This could
  leave the CPSM environment in a state where the CMAS believes
  that the MAS is still connected, even after the region has
  terminated.
  

Problem conclusion

•    The CPSM CONNECT PC routine was modified to store a pointer
  to the work area acquired when it is entered in the region's
  Subsystem Connection Block (XECB).  If the TERMINATE PC routine
  finds a valid XECB containing a saved work area pointer, it
  will use the pre-allocated block rather that acquiring its own
  work area.  On completion, the TERMINATE routine will free the
  work area storage.  When called for end of memory, a valid XECB
  will not exist, but the EOM exit executes in the Scheduler
  address space, which will not be storage constrained.
     Normally the TERMINATE function is invoked to clean up any
  resources if a CPSM environment is found to exist when the EOT
  exit is driven for the TCB which originally connected to the
  ESSS subsystem.  (In a CMAS or MAS, this is the QR TCB.)  The
  CPSM subsystem exit router EYU9XEER (XEER) and the EOT exit
  EYU9XEET were modified to invoke the TERMINATE function if a
  CPSM environment still exists when the EOT exit is entered for
  the Job Step Task (DFHSIP in a MAS, EYU9XSTC in a CMAS).
     Because the MVS Address Space Control Block (ASCB) may no
  longer be valid when subsystem EOM exits are called, the ASID
  of the ASCB whose address was stored in the Connected Address
  Space Table Element (CASTE) will not be compared to the value
  passed in the parameter list if the TERMINATE PC routine is
  called by the EOM exit.
  

Temporary fix

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

Comments

APAR Information

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

  PM92592

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

  UI12154

Modules/Macros

•    EYUTXEPC EYU9XECS EYU9XEET EYU9X310
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UI12154

     UP13/11/06 P F311

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.