릴리스 정보

37.3 db2DatabasePing(새 API)

db2DatabasePing - Ping 데이터베이스

클라이언트와 데이터베이스 서버 사이에서 기초적인 연결성의 네트워크 응답 시간을 테스트합니다. 이 API는 응용프로그램이 호스트 데이터베이스 서버에 DB2 Connect를 통해(직접 또는 게이트웨이를 통해) 액세스할 때 사용할 수 있습니다.

권한 부여

없음

필수 연결

데이터베이스

API 포함 파일

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 매개변수

versionNumber

입력. 응용프로그램이 실행하는 DB2 Universal Database 또는 DB2 Connect 제품의 버전 및 릴리스.

주:

db2Version710 상수 또는 그 이상이 DB2 버전 7.1 이상에서 사용되어야 합니다.

|pParmStruct

입력. db2DatabasePingStruct 구조를 가리키는 포인터

iDbAliasLength

입력. 데이터베이스 별명 길이

주:

이 매개변수는 현재 사용되지 않습니다. 앞으로 사용되기 위해 예약된 것입니다.

iDbAlias

입력. 데이터베이스 별명.

주:

이 매개변수는 현재 사용되지 않습니다. 앞으로 사용되기 위해 예약된 것입니다.

iNumIterations

입력. 테스트 요청 반복 수. 값은 1 - 32767 이내여야 합니다.

poElapsedTime

출력. 요소 갯수가 iNumIterations와 같은 32비트 정수 배열에 대한 포인터. 배열에 있는 각 요소에는 한 테스트 요청 반복에 소요되는 마이크로 단위의 시간이 들어갑니다.

주:

응용프로그램은 이 API를 호출하기 전에 이 배열에 메모리를 할당해야 합니다.

pSqlca

출력. sqlca 구조를 가리키는 포인터. Administrative API Reference에서 이 구조에 대한 자세한 내용을 참조하십시오.

사용 참고

이 API를 호출하기 전에 데이터베이스 연결이 있어야 하며, 그렇지 않으면 오류가 발생합니다.

이 기능은 또한 PING 명령을 사용하여 호출될 수 있습니다. 이 명령에 대한 설명은 Command Reference를 참조하십시오.