Comprueba el tiempo de respuesta en la red de la conectividad subyacente entre un cliente y un servidor de bases de datos. Una aplicación puede utilizar esta API cuando se accede a un servidor de bases de datos principal mediante DB2 Connect directamente o utilizando una pasarela.
Autorización
Ninguna
Conexión necesaria
Base de datos
Archivo de inclusión de API
db2ApiDf.h
Sintaxis de API C
/* Archivo: db2ApiDf.h */ /* API: Base de datos Ping */ /* ... */ 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; }
Sintaxis de API genérica
/* Archivo: db2ApiDf.h */ /* API: Base de datos Ping */ /* ... */ 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; }
Parámetros de API
Notas de utilización
Debe existir una conexión a la base de datos antes de llamar a esta API. En caso contrario, se produce un error.
También es posible llamar a esta función utilizando el mandato PING. Para obtener una descripción de este mandato, consulte el manual Consulta de mandatos.