PH17256: CPSM: EYUXC0023S CACHE LIMIT REACHED FOR BAS CACHE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After recently defining several new sessions, the MP CMAS was
  terminated because the cache limit for the BAS data space was
  reached. It was unable to extend the data space and issued the
  following messages:
  .
  EYUXC0023S applid MAXIMUM DATA CACHE LIMIT HAS BEEN REACHED FOR
    BAS CACHE.
  EYUXC0024S applid THE CMAS IS TERMINATING DUE TO A PREVIOUS
    ERROR WITH THE CACHE COMPONENT.
  .
  The error was due to the DAT transaction issue a MAXCHEDS
  exception when it tried to add a new cache block to the BAS
  dataspaces. The CMAS exception trace contained the following
  entries:
  .
   Task  Mtd  Prev Tran Obj Level Pt-ID Debug    UOW
   12345 XCEC XCBA XDNR CHE Excp  21    MAXCHEDS Ext
   12345 XCCL XCEC XDNR CHE Excp  114   AuxLimit Ext
  .
  Looking at the BAS data space summary, there were 4 dataspaces,
  3 of which were using about 1.7G and the 4th closer to the 2G
  limit:
  .
   Type    Alet     Token    Name     Low      High     Pages
   Private 01010077 AA000100 BAS1CMAS 00001000 7EFFF000 0007EFFF
   Private 01010078 AA000200 BAS2CMAS 00001000 6A900000 0006A900
   Private 01010079 AA000300 BAS3CMAS 00001000 7F900000 0007F900
   Private 0101007A AA000400 BAS4CMAS 00001000 7F900000 0007F900
  

Local fix

• Increasing CACHEDSNUM EYUPARM may help
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CPSM users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Requests for CICSPlex SM data space     *
  *                      storage can fail even when sufficient   *
  *                      contiguous free storage is available    *
  *                      to satisfy the request.                 *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF which resolves        *
  *                 PH17256, all CMASes, MASes (including WUI    *
  *                 servers) and CPSM Batch API address spaces   *
  *                 should be restarted to enable the fix.       *
  *                 Note that the restarts do not need to occur  *
  *                 at the same time and may occur in any order. *
  ****************************************************************
  The CICSPlex SM Cache (CHE) component manages the data space
  storage used by other CPSM components. When a component makes
  a request for data space storage, CHE will assign a free
  storage area if possible. If no sufficiently large free area
  exists then CHE will grow the data space by using the DSPSERV
  service to request additional blocks of storage be assigned.
  
  In some cases CHE may decide to extend the data space using
  DSPSERV even though sufficient contiguous free storage
  exists to satisfy a request for new storage.
  
  CHE will call DSPSERV to request more storage blocks than
  required for a request for data space storage when the following
  conditions are met:
  
  1. The request can't be satisfied by any existing allocated but
     now free storage area.
  2. The request can't be satisfied by the area between the
     highest allocated storage address to the end of available
     data space storage (2GB).
  3. The request can be satisfied by a contiguous area comprised
     of an allocated and used but now free storage area, to the
     end of the allocated but unused storage area.
  
  Eventually a point is reached where these allocated (but unused)
  blocks extend almost to the limit of the data space (2GB). At
  this point if CHE attempts to extend the data space further,
  such that the 2GB limit of data space storage is reached, then
  the CMAS will terminate.
  

Problem conclusion

• EYU0XCEC has been updated to alleviate this situation by
  removing the need to request additional storage blocks in
  the case described.
  

Temporary fix

Comments

APAR Information

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

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

  UI65825 UI65826 UI65827

Modules/Macros

• EYU0UCEC EYU0XCEC
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI65825

     UP19/10/12 P F910

• R10M PSY UI65826

     UP19/10/12 P F910

• R20M PSY UI65827

     UP19/10/12 P F910

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.