PM69822: COI0 TASK TERMINATED DUE TO UNRECOVERABLE ERROR EYUCL0105E EYUNL0905E EYU0NLSD

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The MAS region was under stress due to short on storage
  condition above the line when the ESSS receive link task (COI0)
  was terminated with the following messages:
    EYUCL0105E ESSS RECEIVE LINK TASK TERMINATED ABNORMALLY.
    EYUNL0905E AN UNRECOVERABLE ERROR HAS OCCURRED.  THE MAS
      AGENT IS BEING TERMINATED.
  The trace showed the following:
    CTER CTES COI0 COM EXCP.      1 EXCEPT   CPSM cmasname LMAS
    CTES CLEV COI0 COM EXCP.      3 EXCEPT   CPSM cmasname LMAS
    CLEV XLOP COI0 COM EXCP.      3 EXCEPT   CPSM cmasname LMAS
  Method CTER attempted to get some storage when it received a
  'Getmain Exception' (point-id 1 = CMPI_XCPT_XSCG).  This
  exception is then percolated up to method CTES which received a
  'Recomposition Exception' (point-id 3 = CMPI_XCPT_CTER).  This
  in turn is percolated up to method CLEV which produced the
  EYUCL0105E message which triggers the EYUNL0905E message and
  the dump.  The MAS agent code is then terminated.
  Additional Symptom(s) Search Keyword(s): KIXREVCTC
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R2M0 users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: If a MAS cannot process a request sent  *
  *                      to it from a CMAS, for example, if the  *
  *                      MAS is under stress due to a short on   *
  *                      storage (SOS) condition and cannot      *
  *                      allocate enough storage to process the  *
  *                      request, then the MAS agent code will   *
  *                      terminate with the following messages:  *
  *                                                              *
  *                        EYUCL0105E  ESSS Receive Link Task    *
  *                                    terminated abnormally.    *
  *                                                              *
  *                        EYUNL0905E  An unrecoverable error    *
  *                                    has occurred.  The MAS    *
  *                                    agent is being            *
  *                                    terminated.               *
  *                                                              *
  *                      The shutdown may also be accompanied by *
  *                      a dump.  If so, the title of the dump   *
  *                      will be similar to the following:       *
  *                                                              *
  *                        EYU0XZPT Dump,<jobname>,<masname>,    *
  *                        <lpar>,LMAS,COI0,<tasknum>,TRAC,      *
  *                        EYU0NLSD,<mm/dd/yy>,<hh:mm:ss>        *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMAS and MASes, including those    *
  *                 MASes executing as WUI servers, must be      *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  *                                                              *
  ****************************************************************
  When a request is sent from a CMAS to a MAS, method EYU0CLEV
  (CLEV) in the MAS retrieves the buffer containing the request,
  and passes it to method EYU0CTES (CTES).  CTES, and the methods
  it calls, are responsible for recomposing the buffer into a
  message argument list (MAL) and calling the program that should
  process the MAL.  If an error occurs during this process, then
  CTES returns a failure to CLEV, which will terminate the MAS
  agent code.
  

Problem conclusion

• CTES has been updated to never return a failure to CLEV.
  Instead, if an error occurs during either recomposition of the
  buffer or if execution of the recomposed MAL cannot be
  performed, CLEV will call method EYU0CTBT (CTBT) to return the
  buffer to the CMAS, after marking that the request has failed
  with a RESPONSE of KERNERROR (5) and a REASON of KERR_NPRC
  (231).  CLEV will then perform cleanup of the structures
  allocated for the request, and return OK to CLEV.
  
  API commands that may experience this problem are GET, PERFORM
  OBJECT, PERFORM SET, REFRESH and SET, and for CSD resources
  only, CREATE, REMOVE and UPDATE.  When the problem is
  encountered, the command will receive a RESPONSE of ENVIRONERROR
  (1030) and a REASON of NOTPROCESSED (1378).
  
  API programs that process a FEEDBACK record for such requests
  will receive a FEEDBACK_RESPONSE of ENVIRONERROR (1030) and a
  FEEDBACK_REASON of NOTPROCESSED (1378).
  
  API programs that process a MASQRYER record for such requests
  will receive an MASQRYER_ERRORTYPE of REQNOTPROCED (743).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE13/05/30 FIX IN ERROR. SEE APAR PM90161  FOR DESCRIPTION
  

APAR Information

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

  PM59843

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

  UK81320 UK81321

Modules/Macros

•    DFHSMTAB EYUA2639 EYUC2639 EYUEVGAR EYUE2639
  EYUKVGAR EYUK2639 EYUL2639 EYUP2639 EYUSVGAR EYUS2639 EYUTMOMI
  EYUTMOSD EYUTVOSX EYUT2639 EYUY2639 EYU0ABM0 EYU0CTBT EYU0CTER
  EYU0CTES EYU0CTEX EYU0DXRC EYU0MOFB EYU0VISZ EYU0XDER EYU0XDP1
  EYU9CMRU EYU9CMR3 EYU9CMR4 EYU9DBG1 EYU9XMAL
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50M PSY UK81321

     UP12/09/07 P F209

• R500 PSY UK81320

     UP12/09/07 P F209

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.