DFHFCFR (file control file request handler)
Call mechanism
Kernel subroutine call. Automatic stack storage acquired as part of the call.
Entry address
DFHFCFR. Stored in the CSA in a field named CSAFCEP.
Purpose
The central module in the file control component.
Processes file control requests issued by DFHEIFC (requests from application programs), or from other CICS modules (internal CICS file control requests).
- DFHFCRS for VSAM RLS files
- DFHFCVS for VSAM non-RLS files
- DFHFCBD for BDAM files
- DFHFCDR for coupling facility data tables
- DFHFCTS for user-maintained data tables
- DFHFCDTS for non-update requests to CICS maintained data table
- DFHFCVS for update requests to CICS-maintained data tables
- DFHFCRF for requests to remote files
Implements TEST_FILE_USER requests.
Routes RESTART_FILE_CONTROL requests to DFHFCVS and DFHFCRS during the file control initialization.
Frees buffers at the request of DFHAPSM when ‘short on storage’ has been detected.
- The FLAB and FRTE chain are scanned to find all FRTEs for the specified environment.
- An ENDBR request is issued to terminate any active browse operation.
- An UNLOCK request is issued for any active READ UPDATE or WRITE MASSINSERT.
Called by
- DFHAPLI
- AP language interface program
- DFHAPSM
- AP domain storage notify gate
- DFHDMPCA
- CSD manager adapter
- DFHDTLX
- Shared data tables load program
- DFHEIFC
- File control EXEC interface module
- DFHERM
- Resource manager interface (RMI) module
- DFHFCDL
- Coupling facility data tables load program
- DFHFCDTS
- File control shared data table request processor
- DFHFCFR
- File control file request handler (a recursive call)
- DFHFCRC
- File control recovery control program
- DFHFCRP
- File control restart program
- DFHUEH
- AP user exit handler.
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.
Performs monitoring.
Obtains a FLAB and FRTE to represent this request, or scans the FLAB and FRTE chains to associate this request with a previous FRTE if required. Some checking for error situations is performed during the scan.
Performs file state checking to determine whether or not a (VSAM or BDAM) request to a file is able to proceed. If file is enabled but closed and is not a request to a remote file, opens it before carrying out the request.
Checks for “privileged” requests.
If the request is not remote, checks the “service request” attributes for the file to determine whether the request can proceed.
Checks the file’s access method (VSAM or BDAM as defined in the FCT). If BDAM, calls DFHFCBD to process the request. If VSAM and non-RLS, calls DFHFCVS to process the request. If VSAM and RLS, calls DFHFCRS to process the request. If a data table, calls DFHFCDTS for read requests against a CICS-maintained data table or any request against a user-maintained table, and calls DFHFCVS otherwise (that is, for update and browse requests against a CICS-maintained data table). If the file is remote, calls DFHFCRF to process the request.
On return, performs clean up if required.
How loaded
By DFHSIB1 as part of the CICS nucleus.