sqlxhfrg API - Forget transaction status

Permits the resource manager to release resources held by a heuristically completed transaction (that is, one that has been committed or rolled back heuristically). You might call this API after heuristically committing or rolling back an indoubt XA transaction.

Authorization

None

Required connection

Database

API include file

sqlxa.h

API and data structure syntax

extern int SQL_API_FN sqlxhfrg(
   SQLXA_XID *pTransId,
   struct sqlca *pSqlca
   );

sqlxhfrg API parameters

pTransId: Input. XA identifier of the transaction to be heuristically forgotten, or removed from the database log.
pSqlca: Output. A pointer to the sqlca structure.

Usage notes

Only transactions with a status of heuristically committed or rolled back can have the FORGET operation applied to them.