Using mi_xa_register_xadatasource( )

The mi_xa_register_xadatasource( ) function 3registers an XA data source with the current transaction. This function 3must be repeated with each new transaction. This function operates 3the same way as the ax_reg( ) function.

Use the following syntax for an mi_xa_register_xadatasource( ) function:

mi_integer mi_xa_register_xadatasource(mi_string *xasrc)

For example: 3

     #include "xa.h"
3     #include "milib.h"
3     int    retcode;
3   retcode = mi_xa_register_xadatasource("informix.Newyork"));
3  if ( retcode != MI_OK)
3       {
3        /* Error while registering the XA data source   */
3       }
3            /* Success fully registered */

When you use the mi_xa_register_xadatasource( ) function, 3follow these guidelines: 3

3
• Get the correct value for xarsc, which 3is the user-defined name of the XA data source. The format of the xarsc name 3is owner.xadatasourcename.
3
• Only call the mi_xa_register_xadatasource( ) function 3within an explicit or implicit transaction.
3
• Do not call the mi_xa_register_xadatasource( ) function: 3 3
  3
  • From the sub-ordinator of a distributed transaction or from 3within a resource manager global transaction 3 3

    Dynamic Server can operate as a resource manager in a global 3transaction managed by a third party transaction manager. The mi_xa_register_xadatasource( ) function 3should not be used if Dynamic Server is operating as a resource 3manager.

  3
  • In a non-logging database
  3
  • From any of the XA purpose functions that are specified in a 3CREATE XADATASOURCE TYPE statement.

Multiple registrations of the same XA data source in a single 3transaction do not effect either the transaction or the XA data 3source.

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