IBM Support

PM79647: MSGDFHUS0002 CODE(X'030C') AND CICS TERMINATES AFTER APPLYING THE PTFS FOR PM67891 (UK83850 OR UK83851)

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After applying the PTFs for PM67891 (UK83850 or UK83851) message
    DFHUS0002 with code(x'030C') can occur when a userid used for
    session preset security completes DELETE_USER processing in
    DFHUSAD.
    .
    The problem occurs because the format of the USD1 directory
    key used for these session signons was changed by PM67891, but
    the change was not correctly reflected in the USUDB.  When the
    DELETE_USER processing is done in DFHUSAD the USD1 directory
    key is reconstructed using information in the USUDB.  DFHUSAD
    fails to find this incorrect entry in the USD1 directory so
    assumes there is a major problem with the state of the
    directories and terminates CICS.
    .
    MRO connections using preset security are probably unlikely to
    see the problem as they will typically remain inservice for
    the lifetime of the CICS region.  The problem is more likely to
    be seen using EXCI connections, especially if USRDELAY is set
    to a low value and the EXCI session userid then times out.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users with UK83850 or UK83851       *
    *                 applied.                                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message DFHUS0002 code(x'030C') and     *
    *                      CICS terminates when deleting a session *
    *                      userid.                                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    PM67891 altered the way that session userids were signed on.
    The format of the USD1 key was altered so that these signons
    were not subject to RACF notifications.
    
    When a session userid gets deleted DFHUSAD recreates the USD1
    directory key before removing the user from the directory.
    The key generated during DELETE_USER processing does not match
    the one created during ADD_USER processing.  This causes DFHUSAD
    to fail to locate the correct entry in the USD1 directory.  The
    failure to remove the entry from the USD1 directory causes
    DFHUSAD to believe that its directories are in an inconsistent
    state.  Message DFHUS0002 with code x'030C' is issued and CICS
    is terminated.
    
    Additional keywords:
    US0002
    

Problem conclusion

  • UK83850 UK83851
    DFHUSAD has been changed to correctly delete session userids
    from the USD1 directory.
    

Temporary fix

  •             *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM79647

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-12-21

  • Closed date

    2013-03-01

  • Last modified date

    2013-04-02

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

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

    UK91017 UK91018

Modules/Macros

  •    DFHAMPFI DFHAMRDI DFHAMST  DFHFCRP  DFHSNAS
    DFHSNPU  DFHSNSG  DFHSNSU  DFHSNTU  DFHSNUS  DFHUSAD  DFHUSADT
    DFHUSDM  DFHUSES  DFHUSXM  DFHZSGN
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK91017

       UP13/03/15 P F303 ®

  • R700 PSY UK91018

       UP13/03/15 P F303 ®

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

Document Information

Modified date:
02 April 2013