IBM Support

PI08849: DFHSM0002 ERROR CODE X'0305' IN MODULE DFHSMGF FOR PIIWAPPL STORAGE.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Receiving DFHSM0002 a severe error code x'0305' in module
    DFHSMGF attempting to freemain PIIWAPPL storage that is an
    Invalid_freemain_address.  The address being freed was part of
    a failed getmain due to insufficient storage.  It appears that
    the appl_data_ptr address is not getting cleared out after the
    getmain fails and results in the attempt to freemain that
    address.  Here's the Trace Entries showing the problem:
    .
    SM 0301 SMGF  ENTRY - FUNCTION(GETMAIN)
                       GET_LENGTH(E7747D)
                       SUSPEND(YES)
                       INITIAL_IMAGE(00)
                       REMARK(PIIWAPPL)
                       STORAGE_CLASS(USER)
    .
    .
    SM 0302 SMGF  EXIT  - FUNCTION(GETMAIN)
                       RESPONSE(PURGED)
                       REASON(INSUFFICIENT_STORAGE)
                       ADDRESS(19356D38)
    .
    .
    SM 0305 SMGF  *EXC* - Invalid_freemain_address -
                       FUNCTION(FREEMAIN)
                       ADDRESS(19356D38)
                       FREE_LENGTH(E7747D)
                       REMARK(PIIWAPPL)
                       STORAGE_CLASS(USER)
    .
    .
    Due to this address being returned as the module unwinds from
    the error we get to label pi_return and this checks to see
    whether an address was successfully obtained and if it was its
    freemained.  Since the address returned on the GETMAIN was
    never actually processed an error occurs on the FREEMAIN
    request.
    Additional Symptom(s) Search Keyword(s): KIXREVEPH
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message msgDFHSM0002 Severe error in    *
    *                      DFHSMGF during EXEC CICS INVOKE SERVICE *
    *                      while system is short on storage.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    During an EXEC CICS INVOKE SERVICE call the CICS region goes
    short on storage causing a GETMAIN of PIIWAPPL data storage to
    fail.  During cleanup of the EXEC CICS INVOKE SERVICE call an
    incorrect attempt is made to FREEMAIN the application data area
    which leads to an invalid FREEMAIN and a severe error in DFHSMGF
    
    Additional Keyword: SM0002
    

Problem conclusion

  • DFHPIIW has been changed so that it only issues a freemain for
    PIIAPPL storage if the getmain was successful.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI08849

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-01-02

  • Closed date

    2014-02-13

  • Last modified date

    2014-03-03

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

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

    PI09454 UI15135

Modules/Macros

  •    DFHPIIW
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R700 PSY UI15135

       UP14/02/21 P F402

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 March 2014