db2xa_prepare()--Prepare to Commit an XA Transaction Branch (Job Scoped Locks)


  Syntax
 #include <xa.h>

 int db2xa_switch.xa_prepare_entry(XID *xid,     
     int rmid, long flags);

  Default Public Authority: *USE

  Service Program: QTNXADTP

  Threadsafe: Yes

A transaction manager calls db2xa_prepare() to request that a resource manager prepare for commitment any work performed on behalf of *xid. The resource manager places all resources used in the transaction branch in a state that the changes can be made permanently when it later receives the db2xa_commit() request. All associations for *xid must have been ended by calling db2xa_end() prior to the prepare request.

For additional information about parameters, authorities required, return values, and error conditions, see the xa_prepare() API.


Example

See Code disclaimer information for information pertaining to code examples.

#include <xa.h>

main() {
  XID  *xid;
  int  rmid;
  long flags;
  int  retcode;
  extern struct xa_switch_t db2xa_switch;

  retcode =
     db2xa_switch.xa_prepare_entry(xid, rmid, flags);
}


API introduced: V4R3
Top | UNIX-Type APIs | APIs by category