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. 

xaResource and xids have usage pointer.

Parameter
Description
xaResource
List the prepared transactions of this resource.
xids
The function stores the list of transaction IDs in the array at this location.
desiredCount
Size of the array (number of XIDs).
returnedCount
The function stores the actual number of transaction IDs in this location.
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.


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com