DFHFC0942 E    date time applid CICS data table load has terminated abnormally for data table name, reason code = X'xx'.

Explanation

The CICS task that is loading data table name has received a reason code X'xx', where X'xx' has one of the following values:

X'FB'

CICS file control has requested that the data table load be abandoned. This may occur, for example, if a close request has been made against the data table

X'FD'

an attempt has been made to add more entries to the data table than the maximum specified in the table definition

X'FE'

a shortage of virtual storage has been reported by the add entry (from DASD) service, due to a failure to get storage for the record. DFHDTUP trace entry AB 0B26 gives further information on the function, response and reason code, error code, and qualifier flags, associated with the failing request

System action

The user exit XDTLC is invoked, if enabled, unless file control has requested that the load be abandoned (reason code X'FB'). The value of the UEPDTORC parameter passed to the exit indicates that loading completed abnormally. No more records are loaded into the data table. The user exit may ask for the file to be closed.

If the table is CICS-maintained, provided that the user exit has NOT requested that the file be closed, those records which were not added are retrieved from the source data set to satisfy API requests.

If the table is user-maintained, requests to access any record which was not added results in a "not found" response code. If the table has been closed, then API requests result in an "unenabled" response code.

CICS processing continues.

User response

The appropriate user response depends on the reason code. User responses are as follows:

X'FB'

no action necessary

X'FD'

increase the size specified for the data table using the MAXNUMRECS field in its resource definition

X'FE'

review the dataspace storage use. For lack of storage problems, the most common error codes will be 06 (table entry descriptor storage), 07 (index node storage), or 08 (data storage). CICS uses dataspace DFHDT001 for descriptor entries, DFHDT002 for index nodes, and DFHDT003 through to DFHDT100 for data records. If there is insufficient space for entry descriptors or index nodes, consider splitting the data tables into different CICS regions; for example, different FORs. If a single data table has run out of space on its own, the limit of space for it has been reached, in which case consider whether it should be split into two or more separate tables. See the section "Storage use for shared data tables" in the CICS TS for z/OS 5.1: Shared Data Tables Guide" for more information on storage usage

Module

DFHDTLX

XMEOUT parameters/Message inserts

  1. date
  2. time
  3. applid
  4. name
  5. X'xx'

Destination

CSFL and Console



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