CANCEL

Cancel interval control requests. CANCEL cancels a previously issued DELAY, POST or START command. The CANCEL command can't be used to remove a request that is queued locally.

Syntax -

If SYSID option included, the command is shipped to a remote system. If SYSID omitted and TRANSID option indicates where the command is to be executed. The cancelation effect varies depending on the type of command being cancelled. The cancelation effect can be as follows -

• A DELAY command can be cancelled only by a task other than the task that issued the DELAY command. The REQID must be specified by the suspended task.
• A POST command can be cancelled by the same task and no REQID needs to be specified.
• A POST command can be cancelled only by a task other than the task that issued the POST command. The REQID must be specified by the suspended task.
• A START command is to be cancelled and the REQID associated with the original command.
• A START command issued with PROTECT option, CANCEL will cancel the START command only if the START command has been committed.

Options -

REQID(name) -

Specifies a unique name (1–8 characters) to identify a command. The name is used as a temporary storage identifier. The tsq identified must be defined as a local queue on the CICS system where the CANCEL command is processed. This option can't be used to cancel a POST command issued by the same task.

SYSID(system-name) -

Used to specify remote systems only. Specifies the name (1–4 characters) of the system for the CANCEL command.

TRANSID(name) -

Specifies the transaction used to determine where the CANCEL command is to be executed if SYSID is not specified. If the TRANSID is defined as REMOTE, the CANCEL request is function-shipped to the remote system.

Error Conditions -

Below are the list of error conditions may occur in combination. If more than one occurs, only the first is passed to the application program.