XTA: API Reference for C++ language

xa.h File Reference

Go to the source code of this file.

Classes

struct  xa_switch_t
 
struct  xid_t
 

Macros

#define LIXA_XAER_HAZARD   -20
 
#define MAXBQUALSIZE   64 /* maximum size in bytes of bqual */
 
#define MAXGTRIDSIZE   64 /* maximum size in bytes of gtrid */
 
#define MAXINFOSIZE   256
 
#define NULLXID   -1
 
#define RMNAMESZ   32
 
#define TM_JOIN   2
 
#define TM_OK   0
 
#define TM_RESUME   1
 
#define TMASYNC   0x80000000L
 
#define TMENDRSCAN   0x00800000L
 
#define TMER_INVAL   -2
 
#define TMER_PROTO   -3
 
#define TMER_TMERR   -1
 
#define TMFAIL   0x20000000L
 
#define TMJOIN   0x00200000L
 
#define TMMIGRATE   0x00100000L
 
#define TMMULTIPLE   0x00400000L
 
#define TMNOFLAGS   0x00000000L
 
#define TMNOMIGRATE   0x00000002L
 
#define TMNOWAIT   0x10000000L
 
#define TMONEPHASE   0x40000000L
 
#define TMREGISTER   0x00000001L
 
#define TMRESUME   0x08000000L
 
#define TMSTARTRSCAN   0x01000000L
 
#define TMSUCCESS   0x04000000L
 
#define TMSUSPEND   0x02000000L
 
#define TMUSEASYNC   0x00000004L
 
#define TMXTABRANCH   0x00008000L
 
#define XA_HEURCOM   7
 
#define XA_HEURHAZ   8
 
#define XA_HEURMIX   5
 
#define XA_HEURRB   6
 
#define XA_NOMIGRATE   9
 
#define XA_OK   0
 
#define XA_RBBASE   100
 
#define XA_RBCOMMFAIL   XA_RBBASE+1
 
#define XA_RBDEADLOCK   XA_RBBASE+2
 
#define XA_RBEND   XA_RBTRANSIENT
 
#define XA_RBINTEGRITY   XA_RBBASE+3
 
#define XA_RBOTHER   XA_RBBASE+4
 
#define XA_RBPROTO   XA_RBBASE+5
 
#define XA_RBROLLBACK   XA_RBBASE
 
#define XA_RBTIMEOUT   XA_RBBASE+6
 
#define XA_RBTRANSIENT   XA_RBBASE+7
 
#define XA_RDONLY   3
 
#define XA_RETRY   4
 
#define XAER_AFFINITY   -10
 
#define XAER_ASYNC   -2
 
#define XAER_DUPID   -8
 
#define XAER_INVAL   -5
 
#define XAER_NOTA   -4
 
#define XAER_OUTSIDE   -9
 
#define XAER_PROTO   -6
 
#define XAER_RMERR   -3
 
#define XAER_RMFAIL   -7
 
#define XID_T_TYPE
 
#define XIDDATASIZE   128 /* size in bytes */
 

Typedefs

typedef struct xa_switch_t *(* lixa_get_xa_switch_f )(void)
 
typedef struct xid_t XID
 

Functions

int ax_reg (int rmid, XID *xid, long flags)
 
int ax_unreg (int rmid, long flags)
 

Macro Definition Documentation

#define LIXA_XAER_HAZARD   -20

This is a special XAER return code used to manage the special situation of xa_prepare with errors and xa_rollback with errors. This is not an XA extension, but an internal LIXA implementation dependent value

Definition at line 367 of file xa.h.

#define MAXBQUALSIZE   64 /* maximum size in bytes of bqual */

Definition at line 25 of file xa.h.

#define MAXGTRIDSIZE   64 /* maximum size in bytes of gtrid */

Definition at line 24 of file xa.h.

#define MAXINFOSIZE   256

maximum size in bytes of xa_info strings, including the null terminator

Definition at line 67 of file xa.h.

#define NULLXID   -1

Definition at line 41 of file xa.h.

#define RMNAMESZ   32

length of resource manager name, including the null terminator

Definition at line 63 of file xa.h.

#define TM_JOIN   2

caller is joining existing transaction branch

Definition at line 225 of file xa.h.

#define TM_OK   0

normal execution

Definition at line 233 of file xa.h.

#define TM_RESUME   1

caller is resuming association with suspended transaction branch

Definition at line 229 of file xa.h.

#define TMASYNC   0x80000000L

perform routine asynchronously

Definition at line 161 of file xa.h.

#define TMENDRSCAN   0x00800000L

end a recovery scan

Definition at line 193 of file xa.h.

#define TMER_INVAL   -2

invalid arguments were given

Definition at line 241 of file xa.h.

#define TMER_PROTO   -3

routine invoked in an improper context

Definition at line 245 of file xa.h.

#define TMER_TMERR   -1

an error occurred in the transaction manager

Definition at line 237 of file xa.h.

#define TMFAIL   0x20000000L

dissociates caller and marks transaction branch rollback-only

Definition at line 169 of file xa.h.

#define TMJOIN   0x00200000L

caller is joining existing transaction branch

Definition at line 201 of file xa.h.

#define TMMIGRATE   0x00100000L

caller intends to perform migration

Definition at line 205 of file xa.h.

#define TMMULTIPLE   0x00400000L

wait for any asynchronous operation

