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
割り当て Quota は、送り先で使用できるシステム リソースの割り当てを制御します。たとえば、送り先で格納できるバイト数を Quota を使ってコンフィグレーションできます。
MBean 属性 (アプリケーション モジュールには適用しない):
DestinationBean.Quota
最大メッセージ サイズ この送り先でプロデューサから受信するメッセージの最大サイズ。
メッセージのサイズには、メッセージの本文、ユーザ定義のプロパティ、ユーザ定義の JMS ヘッダ フィールド (JMSCorrelationID および JMSType) が含まれます。送り先でコンフィグレーションされた最大メッセージ サイズを超えるメッセージを送信したプロデューサは、ResourceAllocationException を受け取ります。
最大メッセージ サイズは、メッセージの最初の生成に対してのみ適用されます。エラー送り先に転送されるメッセージや、分散送り先のメンバーに転送されるメッセージは、サイズをチェックされません。たとえば、送り先の最大メッセージ サイズが 128KB、対応するエラー送り先の最大メッセージ サイズが 64KB でコンフィグレーションされている場合、96KB のメッセージは (64KB を超えても) エラー送り先にリダイレクトできますが、プロデューサが 96KB のメッセージをエラー送り先に直接送信することはできません。
この属性は動的にコンフィグレーションできますが、新しく配信されるメッセージにのみ適用され、すでに保存されているメッセージには影響しません。
MBean 属性 (アプリケーション モジュールには適用しない):
DestinationBean.MaximumMessageSize
最小値:
0
最大値:
2147483647