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
(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.
tpcancel
() returns \-1 on error and sets tperrno
to indicate the error condition.
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
]
TPESYSTEM
]
TPEOS
]
tpacall
(3)