db2cli.ini 初期設定ファイル

IBM Data Server Client、 IBM Data Server Runtime Client、または IBM Data Server Driver Packageの場合、以下のいずれかのパスにサンプル構成ファイルが作成されます。

• AIX® または Linux® オペレーティング・システムの場合: installation_path/cfg ディレクトリー
• Windows オペレーティング・システムの場合: C:\ProgramData\IBM\Db2\driver_copy_name\cfg ディレクトリー

installation_path 値は、 IBM データ・サーバー製品をインストールしたディレクトリーを表します。 例えば、Windows 7 オペレーティング・システムに IBM Data Server Driver Package 製品をインストールし、データ・サーバー・ドライバーのコピー名が IBMDBCL1の場合、 C:\ProgramData\IBM\Db2\IBMDBCL1\cfg ディレクトリーに db2cli.ini.sample ファイルが作成されます。

IBM Data Server Driver for ODBC and CLI 製品のインストール済み環境では、以下のいずれかのパスにサンプル構成ファイルが作成されます。

• AIX または Linux オペレーティング・システムの場合: installation_path/cfg ディレクトリー
• Windows オペレーティング・システムの場合: 管理者権限を使用して db2cli install -setup コマンドを実行するときの C:\ProgramData\IBM\Db2\installation_path\cfg ディレクトリー

installation_path 値は、 IBM Data Server Driver for ODBC and CLI 製品を解凍したディレクトリーを表します。 例えば、Windows 7 オペレーティング・システム上の IBM Data Server Driver for ODBC and CLI 製品を C:\IBMDB2\CLIDRIVER\ ディレクトリーにインストールする場合、 db2cli.ini.sample ファイルは C:\ProgramData\IBM\DB2\C_IBMDB2_CLIDRIVER\cfg ディレクトリーに作成されます。

CLI/ODBC 構成キーワードを使用して、以下のタスクを実行できます。

• データ・ソース名、ユーザー名、パスワードなどの一般的な設定を構成する。
• パフォーマンスに影響を及ぼす可能性のあるオプションを設定する。
• ワイルドカード文字などの照会パラメーターを設定する。
• さまざまな ODBC アプリケーション用にパッチや回避策を指定する。
• 接続に関連付けられている設定 (コード・ページや IBM GRAPHIC データ・タイプなど) を指定します。
• アプリケーションによって指定されるデフォルト接続オプションをオーバーライドする。 例えば、アプリケーションが SQL_ATTR_ANSI_APP 接続属性を設定して CLI ドライバーに Unicode サポートを要求する場合、 db2cli.ini ファイルで DisableUnicode キーワードを 1 に設定すると、 CLI ドライバーはアプリケーションに Unicode サポートを提供しなくなります。
  重要: db2cli.ini ファイルで設定した CLI/ODBC 構成キーワードの値が、 SQLDriverConnect() 接続ストリング内のキーワードの値と競合する場合、 SQLDriverConnect() キーワードの値が優先されます。

以下の CLI キーワードは、 [COMMON] セクションでのみ指定できます。

• CheckForFork
• DiagPath
• DisableMultiThread
• JDBCTrace
• JDBCTraceFlush
• JDBCTracePathName
• QueryTimeoutInterval
• ReadCommonSectionOnNullConnect
• Trace
• TraceComm
• TraceErrImmediate
• TraceFileName
• TraceFlush
• TraceFlushOnError
• TraceLocks
• TracePathName
• TracePIDList
• TracePIDTID
• TraceRefreshInterval
• TraceStmtOnly
• TraceTime
• TraceTimeStamp

データベースに固有のセクションは、次のように大括弧で囲まれたデータ・ソース名 (DSN) で始まります。

[data_source_name]

大括弧で囲まれた名前は、セクション・ヘッダー と呼ばれます。

次のフォーマットを使用して、キーワードに値を設定します。

KeywordName=keywordValue

以下のような、他の規則が適用されます。

• 特定のデータベースのすべてのキーワードとその関連値は、そのデータベースのセクション・ヘッダーの下に配置する必要があります。
• データベース固有のセクションに DBAlias キーワードが含まれていない場合、接続の確立時にデータ・ソース名がデータベース別名として使用されます。
• キーワードには大/小文字の区別がありません。ただし、それらの値には、その区別がある場合もあります。
• db2cli.ini ファイルにデータベースが見つからない場合は、キーワードのデフォルト値が適用されます。
• 新しい行の先頭位置にセミコロンを入れると、注釈になります。
• ブランク行は許可されます。
• 1 つのキーワードに重複項目があると、最初の項目が使用され、警告は出されません。

以下のサンプル db2cli.ini ファイルには、2 つのデータベース別名セクションが含まれています：

; This is a comment line.
[MYDB22]
AutoCommit=0
TableType="'TABLE','SYSTEM TABLE'"

; This is another comment line.
[MYDB2MVS]
CurrentSQLID=SAAID
TableType="'TABLE'"
SchemaList="'USER1',CURRENT SQLID,'USER2'"