Definition at line 197 of file xa.h.

#define TMNOFLAGS   0x00000000L

no resource manager features selected

Definition at line 141 of file xa.h.

#define TMNOMIGRATE   0x00000002L

resource manager does not support association migration

Definition at line 149 of file xa.h.

#define TMNOWAIT   0x10000000L

return if blocking condition exists

Definition at line 173 of file xa.h.

#define TMONEPHASE   0x40000000L

caller is using one-phase commit optimisation

Definition at line 165 of file xa.h.

#define TMREGISTER   0x00000001L

resource manager dynamically registers

Definition at line 145 of file xa.h.

#define TMRESUME   0x08000000L

caller is resuming association with suspended transaction branch

Definition at line 177 of file xa.h.

#define TMSTARTRSCAN   0x01000000L

start a recovery scan

Definition at line 189 of file xa.h.

#define TMSUCCESS   0x04000000L

dissociate caller from transaction branch

Definition at line 181 of file xa.h.

#define TMSUSPEND   0x02000000L

caller is suspending, not ending, association

Definition at line 185 of file xa.h.

#define TMUSEASYNC   0x00000004L

resource manager supports asynchronous operations

Definition at line 153 of file xa.h.

#define TMXTABRANCH   0x00008000L

caller is creating a new branch under the scope of an already existent global transaction

Definition at line 215 of file xa.h.

#define XA_HEURCOM   7

the transaction branch has been heuristically committed

Definition at line 304 of file xa.h.

#define XA_HEURHAZ   8

the transaction branch may have been heuristically completed

Definition at line 300 of file xa.h.

#define XA_HEURMIX   5

the transaction branch has been heuristically committed and rolled back

Definition at line 312 of file xa.h.

#define XA_HEURRB   6

the transaction branch has been heuristically rolled back

Definition at line 308 of file xa.h.

#define XA_NOMIGRATE   9

resumption must occur where suspension occurred

Definition at line 296 of file xa.h.

#define XA_OK   0

normal execution

Definition at line 324 of file xa.h.

#define XA_RBBASE   100

the inclusive lower bound of the rollback codes

Definition at line 255 of file xa.h.

#define XA_RBCOMMFAIL   XA_RBBASE+1

the rollback was caused by a communication failure

Definition at line 263 of file xa.h.

#define XA_RBDEADLOCK   XA_RBBASE+2

a deadlock was detected

Definition at line 267 of file xa.h.

#define XA_RBEND   XA_RBTRANSIENT

the inclusive upper bound of the rollback codes

Definition at line 292 of file xa.h.

#define XA_RBINTEGRITY   XA_RBBASE+3

a condition that violates the integrity of the resources was detected

Definition at line 271 of file xa.h.

#define XA_RBOTHER   XA_RBBASE+4

the resource manager rolled back the transaction branch for a reason not on this list

Definition at line 276 of file xa.h.

#define XA_RBPROTO   XA_RBBASE+5

a protocol error occurred in the resource manager

Definition at line 280 of file xa.h.

#define XA_RBROLLBACK   XA_RBBASE

the rollback was caused by an unspecified reason

Definition at line 259 of file xa.h.

#define XA_RBTIMEOUT   XA_RBBASE+6

a transaction branch took too long

Definition at line 284 of file xa.h.

#define XA_RBTRANSIENT   XA_RBBASE+7

may retry the transaction branch

Definition at line 288 of file xa.h.

#define XA_RDONLY   3

the transaction branch was read-only and has been committed

Definition at line 320 of file xa.h.

#define XA_RETRY   4

routine returned with no effect and may be reissued

Definition at line 316 of file xa.h.

#define XAER_AFFINITY   -10

Oracle proprietary extension to support a specific RAC feature. This is a nonstandard value. Please refer to original Oracle documentation

Definition at line 361 of file xa.h.

#define XAER_ASYNC   -2

asynchronous operation already outstanding

Definition at line 328 of file xa.h.

#define XAER_DUPID   -8

the XID already exists

Definition at line 352 of file xa.h.

#define XAER_INVAL   -5

invalid arguments were given

Definition at line 340 of file xa.h.

#define XAER_NOTA   -4

the XID is not valid

Definition at line 336 of file xa.h.

#define XAER_OUTSIDE   -9

resource manager doing work outside global transaction

Definition at line 356 of file xa.h.

#define XAER_PROTO   -6

routine invoked in an improper context

Definition at line 344 of file xa.h.

#define XAER_RMERR   -3

a resource manager error occurred in the transaction branch

Definition at line 332 of file xa.h.

#define XAER_RMFAIL   -7

resource manager unavailable

Definition at line 348 of file xa.h.

#define XID_T_TYPE

Definition at line 27 of file xa.h.

#define XIDDATASIZE   128 /* size in bytes */

Definition at line 23 of file xa.h.

Typedef Documentation

typedef struct xa_switch_t*(* lixa_get_xa_switch_f)(void)

Definition at line 131 of file xa.h.

typedef struct xid_t XID

Definition at line 35 of file xa.h.

Function Documentation

int ax_reg ( int  rmid,
XID xid,
long  flags 
)

Dynamically register a resource manager with a transaction manager

int ax_unreg ( int  rmid,
long  flags 
)

Dynamically unregister a resource manager with a transaction manager


Copyright © 2009-2019, Christian Ferrari tiian@users.sourceforge.net http://www.tiian.org/