ストア アンド フォワード エージェント : 全般
コンフィグレーション オプション 詳細なコンフィグレーション オプション 関連タスク 関連トピック
このページでは、SAF 送信エージェントまたは SAF 受信エージェントの基本および詳細な全般プロパティ値を定義します。
コンフィグレーション オプション
名前 説明 名前 このストア アンド フォワード エージェントの名前。
永続ストア SAF エージェントのための、永続的なディスクベースのファイル ストア、または JDBC でアクセス可能なデータベース。
ストアがコンフィグレーションされていなければ、サーバのデフォルト ストアが使用されます。
MBean 属性:
SAFAgentMBean.Store
エージェントの種類 この SAF エージェントが提供するサービスのタイプ。
値の範囲 :
送信専用
、受信専用
、または両方
。MBean 属性:
SAFAgentMBean.ServiceType
最大会話待機時間 送信側が会話で使用されるリソースを解放するまでの許容最長期間。
指定期間内に会話のためのアクティビティがない場合、送信エージェントはその会話のためのリソースをすべて解放し、受信側にも同じことをするよう通知します。
値
0
は、アプリケーションが明示的に会話を終了させるまでは、その会話のためのリソースが解放されないことを示します。
ConversationIdleTimeMaximum
を更新すると、更新後に開始する接続では、新しい値が使用されます。MBean 属性:
SAFAgentMBean.ConversationIdleTimeMaximum
最小値:
0
詳細なコンフィグレーション オプション
名前 説明 再試行遅延の基数 元の配信試行と、1 回目の再試行との間の時間 (単位はミリ秒)。
RetryDelayMultiplier
が1
に設定されている場合、これにより任意の連続する 2 回の再試行の間隔が定義されます。送信機能のあるエージェントにのみ適用されます。
DefaultRetryDelayBase
を更新すると、更新後に開始する接続では、新しい値が使用されます。値の範囲 : < = RetryDelayMaximum。RetryDelayMultiplier が 1.0 でない場合。
MBean 属性:
SAFAgentMBean.DefaultRetryDelayBase
最小値:
1
最大再試行遅延 連続して行われる 2 回の配信再試行の間の最長期間 (単位はミリ秒)。
送信機能のあるエージェントにのみ適用されます。
DefaultRetryDelayMaximum
を更新すると、更新後に開始する接続では、新しい値が使用されます。値の範囲 : > = RetryDelayBase。RetryDelayMultiplier が 1.0 でない場合。
MBean 属性:
SAFAgentMBean.DefaultRetryDelayMaximum
最小値:
1
再試行遅延の乗数 前回の遅延時間を乗算して、次に使用する遅延時間を計算するための因数。
送信機能のあるエージェントにのみ適用されます。
DefaultRetryDelayMuliplier
を更新すると、更新後に開始する接続では、新しい値が使用されます。値の範囲 : > = 1。
MBean 属性:
SAFAgentMBean.DefaultRetryDelayMultiplier
最小値:
1.0
ロギングを有効化 メッセージ転送が失敗した場合に、サーバ ログ ファイルにメッセージを記録するかどうかを指定します。
これが選択されると、SAF アプリケーション内でエラー処理が行われないか、またはアプリケーションのエラー処理が失敗した場合に、転送されずに最終的な送り先へ配信されるメッセージに適用されます。
受信機能のあるエージェントにのみ適用されます。
LoggingEnabled
を更新すると、更新後に開始する接続では、新しい値が使用されます。MBean 属性:
SAFAgentMBean.LoggingEnabled
生存時間 エージェントが確実にメッセージを送信することを保証する、デフォルトの時間 (単位はミリ秒)。
値 0 は、会話持続中はメッセージを確実に送信するとエージェントが保証していることを示します。
DefaultTimeToLive
を更新すると、更新後に開始する会話では、新しい値が使用されます。MBean 属性:
SAFAgentMBean.DefaultTimeToLive
最小値:
0
ウィンドウ間隔 JMS 送信エージェントが、単一バッチでメッセージを転送するまでに待機する最長時間 (ミリ秒)。
送信エージェントは、(A) ソース送り先メッセージ数が、コンフィグレーションされた
ウィンドウ サイズ
以上になるか、(B) 待機時間が指定されたウィンドウ間隔
になるかの、いずれかの条件が満たされるまで (どちらが先であるかは問わない)、メッセージ バッチを転送せずに待機します。MBean 属性:
SAFAgentMBean.WindowInterval
最小値:
0
ページング ディレクトリ JMS サーバのメッセージ本文のサイズが、メッセージ バッファ サイズを超過した場合に、メッセージ本文が書き込まれる場所を指定します。指定されていない場合、メッセージはホスト WebLogic Server インスタンスのディレクトリ内の
tmp
ディレクトリに書き込まれます。たとえば次のようになります。domainName/servers/servername/tmp
パフォーマンスを最高にするには、このディレクトリを、SAF エージェントの永続ストアが使用するディレクトリとは別のものにする必要があります。
送信機能のあるエージェントにのみ適用されます。
MBean 属性:
SAFAgentMBean.PagingDirectory
メッセージ バッファ サイズ ディスクへページングされる前のメモリ内のメッセージ本文を保存する際のメモリ使用量。
値 -1 (デフォルト) は、サーバが JVM の最大ヒープ サイズに基づいて自動的にサイズを決定することを示します。このデフォルトは、最大ヒープ サイズの 3 分の 1 か、512 MB のうち大きい方のサイズに設定されます。
バッファが大きくなるほど、多くのメッセージがキューまたはトピックに待機している際に JMS でより多くのメモリが消費されます。このバッファ サイズを超えると、JMS はメモリ使用量をバッファ サイズ未満に抑えようとして、PagingDirectory で指定したディレクトリに、メッセージ本文を書き込むことがあります。
バッファ サイズを超えても、JMS サーバは新しいメッセージを受信し続けます。そのため、メッセージ受信速度がディスクへの書き込み速度を上回る場合は、メモリ不足に陥るおそれがあります。メッセージ負荷の大きいユーザが、できるかぎり高い可用性をサポートするには、割り当てまたはしきい値を設定してフロー制御を有効にする必要があります。
送信機能のあるエージェントにのみ適用されます。
ページングは、常にサポートされています。
メモリ サイズを更新すると、メッセージ数がリセットされるので、更新後に受信されるリクエストのみが、新しいメモリ サイズを適用されます。
MBean 属性:
SAFAgentMBean.MessageBufferSize
最小値:
-1
起動時に着信メッセージを休止 起動時に新しく配信されるメッセージのためにエージェントを一時停止するかどうかを指定します。
有効にした場合、送信エージェントは新しいメッセージを受け入れます。無効にした場合、送信エージェントは新しいメッセージを受け入れません。
MBean 属性:
SAFAgentMBean.IncomingPausedAtStartup
起動時にメッセージの転送を休止 起動時にメッセージ転送のためにエージェントを一時停止するかどうかを指定します。
有効にした場合、送信エージェントはメッセージを転送します。無効にした場合、送信エージェントはメッセージを転送しません。
MBean 属性:
SAFAgentMBean.ForwardingPausedAtStartup
ウィンドウ サイズ JMS メッセージの場合は、バッチ内のメッセージ数。送信エージェントは、ソース送り先メッセージ数がこの値以上になるまで、メッセージ バッチを転送せずに待機します。WSRM の場合は、会話中にソース送り先と対象送り先の間で許容される未応答メッセージの最大数。
MBean 属性:
SAFAgentMBean.WindowSize
最小値:
1
確認応答間隔 受信側が連続して 2 回送信する確認応答の最大間隔。
受信機能のあるエージェントにのみ適用されます。
値
-1
は、連続する確認応答の間隔に時間制限がないことを示します。
AcknowlegeInterval
を更新すると、更新後に開始する接続では、新しい値が使用されます。MBean 属性:
SAFAgentMBean.AcknowledgeInterval
起動時にメッセージの受信を休止 起動時にメッセージ受信のためにエージェントを一時停止するかどうかを指定します。
有効にした場合、送信エージェントはメッセージを受信します。無効にした場合、送信エージェントはメッセージを受信しません。
MBean 属性:
SAFAgentMBean.ReceivingPausedAtStartup