CANCEL

CA-GSS/ISERV Commands › CA-GSS/ISERVE Operator Commands › CANCEL

CANCEL

Use the CANCEL command to cancel an IMOD at its next REXX clause (normal cancel) or at its next dispatch (forced cancel).

Syntax

Use this format for the CANCEL command:

CANCEL taskid [FORCE]

Parameters

The CANCEL command takes these 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 will be 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.

Tell Technical Publications how we can improve this information