db2cli - Db2 対話機能 CLI コマンド

CLIで設計およびプロトタイピングを行うための対話式コール・レベル・インターフェース (CLI) 環境を開始します。

db2cli コマンドは、 IBM® データ・サーバー製品をインストールしたディレクトリーの bin サブディレクトリーにあります。 UNIX および Linux® オペレーティング・システムでは、 db2cli コマンドは home_dir/sqllib/bin ディレクトリーにあります。ここで、 home_dir はインスタンス所有者のホーム・ディレクトリーです。 Windows オペレーティング・システムの場合、このコマンドは DB2PATH\bin ディレクトリーにあります。ここで、 DB2PATH は Db2 コピーのインストール場所です。

許可

なし

必要な接続

なし

コマンド・パラメーター

validate

CLI 環境構成を検証してテストします。このオプションは、db2cli.ini ファイルとdb2dsdriver.cfgファイルにあるキーワードのリストを表示します。指定されたデータ・ソースまたはデータベース名に対して無効なキーワードがある場合は、以下のようにリストされます。UNKNOWN. IBM データ・サーバー・クライアント ( IBM Data Server Client または IBM Data Server Runtime Client) の場合、 db2cli validate コマンドは、Windows オペレーティング・システムにインストールされている Db2 クライアント・パッケージをリストします。

db2cli validate コマンドを IBM データ・サーバー・クライアントから発行する場合、リストは、Windows オペレーティング・システムにインストールされている IBM データ・サーバー・クライアントに限定されます。 IBM Data Server Driver for ODBC and CLI パッケージ、および Windows オペレーティング・システムにインストールされている IBM データ・サーバー・クライアント・パッケージをリストするには、 IBM Data Server Driver for ODBC and CLI インストール済み環境から db2cli validate コマンドを発行する必要があります。リストには, 現在のコピー名が次のように示されます。[C]およびデフォルトのコピー名[D].

-dsn dsn_name

妥当性検査を行うデータ・ソース名 (DSN) を指定します。 dsn_name の中に空白文字がある場合は、空白文字を二重引用符で囲んでください。

-database database:server:port

妥当性検査を行うデータベース名、サーバー名、ポート番号を指定します。データベース名、サーバー名、およびポート番号はコロンで区切る必要があります。サーバー名は、完全修飾ドメイン名 (FQDN) で構成されている必要があります (例: TESTDB:dbserver.example.com:19677)。

-- connstring ストリング

ターゲット・データベースのデータベース接続ストリングを指定します。情報は、 SQLDriverConnect API 関数の InConnectionString 引数で定義された形式で指定する必要があります。以下に例を示します。

DATA-BASE=SAMPLE;HOSTNAME=test.ibm.com;PORT=50000;UID=db2user;PWD=db2pwd

注:

接続ストリングのパラメーターが db2dsdriver.cfg ファイルまたは db2cli.ini ファイルにも存在する場合は、接続ストリングの値が使用されます。
db2cli validate コマンドで -connsting オプションを複数回使用すると、最後の -connstring オプションの値が使用されます。

-all

システム・レベルのdb2dsdriver.cfgファイルのすべてのデータベースとDSNエントリーを検証します。 Microsoft Windowsプラットフォームで実行する場合、-allを使とう、システム・レベルとユーザー・レベルの両方のdb2dsdriver.cfgファイルのすべてのデータベースと DSN エントリーが検証されます。 Windows環境では、ユーザー・レベルのdb2dsdriver.cfgファイルは、ユーザーのホーム・ディレクトリーにC:\users\<username>\db2dsdriver.cfgとして保存されます。

-connect

db2cli validate コマンドは、接続してコマンド出力への接続試行に関する情報を書き込みます。

制約事項: クライアント・バージョンより低いバージョンのゲートウェイに接続すると、対応するクライアント/サーバーの組み合わせでサポートされる新機能が使用できない場合があります。

-f OUTPUT_FILE

db2cli コマンドの結果用の出力ファイルを指定します (オプション)。

-help

validate パラメーターの使用法に関連したヘルプ情報を表示します。

Connect

db2cli validate コマンドが接続をテストできる DSN またはデータベースを指定します。接続試行およびライセンス情報に関する情報がコマンド出力にリストされます。

-displaylic: 有効なライセンスの存在およびそのライセンスの配置場所を表示します。ライセンスが存在できる場所は、クライアントまたはサーバー、あるいはその両方です。 Db2 for IBM i または Db2 for z/OS® サーバーにあるライセンスについては、コマンド出力には、ライセンス交付にユーザー定義関数 (UDF) とストアード・プロシージャー (SP) のどちらが使用されているか、およびライセンス・バージョンに関する情報が含まれています。

-odbcdsn: ODBC ドライバー・マネージャーとのデータベース接続をユーザーが妥当性検査できるようにします。

-useserverlic: ライセンス交付に使用されるユーザー定義関数 (UDF) またはストアード・プロシージャー (SP) を呼び出して、 Db2 ( IBM i の場合) または Db2 for z/OS サーバーにあるライセンスをテストします。 -useserverlic オプションは、クライアント・サイドのライセンス検査をバイパスします。ライセンスのバージョンと、ライセンス交付にユーザー定義関数 (UDF) とストアード・プロシージャー (SP) のどちらが使用されるかを表示します。
注意: -useserverlic (S) オプションは、 Db2 ( IBM i の場合) または Db2 for z/OS サーバーへの接続でのみ使用できます。

-user username: 接続に使用するユーザー名を指定します。
-passwd password: 接続に使用するパスワードを指定します。
-keystoredbpassword keystoredbpasswd: Authenticationパラメーターが証明書に設定されている場合に、SSL接続のパスワードを指定します。

bind

指定した filename をターゲット・データベースに対してバインドします。 db2cli bind コマンドは、最初に db2cli bind コマンド・パラメーターで指定された情報を使用してターゲット・データベースに接続してから、バインド・アクションを実行します。バインド・ファイルの拡張子は .bndです。

filename

filename には、バインド・ファイル、または複数のバインド・ファイルの名前を含むリスト・ファイルの名前を指定できます。リスト・ファイルを指定する場合、リスト・ファイル名の先頭に @ 文字を付ける必要があります。完全修飾バインド・ファイル名は二重引用符内に指定できます。

パスなしでバインド・ファイル名のみを指定すると、まず、現行ディレクトリーでそのファイルが検索されます。ファイルが見つかると、そのファイルがピックアップされ、パッケージが作成されます。現行ディレクトリーでファイルが見つからない場合は、インスタンスまたはインストール・パスからファイルが自動的にピックアップされます。

-dsn dsn_name

バインド先のデータ・ソース名 (DSN) を指定します。このバインド・オプションを使用するときには、ターゲット・データベースに接続するために必要なすべての情報 (有効なユーザー ID とパスワードを除く) を以下に指定する必要があります。

