PM90137: 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. This problem occurs after you apply fixes
  below, depending upon your release:
  Release  APAR    PTF
  4.2      PM59843 UK79203
  4.2      PM59843 UK79204
  .
  3.2      PM69822 UK81320
  3.2      PM69822 UK81321
  .
  4.1      PM59843 UK79201
  4.1      PM59843 UK79202
  .
  Additional Keywords/Symptoms: kixrevsvr
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: After applying PTFs UK79201 and UK79202 *
  *                      (CPSM V4R1M0) or UK79203 and UK79204    *
  *                      (CPSM V4R2M0) for APAR PM59843, 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,
  changes made for APAR PM59843 allowed the MAS to return the
  request to the CMAS with a RESPONSE of ENVIRONERROR (1030) and a
  REASON of NOTPROCESSED (1378).  To achieve this, 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.
  
  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:

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

  PM90161 PM90164 UK94986 UK94987 UK94988 UK94989

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
  EYU9CMPU EYU9CMP3 EYU9CMP4 EYU9CMRU EYU9CMR3 EYU9CMR4 EYU9DBG1
  EYU9XMAL
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK94987

     UP13/06/12 P F306 ®

• R600 PSY UK94986

     UP13/06/12 P F306 ®

• R70M PSY UK94989

     UP13/06/12 P F306 ®

• R700 PSY UK94988

     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.