Cancels an outstanding service request
- Specifies which services to cancel:
- Cancel the specific service request identified by
- An unqualified
ALLcancels all outstanding service requests; if followed by a list of service call identifiers (
ALLcancels the specified service requests. Enclose the list of call identifiers with parentheses.
JetNet, Oracle Tuxedo
service_cancelcommand cancels the specified service requests. An unqualified
service_cancelcancels the most recent asynchronous request. You can cancel one or more requests with the
ALLoptions. For example, this statement cancels the service request identified by the Panther variable
ervice_cancel CALL call_id
This statement cancels all outstanding service requests:service_cancel ALL
You can cancel both synchronous and asynchronous service calls. Canceling a call does not stop it from running; however, it does stop the reply. If the canceled service is part of a transaction under Oracle Tuxedo, the cancellation should be accompanied by a rollback to ensure the integrity of an XA resource.
tp_returnproperty to the number of service calls canceled.
service_cancelcan generate the following exceptions:
Exception Severity Cause TP_ALREADY_CANCELED TP_WARNING
The request has already been canceled.
Each request is canceled (informational only).
Service call is unidentifiable.
No connection to the middleware exists.
An error is reported from the middleware.
No service calls are outstanding; that is, a specified service call has already completed.
Note: A call is considered outstanding as soon as its associated
pre_requestevent has been raised, and is considered complete as soon as its associated
post_requestevent has been generated. After each request has terminated, a
post_requestevent is generated. For more information, refer to "Pre_request and Post_request Events" in JetNet/Oracle Tuxedo Guide.
receive, service_call, service_forward, service_return