IBM Support

PI85903: DFHUS0002 A SEVERE ERROR (CODE X'030C') HAS OCCURRED IN MODULE DFHUSAD. 17/11/10 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are receiving the following DFHUS0002 message,
    MESSAGE: DFHUS0002 A severe error (code X'030C') has
              occurred in module DFHUSAD.
     SYMPTOMS:PIDS/5655Y0400 LVLS/690 MS/DFHUS0002 RIDS/DFHUSAD
              PTFS/UI44531 PRCS/0000030C
     .
     The trace shows the following trace entries,
      DD 0201 DDDI  ENTRY DELETE_ENTRY ENTRY_NAME(3CE60070)
                          DIRECTORY_TOKEN(3B900FB0)
                          DIRECTORY_NAME(USD1)
                          NAME(<UserID>   NO ...................)
      DD 0202 DDDI  EXIT  DELETE_ENTRY/EXCEPTION
                          REASON(NOT_FOUND)
                          DATA_TOKEN(00000000 , 00000000)
      US 030C USAD  *EXC* User-not-in-directory
                          FUNCTION(DELETE_USER)
                          SIGNOFF_TYPE(USER_SIGN_OFF)
                          DELETE_IMMEDIATE(YES)
                          USER_TOKEN(00000F70)
    .
    You have the process driver uses X numbers of sequential
    terminals to execute the transaction. The driver finds an
    available terminal, and starts an intermediary transaction(yyyy)
    on the terminal. yyyy signs off the previous userid, signs on
    the new userid, and finally starts the transaction defined in
    the MQ message under this same terminal.
    .
    Further diagnosis, found the following sequences of the events,
    - A terminal signon is done for <UseID>.  This is at a
      sequential terminal and so appears to user domain to look
      exactly like a non terminal signon.
    - An ENF notification is received for <UserID> and the USUDB
      is flagged.
    - A non terminal signon occurs for <UserID>.  This finds the
      USUDB for the terminal signon (not normally expected).
    - A notification had been received so the USD1 entry for
      <UserID> is removed. USUD_DELETED_FROM_DIRKEY is set on.
    - The non terminal task completes.
    - A terminal signoff is done for <UserID>.  Code added by
      PI40828 detects that situation and deletes the USD1 entry.
      This is intended to allow a task to issue a SIGNOFF/SIGNON for
      the same userid to pick up security changes. The USD1 deletion
      does not check the USUD_DELETED_FROM_DIRKEY flag because this
      is a terminal signoff and so the entry should always be there.
    - The USD1 deletion fails because the entry has already been
      deleted.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users with PI40828 applied.         *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS terminates with                    *
    *                      DFHUS0002 A severe error code X'030C'   *
    *                      has occurred in module DFHUSAD.         *
    ****************************************************************
    * RECOMMENDATION: .                                            *
    ****************************************************************
    - A terminal signon is done for Userid UUUUUUUU.
      This is at a sequential terminal and so appears to user
      domain to look exactly like a non terminal signon.
    - An ENF notification is received for Userid UUUUUUUU and the
      USUDB is flagged.
    - A non terminal signon occurs for Userid UUUUUUUU.
      This finds the USUDB for the terminal signon
      (not normally expected).
    - A notification had been received so the USD1 entry for
      Userid UUUUUUUU is removed.
      USUD_DELETED_FROM_DIRKEY is set on in the USUDB.
    - A new USD1 and USD2 entry are created along with a new USUDB.
    - The non terminal task completes and the new USUDB is put on
      the user timeout queue.
    - The USRDELAY time expires.
      This causes the new USUDB to be freed.
      The USD1 and new USD2 entry get deleted.
    - A terminal signoff is done for Userid UUUUUUUU.
      Code added by PI40828
      detects that situation and deletes the USD1 entry.
      This is intended to allow a task to issue a SIGNOFF/SIGNON
      for the same userid to pick up security changes.
      The USD1 deletion does not check the USUD_DELETED_FROM_DIRKEY
      flag because this is a terminal signoff
      and so the entry should always be there.
    - The USD1 deletion fails because the entry has already been
      deleted by the earlier non-terminal task.
    Additional keywords: MSGDFHUS0002
    

Problem conclusion

  • UI28782 UI30325 UI43779 UI28783 UI30326 UI43780
    DFHUSAD has been changed to prevent it from deleting an entry
    from the USD1 directory more than once.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI85903

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-08-14

  • Closed date

    2017-11-17

  • Last modified date

    2018-01-03

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

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

    PI89537 PI90090 UI51989 UI51990

Modules/Macros

  • DFHUSAD
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI51989

       UP17/12/06 P F712 {

  • R900 PSY UI51990

       UP17/12/06 P F712 {

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

Document Information

Modified date:
03 January 2018