PH52169: DFHFC0942 REASON CODE X'FE' INDICATING NO STORAGE FOR SHARED DATA TABLE WHILE STATISTICS SHOWS SPACE AVAILABLE

APAR status

• Closed as program error.

Error description

• CICS puts out the following messages:
  DFHFC0433 Shared Data Tables above the bar storage
            usage has reached 75% of SDTMEMLIMIT storage.
  ..
  DFHFC0433 Shared Data Tables above the bar storage usage has
            reached 100% of SDTMEMLIMIT storage
  followed by
  DFHFC0942 CICS data table load has terminated abnormally for
            data table xxxx, reason code = X'FE'
  
  This means the shared data tables have used all the global
  storage allocated by the SDTMEMLIMIT SIT parameter,
  but when checking Entries and
  Index storage statistics for data tables, there appears to be
  space left.
  
  CICS limits the amount of storage that can be allocated to
  subpool DTCTL64 based on the amount specified by the
  SDTMEMLIMIT SIT parameter.  This subpool resides in above the
  bar global storage and holds records about the tables rather
  than actual table data.  Storage used in this subpool is
  reported in statistics in "Data Tables - Storage" table under
  the following headers: "Entries", "Index", and "Entries +
  Index".  Each of these has two sub-headers: "Storage Allocated"
  and "Storage In-Use".  The "Entries + Index" header should list
  the total data allocated into the DTCTL64 subpool in bytes.
  
  
  In this case, these columns show totals amounting to less than
  the storage limit set by the SDTMEMLIMIT SIT parameter.
  
  
  However, upon inspecting storage domain in the dump, the
  DTCTL64 subpool has reached the storage set by the SDTMEMLIMIT
  SIT parameter, contradicting the output in the statistics table.
  Additional Symptoms: KIXREVSCB
  MEMLIM GCDSA stats SDT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The shared data tables had reached the  *
  *                      storage set by the SDTMEMLIMIT          *
  *                      SIT parameter. However, the statistics  *
  *                      table was printing totals amounting to  *
  *                      less than the storage limit.            *
  ****************************************************************
  CICS limits the amount of storage above the bar that can be
  allocated to shared data tables to use for control information
  based on the SDTMEMLIMIT system initialization parameter.
  
  While loading the data tables, storage usage reached 100% of the
  limit set by SDTMEMLIMIT and load was terminated abnormally.
  
  On the contrary, storage allocated and usage printed in
  statistics for "Data Tables - Storage" table under the header
  "Entries + Index" show totals amounting to less than the storage
  limit set by the SDTMEMLIMIT SIT parameter.
  

Problem conclusion

• CICS has been changed to correctly calculate the storage
  allocated and storage in use for Entries and Indexes for Shared
  Data Tables.
  

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:

  UI91829

Modules/Macros

• DFHDTIX  DFHDTRM
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UI91829

     UP23/05/17 P F305