e-docs > Tuxedo > ATMI C Function Reference > Section 3c - C Functions |
ATMI C Function Reference |
Name
tpcancel()—Routine for canceling a call descriptor for outstanding reply.
Synopsis
#include <atmi.h>
int tpcancel(int cd)
Description
tpcancel() cancels a call descriptor, cd, returned by tpacall(). It is an error to attempt to cancel a call descriptor associated with a transaction.
Upon success, cd is no longer valid and any reply received on behalf of cd will be silently discarded.
In a multithreaded application, a thread in the TPINVALIDCONTEXT state is not allowed to issue a call to tpcancel().
Return Values
Upon failure, tpcancel() returns -1 and sets tperrno to indicate the error condition.
Errors
Upon failure, tpcancel() sets tperrno to one of the following values:
See Also