The xa_complete() function

The xa_complete() function waits for an asynchronous operation to complete. If an operation is still pending, xa_complete() waits for the completion and returns the status.

The syntax for the function is:

mint xa_complete (char  *handle,      /* IN*/
              int * retval,  /* OUT */
           mint rmid,       /* IN */
           int4 flags)     /* IN */

Table 1. xa_complete() Parameters
Parameter	Description
handle	Handle returned by the xa_ call
retval	Return value of the xa_ call that returned `handle`
rmid	Unique resource manager identifier
flags	`TMNOFLAGS`, which indicates no flags

For valid return values, refer to X/Open information, including Distributed Transaction Processing: The XA Specification.

Currently HCL Informix® does not call the xa_complete() function because HCL Informix does not support asynchronous completion.