The xa_rollback() function

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

The syntax for the function is:

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

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

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

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

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