db2cli.iniファイル内のデータ・ソース名セクション。
db2dsdriver.cfgファイルのデータベース・セクションまたは DSN セクション。
ローカル・カタログ項目。

-database database:server:port

バインド先のデータベース名、サーバー名、およびポート番号を指定します。データベース名、サーバー名、およびポート番号はコロンで区切る必要があります。サーバー名は、完全修飾ドメイン名 (FQDN) で構成されている必要があります (例: TESTDB:dbserver.example.com:19677)。

-user username

接続に使用するユーザー名を指定します。

-passwd password

接続に使用するパスワードを指定します。

-options "various_bind_options"

バインド・オプションおよびその値を指定します。以下のバインド・オプションが使用可能です。

BLOCKING
COLLECTION
エンコード
generic
GRANT
権限付与の役割
ISOLATION
KEEPDYNAMIC
REOPT

-help

bind パラメーターの使用法に関連したヘルプ情報を表示します。

registerdsn

db2cli DSN 登録モードを指定します。 Windows オペレーティング・システムで DSN を登録するには、このコマンド・パラメーターを使用します。

-add dsn_name|-alldsn

システムまたはユーザーの ODBC データ・ソースを Microsoft ODBC データソースアドミニストレーターに追加します。 description がレジストリーに追加されるのは、その DSN の description 値が db2dsdriver.cfg ファイルまたは db2cli.ini ファイルに存在する場合のみです。

dsn_name

登録する DSN を指定します。 dsn_name の値は、 db2cli.ini ファイルに定義されている DSN、または db2dsdriver.cfg ファイルに定義されている DSN 別名でなければならず、DBALIAS 名にすることはできません。 -add dsn-name パラメーターを使用すると、ローカル・データベース・ディレクトリー内にあるカタログ済みのデータベースを表すデータ・ソースを追加できます。 dsn-名前 は、 db2cli.ini ファイルまたは定義されている DSN 別名db2dsdriver.cfg ファイルに定義されているデータ・ソース、および IBM データ・サーバー・クライアントのローカル・データベース・ディレクトリーにあるデータベース別名を示すことができます。 dsn_name の中に空白文字がある場合は、空白文字を二重引用符で囲んでください。

-dsn

Microsoft ODBC データソースアドミニストレーターに追加する必要がある DSN 名をユーザーが指定できるようにします。 db2cli registerdsn -add -dsn コマンドは、Windows オペレーティング・システムで使用できます。

-alldsn

db2cli.ini ファイルに定義されているすべてのデータ・ソース、 db2dsdriver.cfg ファイルに定義されている DSN 別名、およびローカル・データベース・カタログを登録します。このパラメーターは、-add パラメーターと組み合わせて使用する必要があります。

-includeldap: LDAP サーバー、db2cli.ini ファイル、db2dsdriver.cfg ファイル、ローカル・データベース・カタログに指定されるすべてのデータ・ソースを登録します。 IBM データ・サーバー・ドライバー構成ファイルの LDAP セクションを構成するか、Windows 環境で LDAP 接続を構成することにより、LDAP サーバーに正常に接続できることを確認します。

-user

データ・ソースをユーザー ODBC データ・ソースとして登録します。パラメーターを指定しないと、データ・ソースはユーザー ODBC データ・ソースとして登録されます。

-system

データ・ソースをシステム ODBC データ・ソースとして登録します。

-remove dsn_name

システムまたはユーザーの ODBC データソースを Microsoft ODBC データソースアドミニストレーターから削除します。 dsn_name の中に空白文字がある場合は、空白文字を二重引用符で囲んでください。

-alldsn: Microsoft ODBC データ・ソース・アドミニストレーターから、指定された Db2 コピーのすべてのユーザーまたはシステム ODBC データ・ソース項目を除去します。 db2cli register -remove -alldsn コマンドは、Windows オペレーティング・システムで使用できます。

-copyname copy_name: 指定された Db2 コピーのユーザーまたはシステム ODBC データ・ソース項目を Microsoft ODBC データソースアドミニストレーターから削除します。コピー名を指定しない場合、現行コピー名が使用されます。現行コピー名とは、db2cli ユーティリティーが属しているクライアントのコピー名です。 -copyname オプションを -alldsn オプションとともに指定すると、Microsoft ODBC データ・ソース・アドミニストレーターのすべてのデータ・ソース・エントリーが、指定された Db2 コピーから除去されます。 db2cli register -remove -copyname コマンドは、Windows オペレーティング・システムで使用できます。

-allcopies: Microsoft ODBC データソースアドミニストレーターから、すべての Db2 コピーのすべてのユーザーまたはシステム ODBC データ・ソース項目を除去します。 -force オプションも指定している場合を除き、すべての ODBC データ・ソース項目を削除するかどうかを確認するプロンプトが出されます。 db2cli register -remove -allcopies コマンドは、Windows オペレーティング・システムで使用できます。

-force: 確認を求めるプロンプトを出さずに、ユーザーまたはシステム ODBC データ・ソース項目をすべて削除します。 -force オプションは、-allcopies オプションを指定する場合にのみ使用できます。 db2cli register -remove -allcopies -force コマンドは、Windows オペレーティング・システムで使用できます。

-dsn: Microsoft ODBC データソースアドミニストレーターから削除する DSN 名を指定します。 db2cli register -remove -dsn コマンドは、Windows オペレーティング・システムで使用できます。デフォルト・オプションは -user であり、ユーザー DSN が削除されます。システム DSN を削除する場合は、-system オプションを指定する必要があります。

-list

Microsoft ODBC データソースアドミニストレータに登録されているすべてのシステム・データ・ソースまたはユーザー IBM Data Server ODBC データ・ソースをリストします。

-copyname copy_name: Microsoft ODBC データ・ソース・アドミニストレーターで指定された Db2 コピーのユーザーまたはシステム ODBC データ・ソース項目をリストします。コピー名を指定しない場合、現行コピー名が使用されます。現行コピー名とは、db2cli ユーティリティーが属しているクライアントのコピー名です。 db2cli register -list -copyname コマンドは、Windows オペレーティング・システムで使用できます。

-allcopies: Microsoft ODBC データ・ソース・アドミニストレーターにあるすべての Db2 コピーのすべてのユーザーまたはシステム ODBC データ・ソース項目をリストします。 db2cli register -list -allcopies コマンドは、Windows オペレーティング・システムで使用できます。

-help

registerdsn パラメーターの使用法に関連したヘルプ情報を表示します。

注: 64 ビット Windows マシンで 32 ビット ODBC データ・ソース・エントリーを追加、削除、またはリストするには、 db2cli32 コマンドを使用します。

csc -info

接続スーパーバイザー・クライアント (CSC) 情報を表示します。 CSC は、エンドツーエンド・モニターの目的で CLI が使用する、動的にロード可能なライブラリーです。

-execsql

入力ファイルで指定した SQL ステートメントを実行または準備します。また、ファイルに出力を保存することもできます。

-execute

