HALT CANCEL command

Read syntax diagramSkip visual syntax diagram
                            .-,--DUMP--=--NO------.   
>>-HALT-- --NET--,--CANCEL--+---------------------+------------><
                            '-,--DUMP--=--+-NO--+-'   
                                          '-YES-'     

Abbreviations

Operand Abbreviation
HALT Z

Purpose

The HALT CANCEL command should be used if the HALT and HALT QUICK commands do not terminate VTAM®. This command depends only on the proper functioning of the operating system's abnormal termination facilities.

CS z/OS® upper layer protocol (ULP) service access points (SAPs) will be abnormally terminated.

This command does not terminate multinode persistent sessions; therefore, the sessions are recoverable.

The HALT CANCEL command results in an abend of VTAM with a system completion code of X'0A9'. No further I/O operations are performed. VTAM application programs having a TPEND exit are notified of a VTAM shutdown, and data in the process of being transmitted might be lost. If the TPEND exit cannot be scheduled, the application program is abnormally terminated. In extraordinary circumstances, the operator might have to cancel some application programs. It is a good idea to shut down application programs (have them close their VTAM ACB) before you issue the HALT CANCEL command.

It is possible that the MVS™ operator console might be hung after you issue a HALT CANCEL command, for example if a message group is truncated before it can be displayed. You can clear the console by issuing the MVS command K Q.

VTAM does not take checkpoints of the directory database and the topology database during HALT CANCEL processing.

Operands

DUMP
Specifies whether a console dump is to be written to a SYS1.DUMP data set before VTAM is terminated.
DUMP=YES
Specifies that a console dump is to be written before VTAM is terminated.
DUMP=NO
Specifies that a console dump is not to be written before VTAM is terminated.