ODBC RM スイッチ モジュールの汎用 1 フェーズ コミット

ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットのビルドに必要な情報について説明します。

Windows 環境

ソース コード
ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESODBCXA.CBL は、デフォルトでは、%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリに配置されています。
注: If you prefer to supply user credentials programatically rather than in the xa_open string, instructions for doing so are provided in the COBOL source file in the Customization section.
ビルド要件
ODBC RM スイッチ モジュールをビルドするには、使用している Windows のバージョン用の Windows ソフトウェア開発キット (SDK) がインストールされている必要があります。

このスイッチ モジュールをビルドする前に、Windows SDK LIB ディレクトリのサブディレクトリにある odbc32.lib ファイルのパスが LIB 環境変数に含まれていることを確認してください。

いくつかの OpenESQL 指令はプロセス ベースであり、通常はデータベース接続を行うプログラムのコード内で設定する必要があります。

サービスをコンテナー管理アプリケーションとしてディプロイされた Enterprise Server で実行する場合は、プログラム ソースのコンパイル時ではなく RM スイッチ モジュールのコンパイル時に、適切な指令を指定する必要があります。詳細については、「範囲 - OpenESQL SQL コンパイラ指令オプション」のトピックで、プロセス ベースの OpenESQL 指令の一覧を参照してください。

スイッチ モジュールのビルド
方法 1
  1. 管理者として、アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer command promptを起動します。
  2. %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) に移動します。
  3. 次のように入力します。 build odbc [directives]
方法 2
  1. アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer command promptを起動します。
  2. %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE 権限がある任意の場所にコピーします。
  3. コピーしたファイルが含まれているディレクトリに移動します。
  4. 次のように入力します。 build odbc [directives]
ビルド出力
ビルド プロセスによって、ESODBCXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 2 つの RM スイッチ モジュール ファイルが生成されます。
ファイル タイプ
ESODBCXA.DLL 静的
ESODBCXA_D.DLL 動的

You can register an RM switch module with Enterprise Server dynamically, or register it statically depending on which binary file you use. We recommend that you use the dynamic switch module option, as this ensures that only active databases used in the global transaction participate in the TM/RM XA flow.

UNIX 環境

ソース コード
ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESODBCXA.CBL は、デフォルトでは、$COBDIR/src/enterpriseserver/xa ディレクトリにあります。
注: If you prefer to supply user credentials programatically rather than in the xa_open string, instructions for doing so are provided in the COBOL source file in the Customization section.
ビルド要件
ビルド スクリプトでは、現在の有効な作業モードを使用して、スイッチ モジュールのビルド方法が決定されます。ビルド スクリプトを呼び出す前に、データベース環境が正しく設定されていることを確認してください。詳細については、データベース ベンダーのドキュメントを参照してください。
スイッチ モジュールのビルド
$COBDIR/src/enterpriseserver/xa ディレクトリには、スイッチ モジュールのビルドに使用できる build スクリプト ファイルが含まれています。
  1. $COBDIR/src/enterpriseserver/xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE 権限がある任意の場所にコピーします。
  2. コピーしたファイルが含まれているディレクトリに移動します。
  3. 次のように入力します。 build odbc
ビルド出力
ビルド プロセスによって、ESODBCXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 4 つの RM スイッチ モジュール ファイルが生成されます。
ESODBCXA.so 32 ビット 静的
ESODBCXA64.so 64 ビット 静的
ESODBCXA_D.so 32 ビット 動的
ESODBCXA64_D.so 64 ビット 動的

You can register an RM switch module with Enterprise Server dynamically, or register it statically depending on which binary file you use. We recommend that you use the dynamic switch module option, as this ensures that only active databases used in the global transaction participate in the TM/RM XA flow.

すべての環境

制限事項
ODBC モジュールでは 1 フェーズ コミットしかサポートされないため、次の SQL 操作は、次のようなディプロイされたコンテナー管理サービスのソースではサポートされません。
  • CONNECT
  • DISCONNECT
  • BEGIN TRANSACTION
  • COMMIT
  • ROLLBACK
追加リソース
xa_open 文字列の定義を含む、ODBC RM スイッチ モジュールの使い方の詳細については、「ODBC xa_open 文字列の汎用 1 フェーズ コミット」を参照してください。