SQL スクリプト・ファイル内の SQL ステートメントを準備して実行するように指定します。パラメーターを指定しない場合は、これがデフォルトになります。結果がコンソールに表示されます。ファイルに出力を保存するには、ファイルの絶対パスか相対パスとともにオプション -output を指定します。 SQL スクリプト・ファイル内の SQL ステートメントに、パラメーター・マーカーを含めることはできません。

-prepareonly

-inputSql オプションで指定したファイル内の SQL ステートメントを準備するものの実行はしないように指定します。このオプションは、ステートメントを実行しないで SQL ステートメントの構文を検査する場合に使用します。

-commentstart comment_indicator

コメント行を表す、行の先頭に表示する文字の組み合わせを指定します。 comment_indicator のデフォルト値は 2 つのダッシュ (--) です。コメントが複数行にまたがる場合は、各行をcomment_indicator 文字の組み合わせで開始します。コメント行の最大長は 128 文字です。入力 SQL ファイルでは、コメント文字の後のテキストにステートメント・カーソルの属性を含めることができます。カーソル属性は、コメント直後の SQL ステートメントに適用されます。

-connstring string

ターゲット・データベースのデータベース名、サーバー、およびポート番号を指定します。情報は、 SQLDriverConnect API 関数の InConnectionString 引数で定義された形式で指定する必要があります。以下に例を示します。

DATABASE=SAMPLE;HOSTNAME=test.ibm.com;PORT=50000;UID=db2user;PWD=db2pwd

-dsn dsn_name

db2cli.ini ファイル内のデータ・ソース名、または db2dsdriver.cfg ファイルに定義されている dsn 別名を指定します。 dsn_name の中に空白文字がある場合は、空白文字を二重引用符で囲んでください。

-help

使用法情報の要約を表示します。

-inputsql sqlfile

SQL ステートメントが入っている入力ファイルを指定します。 sqlfile の値は、ファイルの絶対パスか相対パスになります。このファイル内の SQL ステートメントは、区切り文字で区切られます。準備可能なステートメントのみが使用されます。 Db2 コマンド ( DESCRIBE TABLE や BIND など) は許可されません。

入力 SQL ファイルに含めることができるのは、SQL ステートメントとコメントだけです。このファイルには、 CLI 固有の属性やキーワードを含めることはできません。バッチ SQL ステートメントには対応していません。

-outfile outputfile

出力結果を格納するファイルの絶対パスまたは相対パスを指定します。このオプションを指定しない場合、結果はコンソールに表示されます。

-passwd password

データベースで認証を行うために使用するパスワードを指定します。

-statementdelimiter delimiter

ステートメントを分離するために使用する、入力 SQL ファイルで用いる文字の組み合わせを指定します。区切り文字のデフォルト値は、復帰文字です。

-user username

データベースで認証を行うユーザーを指定します。

install

Windows レジストリーで IBM Data Server Driver for ODBC and CLI を登録または登録抹消します。

-setup: Windows レジストリーの ODBC の下に IBM Data Server Driver for ODBC and CLI を登録します。このパラメーターにより、デフォルトのアプリケーション・データ・パスに構成フォルダー (cfg、cfgcache、db2dump) とサンプル構成ファイルも作成されます。

-appdatapath <path name>: パス名に、構成フォルダー (cfg、cfgcache、db2dump) とサンプル構成ファイルを作成します。

-cleanup

現行の IBM Data Server Driver for ODBC and CLI を ODBCの下の Windows レジストリーから登録抹消します。その後、このクリーンアップは、現行のインストール環境のアプリケーション・データ・パスに作成されたフォルダー、構成サンプル・ファイル、ライセンス管理ファイルを削除します。 –force オプションを指定しない限り、ユーザー作成のファイルやフォルダーは削除されません。

-force: –cleanupオプションで指定すると、インストール固有のフォルダー全体がアプリケーション・データ・パスから削除されます。このフォルダーは、このインストールだけに属するフォルダーです。このフォルダー内にユーザー作成のファイルやフォルダーがある場合、プロンプトも警告も表示されずに削除されます。

-help: install パラメーターの使用法に関連したヘルプ情報を表示します。

writecfg add|remove

db2dsdriver.cfg 構成ファイルを更新します。

add -dsn | -database | -parameter[s]

DSN、データベース、パラメーターに関する情報をdb2dsdriver.cfg構成ファイルに追加します。

-dsn dsn_name [-description dsn_description] -database db_name -host host_name -port port_number

DSN 別名をオプションの description 値と一緒に指定します。構成ファイルのDSN 別名のパラメーター・エレメント、セッション・グローバル変数パラメーター・エレメント、または -dsn サブセクション全体を追加または更新できます。 dsn_name の中に空白文字がある場合は、空白文字を二重引用符で囲んでください。 -descriptionDsn_ 説明の場合、-dsn SNMP名オプションは必須です。

DSNエイリアスとしてdsn_nameを持つ-dsnサブセクションが構成ファイルにない場合、dsncollectionセクションに新しい-dsnサブセクションが追加されます。

DSNエイリアスとしてdsn_nameを持つ-dsnサブセクションが構成ファイルに存在する場合、新しいパラメーターまたはセッションのグローバル変数情報が既存の-dsnサブセクションに追加されます。

同じdb_name 情報を持つ-database サブセクションが db2dsdriver.cfg 構成ファイルに存在する場合、指定パラメーター・エレメントが -database サブセクションに追加されます。それ以外の場合は、指定パラメーター・エレメントまたはセッション・グローバル変数パラメーター・エレメントが新しい -database サブセクションに追加されます。

-parameter[s] par1=par1_val[;...;parN=parN_val]

db2dsdriver.cfg構成ファイルの指定-dsnサブセクションのパラメーター・エレメントを追加または更新するためのパラメーター情報を指定します。

db2dsdriver.cfg 構成ファイルの-dsn サブセクションにない新規パラメーター要素を指定すると、新規パラメーター要素が-dsn サブセクションに追加されます。

指定パラメーター要素が構成ファイルにすでに存在する場合、<dsn>サブセクションの既存のパラメーター値は、-parameter[s]オプションの指定値で更新されます。

値のパス分離文字などの特殊文字の前には、エスケープ文字 \を付けなければなりません。

db2cli writecfg コマンドは、構文検査も、指定のパラメーターの値の妥当性検査も行いません。

-sessionglobalvariables globvar_name=globvar_value[;...;globvar_nameN=globvarN_value]

セッション・グローバル変数情報を指定して、 db2dsdriver.cfg 構成ファイルの指定DSN のパラメーター要素を追加または更新します。

db2dsdriver.cfg構成ファイルの-dsnサブセクションにない新規セッション・グローバル変数パラメーターを指定すると、新規セッション・グローバル変数パラメーター要素が-dsn サブセクションに追加されます。

