/CANCEL command

The /CANCEL command cancels all segments of a multisegment input message.

It must be entered prior to the end-of-message (EOM) indicator from the terminal that was entering the message.

Subsections:

Environment
Syntax
Usage notes
Example

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) from which the command can be issued.

Table 1. Valid environments for the /CANCEL command
Command	DB/DC	DBCTL	DCCTL
/CANCEL	X		X

Syntax


>>-+-/CANCEL-+-------------------------------------------------><
   '-/CAN----'

Usage notes

Because a /CANCEL command must comprise a segment, it cannot be used to cancel a single-segment message.

On a non-3270 device, you can cancel a single-segment message by entering two asterisks (**), followed immediately by an end-of-segment (EOS) indicator. When Message Format Service (MFS) is used, you can define delete characters other than (**) to cancel other segments besides the first.

/CANCEL command has no meaning on display terminals where it is not possible to have some segments of a message already received by IMS™ while receiving subsequent segments.

Example

Entry ET:

  /BROADCAST TO ACTIVE (EOS)
  SYSTEM WILL BE AVAILABLE (EOS)

Entry ET:

  /CANCEL

Response ET:

  DFS058I  CANCEL COMMAND COMPLETED

Explanation: All previously entered segments of the current message are discarded.