外部コンテキスト

一般には、Db2® ODBC ドライバーは、ODBC アプリケーションのコンテキストを管理します。 外部コンテキストを用いると、Db2 ODBC の外側のコンテキストを管理するアプリケーションを 作成できます。複数コンテキストを言語処理環境のスレッドと組み合わせて使用する場合と同じ方法で、 外部コンテキストを言語処理環境のスレッドと組み合わせて使用します。

外部コンテキストを言語処理環境のスレッドと結合する場合は、 外部コンテキストと言語処理環境のスレッドの両方ともアプリケーション内で管理する 必要があります。

外部コンテキストを使用するアプリケーションを作成するには、初期化ファイルで 次の値を指定します。
  • MULTICONTEXT=0
  • MVSATTACHTYPE=RRSAF
アプリケーションで以下の API を呼び出して、Db2 ODBC ドライバーの 代わりに、Resource Recovery Service (RRS) を使用してコンテキストを管理します。
  • CRGGRM() -- アプリケーションをリソース・マネージャーとして登録します。
  • CRGSEIF() -- アプリケーションの出口ルーチンを設定します。
  • CTXBEGC() -- 専用外部コンテキストを作成します。
  • CTXSWCH() -- コンテキスト間ので切り替えます。
  • CTXENDC() -- 専用外部コンテキストを終了します。

アプリケーションが、単一コンテキストから同じデータ・ソースへ複数のアクティブ接続を 確立しようとすると、ODBC ドライバーは接続要求をリジェクトします。

それぞれの外部コンテキストごとに、異なる接続タイプを定義することはできません。 以下の指定によって、Db2 ODBC アプリケーションが作成した各外部コンテキストごとにすべての 接続タイプが設定されます。
  • 初期化ファイルの CONNECTTYPE キーワード
  • SQLSetEnvAttr() 関数および SQLSetConnectAttr() 関数における SQL_ATTR_CONNECTTYPE 属性

Db2 ODBC は、ストアード・プロシージャーとして実行しているアプリケーションでは、 外部コンテキストをサポートしていません。

以下の例は、ODBC 外部のコンテキストを管理する アプリケーションを示しています。このアプリケーションは、RRS API を使用してコンテキスト・マネージャーとして登録し、 出口ルーチンを設定し、外部コンテキストを作成し、さらにコンテキスト間で切り替えます。
図 1. 外部コンテキストを管理するアプリケーション
/* Register as an unauthorized resource manager  */ 
CRGGRM();
/* Set exit information                          */   
CRGSEIF();                                            
/* Get an environment handle (henv)              */   
SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
 /* Get a connection handle, hdbc1, and connect to 
   STLEC1 under the native context.              */   
SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc1);
SQLConnect( hdbc1, "STLEC1", ... );                   
/* Execute SQL under the native context at STLEC1*/
SQLAllocHandle(SQL_HANDLE_STMT, ...);
SQLExecDirect ...
       .
     .
/* Create a private context                      */  
CTXBEGC( ctxtoken1 );
/* Switch to private                             */
CTXSWCH( ctxtoken1 );
An application that manages external contexts
/* Get a connection handle, hdbc2, and connect 
   to STLEC1 under the private context.         */ 
SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc2);
SQLConnect( hdbc2, "STLEC1", ... );                  
/* Execute SQL under the private context at
   STLEC1                                         */  
SQLAllocHandle(SQL_HANDLE_STMT, ...);
SQLExecDirect ...
     .
     .                                                 
/* Commit changes on hdbc2                       */
SQLEndTran(SQL_HANDLE_DBC,  hdbc2, SQL_COMMIT);
/* Switch back to native                         */ 
CTXSWCH( 0 );                                         
/* Execute some more SQL under the native context 
    at STLEC1                                      */ 
SQLAllocHandle(SQL_HANDLE_STMT, ...);
SQLExecDirect ...
    .
    .                                                 
/* Rollback changes on hdbc1                     */
SQLEndTran(SQL_HANDLE_DBC, hdbc1, SQL_ROLLBACK);