Проверяет время ответа сети для соединения между клиентом и сервером баз данных. Этот API может использоваться любой программой, когда обращение к серверу баз данных хоста осуществляется через DB2 Connect, как напрямую, так и через шлюз.
Авторизация
Нет
Необходимое соединение
База данных
Файл включения API
db2ApiDf.h
Синтаксис API C
/* Файл: db2ApiDf.h */ /* API: Проверка соединения с базой данных */ /* ... */ 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
/* Файл: db2ApiDf.h */ /* API: Проверка соединения с базой данных */ /* ... */ 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. Описание этой команды смотрите в руководстве Command Reference.