IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 176)

CEMT PERFORM SHUTDOWN
CEMT PERFORM SHUTDOWN
Function: Shut down the CICS region. The shutdown can
be either controlled or immediate.
Syntax
─ ─ ─CEMT Perform SHUTdown ─ ─┬ ┬ ──────────── ─────
└ ┘ ─ ─Xlt(value)
─ ─ ─┬ ┬ ──────────── ─ ─┬ ┬ ─────────────── ──────────
└ ┘ ─ ─Plt(value) ├ ┤ ─ ─Sdtran(value)
└ ┘ ─NOSdtran──────
─ ─ ─┬ ┬ ────────────────────────── ───────────────
└ ┘ ─Immediate─ ─ ─┬ ┬ ───────────
└ ┘ ─NORestart─
─ ─ ─ ─ ─┬ ┬ ────────── ─ ─ ─ ─┬ ┬ ────── ─
└ ┘ ─Takeover─ └ ┘ ─Dump─
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 VTAM
as a member of a generic resource, it is to be
deregistered as part of shutdown.
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.
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 4 shows the effect of the TAKEOVER and
IMMEDIATE options on the active CICS system.
Table 5 shows the effect of the TAKEOVER and
IMMEDIATE options on the alternate CICS system.
For further information on XRF, see the CICS/ESA 3.3 XRF
Guide.
Table 4. 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 5. 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
158 CICS Supplied Transactions