5.5. SFSB のデフォルトのグローバルタイムアウト値

ejb3 サブシステムでは、default-stateful-bean-session-timeout 属性を使用して、サーバーインスタンスにデプロイされたすべてのステートフルセッション bean (SFSB) にデフォルトのグローバルタイムアウト値を設定できます。

default-stateful-bean-session-timeout 属性を使用すると、ejb3 サブシステムで次の管理 CLI 操作を使用できます。

  • 属性の現在のグローバルタイムアウト値を表示するための管理 CLI での read-attribute 操作。
  • 管理 CLI を使用して属性を設定するための write-attribute 操作。

属性の動作はサーバーモードによって異なります。以下に例を示します。

  • スタンドアロンサーバーで実行している場合、設定された値はアプリケーションサーバーにデプロイされたすべての SFSB に適用されます。
  • 管理対象ドメインでサーバーを実行している場合、サーバーグループ内のサーバーインスタンスにデプロイされたすべての SFSB は同時タイムアウト値を受け取ります。
注記

属性のグローバルタイムアウト値を変更する場合、更新された設定は新規デプロイメントにのみ適用されます。サーバーをリロードして、新しい設定を現在のデプロイメントに適用します。

デフォルトでは、属性値は -1 で設定されています。つまり、デプロイされた SFSB はタイムアウトしないように設定されています。ただし、属性には次の 2 つのタイプの有効な値を設定できます。

  • 属性値を 0 に設定すると、属性は、ejb コンテナーによる削除の対象となる SFSB をすぐにマークします。
  • 0 より大きい属性値を設定すると、 SFSB は、ejb コンテナーが適格な SFSB を削除する前に、ミリ秒単位で指定された時間アイドル状態のままになります。
注記

ejb-jar.xml デプロイメント記述子にある既存の @StatefulTimeout アノテーションまたは stateful-timeout 要素を使用して、SFSB のタイムアウト値を設定できます。ただし、このような設定を設定すると、デフォルトのグローバルタイムアウト値が SFSB に上書きされます。

属性に設定した新しい値を確認するには、次の 2 つの方法があります。

  • 管理 CLI で read-attribute 操作を使用します。
  • サーバーの設定ファイルの ejb3 サブシステムセクションを調べます。

関連情報

  • 属性の現在のグローバルタイムアウト値の表示の詳細については、管理 CLI ガイド属性値の表示 を参照してください。
  • 属性の現在のグローバルタイムアウト値の更新の詳細については、 管理 CLI ガイド属性の更新 を参照してください。