IBM Support

DFHKE0002 error code X'0506' in DFHKEDS when running a DB2 transaction

Troubleshooting


Problem

You receive message DFHKE0002 a severe error (code X'0506') has occurred in module DFHKEDS. Your CICS Transaction Server for z/OS (CICS TS) region also comes down. This occurs when you try to run a DB2 transaction.

Cause

The user ID for the CICS region has no UID.

Diagnosing The Problem

Following is the full CICS trace entry:

KE 0506 *EXC*  - SET_DUB_DEFAULT_ERROR - FUNCTION(CREATE_TCB)
ATTACH_TOKEN(0F2036C0) MODENAME(L8) PRTY_RELATIVE_TO_QR(0)
PARENT_MODENAME(QR) EXEC_CAPABLE(EXEC_YES)
LE_ENVIRONMENT(LE_CICS) TCB_KEY(KEY8) INHERIT_SUBSPACE
(INHERIT_YES) ESSENTIAL_TCB(ESSENTIAL_NO)
1-0000  00680000 00000001 00000000 00000000 B8908FC0 00000000 04B703C0 ...
2-0000  FFFFFFFF 0000009C 0B0C
00FC

Data 2 of the trace entry represents the DUIB results (FFFFFFFF 0000009C 0B0C00FC). The meaning of reason code 00FC ( rsn00FC ) is documented in the UNIX System Services Messages and Codes Manual as follows:

 00FC   JRSAFNoUID
         The user ID has no UID.
         Action: Create an OMVS segment with a UID.

You can also receive message DFHDS0002 A severe error (code X'0137') has occurred in module DFHDSIT.

Resolving The Problem

Define an OMVS segment in the CICS region's user profile and specify the UID parameter.

The CICS TS V4.2 information center under Authorizing access to z/OS UNIX System Services contains instructions on creating or changing a user profile for a CICS region userid. It also states:

CICS® requires access to z/OS® UNIX System Services and to directories and files in the file system. CICS facilities that require this access include TCP/IP support, Java support, CICS Web support, and task-related user exits that are enabled with the OPENAPI option, including the task-related user exit of the CICS DB2 attachment facility.

Related Information

[{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"DB2","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"4.2;4.1;3.2;3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICS TS CICS Transaction Server

Document Information

Modified date:
15 June 2018

UID

swg21082597