PM20899: DFHSM0002 SEVERE ERROR CODE 0315 AFTER A TASK SUSPENDED FOR UDSA STORAGE FOR A CONTAINER IS PURGED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS Transaction server 4.1 and developing
  Webservice applications that use large containers. When testing
  this application, you go short on storage below the line in
  CICS.
  The task is suspended for UDSA storage. When you purge this task
  you receive the following error messages along with a system
  dump:
  DFHSM0002  A severe error (code X'0315') has occurred
             in module DFHSMGF.
  DFHPG0002  A severe error (code X'190A') has occurred
             in module DFHPGCR.
  The SOS condition occurred due to having DATALOCATION(Below)
  specified for the application program definition.
  Looking at the dump from the SM0002, you will see the following
  exception trace entry:
  .
  SM 0315 SMGF  *EXC* -
        Invalid_address_specified_with_storage_class_on_freemain
        FUNCTION(FREEMAIN) ADDRESS(26B236B8)
        FREE_LENGTH(64D990) REMARK(PGCRSET) STORAGE_CLASS(TASK)
  TASK-01303 KE_NUM-003E TCB-QR   /00AF0538 RET-A3616C4C
  .
  The address we are trying to free - 26B236B8, is already free,
  causing the exception. Module DFHPGCR is issuing this freemain
  and obtains the address from field CRCB_SET_ADDRESS.
  Looking back in trace we find this address was passed back on
  the getmain request when the task was purged. Here is that
  trace:
  SMGF  EXIT  - FUNCTION(GETMAIN) RESPONSE(PURGED)
                REASON(INSUFFICIENT_STORAGE)
                ADDRESS(26B236B8)
  This is actually a residual address in a parameter list, that
  DFHPGCR incorrectly moves into the field CRCB_SET_ADDRESS,
  before it checks the actual return code from the getmain
  request to see if it was successful.
  .
  Additional symptoms: GET CONTAINER SET
  KIXREVTGL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: msgDFHSM0002 A severe error (code       *
  *                      X'0315') followed by msgDFHPG0002 A     *
  *                      severe error (code X'190A') have both   *
  *                      occurred in module DFHPGCR.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A transaction running a program defined with DATALOCATION(BELOW)
  issues an EXEC CICS PUT CONTAINER command for a very large data
  area, followed by an EXEC CICS GET CONTAINER SET command for
  the same container, which causes a short on storage condition
  in the UDSA causing the task to be suspended. If this suspend is
  then purged, crcb_set_address is populated with a random value.
  This leads to CICS issuing the following two messages when the
  container is being subsequently deleted.
  DFHSM0002 A severe error (code X'0315') has occurred
            in module DFHSMGF
  DFHPG0002 A severe error (code X'190A') has occurred
            in module DFHPGCR
  Keywords: SM0002 PG0002 SOS msgDFHSM0131 msgDFHSM0132
            DFHSM0131 DFHSM0132 SM0131 SM0132
  

Problem conclusion

• DFHPGCR has been changed so that, if the GETMAIN to allocate SET
  storage fails, the pointer CRCB_SET_ADDRESS remains zero.
  

Temporary fix

• 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:

  UK60633 PM32837

Modules/Macros

•    DESPGCR  DFHPGCR  DFHPGCRA DFHPGCRI DFHPGCRJ
  DFHPGCRM DFHPGCRT
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK60633

     UP10/09/23 P F009

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.