A fix is available
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:
Modules/Macros
DFHUSAD
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
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