tpcancel - Cancel a call descriptor for an outstanding reply

ANSI C, C++

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

K&R C

#include <xatmi.h>
int tpcancel (cd)
int     cd;

The function tpcancel() cancels a call descriptor, cd, returned by tpacall(). It is an error to attempt to cancel a call descriptor associated with a global transaction.

Upon successful return, cd is no longer valid and any reply received (by the communication resource manager) on behalf of cd is silently discarded.

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

Errors

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

Return value	Return value (numeric)	Explanation
TPEBADDESC	2	The argument cd is an invalid descriptor.
TPETRAN	14	The argument cd is associated with the caller's global transaction. Even after an error, the descriptor cd remains valid and the caller's current transaction is not affected.
TPEPROTO	9	The function tpcancel() was called in an improper context.
TPESYSTEM	12	A communication resource manager system error has occurred. The exact nature of the error is determined in a product-specific manner.
TPEOS	7	An operating system error has occurred. The exact nature of the error is determined in a product-specific manner.