db2cli.ini 初期設定ファイル

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

• AIX®、HP-UX、Linux、または Solaris オペレーティング・システムの場合: installation_path/cfg ディレクトリー
• Windows XP および Windows Server 2003 オペレーティング・システムの場合: C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥driver_copy_name¥cfg ディレクトリー
• Windows Vista、Windows 7、および Windows Server 2008 オペレーティング・システムの場合: C:¥ProgramData¥IBM¥DB2¥driver_copy_name¥cfg ディレクトリー

installation_path 値は、IBM データ・サーバー製品をインストールしたディレクトリーを表します。 例えば、 IBM Data Server Driver Package 製品を Windows XP オペレーティング・システム上にインストールする場合で、データ・サーバー・ドライバーのコピー名が DSD_COPY である場合、db2cli.ini.sample ファイルは C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥DSD_COPY¥cfg ディレクトリーに作成されます。

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

• AIX、HP-UX、Linux、または Solaris の各オペレーティング・システムの場合: installation_path/cfg ディレクトリー
• Windows XP および Windows Server 2003 オペレーティング・システムの場合: db2cli install -setup コマンドを管理者権限で実行するとき、C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥installation_path¥cfg ディレクトリー
• Windows Vista、Windows 7、および Windows Server 2008 オペレーティング・システムの場合: db2cli install -setup コマンドを管理者権限で実行するとき、C:¥ProgramData¥IBM¥DB2¥installation_path¥cfg ディレクトリー

installation_path 値は、 IBM Data Server Driver for ODBC and CLI 製品を解凍したディレクトリーを表します。 例えば、IBM Data Server Driver for ODBC and CLI 製品を Windows Vista オペレーティング・システムの 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 つのキーワードに重複項目があると、最初の項目が使用され、警告は出されません。

2 つのデータベース別名セクションがある db2cli.ini サンプル・ファイルを次に示します。

; 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'"