指定セッション・グローバル変数パラメーター要素が構成ファイルに既に存在する場合、-dsn サブセクションのセッション・グローバル変数値は、-sessionglobalvariables オプションで指定値で更新されます。

値のパス分離文字などの特殊文字の前には、エスケープ文字 \を付けなければなりません。

db2cli writecfg コマンドは、構文検査も、指定されたセッション・グローバル変数パラメーターの値の妥当性検査も行いません。

-specialregisters register_name=register_value[;...;register_nameN=registerN_value]

db2dsdriver.cfg構成ファイルの指定DSN のパラメーター要素を追加、更新するために使われる特殊レジスター情報を指定します。

db2dsdriver.cfg構成ファイルの<dsn>サブセクションにない特殊レジスター・パラメーターを指定すると、新しい特殊レジスター・パラメーター要素がそのサブセクションに追加されます。指定特殊レジスター・パラメーター要素が既に構成ファイルにある場合、-dsn サブセクションの特殊レジスター値は、-specialregisters パラメーターの指定値で更新されます。

特殊レジスター値（registerN_value）の特殊文字の前には、エスケープ文字\を付けなければなりません。

db2cli writecfg コマンドは、構文の検証も、指定された特殊レジスター・パラメーターの値の検証も行いません。

-database db_name -host host_name -port port_number

<database>サブセクションの接続情報を指定します。この情報は、データベース名、データベースがあるホストの名前、およびデータベース・サーバーのポート番号で構成されます。

同じdb_name情報を持つ<database>サブセクションが構db2dsdriver.cfg成ファイルに存在する場合、指定パラメーター要素が<database>サブセクションに追加されます。それ以外の場合は、指定パラメーター要素またはセッショングローバル変数パラメーター要素が新しい<database>サブセクションに追加されます。

-parameter[s] parameter_name1=par1_val[;...;parN=parN_val]

db2dsdriver.cfg 構成ファイルの指定データベース名のパラメーター・エレメントを追加または更新するためのパラメーター情報を指定します。

db2dsdriver.cfg構成ファイルの<database>サブセクションにない新しいパラメーター要素を指定すると、新しいパラメーター要素が<database>サブセクションに追加されます。

指定パラメーター要素が構成ファイルにすでに存在する場合、<database>サブセクションの既存のパラメーター値は、-parameter[s]オプションの指定値で更新されます。

値のパス分離文字などの特殊文字の前には、エスケープ文字 \を付けなければなりません。

db2cli writecfg コマンドは、構文検査も、指定のパラメーターの値の妥当性検査も行いません。

-sessionglobalvariables globvar_string

globvar_string の形式は次のとおりです。

globvar_name=globvar_value[;...;globvar_nameN=globvarN_value]

db2dsdriver.cfg構成ファイルで指定されたデータベース名のパラメーター要素を追加または更新するためのセッショングローバル変数情報を指定します。

db2dsdriver.cfg構成ファイルの<database>サブセクションにない新しいセッショングローバル変数パラメーターを指定すると、新しいセッショングローバル変数パラメーター要素が<database>サブセクションに追加されます。

指定セッショングローバル変数パラメーター要素が構成ファイルにすでに存在する場合、<database>サブセクションのセッショングローバル変数値は、-sessionglobalvariablesオプションの指定値で更新されます。

値のパス分離文字などの特殊文字の前には、エスケープ文字 \を付けなければなりません。

db2cli writecfg コマンドは、構文検査も、指定されたセッション・グローバル変数パラメーターの値の妥当性検査も行いません。

-specialregisters register_name=register_value[;...;register_nameN=registerN_value]

db2dsdriver.cfg構成ファイル指定データベース名のパラメーター要素を追加または更新するために使用される特殊レジスター情報を指定します。

db2dsdriver.cfg構成ファイルの<database>サブセクションにない特殊レジスター・パラメーターを指定すると、特殊レジスター・パラメーター要素がそのサブセクションに追加されます。指定された特殊レジスターのパラメーター要素がすでに構成ファイルにある場合、<database>サブセクションの特殊レジスターの値は、-specialregistersパラメーターに指定した値で更新されます。

特殊レジスター値（registerN_value）の特殊文字の前には、エスケープ文字\を付けなければなりません。

db2cli writecfg コマンドは、構文の検証も、指定された特殊レジスター・パラメーターの値の検証も行いません。

-parameter[s] parameter_name1=par1_val[;...;parN=parN_val]

db2dsdriver.cfg構成ファイルのすべてのデータベースとDSNのパラメーター要素を追加または更新するためのパラメーター情報を指定します。

グローバル<parameters>セクションにパラメータを追加するには、データベースまたはデータソースを示さずにパラメータ情報を指定してください。

db2dsdriver.cfg構成ファイルの<parameters>サブセクションにない新しいパラメーター要素を指定すると、新しいパラメーター要素が<parameters>サブセクションに追加されます。

指定パラメーター要素が構成ファイルにすでに存在する場合、<parameters>サブセクションの既存のパラメーター値は、-parameter[s]オプションの指定値で更新されます。

値のパス分離文字などの特殊文字の前には、エスケープ文字 \を付けなければなりません。

db2cli writecfg コマンドは、構文検査も、指定のパラメーターの値の妥当性検査も行いません。

-sessionglobalvariables globvar_string

globvar_string の形式は次のとおりです。

globvar_name=globvar_value[;...;globvar_nameN=globvarN_value]

db2dsdriver.cfg 構成ファイルのすべてのデータベースまたは DSN のパラメーター要素を追加または更新するためのパラメーター情報を指定します。

db2dsdriver.cfg構成ファイルの<parameters>サブセクションにない新しいセッショングローバル変数パラメーターを指定すると、新しいセッショングローバル変数パラメーター要素が<parameters>サブセクションに追加されます。

指定セッショングローバル変数パラメーター要素が構成ファイルにすでに存在する場合、<parameters>サブセクションのセッショングローバル変数値は、-sessionglobalvariablesオプションの指定値で更新されます。

値のパス分離文字などの特殊文字の前には、エスケープ文字 \を付けなければなりません。

db2cli writecfg コマンドは、構文検査も、指定のパラメーターの値の妥当性検査も行いません。

-specialregisters register_string

register_string の形式は次のとおりです。

register_name=register_value[;...;register_nameN=registerN_value]

db2dsdriver.cfg 構成ファイルのすべてのデータベースのパラメーター要素を追加または更新するために使われる特殊レジスター情報を指定します。

db2dsdriver.cfg構成ファイルの<parameters>サブセクションにない特殊レジスター・パラメーターを指定すると、特殊レジスター・パラメーター要素が<parameters>サブセクションに追加されます。指定された特殊レジスターのパラメーター要素がすでに構成ファイルにある場合、<parameters>サブセクションの特殊レジスターの値は、-specialregistersパラメーターに指定した値で更新されます。

特殊レジスター値（registerN_value）の特殊文字の前には、エスケープ文字\を付けなければなりません。

