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

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

Windows 環境

ソース コード
ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESXDBXA.CBL は、デフォルトでは、%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリにあります。
制限事項
ODBC モジュールでは 1 フェーズ コミットしかサポートされないため、次の SQL 操作は、ディプロイされたコンテナー管理サービスのソースではサポートされません:
  • CONNECT
  • DISCONNECT
  • BEGIN TRANSACTION
  • COMMIT
  • ROLLBACK
ビルド要件
開発環境でスイッチ モジュールをビルドします。

いくつかの OpenESQL 指令はプロセス ベースであり、通常はデータベース接続を行うプログラムのコード内で設定する必要があります。コンテナー管理アプリケーションとしてディプロイされた Enterprise Server のもとでサービスを実行する場合は、プログラム ソースのコンパイル時ではなく RM スイッチ モジュールのコンパイル時にこれらの指令を指定する必要があります。

スイッチ モジュールをビルドする
方法 1
  1. 管理者として、アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer コマンド プロンプトを起動します。
  2. %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) に移動します。
  3. 次のように入力します。build odbc [directives]
方法 2
  1. アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer コマンド プロンプトを起動します。
  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 動的

RM スイッチ モジュールの登録は、Enterprise Server で動的に行うか、使用するバイナリ ファイルに応じて静的に行います。推奨される方法は、スイッチ モジュールの動的な登録です。これにより、グローバル トランザクションで使用されるアクティブなデータベースのみが TM/RM XA フローに参加するためです。

UNIX 環境

ソース コード
ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESODBCXA.CBL は、デフォルトでは、$COBDIR/src/enterpriseserver/xa ディレクトリにあります。
ビルド要件
ビルド スクリプトでは、現在の有効な作業モードを使用して、スイッチ モジュールのビルド方法が決定されます。build スクリプトを呼び出す前に、データベース環境が正しく設定されていることを確認してください。詳細は、データベース ベンダーのマニュアルを参照してください。
スイッチ モジュールをビルドする
$COBDIR/src/enterpriseserver/xa ディレクトリには、スイッチ モジュールのビルドに使用できる build バッチ ファイルが含まれています。
  1. $COBDIR/src/enterpriseserver/xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE パーミッションがある任意の場所にコピーします。
  2. コピーしたファイルが含まれているディレクトリに移動します。
  3. 次のように入力します。build odbc
ビルド出力
ビルド プロセスによって、ESODBCXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 4 つの RM スイッチ モジュール ファイルが生成されます。
ESODBCXA.so 32-bit 静的
ESODBCXA64.so 64-bit 静的
ESODBCXA_D.so 32-bit 動的
ESODBCXA64_D.so 64-bit 動的

RM スイッチ モジュールの登録は、Enterprise Server で動的に行うか、使用するバイナリ ファイルに応じて静的に行います。推奨される方法は、スイッチ モジュールの動的な登録です。これにより、グローバル トランザクションで使用されるアクティブなデータベースのみが TM/RM XA フローに参加するためです。

上位ヘルプ：RM スイッチ モジュールのビルド