DFHFCVS (file control VSAM request processor)
Call mechanism
Kernel subroutine call. Automatic stack storage acquired as part of the call.
Entry address
DFHFCVS. The entry point address is held in FC static storage in a field named FC_FCVS_ADDRESS, which is set by DFHFCRP when it loads DFHFCVS.
Purpose
Processes file control requests to VSAM files.
Also initializes certain FC static storage fields during file control initialization.
Called by
- DFHFCDTS
- To access the VSAM source data set to satisfy requests that cannot be satisfied by the table itself
- DFHFCFR
- After having determined that the request is for a VSAM file.
Inputs
The FCFR parameter list, as defined by the DFHFCFRA DSECT. Also the file control environment, including FC static storage and the FCT.
Outputs
Updated FCFR parameter list.
Operation
Selects on the request type, and passes control to the routine specific to that request.
Acquires and releases the VSWA as necessary.
Logs and journals the request if required.
Performs record-length and key-length checking.
Acquires storage, in the correct key subpool, for requests that specify SET.
Calls DFHFCVR to perform the VSAM request.
Resolves conflicts of exclusive control.
Performs record locking and resolves locking conflicts, including the detection of deadlocks caused either by single tasks that deadlock themselves or by multiple tasks that deadlock each other.
Performs initialization of FC static storage during file control initialization.
For CICS-maintained data tables, calls data table services to update the table to keep it in step with the VSAM source data set.
How loaded
By DFHFCRP as part of file control initialization.