10.Transactionサービスに関する設定

Transactionサービス(JTA)に関する設定について説明します。

Transactionサービスに関するコンフィグレーションの設定、および稼動中のトランザクション情報の取得は、基本的には統合運用管理ツール、およびotxadminコマンドを使い、MOを経由して行いますが、いくつかTransactionサービス専用のコマンドも提供しています。前者については次に記述します。コマンドについての詳細は「運用コマンドリファレンスマニュアル」をご参照ください。

また、Transactionサービスでは、実行中のトランザクションに障害が発生した際の復旧処理を行う機能（Recovery Coordination Service:RCS）を提供しています。RCSによるトランザクションの復旧を行うために必要となる、データベースやコネクタリソースの情報定義もここで実施します。

10.1.Transactionサービス全般の設定項目・設定方法

Transactionサービスの設定項目については全てMO化されています。項目の設定方法については「2.各サービスの属性の設定」を参照してください。

補足：

設定された属性は以下のディレクトリ配下に格納されます。

${INSTANCE_ROOT}/config/persistent-mbean/transactionservice

このファイルが存在しない場合にドメインを起動すると、Transactionサービスの設定内容は全て既定値で動作します。このファイルが存在する場合にドメインを再起動した場合は、その値がTransactionサービスの設定内容として使用されます。このファイルの内容を手で書き換えることはしないでください。

Transactionサービスで使用する構成情報設定ファイル

Transactionサービスでは、内部で使用するための構成情報設定ファイル、および実行中のトランザクションの状態などを「${INSTANCE_ROOT}/config/TS」ディレクトリにおいています。本ディレクトリ、およびその配下のファイルの削除はしないでください。トランザクションの結果に矛盾が生じる可能性があります。また内容を直接修正することもしないでください。

10.2.トランザクション情報の表示

各トランザクションに関する情報を管理するMOの種別は「TSTxInfo」、MOの名前は「トランザクション識別子」となります。

統合運用管理ツールでは、ツリーの「<ドメイン名>」−「アプリケーションサーバ」−「Transactionサービス」−「Transaction情報」−「トランザクション識別子」をクリックすると、トランザクションの状態や識別子名などが右側に表示されます。また、コマンドで各項目を参照するには「server.transactionservice.tstxlist.<トランザクション識別子>」を使用します。例えばトランザクション識別子が「0209210086910000」のトランザクションの場合、「server.transactionservice.tstxlist. 0209210086910000」になります。

コマンドによる項目の参照

項目の参照には、以下のgetコマンドを使用してください。

get server.transactionservice.tstxlist.<トランザクション識別子>.attribute-name

項目の設定

設定可能な項目はありません。

10.3.Transactionサービスに関する設定

以下はMOで設定可能トランザクションサービス設定項目の一覧です。

Dottedname : server.transactionservice

Dottedname : server.transactionservice.tstxlist

Dottedname : server.transactionservice.tstxlist.<トランザクション識別子>

これらの値は全て参照のみ可能です。

10.4.リソースを管理するためのコマンド

２フェーズコミットの途中で障害が発生した場合、Transactionサービスは、トランザクションのリカバリ処理を実行します。リカバリ処理で使用するデータベースやコネクタリソースの情報を、Transactionサービスのリソースとして定義します。

Javaアプリケーション用のリソース

JDBCデータソースやコネクタリソース、JMSのコネクションファクトリリソースへの参照情報（JNDIサーバへの登録名と、上書き設定するユーザ名およびパスワード）を、TransactionサービスのJDBCリソースまたはJCAリソースに設定します。

JDBCリソースは、「JDBCデータソースのテスト」操作を行った時や、トランザクション実行時に自動的に生成されます。自動生成されたJDBCリソースをそのまま使用する場合は、「データベースを使用するための準備作業（Java）」に記載されているトランザクションのリカバリを行うための権限を、JDBCデータソースの定義時に指定したユーザに直接付与してください。リカバリを行う時にだけ特権をもったユーザを使用する場合は、自動生成されたJDBCリソースのユーザ名とパスワードを書き換えてください。

C++アプリケーション用のリソース

TransactionサービスのC++ XAリソースでは、トランザクションのリカバリを行うためだけでなく、アプリケーションからデータベースに接続するための接続情報を設定します。また、アプリケーションから、Oracleのオープン文字列中のユーザ名を使い分ける場合には、オプションとして、AP専用のリソース定義を行うことができます。

TransactionサービスのC++用のリソース定義を行った後は、そのリソースの名前を、「tpsystem.applicationGroups.アプリケーショングループ名.processGroups.プロセスグループ名」で、Transaction Serviceのデータベース識別名として指定します。

これらのリソースについては、以降のMOで設定、または、参照することができます。

JDBCリソース

MO名は、「jdbc-resource.resource-name」です。resource-nameは、JDBCデータソースの名前と同じです。

コマンドで各項目を参照・設定する際は、「server.transaction.service.resources.jdbc-resource.resource-name」という名前を指定します。また、統合運用管理ツールでは、ドメインツリーの「WebOTXAdmin[ホスト名].ドメイン名.server.transactionservice.jdbc-resource.resource-name」を選択します。項目の設定方法については「2.各サービスの属性の設定」を参照してください。

JCAリソース

MO名は、「jca-resource.resource-name」です。resource-nameは、コネクタリソースまたはJMSのコネクションファクトリリソースの名前と同じです。

コマンドで各項目を参照・設定する際は、「server.transaction.service.resources.jca-resource.resource-name」という名前を指定します。また、統合運用管理ツールでは、ドメインツリーの「WebOTXAdmin[ホスト名].ドメイン名.server.transactionservice.jca-resource.resource-name」を選択します。項目の設定方法については「2.各サービスの属性の設定」を参照してください。

C++ XAリソース

MO名は、「cppxa-resource.resource-name」です。resource-nameは、C++ XAリソースの名前です。

コマンドで各項目を参照・設定する際は、「server.transaction.service.resources.cppxa-resource.resource-name」という名前を指定します。また、統合運用管理ツールでは、ドメインツリーの「WebOTXAdmin[ホスト名].ドメイン名.server.transactionservice.cppxa-resource.resource-name」を選択します。項目の設定方法については「2.各サービスの属性の設定」を参照してください。

AP用C++ XAリソース

MO名は、「cppxa-ap-resource.parent-name.resource-name」です。parent-nameは、上位のC++ XAリソースの名前です。また、resource-nameは、AP用C++ XAリソースの名前です。

コマンドで各項目を参照・設定する際は、「server.transaction.service.resources.cppxa-resource.parent-name.resource-name」という名前を指定します。また、統合運用管理ツールでは、ドメインツリーの「WebOTXAdmin[ホスト名].ドメイン名.server.transactionservice.cppxa-resource.parent-name.resource-name」を選択します。項目の設定方法については「2.各サービスの属性の設定」を参照してください。