JMSテンプレート: 構成: 全般
構成オプション 詳細な構成オプション 関連タスク 関連トピック
このページでは、このJMSテンプレートの全般的な構成を定義します。たとえば、宛先に届いたメッセージをソートする宛先ソート・キーを選択します。
JMSテンプレート属性は、JMS宛先によって継承され、使用されます。ただし、「名前」属性は、JMSテンプレートでのみ有効です。このJMSテンプレートから作成するJMS宛先には必ず一意な名前を明示的に定義する必要があります。
構成オプション
名前 説明 名前 このJMSテンプレートの名前。
MBean属性:
WebLogicMBean.Name
宛先キー このJMSテンプレートを使用する宛先に届くメッセージのソートに使用できる宛先キーのリスト。
キーは最上位から最下位の順に順序付けられます。複数のキーが指定されている場合、JMSMessageIDに基づいたキーはリストの最後のキーになります。
ノート: JMSMessageIDがキーに定義されていない場合は、暗黙的にそれが最後のキーと仮定され、ソート順序は「昇順」(FIFO)に設定されます。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.DestinationKeys
詳細な構成オプション
名前 説明 起動時にメッセージの生成を休止 サーバー起動時に、このテンプレートを使用する宛先で、新しいメッセージの生成が休止されるかどうかを指定します。
- false
サーバー起動時のメッセージ生成の休止がこのテンプレートでは無効化されます。
- true
サーバー起動時のメッセージ生成の休止がこのテンプレートでは有効化されます。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.ProductionPausedAtStartup
起動時にメッセージの消費を休止 サーバー起動時にこのテンプレートを使用する宛先で、メッセージの消費が休止されるかどうかを指定します。
- false
サーバー起動時のメッセージ消費の休止がこのテンプレートでは無効化されます。
- true
サーバー起動時のメッセージ消費の休止がこのテンプレートでは有効化されます。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.ConsumptionPausedAtStartup
起動時にメッセージの挿入を休止 サーバー起動時にこのテンプレートを使用する宛先で、新しいメッセージの挿入が休止されるかどうかを指定します。
- false
サーバー起動時のメッセージ挿入の休止がこのテンプレートでは無効化されます。
- true
サーバー起動時のメッセージ挿入の休止がこのテンプレートでは有効化されます。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.InsertionPausedAtStartup
順序単位名の自動生成 ドメイン、JMSサーバー、宛先名に基づいて、システムで生成される順序単位名をWebLogic Serverが作成するかどうかを指定します。この宛先に届き、まだ順序単位に属していないメッセージは、このデフォルト名を割り当てられます。
このフィールドは、高度な使用にお薦めします。一般的には、アプリケーションの呼出しまたは接続ファクトリ構成を使用してメッセージの順序単位を設定することをお薦めします。分散宛先での強制的な順序付けで宛先のデフォルトの順序単位に依存する場合、アプリケーションでは順序単位のルーティングが適用されないことを認識している必要があります。かわりに、アプリケーションでは、処理の失敗やサービスの移行が発生した場合でも、順番に処理する必要がある特定のメッセージ・セットが指定された同一のメンバー宛先にすべて送信されるように、特別に注意する必要があります。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.DefaultUnitOfOrder
センダー資格証明のアタッチ このテンプレートを使用する宛先に届くメッセージに送信側ユーザーの資格証明が添付されている必要があるかどうかを指定します。
- サポート
必要な場合は、JMSXUserIDプロパティが送信側ユーザーのセキュリティ・プリンシパルに設定されます。ConnectionFactoryで
AttachJMSXUserID="true"
と指定することにより、送信側はメッセージにIDを添付するようにリクエストできます。- なし
JMSXUserIDプロパティは、送信側ユーザーのセキュリティ・プリンシパルに設定されません。
- 常に
JMSXUserIDプロパティは、送信側ユーザーのセキュリティ・プリンシパルに常に設定されます。
このプロパティは動的に構成できます。動的に変更した場合は、更新後に受信したメッセージにのみ影響します。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.AttachSender
SAFエクスポート・ポリシー ユーザーが、ストア・アンド・フォワードを使用して、このテンプレートを使用する宛先にメッセージを送信できるかどうかを指定します。
- すべて
すべてのユーザーは、ストア・アンド・フォワードを使用する宛先にメッセージを送信できます。
- なし
リモート・ユーザーは、ストア・アンド・フォワードを使用する宛先にメッセージを送信できません。
このプロパティは動的に構成できます。動的に変更した場合は、更新後に送信されたメッセージにのみ影響します。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.SafExportPolicy
メッセージング・パフォーマンスのプリファレンス このテンプレートを使用する宛先が、コンシューマに配信する消費可能なメッセージ(存在する場合)の完全なバッチを作成するまでに待機できる期間の長さを制御します。最小値の場合、バッチ処理は無効化されます。デフォルト値の場合、完全でないバッチは待機せずに、ただちに現在消費可能なメッセージによる配信が行われます。デフォルト値より大きい値にチューニングすることで、完全でないバッチがコンシューマに配信される前に、さらなるメッセージに対する最長待機時間を制御できます。
完全なバッチの最大メッセージ数は、JMS接続ファクトリの「最大メッセージ数」の設定によって制御されます。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.MessagingPerformancePreference
最小値:
0
最大値:
100
作業単位(UOW)メッセージ処理ポリシー このテンプレートを使用する宛先で、作業単位(UOW)機能を有効化するかどうかを指定します。UOWは1つの単位として処理されるメッセージのセットです。
- パススルー
デフォルトでは、このテンプレートを使用する宛先はメッセージをUOWの一部として処理しません。
- 単一のメッセージ配信
この値は、UOWコンシューマでこのテンプレートを使用する宛先に対するメッセージを受信している場合にのみ選択します。選択した場合、UOWメッセージはリストになり、そのリストを格納した
ObjectMessage
として消費されます。MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.UnitOfWorkHandlingPolicy
未完了のUOWメッセージの有効期間 未完了のUOW内の未配信メッセージが期限切れになるまでの最長時間(ミリ秒)を指定します。そのようなメッセージはその後、未配信メッセージに対して定義されている、テンプレートの有効期限ポリシーに従います。
ノート: UOWメッセージのためのテンプレートのエラー宛先は、「単一のメッセージ配信」値を使用するように構成することはできません。
MBean属性(アプリケーション・モジュールには適用しない):
TemplateBean.IncompleteWorkExpirationTime