Db2 ODBC の複数コンテキストのサポート
コンテキストとは、Db2® ODBC において Db2 のスレッドに相当するものです。コンテキストとは、アプリケーションがデータ・ソースに対して行う論理接続を記述する構造であり、 アプリケーションがデータ・ソースに対して操作を指図可能にする内部 Db2 ODBC 接続情報を記述する構造です。
複数コンテキストが使用可能な場合、接続ハンドルの割り振り時にコンテキストを設定します。 Db2 ODBC は、言語処理環境のスレッド上で作成する最初の接続ハンドルに対して コンテキストを常に作成します。複数コンテキストに対する Db2 ODBC サポートを使用できない場合は、これ らの SQLAllocHandle() 呼び出しが 1 つのコンテキストを設定するだけです。複数コンテキストのサポートが使用できる場合は、接続ハンドルを割り振るための SQLAllocHandle() が 出されるごとに、Db2 ODBC は別個のコンテキスト (および Db2 スレッド) を設定します。
Db2 ODBC の複数コンテキストのサポートを使用可能にしたり、明示的に 使用不可にするには、MULTICONTEXT キーワードを Db2 ODBC 初期化ファイルで使用します。
複数コンテキストを使用可能にする前では、作成する各言語処理環境のスレッド は単一コンテキストのみ使用可能です。 各言語処理環境のスレッドごとに 1 つだけのコンテキストを 用いて、ODBC 接続モデルのシミュレーション・サポートでのみ、アプリケーションが実行されます。 デフォルトでは、複数コンテキストは使用不可になっています。 複数コンテキストを使用不可にするには、初期化ファイルで MULTICONTEXT=0 を指定 します。
初期化ファイルで MULTICONTEXT=1 を指定している場合は、それぞれの接続ハンドルごとに 別個のコンテキストが設定されます。これは、SQLAllocHandle() を用いて設定します。 それぞれの接続ごとに 1 つのコンテキスト用いることによって、Db2 ODBC は、ODBC 接続モデル との整合性を維持して、ODBC 接続モデルの完全サポートを提供します。
複数コンテキストを使用する場合は、初期化ファイルで MVSATTACHTYPE=RRSAF を 指定する必要があります。
MULTICONTEXT=1 を指定することは、CONNECTTYPE=1 を暗黙指定することになります。 同時接続タイプは ODBC 接続モデルと暗黙的に整合性があり ます。SQLEndTran() は、コミットとロールバックの両方について、すべての接続を別々に扱い ます。
複数コンテキスト環境では、SQLAllocHandle() を用いてコンテキストを 設定し、SQLFreeHandle() を用いて (両方の関数で引数 HandleType を SQL_HANDLE_DBC に 設定) コンテキストを削除します。 同じ接続ハンドルを使用する SQLConnect() および SQLDisconnect() 操作はすべて、 同じコンテキストに属しています。単一コンテキスト内ではデータ・ソースに対するアクティブな接続は 1 つしか行えません が、SQLDisconnect() を呼び出してから SQLConnect() を呼び出して、ターゲット・データ・ソースを 変更することができます。 複数コンテキスト環境でデータ・ソースを変更する場合、この変更も CONNECTTYPE=1 の規則に 従う必要があります。
- Db2 ODBC アプリケーションが、Db2 ODBC を呼び出す前に Db2 スレッドを作成する場合。 この条件は、Db2 ODBC を使用するストアード・プロシージャーにはいずれも当てはまります。
- Db2 ODBC アプリケーションが、Db2 ODBC を呼び出す前に専用コンテキストを作成し、それに切り替える場合。例えば、z/OS 無許可コンテキスト・サービスを明示的に使用しており、 さらに Db2 ODBC を呼び出す前に ctxswch() を出してプライベート・コンテキストに切り替えるアプリケーションは、MULTICONTEXT=1 を利用できません。
- Db2 ODBC アプリケーションが、Db2 ODBC を呼び出す前に RRS リソース・マネージャーを用いて リカバリー単位を開始する場合。
- 初期化ファイルで MVSATTACHTYPE=CAF を指定する場合。
- オペレーティング・システム・レベルが、無許可コンテキスト・サービスをサポートしていない場合。
Db2 ODBC アプリケーションで MULTICONTEXT=1 がアクティブであるか判別する には、SQL_MULTIPLE_ACTIVE_TXN を設定した引数 InfoType を指定して、SQLGetInfo() を 呼び出します。
次の表は、MULTICONTEXT と CONNECTTYPE の いろいろな組み合わせによる接続特性を示しています。
| 設定: MULTICONTEXT | 設定: CONNECTTYPE | 結果: 言語処理環境のスレッドは、未処理の作業単位のある 複数の ODBC 接続を持つことができる | 結果: 言語処理環境のスレッドは、ODBC 接続を別個にコミットまたはロールバックできる | 結果: アプリケーションのために Db2 ODBC が 作成する Db2 の数 |
|---|---|---|---|---|
| 0 | 2 | 可 | 不可 | 言語処理環境のスレッド当たり 1 つ |
| 0 | 1 | 不可 | 可 | 言語処理環境のスレッド当たり 1 つ |
| 11 | 1 または 22 | 可 | 可 | ODBC 接続ハンドル当たり 1 つ |
| 注:
|
||||