tibemsXAResource_Recover

Function

Purpose

Get a list of prepared transactions.

C Declaration

tibems_status tibemsXAResource_Recover(
    tibemsXAResource xaResource,
    XID* xids,
    tibems_int desiredCount,
    tibems_int* returnedCount,
    tibems_int flag );

COBOL Call

CALL "tibemsXAResource_Recover"
     USING BY VALUE xaResource,
           BY REFERENCE xids,
           BY VALUE desiredCount,
           BY REFERENCE returnedCount,
           BY VALUE flag,
           RETURNING tibems-status
END-CALL.
Note: xaResource and xids have usage pointer.

Parameters

Parameter Description
xaResource List the prepared transactions of this resource.
xids Store the list of transaction IDs in the array.
desiredCount Size of the array (number of XIDs).
returnedCount Store the actual number of transaction.
flag TMSTARTRSCAN—Start a new list of XIDs; the EMS server generates a complete list, and sends the first batch.

TMNOFLAGS—Continue the list of XIDs; the EMS server sends the next batch.

TMENDRSCAN—The EMS server discards its list of prepared transactions, and reclaims storage.

Remarks

When this call returns, if returnedCount  desiredCount, then more prepared transactions might exist. To get the next batch of XIDs, call this function again with TMNOFLAGS flag until returnedCount < desiredCount.