/SHUTDOWN Command

The /SHUTDOWN command causes a normal termination of CA Workload Automation SE execution. Due to the impact of shutting down CA Workload Automation SE, you should use the /SHUTDOWN command with caution.

The /SHUTDOWN command can only be used by a terminal specified as the Master or Alternate Master (CONS=MASTR or CONS=ALTRN on the TERM statement in the initialization file).

You can set default /SHUTDOWN options on the OPTIONS statement in the initialization file. These options take effect if you enter /SHUTDOWN with no parameters.

This command has the following format:

►►─ /SHUTDOWN ─ , ─┬────────┬─────────────────────────────────────────────────►◄
                   ├─ DMPQ ─┤
                   └─ Zn ───┘

DMPQ

(Optional) Specifies that the CA Workload Automation SE queues, except the SCRQ and DQTQ are to be unloaded during the shutdown process. These queues are unloaded to the CA Workload Automation SE queue dump file. The data in the queues is not deleted, only read. If only DMPQ is specified, CA Workload Automation SE does not terminate until all batch terminal processing is completed and all online terminals are logged off.

Note: The VRM database component contains "active" resource records that relate to jobs currently in the CA Workload Automation SE queues. These active records are dumped to the VRM dump queue file ddname CA7VDMP and are date/time stamped to match the queue records to ensure synchronization during MOVQ processing.

Zn

(Optional) Specifies the method of shutdown as follows:

Z1

Specifies a "fast" shutdown of CA Workload Automation SE. Messages are not sent to the individual terminals, and CA Workload Automation SE does not wait for them to log off but waits for batch type terminals to complete (this includes CAICCI terminals).

Z2

Specifies that shutdown is to occur even if batch type terminals are still active but waits for online terminals to log off.

Z3

Specifies that shutdown is to occur even if online and/or batch type terminals are active.

Z4

Specifies a combination of Z1 and DMPQ.

Z5

Specifies a combination of Z3 and DMPQ.

Note: If a form of Zn is not specified, CA Workload Automation SE does not terminate until all terminals have logged off. No batch type terminals can be active.

If a BTI is active when a shutdown is done with a "fast" option that includes not waiting for batch type terminals, CA Workload Automation SE can possibly abend (S002, for example). This is because of IO control blocks that can be changing status (OPEN/CLOSE) during an IO operation.