测试客户机与数据库服务器之间的基本连接的网络响应时间。如果主机数据库服务器是直接通过 DB2 Connect 或通过网关访问的,则应用程序可使用此 API。
权限
无
必需的连接
数据库
API 包含文件
db2ApiDf.h
C API 语法
/* File: db2ApiDf.h */ /* API: Ping Database */ /* ... */ SQL_API_RC SQL_API_FN db2DatabasePing ( db2Uint32 versionNumber, void *pParmStruct, struct sqlca *pSqlca); /* ... */ typedef SQL_STRUCTURE db2DatabasePingStruct { char iDbAlias[SQL_ALIAS_SZ + 1]; db2Uint16 iNumIterations; db2Uint32 *poElapsedTime; }
一般 API 语法
/* File: db2ApiDf.h */ /* API: Ping Database */ /* ... */ SQL_API_RC SQL_API_FN db2gDatabasePing ( db2Uint32 versionNumber, void *pParmStruct, struct sqlca *pSqlca); /* ... */ typedef SQL_STRUCTURE db2gDatabasePingStruct { db2Uint16 iDbAliasLength; char iDbAlias[SQL_ALIAS_SZ]; db2Uint16 iNumIterations; db2Uint32 *poElapsedTime; }
API 参数
使用说明
数据库连接必须存在,才能调用此 API,否则将会产生错误。
此函数还可使用 PING 命令来调用。有关此命令的描述,参见 命令参考。