FCLJ DATASET_COPY Function

This function is called when DFSMSdss initiates a copy of an RLS data set via the VSAM RLS quiesce mechanism. The function causes a ’tie up record’ to be written to the log of logs if either the data set is forward recoverable, or some flavor of autojournalling has been specified in the file definition. In addition, if applicable, a record is written to the forward recovery log.

A tie up record specifies which CICS® system within the sysplex opened the file, and the data set which the file was opened against. Tie up records are used by forward recovery utilities, for example CICS VSAM Recovery for z/OS®.

Input parameters

FCTE_ADDRESS
is the address of the file control table entry for the file associated with a data set being copied.

Output parameters

RESPONSE
is DFHFCLJ’s response to the call. It can have any of these values:
OK|INVALID|PURGED|DISASTER
[REASON]
is returned when RESPONSE is DISASTER. Possible values are:
RESPONSE Possible REASON values
DISASTER
ABEND
LG_RETURNED_ERROR