CANCEL
Cancel interval control requests.
Note for dynamic transaction routing: Using CANCEL with REQID (of a POST, DELAY, or START) could create intertransaction affinities that adversely affect the use of dynamic transaction routing. See the Affinity for more information about transaction affinities.
Description
CANCEL cancels a previously
issued DELAY, POST, or START command. The CANCEL command
cannot be used to remove a request that is queued locally. If
you include the SYSID option, the command is shipped to a remote system.
If you omit SYSID, the TRANSID option, if present, indicates where
the command is to be executed. The effect of the cancelation varies
depending on the type of command being canceled, as follows:
- A DELAY command can be canceled only before it has expired, and only by a task other than the task that issued the DELAY command (which is suspended for the duration of the request). The REQID used by the suspended task must be specified. The effect of the cancelation is the same as an early expiration of the original DELAY. That is, the suspended task becomes dispatchable as though the original expiration time had been reached.
- When a POST command issued by the same task is to be canceled, no REQID need be specified. Cancelation can be requested either before or after the original request has expired. The effect of the cancelation is as if the original request had never been made.
- When a POST command issued by another task is to be canceled, the REQID of that command must be specified. The effect of the cancelation is the same as an early expiration of the original POST request. That is, the timer event control area for the other task is posted as though the original expiration time had been reached.
- When a START command is to be canceled, the REQID associated with the original command must be specified. The effect of the cancelation is as if the original command had never been issued. The cancelation is effective only before the original command has been honored.
- When you use a START command with the PROTECT option, CANCEL will cancel the START command only if the START command has been committed.
Note: A NOTFND response to a CANCEL command of a START
with REQID signifies that the start request is no longer outstanding.
It does not imply that the task to be started has completed by this
point in time; neither does it imply that the started task has issued
a RETRIEVE command to read the FROM data from the REQID queue. A
subsequent START command reusing the same REQID value may fail with
an AEIQ abend (IOERR condition), if the REQID queue still exists at
this time.
Options
- REQID(name)
- specifies
a name (1–8 characters), which should be unique, to identify
a command. This name is used as a temporary storage identifier. The
temporary storage queue thus identified must be defined as a local
queue on the CICS system where
the CANCEL command is processed.
This option cannot be used to cancel a POST command issued by the same task (for which, the REQID option is ignored if it is specified).
- SYSID(systemname)
- (remote systems only) specifies the name (1–4 characters) of the system for the CANCEL command.
- TRANSID(name)
- specifies the symbolic identifier (1–4 characters) of a transaction to be 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.
Conditions
- 54 ISCINVREQ
- occurs
when the remote system indicates a failure that does not correspond
to a known condition.
Default action: terminate the task abnormally.
- 70 NOTAUTH
- occurs
when a resource security check has failed on the specified TRANSID
or on the TRANSID of the START command that corresponds to the request
identification.
Default action: terminate the task abnormally.
- 13 NOTFND
- occurs
if the request identifier specified fails to match an unexpired interval
control command.
Default action: terminate the task abnormally.
- 53 SYSIDERR
- occurs
when the SYSID option specifies a name that is neither the local system
nor a remote system (made known to CICS by
defining a CONNECTION). It also occurs when the link to the remote
system is closed.
Default action: terminate the task abnormally.