PM90164: EYUCL0122E MAS COMMUNICATIONS BUFFER SHORTAGE. EXISTING BUFFERS ORPHANED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You receive message
  EYUCL0122E MAS communications buffer shortage has been detected.
  If this is the first time during the run of the region that
  this shortage has occurred, CPSM will take a diagnostic SVC
  dump and write a EYUXZ0910I message with the dump title similar
  to the following:
  EYUXZ0910I Dump,cmasappl,cmasjob,sysid,xxxx,tranid,
           0012345,TRAC,EYU0CTBT,dd/mm/yyyy,hh:mm:ss.
  .
  In the EYUXZ0910I message, you will have the task number.
  Above, it is 0012345.
  .
  Additional Keywords/Symptoms: kixrevsvr
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: An overlay of the MAS dataspace may     *
  *                      occur if an API or internal request     *
  *                      sent by a CMAS to a MAS fails with a    *
  *                      RESPONSE of ENVIRONERROR (1030) and a   *
  *                      REASON of NOTPROCESSED (1378).          *
  *                                                              *
  *                      This can result in invalid results for  *
  *                      other requests, and will most likely    *
  *                      cause the orphaning of MAS              *
  *                      communication buffers, resulting in the *
  *                      following message being issued by the   *
  *                      CMAS or any MAS connected to it:        *
  *                                                              *
  *                       EYUCL0122E MAS communications buffer   *
  *                                  shortage has been detected. *
  ****************************************************************
  * 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 MAS cannot process a request sent to it from a CMAS,
  method EYU0CTBT (CTBT), running in the MAS, copies the original
  request into a buffer, sets the appropriate response information
  and returns the request to the CMAS with a RESPONSE of
  ENVIRONERROR (1030) and a REASON of NOTPROCESSED (1378).
  
  A logic error in CTBT causes it to use an invalid length to copy
  the original request, resulting in the overlaying of storage in
  the MAS dataspace.  This overlay can invalidly modify other
  buffers, and will most likely cause many of the buffers to be
  orphaned.  Since there is a finite pool of MAS communications
  buffers, it is possible that if many are orphaned, subsequent
  requests will not be able to acquire a buffer, resulting in the
  EYUCL0122E message.
  

Problem conclusion

• CTBT has been updated to use the correct length when copying the
  incoming request to the communications buffer.
  

Temporary fix

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

Comments

APAR Information

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

  PM90137

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

  UK94994

Modules/Macros

• EYU0CTBT EYU0CTER
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R80M PSY UK94994

     UP13/06/12 P F306

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.