# 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`.

Copyright © Cloud Software Group, Inc. All rights reserved.