ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットのビルドに必要な情報について説明します。
- ソース コード
- ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESXDBXA.CBL は、デフォルトでは、%ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa ディレクトリにあります。
- 制限事項
- ODBC モジュールでは 1 フェーズ コミットしかサポートされないため、次の SQL 操作は、デプロイされたコンテナー管理サービスのソースではサポートされません。
- CONNECT
- DISCONNECT
- BEGIN TRANSACTION
- COMMIT
- ROLLBACK
- ビルド要件
- ODBC RM スイッチ モジュールをビルドするには、使用している Windows のバージョン用の Windows ソフトウェア開発キット (SDK) がインストールされている必要があります。
このスイッチ モジュールをビルドする前に、LIB 環境変数に Windows SDK LIB ディレクトリのパスが含まれていることを確認してください。
いくつかの OpenESQL 指令はプロセス ベースであり、通常はデータベース接続を行うプログラムのコード内で設定する必要があります。
コンテナー管理アプリケーションとしてディプロイされた Enterprise Server のもとでサービスを実行する場合は、プログラム ソースのコンパイル時ではなく RM スイッチ モジュールのコンパイル時にアプリケーションの指令を指定する必要があります。詳細については、「範囲 - OpenESQL SQL コンパイラ指令オプション」のトピックで、プロセス ベースの OpenESQL 指令の一覧を参照してください。
- スイッチ モジュールをビルドする
-
- 方法 1
-
- 管理者として、アプリケーションに応じて 32 ビットまたは 64 ビットの Visual COBOL コマンド プロンプトを起動します。
- %ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) に移動します。
- 次のように入力します。build odbc [directives]
- 方法 2
-
- アプリケーションに応じて 32 ビットまたは 64 ビットの Visual COBOL コマンド プロンプトを起動します。
- %ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE パーミッションがある任意の場所にコピーします。
- コピーしたファイルが含まれているディレクトリに移動します。
- 次のように入力します。build odbc [directives]
- ビルド出力
- ビルド プロセスによって、ESODBCXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 2 つの RM スイッチ モジュール ファイルが生成されます。
| ファイル |
タイプ |
| ESODBCXA.DLL |
静的 |
| ESODBCXA_D.DLL |
動的 |
RM スイッチ モジュールの登録は、Enterprise Server で動的に行うか、使用するバイナリ ファイルに応じて静的に行います。推奨される方法は、スイッチ モジュールの動的な登録です。これにより、グローバル トランザクションで使用されるアクティブなデータベースのみが TM/RM XA フローに参加するためです。
- ソース コード
- ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESODBCXA.CBL は、デフォルトでは、$COBDIR/src/enterpriseserver/xa ディレクトリにあります。
- ビルド要件
- ビルド スクリプトでは、現在の有効な作業モードを使用して、スイッチ モジュールのビルド方法が決定されます。ビルド スクリプトを呼び出す前に、データベース環境が正しく設定されていることを確認してください。詳細は、データベース ベンダーのマニュアルを参照してください。
- スイッチ モジュールをビルドする
- $COBDIR/src/enterpriseserver/xa ディレクトリには、スイッチ モジュールのビルドに使用できる build バッチ ファイルが含まれています。
- $COBDIR/src/enterpriseserver/xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE パーミッションがある任意の場所にコピーします。
- コピーしたファイルが含まれているディレクトリに移動します。
- 次のように入力します。build odbc
- ビルド出力
- ビルド プロセスによって、ESODBCXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 4 つの RM スイッチ モジュール ファイルが生成されます。
| ESODBCXA.so |
32 ビット |
静的 |
| ESODBCXA64.so |
64 ビット |
静的 |
| ESODBCXA_D.so |
32 ビット |
動的 |
| ESODBCXA64_D.so |
64 ビット |
動的 |
RM スイッチ モジュールの登録は、Enterprise Server で動的に行うか、使用するバイナリ ファイルに応じて静的に行います。推奨される方法は、スイッチ モジュールの動的な登録です。これにより、グローバル トランザクションで使用されるアクティブなデータベースのみが TM/RM XA フローに参加するためです。