db2cli writecfg コマンドは、構文の検証も、指定された特殊レジスター・パラメーターの値の検証も行いません。

remove -dsn| -database | -parameter[s]

DSN、データベース、パラメーターに関する情報をdb2dsdriver.cfg 構成ファイルから削除します。

-dsn dsn_name

パラメーター要素、セッショングローバル変数パラメーター要素、または構成ファイルの<dsn>サブセクション全体を削除するDSNを指定します。 dsn_name の中に空白文字がある場合は、空白文字を二重引用符で囲んでください。

パラメーター・エレメントまたはセッション・グローバル変数パラメーター・エレメントの情報を削除するには、対応する DSN とパラメーター、またはセッション・グローバル変数の情報を指定します。

データ・ソース・サブセクション全体を削除するには、パラメーターやセッション・グローバル変数の情報を指定せずに、DSN のみを指定します。

-parameter[s] parameter_name1[;...;parameter_nameN]: db2dsdriver.cfg構成ファイルで指定されたDSNから削除するパラメーター情報を指定します。
示されたパラメーターが構成ファイルの指定<dsn>サブセクションにない場合、アクションは実行されません。

-sessionglobalvariables globvar_name[;...;globvar_nameN]: db2dsdriver.cfg構成ファイルの指定DSN から削除するセッション・グローバル変数情報を指定します。
示されたセッショングローバル変数が構成ファイルの指定<dsn>サブセクションにない場合、アクションは実行されません。

-sessionglobalvariables -force: db2dsdriver.cfg構成ファイルの指定された<dsn>サブセクションからすべてのセッショングローバル変数情報を削除します。 <dsn> サブセクションにセッション・グローバル変数がない場合、アクションは実行されません。

-specialregisters register_name[;...;register_nameN]: db2dsdriver.cfg構成ファイルの指定された<dsn>サブセクションから削除する特殊レジスター情報を指定します。構成ファイルの指定の <dsn> サブセクションに、示された特殊レジスターがない場合、アクションは何も実行されません。

-specialregisters -force: db2dsdriver.cfg構成ファイルの指定<dsn>サブセクションからすべての特殊レジスター情報を削除します。 <dsn> サブセクションに特殊レジスターがない場合、アクションは実行されません。

-database db_name -host host_name -port port_number

パラメーター要素、セッショングローバル変数パラメーター要素、または構成ファイルの<database>サブセクション全体を削除するデータベース名を指定します。

パラメーター・エレメントまたはセッション・グローバル変数パラメーター・エレメントの情報を削除するには、対応するデータベース名およびパラメーターまたはセッション・グローバル変数の情報を指定します。

データベース・サブセクション全体を削除するには、パラメーターやセッション・グローバル変数の情報を指定せずに、データベース名のみを指定します。

-parameter[s] parameter_name1[;...;parameter_nameN]: db2dsdriver.cfg構成ファイルの指定データベース名から削除するパラメーター情報を指定します。
示されたパラメーターが構成ファイルの<database>サブセクションにない場合、アクションは実行されません。

-sessionglobalvariables globvar_name[;...;globvar_nameN]: db2dsdriver.cfg構成ファイルに指定されたデータベース名から削除するセッショングローバル変数情報を指定します。
示されたセッショングローバル変数が構成ファイルの<database>サブセクションに指定されない場合、アクションは実行されません。

-sessionglobalvariables -force: db2dsdriver.cfg構成ファイルの指定データベース名からすべてのセッション・グローバル変数情報を除去します。 <database> サブセクションにセッション・グローバル変数がない場合、アクションは実行されません。

-specialregisters register_name[;...;register_nameN]: db2dsdriver.cfg構成ファイルの指定データベース名から除去する特殊レジスター情報を指定します。構成ファイルの指定の <database> サブセクションに、示された特殊レジスターがない場合、アクションは何も実行されません。

-specialregisters -force: db2dsdriver.cfg構成ファイルの指定データベース名からすべての特殊レジスター情報を除去します。 <database> サブセクションに特殊レジスターがない場合、アクションは実行されません。

-parameter[s] parameter_name1[;...;parameter_nameN]

db2dsdriver.cfg構成ファイルの<parameters>セクションから削除するパラメーター情報を指定します。

示されたパラメーターが構成ファイルの<parameters>セクションにない場合、アクションは実行されません。

-sessionglobalvariables globvar_name[;...;globvar_nameN]

db2dsdriver.cfg構成ファイルの<parameters>セクションから削除されるセッショングローバル変数情報を指定します。

示された<parameters>セッショングローバル変数が構成ファイルのセクションにない場合、アクションは実行されません。

-sessionglobalvariables -force: db2dsdriver.cfg構成ファイルの<parameters>セクションからすべてのセッショングローバル変数情報を削除します。 <parameters> サブセクションにセッション・グローバル変数がない場合、アクションは実行されません。

-specialregisters register_name=register_value[;...;register_nameN=registerN_value]: db2dsdriver.cfg構成ファイルの<parameters>セクションから削除する特殊レジスター情報を指定します。指示した特殊レジスターが構成ファイルの <parameters> サブセクションにない場合、アクションは実行されません。

-specialregisters -force: db2dsdriver.cfg構成ファイルの<parameters>セクションからすべての特殊レジスター情報を削除します。 <parameters> サブセクションに特殊レジスターがない場合、アクションは実行されません。

-help

writecfg パラメーターの使用法に関連したヘルプ情報を表示します。

refreshldap

IBM データ・サーバー・ドライバー構成ファイル (db2dsdriver.cfg) 内のすべての構成情報を、Lightweight Directory Access Protocol (LDAP) サーバーで指定されている構成情報で更新および追加します。 db2cli refreshldap コマンドは、LDAP サーバーへの接続に使用する現行のユーザー ID に対して指定されている構成情報を取得します。 db2cli refreshldap コマンドを使用して作成された IBM データ・サーバー・ドライバー構成ファイル内のすべての DSN 項目には、 LDAP="1 " 属性が含まれています。

LDAP サーバー内のデータベースに対して定義されている認証タイプは、 IBM データ・サーバー・ドライバー構成ファイル内のその DSN 別名の <dsn> セクションに追加または更新されます。

LDAPサーバーのデータベースに定義されるProtocolパラメーターは、値がTCPIPでない場合にのみ、そのDSNエイリアスの<dsn>セクションに追加または更新されます。

以下の表に、 IBM データ・サーバー・ドライバー構成ファイルでサポートされる DCS パラメーターおよび同等のキーワードをリストします。ここに示された DCS パラメーターのみ、refreshldap オプションで追加または更新できます。

表 1. DCS パラメーターおよび同等の IBM データ・サーバー・ドライバー構成キーワード
DCS パラメーター	同等のキーワード
`マップ・ファイル`	SQLCODEMAP
INTERRUPT_ENABLED	InterruptProcessingMode
SYSPLEX	ConnectionLevelLoadBalancing
BIDI	BiDiCCSID

