Administrative API Reference

sqlxphqr - List Indoubt Transactions

Gets a list of all indoubt transactions for the currently connected database.

Scope

This API only affects the node on which it is issued.

Authorization

One of the following:

• sysadm
• dbadm

Required Connection

Database

Version

sqlxa.h

C API Syntax

/* File: sqlxa.h */ /* API: List Indoubt Transactions */ /* ... */ extern int SQL_API_FN sqlxphqr( int exe_type, SQLXA_RECOVER **ppIndoubtData, sqlint32 *pNumIndoubts, struct sqlca *pSqlca ); /* ... */

API Parameters

exe_type

Input. If EXE_THIS_NODE is specified, the operation is executed only at this node.

ppIndoubtData

Output. Supply the address of a pointer to an SQLXA_RECOVER structure to hold the indoubt transactions. This API allocates sufficient space to hold the list of indoubt transactions, and returns a pointer to this space. The space is released only when the process terminates. Do not use sqlefmem - Free Memory to free this memory, since it contains pointers to other dynamically allocated structures which will not be freed. For more information, see SQLXA-RECOVER.

pNumIndoubts

Output. The API will return the number of indoubt transactions returned in ppIndoubtData.

pSqlca

Output. A pointer to the sqlca structure. For more information about this structure, see SQLCA.