Use the QUIESCE command to drain all inactive XIM initiators. This command flags all active initiators to be drained after the initiators become inactive. When all initiators have been drained and XIM has become dormant, you can issue the SHUTDOWN command to terminate XIM.
Syntax of the QUIESCE command
| |
|---|
| ALL is the default. It changes XIM status to prevent additional work from being accepted and additional XIM initiators from being started. |
| NEW allows products that are being executed to complete their work before termination. It changes XIM status to allow additional new units of work to be accepted from products that are connected to XIM. XIM does not allow any work to be accepted from other instances of XIM or any additional XIM initiators from being started by programs that are not already communicating with XIM. |
| IMMEDIATE allows products that are in execution to complete their current work before termination, but it does not allow any new work to start (no additional XIM initiators are started). |
Examples
The following example shows how to quiesce an XIM subsystem with the QUIESCE command (default is QUIESCE ALL).
F ximstc,QUIESCE
BMC95100I XIM QUIESCE Command Accepted, XIM QUIESCE in progress ximstc
BMC95192I XIM Command DRAIN ALL failed, no ACTIVE Initiators found ximstc
BMC95100I XIM STOP Command Accepted,Initiator termination in progress ximstc
BMC98522I Initiator shutdown request received in ASID(009B). XJSI
BMC98534I No work has been selected because initiator in ASID(009B) has been requested to stop. XJSI
BMC98510I Session terminated for initiator in ASID(009B). XJSI
BMC98212I XJS initiator ended in ASID(009B). XJSI
IEF404I XIMXJSI - ENDED - TIME=11.06.45
$HASP395 XIMXJSI ENDED
$HASP250 XIMXJSI PURGED -- (JOB KEY WAS AEBC8BE7)
The following example shows of how to quiesce an XIM subsystem with the QUIESCE NEW command.
F ximstc,QUIESCE NEW
BMC95100I XID QUIESCE Command Accepted, XID QUIESCE in progress ximstc
The following example shows how to quiesce an XIM subsystem with the QUIESCE IMMEDIATE command.
F ximstc,QUIESCE IMMEDIATE
BMC95100I XID QUIESCE Command Accepted, XID QUIESCE in progress ximstc
If you attempt to use the MVS CANCEL command (instead of the QUIESCE IMMEDIATE command), the XIM started task is intercepted by XJS and changed to a QUIESCE IMMEDIATE command. You must wait for XIM to stop automatically, cancel your batch jobs and cause XIM to terminate, issue the same CANCEL command again, or issue the ACTIVATE command to reverse the status change initiated by CANCEL.