環境情報およびデータ・ソース情報を照会するための関数
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 ....*/
}
}
}