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