SYSPLEXパラメーターを除くすべてのサポートされているDCSパラメーターは、<dsn>セクションに追加または更新されます。 LDAP サーバーに存在する SYSPLEX パラメーターは、対応する <database> セクションに追加または更新されます。 refreshldap オプションを使用して IBM データ・サーバー・ドライバー構成ファイルを更新する場合、 db2cli.ini ファイルを構成しないことで、予期しない動作を回避できます。 db2cli.ini ファイル構成は、 IBM データ・サーバー・ドライバー構成ファイルより優先されます。

db2cli refreshldap コマンドは、 IBM データ・サーバー・ドライバー構成ファイルが存在しない場合は作成します。

db2cli refreshldap コマンドは、LDAP サーバーで指定されている CLI キーワードと同等のキーワードを使用して、 IBM データ・サーバー・ドライバー構成ファイルを更新します。 LDAP サーバー上で指定された CLI キーワードのうち、同等の IBM データ・サーバー・ドライバー構成キーワードを持たないものがあると、警告メッセージが出されます。 GWNODE オプションを使用して指定された LDAP サーバー上のゲートウェイ設定は、追加も更新もされず、警告メッセージが表示されます。 LDAP サーバーの代替サーバー設定は、追加も更新もされず、警告メッセージが表示されます。

LDAP サーバー項目から作成されていない ( LDAP="1 " 属性がない) IBM データ・サーバー・ドライバー構成ファイル内の既存の DSN 項目と一致する DSN 項目が LDAP サーバー上にある場合、警告が返され、DSN 項目は更新されません。

同じデータベースに対して、別名が異なる複数の DSN エントリーが IBM データ・サーバー・ドライバー構成ファイルに存在する場合、LDAP サーバー上の DSN エントリーが削除されると、LDAP サーバー・エントリー ( LDAP="1 " 属性を持つ) から作成された DSN エントリーのみが削除されます。

db2cli refreshldap コマンドは、任意の IBM Db2 データ・サーバー製品および IBM Db2 データベース製品を使用して発行できます。

db2cli refreshldap コマンドは、 IBM Data Server Client、 IBM Data Server Runtime Client または IBM データベース・サーバー製品から発行できる REFRESH LDAP IMMEDIATE ALL コマンドに似ています。

-global: LDAP サーバー上のすべてのユーザー ID に指定されたグローバル構成情報を使用して、 IBM データ・サーバー・ドライバー構成ファイル内のすべての構成情報を更新および追加します。

-help

db2cli コマンドのヘルプ情報を表示します。

使用上の注意

対話式 CLI インターフェースは、 CLI 関数呼び出しの設計、プロトタイプ化、およびテストに使用できる一連のコマンドで構成されています。これは、使用を希望するプログラマーの便宜のために提供されているテスト・ツールであり、 IBM はそのパフォーマンスを保証しません。このインターフェースは、ユーザーを対象にしてはいないので、広範囲にわたるエラー・チェック機能はありません。

以下の 3 タイプのコマンドがサポートされています。

CLI commands: CLIによってサポートされている各関数呼び出しに対応する (および同じ名前の) コマンド。
Support commands: 同等の CLI 関数を持たないコマンド。
Additional modes: db2cli コマンドの追加モードを使用して、 CLI 環境構成を検証およびテストできます。

コマンドは対話式に発行することも、またはファイル内から発行することもできます。同様に、コマンドの出力は、端末に表示することもファイルに書き込むこともできます。 IBM Data Server Driver for ODBC and CLI の便利な機能は、セッション中に入力されたすべてのコマンドを取り込み、それらをファイルに書き込む機能です。これにより、後で再実行できるコマンド・スクリプトが作成されます。

Windows 64 ビット・オペレーティング・システム上の IBM Data Server クライアント・パッケージの場合、 db2cli コマンドの 64 ビット・バージョンに加えて、32 ビット・バージョンの db2cli (db2cli32.exe) がサポートされます。

SQL ステートメントは、SQLExecDirect() 関数を使用して実行されます。 SQL ステートメントの実行時に、db2cli execsql コマンドでは、db2cli.ini ファイルと db2dsdriver.cfg ファイルで指定されたデータベース設定値が使用されます。

db2cli コマンドによって戻されるエラー・メッセージは、SQLGetDiagRec() 関数と同じフォーマットでフォーマット設定されます。

コマンド行 ODBC の登録: Windows で DSN を構成および登録するには、以下のようにします。

サーバー・ノードのカタログを作成します。詳しくは、『CLP によるクライアントからの TCP/IP ノードのカタログ』を参照してください。
接続先のデータベースのカタログを作成します。詳しくは、『CLP を使用したクライアントからのデータベースのカタログ作成』を参照してください。
(オプション) データベース接続サービス (DCS) ディレクトリーのカタログを作成します。詳しくは、『CATALOG DCS DATABASE コマンド』を参照してください。
db2cli 対話式ツールを使って DSN を登録します。
- 32 ビットの ODBC DSN の場合、db2cli32 コマンドを使用します。
- 64 ビットの ODBC DSN の場合、db2cli コマンドを使用します。

64 ビットのインストール済み環境では、DSN の登録に db2cli と db2cli32 の両方のバージョンを使用できます。 db2cli コマンドは 64 ビットの DSN を登録し、db2cli32 コマンドは 32 ビットの DSN を登録します。

32 ビットのインストール済み環境では、db2cli コマンドは、デフォルトで 32 ビットの DSN のみを登録します。

登録DSN は、db2cli.iniファイルまたはdb2dsdriver.cfgファイル内になければなりません。

例

db2cli validate

以下の例では、ユーティリティーは、db2cli.iniファイルの[COMMON]セクション、db2cli.iniファイルのsampleDSN 名の[DSN] セクションおよびdb2dsdriver.cfgファイルのsampleDSN 名の<dsn>要素を読み取ります。有効なキーワードと無効なキーワードの両方が表示されます。無効なキーワードは、UNKNOWN としてリストされます。

db2cli validate -dsn sample

以下の例は、 -connstring オプションを使用する場合のコマンド構文を示しています。

db2cli validate -connstring “dsn=sample”

次の例では、ユーティリティーは、db2dsdriver.cfgファイルのdb2cli.iniファイルの[COMMON] セクション、データベース dbname1、サーバーserver1.net1.comおよびポート50001の<database>セクションを読み取ります。有効なキーワードと無効なキーワードの両方が表示されます。無効なキーワードは、UNKNOWN としてリストされます。

db2cli validate -database dbname1:server1.net1.com:50001

以下の例は、 -connstring オプションを使用する場合のコマンド構文を示しています。

db2cli validate -connstring “database=dbname1;hostname=server1.net1.com;port=50001;”

次の例では、データ・ソース名を指定してユーティリティーを使用しています。データ・ソース名に二重引用符 ("") が付けられています。

db2cli validate -dsn "IBM - User Acceptance" 
   -connect -user <userid> -passwd <password>

