IBM Support

PK58351: A DFHSM0002 RC030E MAY OCCUR DURING TERMINATION WHEN A FREEMAIN REQUEST IS MADE FOR THE DLPE SUBPOOL.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • During termination you may see an abendABM3 abend occur for
    the shutdown transaction, followed by a DFHSM0002 RC030E for a
    freemain of the DPLE subpool.
      The storage manager will show that the DPLE subpool is intact,
    and you will see that the transaction no longer has a facility
    address in the User TCA +x'8'.
      Control was in the second stage of PLTSD process.  The debug
    profiles are being quiesced.  DFHDPIN tries to send a DFHDP0300
    message to the terminal, but the shutdown task nolonger owns a
    facility.  The abendABM3 occurs.  Recovery in DFHDPIN is
    driven, and an attempt is made to finish the debug profile
    clean up process, but the dplm_browse_list_token has been
    lost, ie., it is 0s.  This causes an invald freemain when
    control picks up a bad address in lowcore and passes it as
    a QPH address in the DPLE subpool.
    Additional Symptom(s) Search Keyword(s)
    KIXREVDFW
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHSM0002 A severe error (code X'030E') *
    *                      has occurred in module DFHSMGF and      *
    *                      DFHDP0001 An abend (code 0C4/AKEA) has  *
    *                      occurred at offset X'3420' in module    *
    *                      DFHDPLM following an abend ABM3.        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    DFHDPIN can be included in the second phase Program List Table
    (PLT) in order to inactivate debugging profiles and issues
    console message MSGDFHDP0300 saying how many debugging profiles
    have been inactivated.  However, the message may also be sent to
    the terminal associated with the task, which no longer exists as
    CICS is shutting down.  As a result, abend ABM3 is issued which
    invokes the recovery routine in DFHDPIN.  This issues a
    dfhdplmm function(ENDBR_DEBUG_PROFILES) with
    browse_list_token( browse_token ) but browse_token is zero, so
    an invalid FREEMAIN of a DPLE is attempted causing "DFHSM0002 A
    severe error (code X'030E') has occurred in module DFHSMGF" to
    be issued, followed by "DFHDP0001 An abend (code 0C4/AKEA) has
    occurred at offset X'3420' in module DFHDPLM" to be issued.  The
    same problem can occur with MSGDFHDP0301.
    
    Additional keywords: DFHDP0301 DP0300 DP0301 CADP
    

Problem conclusion

  • Refsteps dfhdpin_issue_msg_300 and dfhdpin_issue_msg_301 in
    DFHDPIN have been changed to check that tczfcaaa (principal
    facility) is not zero and that flag tczfctrm (indicating that
    the principal facility is a terminal) in addition to checking
    that eibtrmid (terminal id) is not nulls in order to determine
    that MSGDFHDP0300 or MSGDFHDP0301 can safely be sent to the
    terminal.  Also, in refstep dfhdpin_abend_handler, the
    dfhdplmm function(ENDBR_DEBUG_PROFILES) call will not be issued
    if browse_token is zero.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK58351

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-12-17

  • Closed date

    2008-03-07

  • Last modified date

    2008-04-01

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

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

    UK34402 UK34403

Modules/Macros

  •    DESDPIN  DFHDPIN
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK34402

       UP08/03/14 P F803

  • R500 PSY UK34403

       UP08/03/14 P F803

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

Document Information

Modified date:
01 April 2008