PI35668: EYUXC0023S MAXIMUM DATA CACHE LIMIT HAS BEEN REACHED FOR WLM CACHE DUE TO EXHAUSTED WNLE POOL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• About 24 hours after applying maintenance (PI17717/UI18977) to
  your CPSM 5.1 environment, your CMAS issues message:
  .
  EYUXC0023S cmasname Maximum data cache limit has been reached
  for WLM cache.
  .
  The task failing trying to acquire a cache block has the
  following stkframe:
  .
   Task  Meth
   xxxx  XLOP
   xxxx  WMGR   WLM Wait for CICS events to occur
   xxxx  WMEV   WLM Workload Event Handler
   xxxx  WMTJ   WLM TOR Join
   xxxx  XCLB   Build Search List Method Receiver
   xxxx  XCBA   Acquire Cache Block Method Receiver
   xxxx  XCEC   Extend Cache Method Receiver
   xxxx  XCCL   Cache Auxstor Limit Verification
   xxxx  XZPT
  .
  This problem occurs because the TOR has exhausted its WNLE pool
  supply, at which point WDIN should request garbage collection
  to freeup ones no longer in use.  In the MAS dump, none of the
  tasks for the inuse WNLEs appear to be active, so they should
  have been freed.  However, garbage collection is not going to
  run because the flag is on indicating it is in progress.
  However, garbage collection is not in progress because the COWC
  transaction received an ICH408I security error.  The COWC
  transaction was not authorized to execute allowing the TOR to
  do garbage collection and free up the orphaned WNLEs.
  .
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0 and V5R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: If the PTF for APAR PI17717 is applied  *
  *                      (UI18977 for CPSM 5.1 or UI18976 for    *
  *                      CPSM 5.2), then message EYUXC0023S may  *
  *                      be issued for the WLM data cache by a   *
  *                      CMAS or by MASes defined as CPSM WLM    *
  *                      routing regions.  The text of the       *
  *                      message will be similar to the          *
  *                      following:                              *
  *                                                              *
  *                        EYUXC0023S Maximum data cache limit   *
  *                                   has been reached for WLM   *
  *                                   cache.                     *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes defined as CPSM WLM routing  *
  *                 regions must be restarted.  Note that the    *
  *                 restarts do not need to occur at the same    *
  *                 time.                                        *
  ****************************************************************
  When a request stream (RZ) transaction is routed in a CPSM WLM
  routing region, a copy of the EYURWTDA is placed into the user
  area of the DFHDYPDS for the route request, so that it can be
  passed to the target region that will receive the transaction.
  Because of timing issues, the transaction may not be fully sent
  to the target region when the routing region receives the route
  complete request for the transaction.  As such, the routing
  region must not update the EYURWTDA in the DFHDYPDS.
  
  Changes made for PI17717 bypassed the update of the EYURWTDA,
  but erroneously skipped the cleanup for other data areas
  associated with the request.  This will cause these resources to
  be orphaned.  Each routing region has a finite pool of resources
  allocated when it initializes, based upon the MXT setting of the
  region.  As the pool of resources diminish, method EYU0WDIN
  (WDIN) - which runs in the routing region as part of the DTRPGM
  and DSRTPGM process - will start transaction COWC.  COWC will
  perform reclaimation of the resources that are associated with
  CICS tasks in the routing region that are no longer active.  If
  this process is unsuccessful (for example if COWC fails to run
  because of security authorization failures, or if the routing is
  being performed by long running tasks that do not terminate),
  then eventually this pool will be exhausted.  When that occurs,
  additional resources must be allocated to allow routing to
  continue.  These additional resources will also be orphaned at
  request termination.  Eventually this may lead to the WLM data
  cache being exhausted, resulting in the EYUXC0023S message being
  issued.
  

Problem conclusion

• Method EYU0WDTM (WDTM), which is called for route completion in
  a CPSM WLM routing region, has been updated to correctly bypass
  the updating of the DFHDYPDS copy of the EYURWTDA, and to
  properly perform clean up of all other resources allocated for
  the route request.
  

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:

  UI26550 UI26551

Modules/Macros

•    EYU0WDTM
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R80M PSY UI26550

     UP15/04/09 P F504 «

• R90M PSY UI26551

     UP15/04/09 P F504 «

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.