Cancela o efeito de um comando DELAY, POST ou START

Sintaxe

Descrição:

CANCEL cancels a previously issued DELAY, POST, or START command.
The effect of the cancelation 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 the cancelation is as if the original command was never made.
  The cancelation is effective only before the expiration of the original command.
  It is not possible to cancel a START command that is currently locally queued.

Opções

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.

Condições

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.

Informações relacionadas:

• DELAY
• START
• POST
• WAIT EVENT.
• TXSeries for Multiplatforms Administration Reference
• TXSeries for Multiplatforms Intercommunication Guide