[Top] [Prev] [Next] [Bottom]

tpcancel(3)

tpcancel(3)

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

Return Values

tpcancel() returns \-1 on error and sets tperrno to indicate the error condition.

Errors

Under the following conditions, tpcancel() fails and sets tperrno to:

[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 in an improper context.

[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.

See Also

tpacall(3)



[Top] [Prev] [Next] [Bottom]