Section 3c - C Functions

ATMI C Function Reference

tpcancel(3c)

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:

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