Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo C Function Reference

tpcancel() - routine for canceling a call descriptor for outstanding reply

#include <atmi.h> 
int tpcancel(int cd)

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().

Upon failure, tpcancel() returns -1 and sets tperrno() to indicate the error condition.

Upon failure, tpcancel() sets tperrno() to one of the following values.

[TPEBADDESC]

cd is an invalid descriptor.

[TPETRAN]

cd() is associated with the caller's transaction. cd remains valid and the caller's current transaction is not affected.

[TPEPROTO]

tpcancel() was called improperly.

[TPESYSTEM]

A BEA Tuxedo system error has occurred. The exact nature of the error is written to a log file.

[TPEOS]

An operating system error has occurred.

tpacall(3c)