PK09426: MAS1XXXX AND MAS2XXXX CACHE FILLED WITH EYURXCWF HISTORY BUCKETS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• MAS issues message EYUXC0023S due to MAS cache limit being
  reached.  Dump shows MAS1xxxx and MAS2xxxx dataspaces have
  been allocated.  A separate dump of the MAS cache indicates it
  is filled with empty history bucket EYURXCWF structures each
  with a length of x'38C400'.  Many CICS regions have several of
  these structures allocated.  If a site has a few hundred
  regions where monitoring with history recording is activated
  and deactivated or if a CICS region is cycled, the MAS cache
  can extend to two 2G dataspaces resulting in the EYUXC0023S.
  Subroutine NHCT_DETACH_WORKAREA within method NHCT frees the
  MAS_HISTORY_WORK area when the WHDR_ATTACHMENT count reaches
  zero.  In this instance the WHDR_ATTACHMENT count is always a
  fullword of 00000001.  Method NNMS invokes method NHCT to
  start history recording for the monitor component in the MAS
  for the MTRAN monitor class.  Method NHCT invokes method NHFM
  which results in a NHFM_STATUS of NHFM_NO_FILES as no EYUHISTx
  history datasets have been allocated.  This results in messages
  .
  EYUNL0176W applid No History Datasets available.
  EYUNL0171I applid History Recorder has been terminated
  .
  Method NHCT branches to label NHCT_NO_FILES to issue the
  message and to label NHCT_EXCP_TERM and NHCT_TERM0040 .  The
  branch to subroutine NHCT_DETACH_WORKAREA does not take place
  for any exceptions branching to NHCT_EXCP_TERM resulting in the
  history bucket work area being orphaned.  If the MON component
  is stopped and restarted or if the region is recycled a new
  EYURXCWF structure is allocated.  If the CMAS remains active
  method MMTM will not run to free the storage and eventually the
  MAS cache will fill resulting in EYUXC0023S.
  .
  Additional Symptom(s) Search Keyword(s): XCWF
  MCST_HIST_DATA_BCKT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Auxiliary storage shortages may occur   *
  *                      on an LPAR where MASes are executing    *
  *                      with CPSM monitoring for transactions   *
  *                      (MTRAN) active.                         *
  *                                                              *
  *                      This may result in various dataspace    *
  *                      storage shortage related messages       *
  *                      issued by any CMAS or MAS running on    *
  *                      the LPAR.  Possible messages are:       *
  *                                                              *
  *                           EYUXC0016S                         *
  *                           EYUXC0021S                         *
  *                           EYUXC0022S                         *
  *                           EYUXC0023S                         *
  *                           EYUXC0024S (CMAS only)             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be restarted.  Note    *
  *                 that the restarts do not need to occur at    *
  *                 the same time.                               *
  ****************************************************************
  When CPSM monitoring is active for transactions in a MAS, the
  CMAS allocates a storage area in the MAS dataspace to capture
  information about tasks.  When monitoring is terminated for the
  MAS, either explicitly (through the EUI, API, or WUI) or by
  terminating the MAS or CMAS it is connected to, this area is not
  freed.  If termination is not because of CMAS termination and
  monitoring is re-activated prior to the expiration of the MAS's
  monitor retention period, the previous area is reused.  However,
  if the termination is due to CMAS termination or the MAS's
  monitor retention period has expired, a new area is acquired and
  the previous area is orphaned.  This storage will not be
  reclaimed until the CMAS and all its connected MASes are
  terminated at the same time.
  

Problem conclusion

• Method EYU0MPCT (MPCT), which is called in a CMAS when a MAS's
  monitor retention period expires, has been updated to free the
  task history workarea.
  

Temporary fix

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

Comments

• Auxiliary storage shortages may occur
  on an LPAR where MASes are executing
  with CPSM monitoring for transactions
  (MTRAN) active.
  
  This may result in various dataspace
  storage shortage related messages
  issued by any CMAS or MAS running on
  the LPAR.  Possible messages are:
  
       EYUXC0016S
       EYUXC0021S
       EYUXC0022S
       EYUXC0023S
       EYUXC0024S (CMAS only)
  
  
  When CPSM monitoring is active for transactions in a MAS, the
  CMAS allocates a storage area in the MAS dataspace to capture
  information about tasks.  When monitoring is terminated for the
  MAS, either explicitly (through the EUI, API, or WUI) or by
  terminating the MAS or CMAS it is connected to, this area is not
  freed.  If termination is not because of CMAS termination and
  monitoring is re-activated prior to the expiration of the MAS's
  monitor retention period, the previous area is reused.  However,
  if the termination is due to CMAS termination or the MAS's
  monitor retention period has expired, a new area is acquired and
  the previous area is orphaned.  This storage will not be
  reclaimed until the CMAS and all its connected MASes are
  terminated at the same time.
  
  
  Method EYU0MPCT (MPCT), which is called in a CMAS when a MAS's
  monitor retention period expires, has been updated to free the
  task history workarea.
  

APAR Information

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

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

  UK07304 PK72485

Modules/Macros

•    EYU0MPCT
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK07304

     UP05/09/20 P F509

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.