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 -


CANCEL

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.

Error ConditionRESP2, Description & SolutionSystem Action
54 ISCINVREQ The remote system indicates a failure that does not correspond to a known condition.
Solution -Contact remote system support team to resolve the issue.
Task abnormally terminated
70 NOTAUTH Occurs when a resource security check has failed on the specified TRANSID.
Solution -Contact system administrator team to check whether the appropriate access added for the user or group. It will resolve the problem.
Task abnormally terminated
13 NOTFND Occurs if the request identifier specified fails to match an unexpired interval control command.
Solution -The CANCEL request identifier should match with unexpired interval control command. Modify the program to match the request identifiers.
Task abnormally terminated
53 SYSIDERR 130 - The SYSID name specified is neither the local region nor a remote system or the link to the remote system is closed.
Solution -The specified SYSID name is not related to any system. Correct it.

If the link to the remote system is closed, that might be due to the remote system is not up and running. Contact remote system support team.
Task abnormally terminated