CEMT PERFORM SHUTDOWN
Shut down the CICS® region.
In the CICS Explorer®, the Regions view provides a functional equivalent to this command.
Description
The shutdown can be either controlled or immediate. If a shutdown (either normal or immediate) hangs, a subsequent SHUTDOWN IMMEDIATE resumes the shutdown process.
Syntax
Options
- DUMP
- A dynamic storage dump is produced upon completion of the termination process.
- IMMEDIATE
- Specifies that the system is shut down immediately, terminating all active tasks and SNA sessions. If IMMEDIATE is not specified, all tasks are allowed to finish, and SNA sessions are allowed to terminate normally.
- NORESTART
- Specifies that, if the CICS region is registered to MVS™ Automatic Restart Manager (ARM), it is to be deregistered as part of shutdown and not restarted automatically.
- NOSDTRAN
- No
shutdown assist transaction is to be run at CICS shutdown.
The default shutdown transaction, if neither SDTRAN nor NOSDTRAN are specified, is CESD.
- PLT (value)
- Specifies the 1 or 2-character suffix of a program list table (PLT) to be used for the shutdown.
- PLTNAME (value)
- Specifies the 1 to 8-character name of a program list table (PLT) to be used for the shutdown. If you specify 1 or 2 characters, it is treated as a suffix and appended to prefix DFHPLT to form the name of the table. If you specify 3 to 8 characters, it is treated as the full name of the table.
- RESTART
- Specifies that, if the CICS region shuts down normally, it is to be restarted by MVS ARM.
- SDTRAN
- The 4-character identifier of the shutdown assist transaction
- TAKEOVER
- Specifies that this CICS region should be closed down, and the alternate CICS region is to take over. This is valid only if the XRF=YES system initialization parameter was specified for CICS startup.
- XLT (value)
- Specifies
the 2-character suffix of a transaction list table (XLT) to be used
for the shutdown.
Transactions listed in the specified XLT can be initiated after the SHUTDOWN request, and before the system quiesces. The default XLT should contain an entry for the main terminal transaction. This ensures that you can issue an immediate shutdown if, for example, a task is found to be suspended after an ordinary (nonimmediate) shutdown has been requested.
Table 1 shows
the effect of the TAKEOVER and IMMEDIATE options on the active CICS system.
| CEMT PERFORM SHUTDOWN | |||
|---|---|---|---|
| (normal) | TAKEOVER | IMMEDIATE | |
| Tasks | finish | finish | terminate |
| SNA session (XRF) | unbind | leave | leave |
| SNA session (non-XRF) | unbind | unbind | unbind |
Table 2 shows the effect
of the TAKEOVER and IMMEDIATE options on the alternate CICS system.
| CEMT PERFORM SHUTDOWN | |||
|---|---|---|---|
| (normal) | TAKEOVER | IMMEDIATE | |
| CICS alternate | shuts down | takes over | takes over |