CA-GSS/ISERV Commands › GSS Extended Functions › CANCEL

CANCEL

This command cancels an IMOD at its next REXX clause (normal cancel) or at its next dispatch (forced cancel).

Syntax

CANCEL taskid [FORCE]

Parameters

taskid

Unique identifying number of the IMOD that you are canceling. The value is entered in hexadecimal.

To determine this number, use the DISPLAY ACTIVE command. The number is displayed in the IMOD ID column.

FORCE

Performs a forced cancel, which cancels the IMOD at the next dispatch. Otherwise, the IMOD is terminated at the conclusion of the current REXX clause.

You cannot perform a forced cancel unless you have tried to perform a normal cancel and the cancel failed.

Example

If you issue a CANCEL 3BC7 FORCE command (after issuing a CANCEL 3BC7 command), the following information is returned:

-------------------------- CA‑GSS/ISERVE Control Panel ------------------
==> cancel 3BC7 force                                             => PAGE
Target node: *                ssid: *    Host node: B1MAIN      ssid ISRV
=========================================================================
FORCE scheduled for IMOD 3BC7

Usage Notes

• The CANCEL command cannot terminate an IMOD while it is waiting for some external event, such as a WTOR. However, the IMOD is canceled as soon as the wait is completed.
• The CANCEL command without the FORCE option does not terminate an IMOD that is in a non-REXX loop, such as a loop occurring within a function or ADDRESS environment.

Other Responses

CANCEL scheduled for IMOD taskname

The specified IMOD is canceled at the end of the next REXX clause.

IMOD taskname not found

The specified IMOD is not currently executing.

IMOD taskname required "CANCEL" before "FORCE"

You cannot perform a forced cancel unless a previous normal cancel failed.