Using mi_xa_unregister_xadatasource( )

The mi_xa_unregister_xadatasource( ) function 3unregisters the previously registered XA data source from the transaction.

Use the following syntax for an mi_xa_unregister_xadatasource( ) function: 3

mi_integer mi_xa_unregister_xadatasource(mi_string *xasrc)

For example: 3

     #include "xa.h"
3     #include "milib.h"
3     int    retcode;
3   retcode = mi_xa_unregister_xadatasource("informix.Newyork"));
3  if ( retcode != MI_OK)
3       {
3        /* Error while unregistering the XA data source   */
3       }
3            /* Successfully unregistered */

When you use the mi_xa_unregister_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 3

  You can use the mi_xa_get_current_xid( ) function 3to return the pointer to the current XID structure for an XA-compliant, 3external data source.

3
• Only call the mi_xa_unregister_xadatasource( ) function 3within an explicit or implicit transaction.
3
• Do not call the mi_xa_unregister_xadatasource( ) function: 3 3
  3
  • From the sub-ordinator of a distributed transaction
  3
  • From within a resource manager global transaction
  3
  • In a non-logging database
  3
  • From any of the XA purpose functions that are specified in a 3CREATE XADATASOURCE TYPE statement.
3
• Do not unregister an XA data source that is not registered or 3already unregistered.

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