PURPOSE

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(3c). 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 System/T 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(3c)