cancel task submit(1) — Commands
Digital
NAME
CANCEL TASK SUBMIT − statement that removes an inactive request from the queue of submitted requests
SYNOPSIS
[ <label-name>: ] CANCEL TASK SUBMIT
{ ID | IDENTIFIER } <identifier-field>
[ WITH { DEPENDENT | INDEPENDENT } WORK ] ;
PARAMETERS
•label-name
An internal unqualified identifier associated with the statement, for use in flow control operations.
•identifier-field
An array workspace field of 16 octets (ARRAY SIZE 16 OF OCTET). A submit identifier uniquely identifies each item in the request queue. When ACMSxp software enqueues the request, it generates a unique identifier, and stores the unique identifier value in a workspace field with the id-workspace field format.
DESCRIPTION
The queue storing the request and the canceling task must be on the same TPsystem.
Default operations depend on whether the task is restartable. For a nonrestartable task, the default is WITH INDEPENDENT WORK. That is, the removal is done immediately, independent of the outcome of the current transaction. For a restartable task, the default is WITH DEPENDENT WORK. That is, the removal is done transactionally within the current transaction.
If CANCEL TASK SUBMIT is used in a noncomposable task, it must be inside a transaction block.
The following requirements are necessary for CANCEL TASK SUBMIT:
oThe submitting task and the request queue containing the task to be canceled are on the same TPsystem.
oThe task to be canceled has not been forwarded or started executing.
The normal execution flow for CANCEL TASK SUBMIT is to remove from the local request queue the request specified by the value of the workspace field in IDENTIFIER. Deviations from the normal execution flow occur when one of the conditions described in the Exceptions section occurs. The CANCEL TASK SUBMIT completes with the exception class associated with the condition.
EXCEPTIONS
The CANCEL TASK SUBMIT statement can generate the ENVEXECUTION-FAULT exception class for one of the following error conditions:
oA request with the identifier specified could not be found.
oThe request with the identifier specified is executing.
oThe submitter TP system encountered a problem removing the request from the request queue.
RELATED INFORMATION
Syntax: exception(1), exception_handler(1), statement(1), stdl_syntax(1), submit_task(1), task_definition(1), transaction_block(1)