为当前连接的数据库提供了所有不确定事务的列表。
作用域
此 API 仅影响在其上发出该 API 的节点。
权限
下列其中一项:
必需的连接
数据库
API 包含文件
db2ApiDf.h
C API 语法
/* File: db2ApiDf.h */ /* API: List Indoubt Transactions */ /* ... */ SQL_API_RC SQL_API_FN db2XaListIndTrans ( db2Uint32 versionNumber, void * pParmStruct, struct sqlca * pSqlca); typedef SQL_STRUCTURE db2XaListIndTransStruct { db2XaRecoverStruct * piIndoubtData; db2Uint32 iIndoubtDataLen; db2Uint32 oNumIndoubtsReturned; db2Uint32 oNumIndoubtsTotal; db2Uint32 oReqBufferLen; } db2XaListIndTransStruct; typedef SQL_STRUCTURE db2XaRecoverStruct { sqluint32 timestamp; SQLXA_XID xid; char dbalias[SQLXA_DBNAME_SZ]; char applid[SQLXA_APPLID_SZ]; char sequence_no[SQLXA_SEQ_SZ]; char auth_id[SQL_USERID_SZ]; char log_full; char connected; char indoubt_status; char originator; char reserved[8]; } db2XaRecoverStruct; |
API 参数
如果值为 NULL,DB2 将计算所需缓冲区的大小,并以 oReqBufferLen 的形式返回此值。oNumIndoubtsTotal 将包含不确定事务的总数。该应用程序可分配所需的缓冲区大小并再次发出该 API。
使用说明
在设置了与数据库或分区数据库协调节点的当前连接之后,典型的应用程序将执行下列步骤:
另见
Administrative API Reference 中的“sqlxhfrg - Forget Transaction Status”、“sqlxphcm - Commit an Indoubt Transaction”和“sqlxphrl - Roll Back an Indoubt Transaction”。