PM37246: CICS REGION INCORRECTLY FLAGGED SHORT ON STORAGE (SOS) IF CICSPLEX OPTIMIZED WORKLOAD USED AND ANY FIXED DSA SIZES IN SIT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using CICSPlex Optimized Workload Management and find
  that your CICS regions are being incorrectly marked SOS (Short
  On Storage) in the CPSM WUI views which show target regions.
  There are no DFHSM0131 or DFHSM0133 messages in those CICS
  region logs, nor are there any other indications that the
  regions are under stress. If you turn off optimized workload
  management in the CICS region, the SOS condition goes away.
  .
  The problem only occurs if you have preset one of the sizes of
  the CICS DSA's by using any of the following SIT parameters:
  .
  CDSASZE, ECDSASZE
  RDSASZE, ERDSASZE
  SDSASZE, ESDSASZE
  UDSASZE, EUDSASZE
  .
  While a region is flagged as being SOS, CPSM Workload Management
  algorithms are unlikely to route any new transactions to the
  CICS region.
  .
  Additional Symptoms and Keywords
  KIXREVSVR
  

Local fix

• Turn off optimized workload management in the region or,
  preferably, let CICS manage storage in the region dynamically
  and do not pre-set the size of any of the CICS individual DSA's.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Sites using CICSPlex Optimized Workload *
  *                      Management may find that CICS regions   *
  *                      are being marked SOS (Short On Storage) *
  *                      incorrectly in the CPSM WUI view        *
  *                      EYUSTARTWLMATARG.TABULAR3.  There are   *
  *                      no DFHSM0131 or DFHSM0133 messages in   *
  *                      the CICS region logs, nor are there any *
  *                      other indications that the regions are  *
  *                      under stress. If you turn off optimized *
  *                      workload management in the CICS region, *
  *                      the SOS indication is removed.          *
  *                                                              *
  *                      The problem only occurs if you have     *
  *                      preset one of the sizes of the CICS     *
  *                      DSA's by using any of the following SIT *
  *                      parameters:                             *
  *                      .                                       *
  *                       CDSASZE, ECDSASZE                      *
  *                       RDSASZE, ERDSASZE                      *
  *                       SDSASZE, ESDSASZE                      *
  *                       UDSASZE, EUDSASZE                      *
  *                      .                                       *
  *                      While a region is flagged as being SOS, *
  *                      CPSM Workload Management algorithms are *
  *                      unlikely to route any new transactions  *
  *                      to the CICS region.                     *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes must be recycled to pick up  *
  *                 the new code.  Note that the restarts do not *
  *                 need to be done at the same time.            *
  ****************************************************************
  If a user fixes a specific DSA size (for example by coding
  UDSASZE=4M in the SIT) the STORAGE_NOTIFY calls to all the
  domains, including the RS domain, include a parameter of
  DSAS_CONSTRAINED(YES). A logic error in DFHRSSM (CICS RS Storage
  Notify for region status) will cause the SOS_Timestamp to be
  null, and the SOS flag to be turned on.
  

Problem conclusion

• Module DFHRSSM (CICS RS Storage Notify for region status) was
  modified to correctly handle DSAS_CONSTRAINED(YES).
  

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:

  UK67146

Modules/Macros

•    DESRSSM  DFHRSSM
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK67146

     UP11/05/10 P F105

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.