版本注意事項

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.

Authorization

None

Required Connection

Database

API Include File

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 Parameters

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.

Note:

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