The xa_close() function

When the database is closed or the session ends, which ever occurs first, HCL Informix® calls the xa_close() function for each XA data source used in the database session. This occurs when a new local database is opened, a database is closed, or a client session ends. The xa_close() function is also called when the XA data source is created and registered in a transaction and the transaction is rolled back.

When a database session is closed, all of the XA resources are freed and HCL Informix calls xa_close() for any registered XA datasources in the database session.

The syntax for the function is

mint xa_close(char *xa_info, /* IN */
           mint rmid,     /* IN */
           int4 flags)   /* IN */

Table 1. The xa_close() parameters
Parameter	Description
xa_info	Information string ("session-id:databasename@servername")
rmid	Unique resource manager identifier
flags	`TMNOFLAGS`, the valid value

The following code fragment contains the xa_close() function:

#include "xa.h"
mint mqseries_close(char *xa_info, 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.