DFHFCSD (file control shutdown program)
Call mechanism
Kernel subroutine call. Automatic stack storage acquired as part of the call.
Entry address
DFHFCSD. The entry point address is held in FC static storage in a field named FC_FCSD_ADDRESS, which is set by DFHFCRP when it loads DFHFCSD.
Purpose
The file control shutdown program is part of the file control component. Its purpose is to close all CICS files that are still open during phase 2 of a normal controlled CICS termination. This processing is bypassed for immediate termination.
Called by
DFHSTP, to close all open files managed by CICS file control.
Inputs
The FCSD parameter list, as defined by the DFHFCSDA DSECT, is created as part of the subroutine call.
Type of shutdown (immediate, warm)
Outputs
The response and reason codes only, which are returned in the FCSD parameter list.
Operation
DFHFCSD has only one function: TERMINATE.
On a ‘warm’ shutdown (that is, a not-immediate shutdown), DFHFCSD calls DFHTMP to scan all FCT entries. For each file, it calls DFHFCFS to close the file. A special CLOSE qualifier (shutdown) is specified on the call to DFHFCFS so as not to catalog the FCT entry as in an ‘unenabled’ state. DFHFCSD also calls DFHFCDO to disconnect coupling facility data table pools.
If RLS is supported, the quiesce system tasks CFQS and CFQR are terminated.
How loaded
By DFHFCRP as part of file control initialization.