Notas del release

38.3 db2DatabasePing (nueva API)

db2DatabasePing - Base de datos Ping

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

versionNumber

Entrada. Versión y release del producto DB2 Universal Database o DB2 Connect que utiliza la aplicación.

Nota:

se debería utilizar la constante db2Version710 o superior para DB2 versión 7.1 o superior.

pParmStruct

Entrada. Puntero a la estructura db2DatabasePingStruct.

iDbAliasLength

Entrada. Longitud del nombre de alias de la base de datos.

Nota:

Este parámetro no se utiliza actualmente. Está reservado para su utilización en el futuro.

iDbAlias

Entrada. Nombre del alias de la base de datos.

Nota:

Este parámetro no se utiliza actualmente. Está reservado para su utilización en el futuro.

iNumIterations

Entrada. Número de iteraciones de peticiones de comprobación. El valor debe estar entre 1 y 32767, ambos inclusive.

poElapsedTime

Salida. Puntero hacia una matriz de enteros de 32 bits donde el número de elementos es igual a iNumIterations. Todos los elementos de la matriz contendrán el tiempo transcurrido en microsegundos para una iteración de petición de comprobación.

Nota:

La aplicación es responsable de la asignación de memoria para esta matriz antes de llamar a esta API.

pSqlca

Salida. Puntero hacia la estructura sqlca. Para obtener más información sobre esta estructura, consulte el manual Administrative API Reference.

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.