Проверяет время ответа сети для соединения между клиентом и сервером баз данных. Этот API может использоваться любой программой, когда обращение к серверу баз данных хоста осуществляется через DB2 Connect, как напрямую, так и через шлюз.
Авторизация
Нет
Необходимое соединение
База данных
Версия
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; }
Результаты
/* Файл: 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
Прим.: | Для DB2 Версии 7.1 или новее должна использоваться константа db2Version710. |
Прим.: | Этот параметр сейчас не используется. Он зарезервирован для будущего использования. |
Прим.: | Этот параметр сейчас не используется. Он зарезервирован для будущего использования. |
Прим.: | За выделение памяти для этого массива перед вызовом данного API отвечает прикладная программа. |
Замечания по использованию
Перед вызовом данного API соединение с базой данных должно существовать, иначе произойдет ошибка.
Эту функцию можно также вызвать при помощи команды PING. Описание этой команды смотрите в руководстве Command Reference.