db2cli writecfg

このセクションで説明する例では、db2dsdriver.cfgファイルに以下の内容が含まれることを前提としています。

<configuration>
  <dsncollection>
   <dsn alias="alias1" name="name1" host="server1.net1.com" port="50001"> 
    <parameter name="DisableAutoCommit" value="TRUE"/>
   </dsn>
  </dsncollection>
  <databases>
   <database name="name1" host="server1.net1.com" port="50001">
    <parameter name="CurrentSchema" value="OWNER1"/>
   </database> 
  </databases>
  <parameters>
     <parameter name="IsolationLevel" value="SQL_TXN_READ_COMMITTED"/>
  </parameters>
</configuration>

以下の例では、新しいデータ・ソース・エレメントをdb2dsdriver.cfg構成ファイルに追加します。

db2cli writecfg add –dsn alias2 –database name2 -host server1.net1.com -port 50001

このコマンドの結果、dsncollection セクションは以下のように変更されます。

<dsncollection>
 <dsn alias="alias1" name="name1" host="server1.net1.com" port="50001"> 
  <parameter name="DisableAutoCommit" value="TRUE"/>
 </dsn>
 <dsn alias="alias2" name="name2" host="server1.net1.com" port="50001"/>
</dsncollection>

以下の例では、説明付きの新規データ・ソース要素をdb2dsdriver.cfg構成ファイルに追加します。

db2cli writecfg add –dsn alias3 -description alias3description –database name3 -host server1.net1.com -port 50001

このコマンドの結果、dsncollection セクションは以下のように変更されます。

<dsncollection>
<dsn alias="alias1" name="name1" host="server1.net1.com" port="50001">
  <parameter name="DisableAutoCommit" value="TRUE"/>
</dsn>
<dsn alias="alias2" name="name2" host="server1.net1.com" port="50001"/>
<dsn alias="alias3" description="alias3description" name="name3" host="server1.net1.com" port="50001"/>
</dsncollection>

以下の例では、構成ファイル内の dsn エレメントが削除されます。

db2cli writecfg remove –dsn alias3

このコマンドの結果、dsncollection セクションは以下のように変更されます。

<dsncollection>
<dsn alias="alias1" name="name1" host="server1.net1.com" port="50001">
  <parameter name="DisableAutoCommit" value="TRUE"/>
</dsn>
<dsn alias="alias2" name="name2" host="server1.net1.com" port="50001"/>
</dsncollection>

以下の例では、構成ファイル内の既存のデータ・ソースにパラメーター情報が追加されます。

db2cli writecfg add –dsn alias2 –parameters “DisableAutoCommit=FALSE;CurrentSchema=OWNER2;pureQueryXml=C:\\clico”

このコマンドの結果、dsncollection セクションは以下のように変更されます。

<dsncollection>
 <dsn alias="alias1" name="name1" host="server1.net1.com" port="50001"> 
  <parameter name="DisableAutoCommit" value="TRUE"/>
 </dsn>
 <dsn alias="alias2" name="name2" host="server1.net1.com" port="50001">
  <parameter name="DisableAutoCommit" value="FALSE"/>
  <parameter name="CurrentSchema" value="OWNER2"/>
..<parameter name="pureQueryXml" value="C:\clico"/>
 </dsn>
</dsncollection>

以下の例では、構成ファイル内のパラメーターに新しいデータベース・エレメントが追加されます。

db2cli writecfg add –database name2 –host server1.net1.com -port 50001  -parameters “LockTimeout=20;KeepAliveTimeout=20000”

このコマンドの結果、databases セクションは以下のように変更されます。

<databases>
 <database name="name1" host="server1.net1.com" port="50001">
  <parameter name="CurrentSchema" value="OWNER1"/>
 </database> 
 <database name="name2" host="server1.net1.com" port="50001">
  parameter name=" LockTimeout" value="20"/>
  parameter name="KeepAliveTimeout" value="20000"/>
 </database> 
</databases>

以下の例では、構成ファイル内の既存の dsn エレメントの既存のパラメーターが変更されます。

db2cli writecfg add –dsn alias1 –parameter “DisableAutoCommit=FALSE”

このコマンドの結果、dsncollection セクションは以下のように変更されます。

<dsncollection>
 <dsn alias="alias1" name="name1" host="server1.net1.com" port="50001"> 
  <parameter name="DisableAutoCommit" value="FALSE"/>
 </dsn>
 <dsn alias="alias2" name="name2" host="server1.net1.com" port="50001">
  <parameter name="DisableAutoCommit" value="FALSE"/>
  <parameter name="CurrentSchema" value="OWNER2"/>
..<parameter name="pureQueryXml" value="C:\clico"/>
 </dsn>
</dsncollection>

以下の例では、構成ファイル内のグローバル・セクションにパラメーター・エレメントが追加されます。

db2cli writecfg add -parameter "ReceiveTimeout=20000"

このコマンドの結果、グローバル・セクションが以下のように変更されます。

<parameters>
 <parameter name="IsolationLevel" value=" SQL_TXN_READ_COMMITTED"/>
 <parameter name="ReceiveTimeout" value="20000"/> 
</parameters>

以下の例では、構成ファイル内のデータベースからパラメーター・エレメントが削除されます。

db2cli writecfg remove –database name1 -host server1.net1.com -port 50001 –parameter “CurrentSchema”

このコマンドの結果、databases セクションは以下のように変更されます。

<databases>
 <database name="name1" host="server1.net1.com" port="50001">
 </database>
 <database name="name2" host="server1.net1.com" port="50001">
  parameter name="LockTimeout" value="20"/>
  parameter name="KeepAliveTimeout" value="20000"/>
 </database>
 </databases>

以下の例では、構成ファイル内の dsn エレメントが削除されます。

db2cli writecfg remove –dsn alias1

このコマンドの結果、dsncollection セクションは以下のように変更されます。

<dsncollection>
 <dsn alias="alias2" name="name2" host="server1.net1.com" port="50001">
  <parameter name="DisableAutoCommit" value="FALSE"/>
  <parameter name="CurrentSchema" value="OWNER2"/>
  <parameter name="pureQueryXml" value="C:\clico"/>
 </dsn>
</dsncollection>

db2cli execsql

以下の例では、SAMPLE データベースに以下の表およびプロシージャーが作成されているとします。

