ATMI C Function Reference
tpclose()
—Routine for closing a resource manager.
#include <atmi.h>
int tpclose(void)
tpclose()
tears down the association between the caller and the resource manager to which it is linked. Since resource managers differ in their close
semantics, the specific information needed to close a particular resource manager is placed in a configuration file.
If a resource manager is already closed (that is, tpclose()
is called more than once), no action is taken and success is returned.
In a multithreaded application, a thread in the TPINVALIDCONTEXT
state is not allowed to issue a call to tpclose()
.
Upon failure, tpclose()
returns -1 and sets tperrno
to indicate the error condition.
Upon failure, tpclose()
fails and sets tperrno
to one of the following values:
A resource manager failed to close correctly. More information concerning the reason a resource manager failed to close can be obtained by interrogating a resource manager in its own specific manner. Note that any calls to determine the exact nature of the error hinder portability.