Release-Informationen

37.6 db2XaGetInfo (new API)

db2XaGetInfo - Get Information for Resource Manager

Extracts information for a particular resource manager once an xa_open call has been made.

Berechtigung

None

Erforderliche Verbindung

Database

API-Include-Datei

sqlxa.h

C-API-Syntax

   /* File: sqlxa.h */
   /* API: Get Information for Resource Manager */
   /* ... */
   SQL_API_RC SQL_API_FN
   db2XaGetInfo (
      db2Uint32 versionNumber,
      void * pParmStruct,
      struct sqlca * pSqlca);
 
   typedef SQL_STRUCTURE db2XaGetInfoStruct
   {
     db2int32 iRmid;
     struct sqlca oLastSqlca;
   } db2XaGetInfoStruct;

API-Parameter

versionNumber

Input. Specifies the version and release level of the structure passed in as the second parameter, pParmStruct.

pParmStruct

Input. A pointer to the db2XaGetInfoStruct structure.

pSqlca

Output. A pointer to the sqlca structure. For more information about this structure, see the Administrative API Reference.

iRmid

Input. Specifies the resource manager for which information is required.

oLastSqlca

Output. Contains the sqlca for the last XA API call.

Anmerkung:

Only the sqlca that resulted from the last failing XA API can be retrieved.