1 つ以上のデータ・ソースに接続する方法

Db2® は、DRDA によるリモート・データ・ソースへの別の接続タイプをサポートします。

アプリケーションが CONNECT (タイプ 1) であり、かつ MULTICONTEXT=0 を 指定している場合は、Db2 ODBC を使ってそのアプリケーションは論理的に 複数の データ・ソースへ接続することができます。ただし、Db2 ODBC は、アクティブ接続でのアプリケーションでは、 未解決トランザクション (アプリケーションがまだコミットしていない、またはロールバック していないトランザクション) は 1 つしか認めていません。 アプリケーションが CONNECT (タイプ 2) の場合、トランザクションは分散作業単位となり、 すべてのデータ・ソースは、トランザクションの処理 (コミットまたはロールバック) に関与します。

1 つ以上のデータ・ソースに同時に接続するためには、各接続ごと に 1 回、SQLAllocHandle() (HandleType を SQL_HANDLE_DBC に設定) を呼び出します。このステートメントが SQLConnect() 呼び出しで引き渡す接続ハンドルを使用して、 データ・ソース接続を要求します。SQLAllocHandle() 呼び出し (HandleType を SQL_HANDLE_STMT に設定) で、 同じ接続ハンドルを使用してステートメント・ハンドルを割り振り、その接続内で使用します。拡張接続関数 SQLDriverConnect() によって、追加の接続属性を設定することができます。しかし異なる接続で実行するステートメントは調整を行いません。

例: 以下の例 は、接続し、 ハンドルを割り振り、ハンドルを解放し、切断するアプリケーションを示しています。このアプリケーションは、複数のデータ・ソースに接続しますが、明示的に接続タイプを 設定したり、複数コンテキスト・サポートを指定することはありません。 初期化ファイルの CONNECTTYPE および MULTICONTEXT キーワードが、これらの設定を宣言します。

図 1. 2 つのデータ・ソースに接続するアプリケーション
/* ... */
/*******************************************************
**    - Demonstrate basic connection to two data sources.
**    - Error handling mostly ignored for simplicity
**
**  Functions used:
**
**    SQLAllocHandle   SQLDisconnect
**    SQLConnect       SQLFreeHandle
**  Local Functions:
**    DBconnect
**
********************************************************/
#include <stdio.h>
#include <stdlib.h>
#include "sqlcli1.h"
int
DBconnect(SQLHENV henv,
          SQLHDBC * hdbc,
          char    * server);
#define MAX_UID_LENGTH    18
#define MAX_PWD_LENGTH    30
#define MAX_CONNECTIONS   2
int
main( )
{
    SQLHENV         henv;
    SQLHDBC         hdbc[MAX_CONNECTIONS];
    char *          svr[MAX_CONNECTIONS] =
                    {
                      "KARACHI"   ,
                      "DAMASCUS"
                    }
    /* Allocate an environment handle   */
    SQLAllocHandle( SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
    /* Connect to first data source */
    DBconnect(henv, &hdbc[0],
              svr[0]);
    /* Connect to second data source */
    DBconnect(henv, &hdbc[1],
              svr[1]);
    /*********   Start processing step  *************************/
    /* Allocate statement handle, execute statement, and so on  */
    /*********   End processing step  ***************************/
    /************************************************************/
    /* Commit work on connection 1.                             */
    /************************************************************/
    SQLEndTran(SQL_HANDLE_DBC, hdbc[0], SQL_COMMIT);
    /************************************************************/
    /* Commit work on connection 2. This has NO effect on the   */
    /* transaction active on connection 1.                      */
    /************************************************************/
    SQLEndTran(SQL_HANDLE_DBC, hdbc[1], SQL_COMMIT);
    printf("¥nDisconnecting .....¥n");
    SQLDisconnect(hdbc[0]);   /* disconnect first connection */ 
       SQLDisconnect(hdbc[1]);     /* disconnect second connection  */                                       
    SQLFreeHandle (SQL_HANDLE_DBC, hdbc[0]);    /* free first connection handle */
    SQLFreeHandle (SQL_HANDLE_DBC, hdbc[1]);    /* free second connection handle */
     SQLFreeHandle(SQL_HANDLE_ENV, henv);   /* free environment handle */
    return (SQL_SUCCESS);
}
/********************************************************************
**   Server is passed as a parameter. Note that NULL values are    **
**   passed for USERID and PASSWORD.                               **
********************************************************************/
int
DBconnect(SQLHENV henv,
          SQLHDBC * hdbc,
          char    * server)
{
    SQLRETURN       rc;
    SQLCHAR         buffer[255];
    SQLSMALLINT     outlen;
   
    SQLAllocHandle(SQL_HANDLE_DBC, henv, hdbc); /* allocate connection handle */
    rc = SQLConnect(*hdbc, server, SQL_NTS, NULL, SQL_NTS, NULL, SQL_NTS);
    if (rc != SQL_SUCCESS) {
        printf(">--- Error while connecting to database: 
        return (SQL_ERROR);
    } else {
        printf(">Connected to 
        return (SQL_SUCCESS);
    }
}
/* ... */