DFHFC7093 date time applid CICS data table load has terminated abnormally for coupling facility data table dddd, file filename, pool poolname, reason code = X'xx'.
Explanation
The CICS task that is loading coupling facility data table dddd has received a reason code X'xx', where X'xx' has one of the following values:
- X'02'
-
ILLOGIC - A VSAM error which does not fall into one of the other categories.
- X'0C'
-
NOTOPEN - The file is CLOSED and UNENABLED, or still open and in use, but a CLOSE request has been received.
- X'0D'
-
DISABLED - The file is DISABLED.
- X'0F'
-
ENDFILE - The file is CLOSED and UNENABLED, or still open and in use, but a CLOSE request has been received.
- X'80'
-
IOERR - I/O error.
- X'84'
-
TABLE_FULL - Maximum records exceeded.
- X'85'
-
RLS_DISABLED - RLS access currently not available.
- X'86'
-
RLS_FAILURE - The RLS server has failed.
- X'87'
-
PREVIOUS_RLS_FAILURE - The RLS server has been recycled in this unit of work.
- X'88'
-
CACHE_FAILURE - Cache connectivity failure.
- X'89'
-
CFDT_POOL_FULL - No more space available in the coupling facility structure for the table pool.
- X'8A'
-
DATASET_BEING_COPIED - DSS is performing a sharp copy
System action
The user exit XDTLC is invoked, if enabled, with the parameter UEPDTORC set to indicate that loading completed abnormally. The user exit may ask for the file to be closed. No more records are loaded into the coupling facility data table.
If the user exit did not request the file to be closed (or if no user exit program was enabled at the XDTLC exit point), then API requests to access records within the range of keys which has already been loaded into the data table will succeed, but requests to access any record beyond the loaded range will receive the "LOADING" condition.
If the file has been closed, then API requests will receive a "NOTOPEN" condition.
CICS processing continues.
User response
Investigate the reason for the return code from CICS file control. For further information about the reason code, see the description of exception conditions for the STARTBR, READNEXT and WRITE commands in the Reference: application development.
You may be able to correct the cause of the failure, for example by explicitly enabling the file if the reason is DISABLED, or re-cycling the RLS server if it has failed. If the error is TABLE_FULL, meaning that the number of records to be loaded into the table exceeds the MAXNUMRECS parameter, then you can increase this parameter using the coupling facility data tables server command SET TABLE=tablename,MAXRECS=n. (Note that although altering the MAXNUMRECS parameter on the file definition within CICS, using SET FILE for example, will not have any effect on the current setting for the data table, you should consider resetting it to the new value in order to avoid getting a warning message about the mismatch.) If the error is CFDT_POOL_FULL, then you can increase the size of the coupling facility data table pool that this data table resides in.
If it is possible to correct the problem which caused the load to fail, then you can complete the load of the coupling facility data table by closing the file which attempted the load (if it has not already been closed) and re-opening it, or any other file which is capable of loading the table; that is, which has access to the source data set. This will cause the load to be restarted from the point at which it failed.
Module
XMEOUT parameters/Message inserts
- date
- time
- applid
- dddd
- filename
- poolname
- X'xx'
Destination
CSFL and Console