0001 TX_CLOSE(3)
0002 ===========
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 tx_close - Close XA sub-system, disconnect from XA resource manager
0009
0010
0011 SYNOPSIS
0012 --------
0013 #include <tx.h>
0014
0015 int tx_close(void);
0016
0017 For XATMI client link with '-latmiclt -latmi -lubf -lnstd -lpthread -lrt -lm'
0018
0019 For XATMI server link with '-latmisrv|-latmisrvnomain|-latmisrvinteg -latmi -lubf -lnstd -lpthread -lrt -lm'
0020
0021 DESCRIPTION
0022 -----------
0023 Function disconnects control thread/process from XA driver. The function shall
0024 be called only when process have terminated global transaction. If resource
0025 manager was not open previously, function still succeed.
0026
0027 TX API is base on TP API. This function is based on *tpclose(3)* and it is possible
0028 to mix these two API kinds.
0029
0030 RETURN VALUE
0031 ------------
0032 On success, *tx_close()* return *TX_OK*; on error, error code is returned
0033
0034 ERRORS
0035 ------
0036
0037 *TX_PROTOCOL_ERROR* Process is in global transaction.
0038
0039 *TX_ERROR* Resource manager error occurred during the close.
0040
0041 EXAMPLE
0042 -------
0043 See *atmitest/test021_xafull/atmiclt21tx.c* for sample code.
0044
0045 BUGS
0046 ----
0047 Report bugs to support@mavimax.com
0048
0049 SEE ALSO
0050 --------
0051 *tx_open(3)* *tpclose(3)* *tx_open(3)* *tx_commit(3)* *tx_rollback(3)* *tx_info(3)*
0052
0053 COPYING
0054 -------
0055 (C) Mavimax, Ltd
0056
