IBM Support

PK87792: USING EXEC INQUIRE TASK IPFACILITIES CAUSES INVALID FREEMAIN ADDRESS AND DFHSM0002 SEVERE ERROR X'0305'

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CICS TS v3.2. Using EXEC INQUIRE TASK IPFACILITIES in a PCREQ
    exit, command functions and returns proper results, but causes
    the following error message:
    DFHSM0002  A severe error (code X'0305') has occurred
               in module DFHSMGF
    Looking at internal trace in the dump we see the following
    exception trace entry:
    *EXC* - Invalid_freemain_address - FUNCTION(FREEMAIN)
            ADDRESS(18F308E8)
    This freemain was issued out of module DFHUEH and specified a
    storage class of CICS, yet when the storage was getmained out of
    DFHEIQSK its specified a storage class of TASK. This caused the
    severe error code 0305.
    .
    Additional Symptom(s) Search Keyword(s):
    KIXREVRJL
    IPCONN SM0002 EIQSKBIB BIB Invalid_freemain_address
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: MSGDFHSM0002 severe error code          *
    *                      X'0305', invalid_freemain_address       *
    *                      when EXEC CICS INQUIRE TASK             *
    *                      IPFACILITIES is issued from a GLUE,     *
    *                      TRUE or URM.                            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    EXEC CICS INQUIRE TASK IPFACILITIES  is issued from global
    user exit XPCREQ. DFHEIQSK getmains the browse interface block
    (BIB) as TASK storage but, on exit from the GLUE, DFHAPEVI
    frees the BIB as CICS storage. This causes DFHSM0002 severe
    error code X'0305', invalid_freemain_address.
    A similar problem could happen if this command were issued
    from a task-related user exit (TRUE) or a user replaceable
    module (URM).
    Additional keywords: EIQSKBIB EIQSPBIB APEVI SM0002
    

Problem conclusion

  • DFHEIQSK has been altered to getmain EIQSKBIB storage as
    CICS storage.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK87792

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-06-02

  • Closed date

    2009-06-16

  • Last modified date

    2009-07-01

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

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

    PK88746 UK47495

Modules/Macros

  •    DFHEIQSK
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK47495

       UP09/06/18 P F906

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:
01 July 2009