DFHFCIN1 (file control initialization program 1)
Call mechanism
Kernel subroutine call. Automatic stack storage acquired as part of the call.
Entry address
DFHFCIN1. Stored in the CSA in a field named CSAFCXAD.
Purpose
The file control initialization program is part of the file control component. This program initializes file control and starts the file control restart task. It also waits for the restart task to complete, and returns the status of the completion to the caller.
Called by
DFHSII1, as part of CICS initialization.
Inputs
The FCIN parameter list, as defined by the DFHFCINA DSECT.
Outputs
Updated FCIN parameter list.
Operation
Initialize:
- Calls storage manager domain to add a subpool for file control static storage.
- Calls storage manager domain to create the storage for file control static storage.
- Initializes file control static storage.
- Attaches the file control restart task by means of a DFHKC request, with entry point address DFHFCIN2.
WAITINIT:
- Issues a dispatcher domain call to wait on the CICS ECB which indicates that the file control restart task has finished (FC_RECOV_ALLOWED_ACB) in file control static storage.
- On completion of the wait, tests the response and returns to DFHSII1.
How loaded
Link-edited with DFHFCIN2 to form the DFHFCIN module, which is loaded by DFHSIB1 as part of the CICS nucleus.