CANCEL
Cancels an interval control request.
Syntax
Description
CANCEL cancels a previously issued DELAY, POST, or START command. The effect of CANCEL varies
depending on the type of command that is being canceled, as follows:
- A DELAY command can be canceled only before it expires. The task that issued the DELAY command is suspended for the duration of the request, so that it can be canceled only by another task. You must specify the REQID that is used by the suspended task. Canceling the command has the same effect as the early expiration of the original DELAY. The suspended task becomes dispatchable, as though the expiration time of the original has been reached.
- When a START command is to be canceled, you must specify the REQID of the original command. The effect of CANCEL is as if the original command was never made. CANCEL is effective only before the expiration of the original command. It is not possible to cancel a START command that is currently locally queued.
Options
- REQID(name)
- Specifies a name that uniquely identifies the command that is to be canceled. The name can be up to eight characters long.
- SYSID(name)
- Specifies
on which CICS® region
the CANCEL is to run. The SYSID name has one through four characters. For
a full description of the SYSID option refer to SYSID.
If the SYSID option is not specified, it defaults to the value that is in the RemoteSysId attribute of the Transactions Definitions (TD) entry for the transaction that is requested in the TRANSID option.
If neither the SYSID option nor the TRANSID option is specified, the CANCEL request runs on the local region.
- TRANSID(name)
- Specifies the name, from one to four characters, of the transaction from the interval control request that is to be canceled. If you do not use the SYSID option to specify a remote SYSID, this transaction must have an entry in the TD.
Conditions
- INVREQ
- Occurs
when a remotely linked-to program attempts to execute a CANCEL command that
refers to the principal facility.
Default action: Terminates the task abnormally.
- ISCINVREQ
- Occurs
if the remote region indicates a problem that does not correspond to a known
condition.
Default action: Terminates the task abnormally.
- NOTAUTH
- Occurs
for the following conditions:
- A resource security check is unsuccessful on TRANSID(name).
- SYSID is specified by a transaction that is defined with the RSLCheck attribute set to either internal or external.
Default action: Terminates the task abnormally.
- NOTFND
- Occurs
if the specified request identifier cannot match an unexpired interval control
command.
Default action: Terminates the task abnormally.
- SYSIDERR
- Occurs
if the communications configuration has a problem that prevents the CANCEL
from proceeding. For example:
- The connection that is named in the SYSID option is not the name of a Communications Definition (CD) entry.
- The SYSID option references a CD entry that is incorrectly configured.
- The SYSID option references a CD entry that is marked as out-of-service.
It can also occur if the connection to the remote system is closed. This is possibly because the remote system is not available.
Default action: Terminates the task abnormally.