CICS actions on a normal shutdown (PERFORM SHUTDOWN)
Normal shutdown is initiated by the master terminal operator or by an application program. There are two stages in a normal shutdown.
First stage of normal shutdown
During the first stage of CICS® normal shutdown, all terminals are active and all CICS facilities are available.
- Message DFHTM1715 is issued to the console and the master terminal user to inform the operator that CICS is terminating.
- Tasks that already exist will complete. Long running tasks, such as conversational tasks, must end before this stage of shutdown can complete.
- Tasks to be automatically initiated will run, if they can start before the second stage.
- Any user-written programs listed in the first part of the shutdown program list table (PLT) are run sequentially.
- The Front End Programming Interface (FEPI) is requested to shut down.
- The terminal that initiated the shutdown, if any, is detached. This allows the operator to start
any further tasks that might be required, or to purge any tasks.
A new task is allowed to start only if it has been defined as SHUTDOWN(ENABLED) in its TRANSACTION resource definition, or, for a transaction started as a result of terminal input, if the transaction identifier is listed in the current transaction list table (XLT). The XLT list of transactions restricts the tasks that can be started by terminals and allows the system to shut down in a controlled manner. The current XLT is the one specified by the XLT system initialization parameter, which can be overridden by the XLT option of the CEMT or EXEC CICS PERFORM SHUTDOWN command.
Certain CICS-supplied transactions are, however, allowed to start whether or not their code is listed in the XLT. These transactions are CEMT, CESF, CLS1, CLS2, CSAC, CSTE, and CSNE.
Note: You should not change the SHUTDOWN(ENABLED) attribute of the resource definitions for these transactions, otherwise CICS might not shut down successfully. - A request is issued to all interregion communication (IRC) activity.
- Terminal control is requested to ignore all further input.
- Unless SDTRAN=NO or NOSDTRAN was specified, the shutdown task starts the specified shutdown transaction (default is CESD). CESD manages the purging of long-running user tasks.
- CLSDST requests are issued for all z/OS® Communications Server terminals.
- The termination task waits for all terminal activity to cease, before entering the second stage of shutdown.
The first shutdown stage is complete when the last of the programs specified in the first part of the shutdown PLT has run and all user tasks are complete.
Second stage of normal shutdown
During the second stage of shutdown, terminals are not active, and no new tasks are allowed to start.
- User-written programs listed in the second part of the shutdown PLT (if any) are executed sequentially. These programs cannot communicate with terminals, or make any request that would cause a new task to start.
- All currently open CICS files are now closed.
- The transient data CI buffer and the temporary storage buffers are flushed.
- CICS writes the following information to the global catalog:
- A warm keypoint. This contains information that is used to restore the operating environment during a subsequent warm start.
- A warm-start-possible indicator. This status applies on the next initialization of CICS if START=AUTO is specified.
- Transient data is terminated.
- A dump is taken, if one is required.
- The local and global catalogs are closed.
- The following message is issued:
DFHKE1799 applid TERMINATION OF CICS IS COMPLETE - CICS completes some internal processing, then returns control to MVS.