Exit XDTLC
The XDTLC user exit is invoked at the completion of data table loading—whether successful or not. The user exit is not invoked if the data table is closed for any reason before loading is complete. The XDTLC exit is invoked for a coupling facility data table only if the table is loaded from a source data set.
The exit program is informed if the loading did not complete
successfully—see field UEPDTORC. This could occur, for example, if
the maximum number of records was reached or there was insufficient
virtual storage. In this case, the exit program can request that
the file is closed immediately, by setting the return code.
- When invoked
- At the completion of table loading. It is not invoked if the loading process was terminated because the data table had been closed.
- Exit-specific parameters
-
- UEPDTPL
- Address of the data table user exit parameter list, which is mapped
by DSECT DT_UE_PLIST in copybook DFHXDTDS. The data table user exit
parameter list contains:
- UEPDTNAM
- The 8-character data table name.
- UEPDTFLG
- A 1-byte flag field. The possible bit settings are:
- UEPDTSDT (X'80')
- The exit has been invoked by CICS® shared data table support.
- UEPDTCMT (X'40')
- This is a CICS-maintained table. Only meaningful if UEPDTSDT is on.
- UEPDTCFT(X'10')
- The exit has been invoked by coupling facility data table support.
- UEPDTUMT (X'08')
- This is a user-maintained table. Only meaningful if UEPDTSDT is on.
- UEPDTORC
- Data table open result code. The possible values are:
- UEPDTLCS
- Load successful
- UEPDTLFL
- Load unsuccessful.
- UEPDTDSL
- The fullword length of the name of the source data set. Only meaningful if either UEPDTSDT or UEPDTCFT is on.
- UEPDTDSN
- A 44-character field containing the name of the source data set. Only meaningful if either UEPDTSDT or UEPDTCFT is on.
- Return codes
-
- UERCDTOK
- Accept the data table in its present state
- UERCDTCL
- Close the data table.
- XPI calls
- All can be used.