Using ax_unreg( )

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

By default, all XA-compliant external data sources are unregistered 3at the end of a transaction. Use the ax_unreg( ) function 3to unregister the data source before the end of the transaction 3so the data source does not participate in the transaction.

Use the following syntax for an ax_unreg( ) function:

int ax_unreg(int rmid, int4 flags)

For example:

     #include "xa.h"
3     #include "milib.h"
3     int   rmid, retcode;
3   if ( (rmid = mi_xa_get_xadatasource_rmid("informix.Newyork")) <= 0)
3       {
3        /* Error while getting XA data source id */
3       }
3  retcode  = ax_unreg(rmid,  TMNOFLAGS);
3  if (retcode != TM_OK )
3     {
3         /* ax_uunreg() Error  */
3     }
3 /* ax_unreg() is Successful */

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

3
• Get the correct rmid (resource manager 3ID) value to use in the syntax for this function. If you do not 3know the resource manager ID, you can use the mi_xa_get_xadatasource_rmid( ) function 3to get the ID.
3
• Make sure the flags are passed as TMNOFLAGS.
3
• Only call the ax_unreg( ) function within 3an explicit or implicit transaction.
3
• Do not call the ax_unreg( ) function from 3these contexts: 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.