Name

tx_close()—Closes a set of resource managers.

Synopsis

#include <tx.h> 
int tx_close(void)

Description

tx_close() closes a set of resource managers in a portable manner. It invokes a transaction manager to read resource-manager-specific information in a transaction-manager-specific manner and pass this information to the resource managers linked to the caller.

tx_close() closes all resource managers to which the caller is linked. This function is used in place of resource-manager-specific "close" calls and allows an application program to be free of calls which may hinder portability. Since resource managers differ in their termination semantics, the specific information needed to "close" a particular resource manager must be published by each resource manager.

tx_close() should be called when an application thread of control no longer wishes to participate in global transactions. tx_close() fails (returning [TX_PROTOCOL_ERROR]) if the caller is in transaction mode. That is, no resource managers are closed even though some may not be participating in the current transaction.

When tx_close() returns success (TX_OK), all resource managers linked to the calling thread are closed.

In a multithreaded application, a thread in the TPINVALIDCONTEXT state is not allowed to issue a call to tx_close().

Return Value

Upon successful completion, tx_close() returns TX_OK, a non-negative return value.

Errors

Under the following conditions, tx_close() fails and returns one of these negative values:

See Also

Warnings

Both the X/Open TX interface and the X-Windows system define the type XID. It is not possible to use both X-Windows calls and TX calls in the same file.