The xa_rollback( ) function

Home | Previous Page | Next Page Database Access > Working with XA-Compliant External Data Sources > Creating User-Defined XA-Support Routines > 3 3 3

The xa_rollback( ) function

The xa_rollback( ) function 3is called if an application rolls back the transaction or if the 3prepare stage of the transaction fails.

The syntax for the function is: 3

mint xa_rollback (XID *xid,   /* IN */
3            mint rmid,     /* IN */
3            int4 flags)   /* IN */

3 33333333333333333333333

Table 78. xa_rollback( ) Parameters
Parameter	Description
xid	Pointer to the XID data structure that is defined 3in the xa.h file and used for the current 3transaction
rmid	Unique resource manager identifier
flags	`TMNOFLAGS`, which is the valid value.

The following code sample code fragment contains the xa_rollback( ) function: 3

#include "xa.h"
3mint mqseries_rollback(XID *xid, mint rmid, int4 flags)
3  {
3/*  Error  */
3   return XAER_RMERR;
3/* Success */
3  return XA_OK;
3}

For valid return values, refer to X/Open information, including Distributed Transaction Processing: The XA Specification.