クライアントとデータベース・サーバーの間の基礎接続のネットワーク応答時間をテストします。この API は、ホスト・データベース・サーバーが、直接またはゲートウェイ経由で DB2 コネクトからアクセスされるときにアプリケーションによって使用されます。
権限
なし
必要な接続
データベース
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 コマンドを使用して呼び出すこともできます。このコマンドの説明については、コマンド解説書 をご覧ください。