QUIESCE

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.

Related Topic

XIM-commands

Syntax of the QUIESCE command

image2019-1-4_12-26-0.png

Parameter

Description

ALL

ALL is the default. It changes XIM status to prevent additional work from being accepted and additional XIM initiators from being started.

NEW

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

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.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*