The ax_unreg() function

Use the following syntax for an ax_unreg() function:

int ax_unreg(int rmid, int4 flags)

For example:

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

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

• Get the correct rmid (resource manager ID) value to use in the syntax for this function. If you do not know the resource manager ID, you can use the mi_xa_get_xadatasource_rmid() function to get the ID.
• Make sure the flags are passed as TMNOFLAGS.
• Only call the ax_unreg() function within an explicit or implicit transaction.
• Do not call the ax_unreg() function from these contexts:
  • From the subordinator of a distributed transaction
  • From within a resource manager global transaction
  • In a nonlogging database
  • From any of the XA purpose functions that are specified in a CREATE XADATASOURCE TYPE statement.
• Do not unregister an XA data source that is not registered or already unregistered.