0001 TPCLOSE(3)
0002 ==========
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 tpclose - Close XA sub-system, disconnect from XA resource manager
0009
0010
0011 SYNOPSIS
0012 --------
0013 #include <atmi.h>
0014
0015 int tpclose (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 Close connection to XA resource manager. This basically calls underlaying XA
0024 switches *xa_close_entry()* with *NDRX_XA_CLOSE_STR*.
0025
0026 If *tpclose()* was already call and XA is closed, then function will succeed,
0027 and no error will be generated.
0028
0029 RETURN VALUE
0030 ------------
0031 On success, *tpclose()* return zero; on error, -1 is returned,
0032 with *tperrno* set to indicate the error.
0033
0034
0035 ERRORS
0036 ------
0037 Note that *tpstrerror()* returns generic error message plus custom message with
0038 debug info from last function call.
0039
0040 *TPEPROTO* Control thread is in global transaction.
0041
0042 *TPERMERR* Resource Manager failed. The *tpstrerror()* will provide more
0043 info from last call.
0044
0045 *TPESYSTEM* System failure occurred during serving. See logs i.e. user log,
0046 or debugs for more info. This could also be a problem with dynamical driver loading.
0047
0048 *TPEOS* System failure occurred during serving. See logs i.e. user log,
0049 or debugs for more info.
0050
0051
0052 EXAMPLE
0053 -------
0054 See *atmitest/test021_xafull/atmiclt21.c* for sample code.
0055
0056 BUGS
0057 ----
0058 Report bugs to support@mavimax.com
0059
0060 SEE ALSO
0061 --------
0062 *tpcommit(3)* *tpclose(3)* *tpopen(3)* *tpsuspend(3)* *tpresume(3)*
0063
0064 COPYING
0065 -------
0066 (C) Mavimax, Ltd
0067
