Getting the XID Structure

The mi_xa_get_current_xid( ) function 3returns the pointer to the current XID structure for an XA-compliant, 3external data source. The XID structure is defined in the $INFORMIXDIR/incl/public/xa.h file.

This XID structure that is returned is valid only until the user-defined 3routine terminates. The calling user-defined routine must copy this 3function if it is necessary to keep the data for a longer period 3of time.

The syntax for the function is: 3

XID * mi_xa_get_current_xid ( )

For example: 3

     #include "xa.h"
3     #include "milib.h"
3XID * xid;
3xid = mi_xa_get_current_xid();   
3if ( (!xid)
3       {
3        /* Error while getting the curret XID */
3       }
3 /* Successful */

If successful, this function returns the pointer to the XID structure, 3which is not null.

For more information on this function, see the IBM Informix: DataBlade API Function Reference.