トランザクション・サービスのカスタム・プロパティー

WebSphere® Application Server では、トランザクション・サービスの多くのカスタム・プロパティーを構成できます。

注: このトピックでは、 1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM® i システムの SystemOut.log、SystemErr.log、trace.log、activity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS® ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、 情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。

トランザクション・サービスのカスタム・プロパティーは管理コンソールで指定できます。これらのカスタム・プロパティーのいずれかを使用する場合は、「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Server」 > 「server_name」 > 「[コンテナー設定] コンテナー・サービス」 > 「トランザクション・サービス」 > [追加プロパティー] カスタム・プロパティー」をクリックします。

以下のトランザクション・サービス・カスタム・プロパティーを定義できます。

DELAY_CANCELLING_ALARMS

トランザクション処理の完了前の段階に、完了までに長い時間がかかるか失敗する可能性がある処理が含まれると考えられる場合は、トランザクションがタイムアウトになるようにすることができます。

デフォルトでは、 トランザクション・タイムアウト・アラームは、 トランザクションの完了前の段階が開始される前に 取り消されます。DELAY_CANCELLING_ALARMS カスタム・プロパティーにより、 トランザクションの完了前の段階をトランザクション・タイムアウト期間の中に 含めることができます。そのためには、 アプリケーション・サーバーでこのカスタム・プロパティーを設定します。

表 1. DELAY_CANCELLING_ALARMS カスタム・プロパティー. 以下の表は、プロパティーのデータ型、許容値、およびデフォルトを示します。
通知 値
データ型 ブール
許容値 TRUE、FALSE
デフォルト FALSE

DISABLE_RECOVERY_AUDIT_LOGGING

トランザクション・サービスのリカバリー時に情報メッセージを管理コンソールに表示して SystemOut.log ファイルに書き込むかどうかを制御できます。そのためには、サーバーのトランザクション・サービスの DISABLE_RECOVERY_AUDIT_LOGGING カスタム・プロパティーを設定します。

[AIX Solaris HP-UX Linux Windows][IBM i]分散プラットフォームのデフォルトでは、トランザクション・サービスのリカバリー中に、情報メッセージが管理コンソールに表示され、SystemOut.log ファイルに書き込まれます。これらのメッセージを表示しない場合は、DISABLE_RECOVERY_AUDIT_LOGGING カスタム・プロパティーを使用できます。

表 2. DISABLE_RECOVERY_AUDIT_LOGGING カスタム・プロパティー. 以下の表は、プロパティーのデータ型、許容値、およびデフォルトを示します。
通知 値
データ型 ブール
許容値 TRUE、FALSE
デフォルト

[AIX Solaris HP-UX Linux Windows][IBM i]FALSE

ENABLE_XARESOURCE_TIMEOUT

この値を true に設定すると、トランザクション・サービスは XA リソースがグローバル・トランザクションに登録されると、XA リソースにタイムアウト値を渡します。渡されるタイムアウト値は、トランザクションがタイムアウトするまでの残りの秒数になります。

表 3. ENABLE_XARESOURCE_TIMEOUT カスタム・プロパティー. 以下の表は、プロパティーのデータ型、許容値、およびデフォルトを示します。
通知 値
データ型 ブール
許容値 TRUE、FALSE
デフォルト FALSE

REMOVE_PARTNER_LOG_ENTRY

トランザクション・パートナー・ログ・ファイルからエントリーを削除することができます。そのためには、パートナー・ログを所有する サーバーのトランザクション・サービスの REMOVE_PARTNER_LOG_ENTRY カスタム・プロパティーを 設定します。

トランザクション・リカバリー処理の一環として、 パートナー・ログが検査され、 必要なリソースが確保されます。パートナー・ログから特定のエントリー (存在しなくなったリソースなど) を削除する場合は、削除するエントリーを含むトランザクション・パートナー・ログを所有するアプリケーション・サーバーでこのカスタム・プロパティーを設定します。

REMOVE_PARTNER_LOG_ENTRY カスタム・プロパティーは、 以下の両方の状況に該当する場合にのみ有効です。

  • アプリケーション・サーバーがリカバリー・モードで始動されている。
  • リカバリーを現在必要としているトランザクションがアプリケーション・サーバーにない。 これを確認するには、SystemOut.log ファイルを調べます。
表 4. REMOVE_PARTNER_LOG_ENTRY カスタム・プロパティー. 以下の表は、プロパティーのデータ型、許容値、およびデフォルトを示します。
通知 値
データ型 整数
許容値 (整数のリカバリー ID を 1 つ以上コンマで区切ったもの)
デフォルト (ヌル)

ZOS_RECOVER_BEFORE_COMMIT

このプロパティーを指定すると、リカバリー時に MQ Server リソースに対して xa_recover 呼び出しが発行された後にデッドロックが発生しなくなります。MQ Server は、JCA 1.5 トランザクション・インフロー・インターフェースを通常操作の一環として使用します。これらのインターフェースにより、MQ Server Bus メンバーは、WebSphere Application Server トランザクションを使用して WMQ リソースおよびサービス統合バス・リソースを調整できます。リカバリー時のトランザクションのコミットでは、xa_commit または xa_rollback 呼び出しが出されたときにそのトランザクションが存在していても、一部の古い DB2 ドライバーによって XAER_NOTA が返されてしまうことがないように、xa_recover が呼び出されます。 リカバリー時のトランザクションのコミットでは、xa_commit または xa_rollback 呼び出しが出されたときにそのトランザクションが存在していても、一部の古い DB2 ドライバーによって XAER_NOTA が返されてしまうことがないように、xa_recover が呼び出されます。

このデッドロックが発生するのは、MQ Server リソースが呼び出しをコントローラーに再発行し、xa_recover 呼び出しに応答する必要があるトランザクションのリストを MQ Server リソースが生成できるようにするために、すべての既知のトランザクションをロックしようとするためです。ただし、コミット対象の IN-COMMIT トランザクションは既にロックされているため、xa_recover 呼び出しは IN-COMMIT トランザクションをロックするために無期限に待機します。これは、そのトランザクションは、トランザクションがコミットされるまでアンロックされないからです。

このプロパティーを FALSE に設定すると、リカバリー時におけるトランザクションの処理中に、xa_commit または xa_rollback 呼び出しの前に xa_recover 呼び出しは発行されません。

トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): 現在サポートされるすべての DB2 ドライバーは、xa_commit または xa_rollback 呼び出しの発行前に xa_recover 呼び出しを発行する必要がないようにする自動リカバー機能を備えています。DB2 ドライバーの資料を読んだ後に、ご使用の DB2 ドライバーに自動リカバー機能が含まれているかどうかが確かではない場合は、DB2 にアクセスするアプリケーションをホストしているサーバーでこのプロパティーの設定を安全に使用できるかどうかを最終的に確認するために、IBM DB2 サポートに連絡してください。gotcha
表 5. ZOS_RECOVER_BEFORE_COMMIT カスタム・プロパティー. 以下の表は、プロパティーのデータ型、許容値、およびデフォルトを示します。
通知 値
データ型 ブール
許容値 TRUE、FALSE
デフォルト TRUE

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rjta_transerv_custproperties
ファイル名:rjta_transerv_custproperties.html