create table employee(empid integer, empname varchar(100)

  CREATE PROCEDURE proc1 (  ) 
  DYNAMIC RESULT SETS 1 P1: 
  BEGIN
    DECLARE cursor1 CURSOR WITH RETURN FOR  SELECT * FROM fprem;  
    OPEN cursor1;
  END P1

  CREATE PROCEDURE PROC2(IN ID1 INTEGER,OUT NAME VARCHAR(20)) 
  BEGIN 
  DECLARE CUR1 CURSOR WITH RETURN TO CALLER FOR SELECT * FROM EMPLOYEE1 WHERE ID=ID1; 
    OPEN CUR1; 
  END

また、この例では、SQL ファイル test.sql に以下のテキストが含まれているとします。

--Populate table( employee )
insert into employee(empid, empname) values(1, 'Adam')
insert into employee(empid, empname) values(2, 'Atul')
select empid, empname  from employee

--Execute the stored procedure
Call proc1( )

コンソール・ウィンドウに以下の db2cli コマンドを入力して、ファイル内の SQL ステートメントを実行します。

db2cli execsql –dsn sample –inputsql test.sql

以下のテキストが、コンソール・ウィンドウに表示されます。

IBM DATABASE 2 Interactive CLI Sample Program
(C) COPYRIGHT International Business Machines Corp. 1993,1996
All Rights Reserved
Licensed Materials - Property of IBM
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

insert into employee(empid, empname) values(1, 'Adam')
The SQL command completed successfully.

insert into employee(empid, empname) values(2, 'Atul')
The SQL command completed successfully.

select empid, empname  from employee

EMPID EMPNAME
1, Adam
2, Atul

Call proc1()

EMPID EMPNAME
1, Adam
2, Atul

OUT 引数を持つストアード・プロシージャーの CALL ステートメントを実行します。疑問符 (?) を OUT パラメーターとして使用することができます。

以下の例では、 SQL スクリプト・ファイル test2.sql に以下のテキストが含まれているとします。

CALL PROC2( 1, ?)

コンソール・ウィンドウに以下の db2cli コマンドを入力して、ファイル内の SQL ステートメントを実行します。

db2cli execsql –dsn sample –inputsql test2.sql

以下のテキストが、コンソール・ウィンドウに表示されます。

Value of output parameters
--------------------------
Parameter Name  : NAME
Parameter Value : -

ID
-----------
    1

-prepareonly オプションを指定して、 SQL ステートメントを実行せずに準備します。 SQL ステートメントに必要な DDL ステートメントは、 -prepareonly オプションを指定して db2cli execsql コマンドを実行する前に実行する必要があります。

以下の例では、 SQL ファイル test3.sql に以下のテキストが含まれているとします。

--populate table( employee )
insert into employee(empid, empname) values(1, 'Adam');
insert into employee(empid, empname) values(2, 'Atul');
select empid, empname  from employee;

また、表 EMPLOYEE がデータベースに作成されているとします。コンソール・ウィンドウに以下の db2cli コマンドを入力して、ファイル内の SQL ステートメントを準備します。

db2cli execsql –prepareonly –dsn sample –inputsql test3.sql

以下のテキストが、コンソール・ウィンドウに表示されます。

IBM DATABASE 2 Interactive CLI Sample Program
(C) COPYRIGHT International Business Machines Corp. 1993,1996
All Rights Reserved
Licensed Materials - Property of IBM
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

insert into employee(empid, empname) values(1, 'Adam')
The SQL command prepared successfully.

insert into employee(empid, empname) values(2, 'Atul')
The SQL command prepared successfully.

select empid, empname  from employee
The SQL command prepared successfully.
If you place DDL statements that are required for DML statements in
the same file, the DML statements that require the DDL statements 
fail. For example, assume that the following text is in the file 
test4.sql, and assume that and the EMPLOYEE table has not been 
created in the database:
--create and populate table( employee )
create table employee(empid integer, empname varchar(100));
insert into employee(empid, empname) values(1, 'Adam');
insert into employee(empid, empname) values(2, 'Atul');
select empid, empname  from employee;

-- try to create another table with the same name
create table employee(empid integer, empname varchar(100));

INSERT および SELECT ステートメントを正常に実行するには、事前に CREATE TABLE ステートメントを実行しておく必要があります。

コンソール・ウィンドウに以下の db2cli コマンドを入力して、ファイル内の SQL ステートメントを準備します。

db2cli execsql –prepareonly –dsn sample –inputsql test4.sql

以下のテキストが、コンソール・ウィンドウに表示されます。

IBM DATABASE 2 Interactive CLI Sample Program
(C) COPYRIGHT International Business Machines Corp. 1993,1996
All Rights Reserved
Licensed Materials - Property of IBM
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

create table employee(empid integer, empname varchar(100))
The SQL command prepared successfully.

insert into employee(empid, empname) values(1, 'Adam')
The SQL command failed. During SQL processing it returned:
[IBM][CLI Driver][DB2/6000] SQL0204N  "EMPLOYEE" is an undefined name.  SQLSTATE=42704

insert into employee(empid, empname) values(2, 'Atul')
The SQL command failed. During SQL processing it returned:
[IBM][CLI Driver][DB2/6000] SQL0204N  "EMPLOYEE" is an undefined name.  SQLSTATE=42704

select empid, empname  from employee
The SQL command failed. During SQL processing it returned:
[IBM][CLI Driver][DB2/6000] SQL0204N  "EMPLOYEE" is an undefined name.  SQLSTATE=42704

create table employee(empid integer, empname varchar(100))
The SQL command prepared successfully.

この例では、2 つの CREATE SQL ステートメントが正常に準備されましたが、 EMPLOYEE 表はデータベースに作成されませんでした。 EMPLOYEE 表がデータベースに存在しなかったため、 INSERT および SELECT ステートメントが正常に準備されませんでした。

db2cli bind

以下の例では、 db2cli.lstリスト・ファイルをバインドします。

$ db2cli bind @db2cli.lst –database “mydb:test.torolab.ibm.com:446” 
–options “BLOCKING unambig REOPT always ISOLATION RR”
LINE    MESSAGES FOR db2cli.lst
------  --------------------------------------------------------------
        SQL0061W  The binder is in progress.
        SQL0091N  Binding was ended with "0" errors and "0" warnings.

db2cli refreshldap

以下の db2dsdriver.cfg ファイルは、 db2cli refreshldap コマンドによって変更されます。

<configuration>
<dsncollection>
 <dsn alias="sample" name="sample" host="hotel53.ibm.com" port="40576” ldap="1">
  <parameter name="DisbaleAutoCommit" value="0"/>
  <parameter name="AllowDeferredPrepare" value="1"/> 
 </dsn>
 <dsn alias="EC205" name="STLEC1"  host="INEC005.ibm.com" port="446" ldap="1">
  <parameter name="InterruptProcessingMode" value="1"/>
 </dsn>
 <dsn alias="test1" name="test" host="xyz.ibm.com" port="446" ldap="1">
  <parameter name="QueryTimeoutInterval" value="15"/>
  <parameter name="Authentication" value="SERVER"/>
 </dsn>
</dsncollection>
 <databases>
  <database name="sample" host="hotel53.ibm.com" port="40576"/>
  <database name="STLEC1" host="INEC006.ibm.com" port="446">
   <parameter name="ConnectionLevelLoadBalancing" value="1"/>
  </database>
  <database name="test" host="xyz.ibm.com" port="446"/>
 </databases>
</configuration>