DFHFCIN2 (file control initialization program 2)
Call mechanism
Attached by DFHFCIN1 as a separate CICS task. Given control by means of the DFHKC TYPE=ATTACH mechanism.
Entry address
DFHFCIN2. Because DFHFCIN2 is link-edited with DFHFCIN1, the entry address is known to DFHFCIN1 at the time the DFHKC TYPE=ATTACH is issued.
Purpose
The file control initialization program is part of the file control component. This program loads and calls the file control restart program (DFHFCRP), to perform file control restart as a separate task.
Called by
CICS task control, after being attached by DFHFCIN1.
Inputs
None.
Outputs
The initialized file control component. Addresses and indicators completed in file control static storage.
Operation
Calls loader domain to acquire (that is, to load) the DFHFCRP program. Stores the entry point address of the loaded module (which is also the load point) in DFHFCIN2’s automatic storage in a field named FCRP_ENTRY_ADDRESS.
If the ACQUIRE request failed, calls loader domain to define program and then retries the ACQUIRE request.
Calls DFHFCRP by means of a subroutine call via the kernel.
On successful completion, calls loader domain to release DFHFCRP. On both successful and unsuccessful completion, posts the ECBs FC_NON_RECOV_ALLOWED_ECB and FC_RECOV_ALLOWED_ECB. The success or otherwise of File Control restart is indicated by the flag FCSCMPLT in file control static storage.
On unsuccessful completion, posts the Restart Task ECB complete and returns.
How loaded
By DFHSIB1 as part of the CICS nucleus.