PM59843: 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 V4R1M0 and V4R2M0 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, CTES 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).  CTES 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 PM90137  FOR DESCRIPTION
  

APAR Information

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

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

  UK79201 UK79202 UK79203 UK79204 PM69822

Modules/Macros

•    DFHSMTAB DYU0MOFB DYU0VISZ EYUA2639 EYUCXXRS
  EYUC2639 EYUEVGAR EYUKVGAR EYUL2639 EYUP2639 EYUQCTBT EYUQXXRC
  EYURCTBT EYURVGAR EYURXLMF EYUSVGAR EYUTMOMI EYUTMOSD EYUTRCOM
  EYUTRDIR EYUTVOSX EYUT2639 EYUUXXFI EYUUXXRS EYUUXXTC EYUYCTBT
  EYUY2639 EYUZCTBT EYU0ABM0 EYU0CTBT EYU0CTER EYU0CTES EYU0CTEX
  EYU0DXRC EYU0MOFB EYU0VISZ EYU0XDER EYU0XDP1 EYU9CMRU EYU9CMR3
  EYU9CMR4 EYU9DBG1 EYU9XMAL MASQRYER
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK79202

     UP12/06/15 P F206

• R600 PSY UK79201

     UP12/06/15 P F206

• R70M PSY UK79204

     UP12/06/15 P F206

• R700 PSY UK79203

     UP12/06/15 P F206

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.