GET CLI CONFIGURATION コマンド

GET CLI CONFIGURATION コマンドは、 db2cli.ini ファイルの内容をリストします。 ファイル全体または指定したセクションをリスト表示することができます。

db2cli.ini ファイルは、 Db2® コール・レベル・インターフェース (CLI) 構成ファイルとして使用されます。 これには、 CLI およびそれを使用するアプリケーションの動作を変更するために使用できるさまざまなキーワードと値が含まれています。 このファイルは複数のセクションに分かれており、 それぞれのセクションはデータベース別名に対応します。

許可

なし

必要な接続

なし

コマンド構文

Read syntax diagramSkip visual syntax diagramGET CLICONFIGURATIONCONFIGCFGAT GLOBAL LEVELFOR SECTIONsection-name

コマンド・パラメーター

AT GLOBAL LEVEL
LDAP ディレクトリー内のデフォルトの CLI 構成パラメーターを表示します。 このパラメーターは、 Windows オペレーティング・システムでのみ有効です。
FOR SECTION section-name
キーワードがリスト表示されるセクションの名前。 指定しない場合、すべてのセクションがリスト表示されます。

次の出力例は、2 つのセクションを持つ db2cli.ini ファイルの内容を示しています。

   [tstcli1x]
   uid=userid
   pwd=password
   autocommit=0
   TableType="'TABLE','VIEW','SYSTEM TABLE'"

   [tstcli2x]
   SchemaList="'OWNER1','OWNER2',CURRENT SQLID"

使用上の注意

このコマンドで指定するセクション名では、大/小文字の区別がありません。 例えば、 db2cli.ini ファイルのセクション名 (大括弧に区切られる) が小文字で、コマンドに指定されたセクション名が大文字の場合、正しいセクションがリストされます。

PWD (パスワード) キーワードの値はリストされません。代わりに、5 つのアスタリスク (*****) がリストされます。

LDAP (Lightweight Directory Access Protocol) が有効になっている場合、 CLI 構成パラメーターは、マシン・レベルに加えてユーザー・レベルでも設定できます。 ユーザー・レベルの CLI 構成は、LDAP ディレクトリーで維持されます。 指定されたセクションがユーザー・レベルで存在する場合は、そのセクションのユーザー・レベルの CLI 構成が返されます。存在しない場合は、マシン・レベルの CLI 構成が返されます。

ユーザー・レベルでの CLI 構成は、LDAP ディレクトリーに保持され、ローカル・マシンにキャッシュされます。 ユーザー・レベルで CLI 構成を読み取る場合、 Db2 は常にキャッシュから読み取ります。 キャッシュは、以下の場合に更新されます。
  • ユーザーが CLI 構成を更新します。
  • ユーザーは、 REFRESH LDAP コマンドを使用して CLI 構成のリフレッシュを明示的に強制します。

LDAP 環境では、ユーザーは、LDAP ディレクトリーにカタログされているデータベースに対してデフォルトの CLI 設定のセットを構成できます。 LDAP カタログ・データベースが CLI/ODBC 構成ユーティリティーを使用してデータ・ソース名 (DSN) として追加されると、デフォルトの CLI 設定が LDAP ディレクトリーに存在する場合は、ローカル・マシン上でその DSN 用に構成されます。 デフォルトの CLI 設定を表示するには、 AT GLOBAL LEVEL 節を指定する必要があります。