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

Read syntax diagramSkip visual syntax diagram
CEMT PERFORM SHUTDOWN

>>-CEMT PERFORM SHUTDOWN--+------+--+---------+----------------->
                          '-DUMP-'  '-RESTART-'   

>--+---------------+--+------------+--+------------+-----------><
   +-SDTRAN(value)-+  '-PLT(value)-'  '-XLT(value)-'   
   '-NOSDTRAN------'                                   

Read syntax diagramSkip visual syntax diagram
CEMT PERFORM SHUTDOWN IMMEDIATE

>>-CEMT PERFORM SHUTDOWN IMMEDIATE--+------+--+-----------+----->
                                    '-DUMP-'  '-NORESTART-'   

>--+---------------+-------------------------------------------><
   +-SDTRAN(value)-+   
   '-NOSDTRAN------'   

Read syntax diagramSkip visual syntax diagram
CEMT PERFORM SHUTDOWN TAKEOVER

>>-CEMT PERFORM SHUTDOWN TAKEOVER--+------+--------------------->
                                   '-DUMP-'   

>--+---------------+-------------------------------------------><
   +-SDTRAN(value)-+   
   '-NOSDTRAN------'   

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 2-character suffix of a program list table (PLT) to be used for the shutdown.
Start of changeRESTARTEnd of change
Start of changeSpecifies that, if the CICS region shuts down normally, it is to be restarted by MVS ARM.End of change
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 master 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.

Table 1. 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.

Table 2. 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


dfha7n0.html | Timestamp icon Last updated: Monday, 5 June 2017