Administration Console オンライン ヘルプ

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

ストア アンド フォワード エージェント : 全般

コンフィグレーション オプション     詳細なコンフィグレーション オプション     関連タスク     関連トピック

このページでは、SAF 送信エージェントまたは SAF 受信エージェントの基本および詳細な全般プロパティ値を定義します。

コンフィグレーション オプション

名前 説明
名前

このストア アンド フォワード エージェントの名前。

永続ストア

SAF エージェントのための、永続的なディスクベースのファイル ストア、または JDBC でアクセス可能なデータベース。

ストアがコンフィグレーションされていなければ、サーバのデフォルト ストアが使用されます。

MBean 属性:
SAFAgentMBean.Store

変更は、モジュールの再デプロイ後またはサーバの再起動後に有効になります。

エージェントの種類

この SAF エージェントが提供するサービスのタイプ。JMS では、メッセージ送信側の送信エージェントのみが必要となります。一方、Web Services Reliable Messaging では、メッセージの送信エージェントと受信エージェントの両方が必要です。

  • [送信専用]

    永続ストレージ内にメッセージを格納するエージェントをコンフィグレーションして、受信側にメッセージを転送し、承認が時間内に戻されない場合にメッセージを再送信します。

  • [受信専用]

    受信エージェントから送信された重複メッセージを検出して削除するエージェントをコンフィグレーションし、最終的な送り先にメッセージを配信します。

  • [両方]

    送信エージェントおよび受信エージェントの両方の機能を持つエージェントをコンフィグレーションします。

MBean 属性:
SAFAgentMBean.ServiceType

変更は、モジュールの再デプロイ後またはサーバの再起動後に有効になります。

最大会話待機時間

送信側が会話で使用されるリソースを解放するまでの許容最長期間。

  • 指定期間内に会話のためのアクティビティがない場合、送信エージェントはその会話のためのリソースをすべて解放し、受信側にも同じことをするよう通知します。

  • 0 は、アプリケーションが明示的に会話を終了させるまでは、その会話のためのリソースが解放されないことを示します。

  • ConversationIdleTimeMaximum を更新すると、更新後に開始する接続では、新しい値が使用されます。

MBean 属性:
SAFAgentMBean.ConversationIdleTimeMaximum

最小値: 0

詳細なコンフィグレーション オプション

名前 説明
再試行遅延の基数

元の配信試行と、1 回目の再試行との間の時間 (単位はミリ秒)。

  • RetryDelayMultiplier1 に設定されている場合、これにより任意の連続する 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

変更は、モジュールの再デプロイ後またはサーバの再起動後に有効になります。

関連タスク

関連トピック

 

Skip navigation bar ページの先頭