DFHFC0412    applid Data table cannot be opened. Data table initialization has failed owing to a module loading failure - reason code X'code'.

Explanation

CICS is about to open a data table but a module loading failure has prevented the initialization of shared data table services. The value of the reason code, X'code', provides further information about which module was being loaded, and what went wrong with the attempt to load it.

The format of the reason code is X'mfrraaaa' in which m identifies the module and f is a code for the type of failure. For some failures, rr contains the register 15 return code from the failing macro call, and aaaa might contain additional information.

The value of X'm' can be:

X'1'

DFHDTFOR

X'2'

DFHDTAM

X'6'

DFHMVRMS

The values of X'f' are:

X'1'

module not found by a LOAD, BLDL or CSVQUERY macro call.

X'2'

an error was returned by the MVS LOAD macro. The two bytes X'aaaa' of additional information in the reason code contain the completion code from the LOAD. X'rr' is the register 15 return code.

X'3'

an error was returned by the MVS CSVQUERY macro. X'rr' is the register 15 return code.

X'4'

an error was returned by the MVS BLDL macro. The two bytes X'aaaa' of additional information in the reason code contain the R0 reason code returned by BLDL.

X'5'

the module is not reentrant.

X'6'

the module had the wrong AMODE.

X'7'

the module had the wrong RMODE.

:note text='Note for CICS/ESA 3.2.1 users'. There is an additional code of X'08000000' which is only seen on a CICS/ESA 3.2.1 system that has DFHDTINS installed in the LPA or in its load library, and has mistakenly loaded this module.

System action

CICS continues normally. This message is followed either by message DFHFC0931 or by DFHFC0932. The following message indicates the action taken for the table involved.

User response

The response depends on the reason for the failure as indicated in the second hex digit of the reason code:

X'1'

Use the first hex digit to determine which module could not be found, and ensure that it is in the correct library.

X'2'

Refer to the documentation of the MVS LOAD macro to interpret the return and completion codes given in the reason code. There might also be a message from the MVS LOAD which explains the reason for the failure.

X'3'

Refer to the documentation of the MVS CSVQUERY macro to interpret the return code given in the second byte of X'code'.

X'4'

This indicates an I/O error or a storage allocation failure. Refer to the documentation of the MVS BLDL macro to interpret the values in the reason code X'code'.

X'5', X'6', X'7'

Use the first digit of the reason code to determine the name of the module, then check the status of that module. These errors imply that it is either not the module which was supplied with CICS or that it has become corrupted.

:note text='Note for CICS/ESA 3.2.1 users'. If the reason code was X'08000000', the shared data tables module DFHDTINS has been incorrectly installed in a library which is used by this CICS/ESA 3.2.1 system. If DFHDTINS is in the load library specified by this CICS, it should be removed: shared data tables support cannot be installed on a CICS system at a lower level than 3.3. If it is in the link pack area (LPA) of this MVS system, it should be removed: the DFHDTINS module should not be placed in the LPA of an MVS system which contains any CICS regions at release 3.2.1 which might want to use data tables, unless a PTF has been applied to the CICS 3.2.1 regions

Module

DFHFCFS

XMEOUT parameters/Message inserts

  1. applid
  2. X'code'

Destination

Console



DFHFC0412.html | Timestamp icon Last updated: Sunday, 4 June 2017