環境情報およびデータ・ソース情報を照会するための関数

Db2® ODBC では、アプリケーションによって、現行の ODBC ドライバーまたは接続先のデータ・ソースの特性と機能に関する情報を取り出す関数を用意しています。

ドライバーまたはデータ・ソース情報を提供する関数を必要とする、最も一般的な状況の 1 つに、ユーザーに関する情報の表示があります。 データ・ソースの名前とバージョン、または Db2 ODBC ドライバーの バージョンなどの情報は、接続時に表示されたり、エラー報告処理の一部 として表示されることがあります。

例: 以下のコード は、データ・ソース、 すべてのサポートされる関数、およびサポートされるデータ・タイプについての ODBC 環境を照会する アプリケーションを示しています。
図 1. 環境情報を照会するアプリケーション
/***********************************************************/
/*  Querying environment and data source information       */
/***********************************************************/
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <sqlcli1.h>
void main()
{
    SQLHENV         hEnv;            /* Environment handle               */
    SQLHDBC         hDbc;            /* Connection handle                */
    SQLRETURN       rc;              /* Return code for API calls        */
    SQLHSTMT        hStmt;           /* Statement handle                 */
    SQLCHAR         dsname[30];      /* Data source name                 */
    SQLCHAR         dsdescr[255];    /* Data source description          */
    SQLSMALLINT     dslen;           /* Length of data source            */
    SQLSMALLINT     desclen;         /* Length of dsdescr                */
    BOOL            found = FALSE;
    SQLSMALLINT     funcs[100];
    SQLINTEGER      rgbValue;
    /*
     *  Initialize environment - allocate environment handle.
     */
    rc = SQLAllocHandle( SQL_HANDLE_ENV, SQL_NULL_HANDLE, &hEnv );
    rc = SQLAllocHandle( SQL_HANDLE_DBC, hEnv, &hDbc );
    /*
     *  Use SQLDataSources to verify ZOSDB2 does exist.
     */
    while( ( rc = SQLDataSources( hEnv,
                            SQL_FETCH_NEXT,
                            dsname,
                            SQL_MAX_DSN_LENGTH+1,
                            &dslen,
                            dsdescr,
                            &desclen ) ) != SQL_NO_DATA_FOUND )
    {
       if( !strcmp( dsname, "ZOSDB2" ) )   /* data source exist          */
       {
           found = TRUE;
           break;
       }
    }
    if( !found )
    {
        fprintf(stdout, "Data source 
        fprintf(stdout, "program aborted.¥n");
        exit(1);
    }     
    if( ( rc = SQLConnect( hDbc, dsname, SQL_NTS, "myid", SQL_NTS,
                            "mypd", SQL_NTS ) ) 
         == SQL_SUCCESS )
    {
       fprintf( stdout, "Connect to 
    }
    SQLAllocHandle( SQL_HANDLE_STMT, hDbc, &hStmt );
    /*
     *   Use SQLGetFunctions to store all APIs status.
     */
    rc = SQLGetFunctions( hDbc, SQL_API_ALL_FUNCTIONS, funcs );
    /*
     *   Check whether SQLGetInfo is supported in this driver. If so,
     *   verify whether DATE is supported for this data source.
     */
    if( funcs[SQL_API_SQLGETINFO] == 1 )
    {
        SQLGetInfo( hDbc, SQL_CONVERT_DATE, (SQLPOINTER)&rgbValue, 255, &desclen );
        if( rgbValue & SQL_CVT_DATE )
        {
           SQLGetTypeInfo( hStmt, SQL_DATE );
           /*  use SQLBindCol and SQLFetch to retrieve data ....*/
        }
    }
}