管理コンソール・オンライン・ヘルプ

前 次 新規ウィンドウで目次を開く
ここから内容の開始

JMSテンプレート: 構成: しきい値と割当

構成オプション     関連タスク     関連トピック

このページでは、このテンプレートから作成された宛先のバイト/メッセージしきい値の上限と下限を定義します。これらのしきい値を超過すると、ログ・メッセージの生成およびメッセージ・フロー制御の開始などのイベントがトリガーされます。また、宛先で許容される最大メッセージ・サイズを指定したり、あらかじめ構成された割当てを選択することもできます。この割当てにより、メモリー使用量を節約するために宛先に格納できる最大メッセージ数または最大バイト数が決定されます。

JMSテンプレートに対して構成可能なしきい値および割当て属性は、宛先に構成される属性と同じです。ただし、JMSテンプレートを使用する宛先が、しきい値と割当てにデフォルト以外の値を指定している場合は、その値が使用されます。JMSサーバーで、JMSサーバーに割り当てられたJMSモジュール内のすべての宛先のしきい値と特定の割当ての設定を管理することもできます。

構成オプション

名前 説明
最大バイトしきい値

ロギングやフロー制御イベントを発生させる上限しきい値(この宛先内の合計バイト数)。java.lang.Long.MAX_VALUEの値は、宛先のロギングおよびフロー制御イベントを無効化します。

バイト数がこのしきい値を超えた場合、発生するイベントは次のとおりです。

  • ログ・メッセージ

    - 最大しきい値条件を示すメッセージがサーバーのログに記録されます。

  • フロー制御

    - フロー制御が有効化されている場合、宛先が防御状態になり、プロデューサに対してメッセージ・フローを減らすよう指示します。

値の範囲: <= BytesMaximum; >= BytesThresholdLow

このしきい値に対する変更は、受信メッセージにのみ影響します。格納されているメッセージには影響しません。

MBean属性(アプリケーション・モジュールには適用しない):
ThresholdParamsBean.BytesHigh

最小値: 0

最大値: 9223372036854775807

最小バイトしきい値

ロギングやフロー制御イベントを発生させる下限しきい値(この宛先内の合計バイト数)。java.lang.Long.MAX_VALUEの値は、宛先のロギングおよびフロー制御イベントを無効化します。

バイト数がこのしきい値を下回った場合、発生するイベントは次のとおりです。

  • ログ・メッセージ

    最小しきい値条件を示すメッセージがサーバーのログに記録されます。

  • フロー制御

    - フロー制御が有効化されている場合、宛先が防御状態を解除して、プロデューサに対してメッセージ・フローを増やすよう指示します。

値の範囲: < BytesThresholdHigh

このしきい値に対する変更は、受信メッセージにのみ影響します。格納されているメッセージには影響しません。

MBean属性(アプリケーション・モジュールには適用しない):
ThresholdParamsBean.BytesLow

最小値: 0

最大値: 9223372036854775807

最大メッセージしきい値

ロギングやフロー制御イベントを発生させる上限しきい値(この宛先内の合計メッセージ数)。java.lang.Long.MAX_VALUEの値は、宛先のロギングおよびフロー制御イベントを無効化します。

メッセージ数がこのしきい値を超えた場合、発生するイベントは次のとおりです。

  • ログ・メッセージ

    - 最大しきい値条件を示すメッセージがサーバーのログに記録されます。

  • フロー制御

    - フロー制御が有効化されている場合、宛先が防御状態になり、プロデューサに対してメッセージ・フローを減らすよう指示します。

値の範囲: <= MessagesMaximum; >= MessagesThresholdLow

このしきい値に対する変更は、受信メッセージにのみ影響します。格納されているメッセージには影響しません。

MBean属性(アプリケーション・モジュールには適用しない):
ThresholdParamsBean.MessagesHigh

最小値: 0

最大値: 9223372036854775807

最小メッセージしきい値

ロギングやフロー制御イベントを発生させる下限しきい値(この宛先内の合計メッセージ数)。java.lang.Long.MAX_VALUEの値は、宛先のロギングおよびフロー制御イベントを無効化します。

メッセージ数がこのしきい値を下回った場合、発生するイベントは次のとおりです。

  • ログ・メッセージ

    最小しきい値条件を示すメッセージがサーバーのログに記録されます。

  • フロー制御

    - フロー制御が有効化されている場合、宛先が防御状態を解除して、プロデューサに対してメッセージ・フローを増やすよう指示します。

値の範囲: < MessagesThresholdHigh

このしきい値に対する変更は、受信メッセージにのみ影響します。格納されているメッセージには影響しません。

MBean属性(アプリケーション・モジュールには適用しない):
ThresholdParamsBean.MessagesLow

最小値: 0

最大値: 9223372036854775807

最大メッセージ・サイズ

この宛先でプロデューサから受信するメッセージの最大サイズ。

メッセージのサイズには、メッセージの本文、ユーザー定義のプロパティ、ユーザー定義のJMSヘッダー・フィールド(JMSCorrelationIDおよびJMSType)が含まれます。宛先のメッセージの最大サイズの設定を超えるメッセージをプロジューサが送信すると、ResourceAllocationExceptionが発生します。

最大メッセージ・サイズは、メッセージの最初の生成に対してのみ適用されます。エラー宛先に転送されるメッセージや、分散宛先のメンバーに転送されるメッセージは、サイズをチェックされません。たとえば、宛先の最大メッセージ・サイズが128KB、対応するエラー宛先の最大メッセージ・サイズが64KBで構成されている場合、96KBのメッセージは(64KBを超えても)エラー宛先にリダイレクトできますが、プロデューサが96KBのメッセージをエラー宛先に直接送信することはできません。

この属性は動的に構成できますが、新しく配信されるメッセージにのみ適用され、すでに保存されているメッセージには影響しません。

MBean属性(アプリケーション・モジュールには適用しない):
DestinationBean.MaximumMessageSize

最小値: 0

最大値: 2147483647

割当

Quotaは、宛先で使用できるシステム・リソースの割当てを制御します。たとえば、宛先で格納できるバイト数をQuotaを使用して構成できます。

MBean属性(アプリケーション・モジュールには適用しない):
DestinationBean.Quota

トピック・サブスクリプション・メッセージの制限

トピック・サブスクリプションに格納できるメッセージの最大数。

指定した制限に到達したサブスクリプションに新しいメッセージが到着すると、新しいメッセージ用のスペースを設けるため、それらのサブスクリプションで最初に使用可能なメッセージが削除されます。サブスクリプション・メッセージがこの削除から免除されるのは、それらが保留中のトランザクションに参加しており、すでにコンシューマに渡されていて確認応答を待機している場合、またはそれらがそのすべてのメッセージの蓄積を待機している作業単位の一部である場合です。すべてのメッセージが削除から免除される場合、新しいメッセージによってサブスクリプション・サイズがその制限を超える可能性があります。

-1の値に設定されている場合、制限はオーバーライドされません。

MBean属性(アプリケーション・モジュールには適用しない):
TopicSubscriptionParamsBean.MessagesLimitOverride

最小値: -1

最大値: 9223372036854775807

関連タスク

関連トピック


先頭に戻る