PH49780: DFHSM0133 SHORT ON STORAGE ABOVE THE LINE IN SUBPOOL TGODR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your AOR region goes short on storage as seen in the
  message log:
  DFHSM0133 CICS is under stress (short on storage above 16MB).
  DFHSM0142 CICS is still under stress(short on storage above
                                                         16MB).
  
  Reviewing a dump at the time of the SOS, shows the ECDSA using
  the majority of the storage.  The ECDSA subpool summary shows
  quickcell subpool TGODR using the majority of the storage.
  This is storage for the transaction group origin data record.
  .
  Looking at CICS internal trace we could see the flow where
  this storage was getmained, but not freemained. It is getmained
  as part of processing an EXEC CICS START command:
  
  AP 00E1 EIP   ENTRY START
  AP 00F3 ICP   ENTRY INITIATE
  MN 0B0A MNOD  ENTRY GET_ODR ODR_BUFFER
  MN 0B0B MNOD  EXIT  GET_ODR/OK ODR_BUFFER
  SM 0301 SMGF  ENTRY GETMAIN SUBPOOL_TOKEN(1B85B0EC , 000000ED)
                      SUSPEND(YES) REMARK(DSTGODR)<--TGODR storage
  SM 0302 SMGF  EXIT  GETMAIN/OK
  AP F361 APIC  EXIT  START/OK
  AP 00E1 EIP   EXIT  START INVREQ
  .
  The start fails with an invalid request.
  DFHICP is returning INVREQ due to field TCAICTR
  not containing an expected value.  In this case, DFHICP
  returns back to the caller without freemaining the origin data
  storage.
  
  additional symptoms: KIXREVCTC
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: An AOR region goes short on storage.    *
  *                      Dump SM0133 is taken and shows          *
  *                      ECDSA using the majority of the         *
  *                      storage.                                *
  ****************************************************************
  An AOR region is receiving many function shipped STARTS to a
  long running mirror transaction. MROLRM=YES is specified in
  the SIT.
  
  The EXEC CICS STARTs are GETMAINing DSTGODR (origin data
  storage), but fail with an INVREQ.
  
  DFHICP processes the INVREQs and returns back to the caller
  without FREEMAINing the origin data storage(DSTGODR).
  
  The storage would be freed as part of transaction detach but
  we do not get there as the long running mirror is still
  executing.
  
  Eventually the ECDSA goes SOS with subpool TGODR using the
  majority of the storage.
  

Problem conclusion

• DFHICP has been changed to freemain DSTGODR storage following
  a transaction failing INVREQ.
  

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:

  PH50842 UI83476 UI83477

Modules/Macros

• DFHICP
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI83477

     UP22/11/29 P F211

• R300 PSY UI83476

     UP22/11/29 P F211

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.