IBM Support

PK81488: DFHSM0002 ERROR CODE 0317 IN DFHSMGF DOUBLE FREEMAIN OF FIELD ICE_TG_ODR_ADDR 09/10/28 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Running CICS Transaction Server 3.2, you receive the following
    error message:
    DFHSM0002 A severe error (code X'0317') has occurred in module
    DFHSMGF
    A dump taken at the time shows the following exception
    trace entry:
    .
    SM 0317 SMGF *EXC* - Freemain_length_overlays_next_SCF -
                  FUNCTION(FREEMAIN)
                  SUBPOOL_TOKEN(1B4F6AAC , 000000AB)
                  ADDRESS(1DF04200) REMARK(DSTGODR)
    .
    Transaction CSSY transaction was running trying to freemain
    a piece of storage out of supbool TGODR, that was already
    freed. Module DFHICP is doing this freemain. It retrieves
    the address from an ICE (interval control element) control
    block. The field name is ICE_TG_ODR_ADDR.
    In some cases, this ICE control block that DFHICP was
    pointing to was also free.
    The problem involves the SMLOCK.  CSSY requested it,
    prior to freemaining this ICE_TG_ODR_ADDR, but got suspended.
    While suspended, the task that was kicked off due to the
    ICE ran, and it freemained this area. Now when CSSY was
    dispatched again, it failed on its attempt to freemain
    this same area.
    Additional Symptom(s) Search Keyword(s):
    KIXREVEPH MSGDFHSM0002
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHSM0002 A severe error (code X'0317') *
    *                      has occurred in module DFHSMGF.         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    DFHICP issues a GETMAIN for a STARTed task but is suspended.
    During the suspend, the attempt to attach the task fails because
    the transaction is disabled and the CSAC transaction is
    attached.  When CSAC runs, DFHICP FREEMAINs the task's Origin
    Data Record storage but the pointer is not cleared.  When the
    suspended task runs it tries to FREEMAIN the already FREEMAINed
    storage, leading to message "DFHSM0002 A severe error
    (code X'0317') has occurred in module DFHSMGF." being issued.
    MSGDFHSM0002 could also be issued with (code X'0305') or
    (code X'0316').
    
    Additional keywords: SM0002
    

Problem conclusion

  • UK43490 UK45224
    DFHICP has been changed to save and then clear the address of
    the Origin Data Record storage and to use the saved address to
    FREEMAIN the storage later.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK81488

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-02-26

  • Closed date

    2009-05-13

  • Last modified date

    2010-01-18

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

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

    UK46548

Modules/Macros

  •    DFHICP
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK46548

       UP09/05/19 P F905

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":"3.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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
18 January 2010