JMS テンプレート : コンフィグレーション : 全般
コンフィグレーション オプション 詳細なコンフィグレーション オプション 関連タスク 関連トピック
このページでは、この JMS テンプレートの全般的なコンフィグレーションを 定義します。たとえば、送り先に届いたメッセージをソートする送り先 ソート キーの選択などを行います。
JMS テンプレート属性は、JMS 送り先によって継承され、使用されます。ただし、 [名前] 属性は、JMS テンプレートでのみ有効です。この JMS テンプレート から作成する JMS 送り先には必ずユニークな名前を明示的に定義する必要が あります。
コンフィグレーション オプション
名前 説明 名前 この JMS テンプレートの名前。
送り先キー この JMS テンプレートを使用する送り先に届くメッセージのソートに使用できる送り先キーのリスト。
キーは最上位から最下位の順に順序付けられます。複数のキーが指定されている場合、JMSMessageID に基づいたキーはリストの最後のキーになります。
注意 : JMSMessageID がキーに定義されていない場合は、暗黙的にそれが最後のキーと仮定され、ソート順序は「昇順」(FIFO) に設定されます。
MBean 属性 (アプリケーション モジュールには適用しない) :
TemplateBean.DestinationKeys
詳細なコンフィグレーション オプション
名前 説明 起動時にメッセージの生成を休止 サーバ起動時に、このテンプレートを使用する送り先で、新しいメッセージの生成が休止されるかどうかを指定します。
- false
サーバ起動時のメッセージ生成の休止がこのテンプレートでは無効化されます。
- true
サーバ起動時のメッセージ生成の休止がこのテンプレートでは有効化されます。
MBean 属性 (アプリケーション モジュールには適用しない) :
TemplateBean.ProductionPausedAtStartup
起動時にメッセージの消費を休止 サーバ起動時にこのテンプレートを使用する送り先で、メッセージの消費が休止されるかどうかを指定します。
- false
サーバ起動時のメッセージ消費の休止がこのテンプレートでは無効化されます。
- true
サーバ起動時のメッセージ消費の休止がこのテンプレートでは有効化されます。
MBean 属性 (アプリケーション モジュールには適用しない) :
TemplateBean.ConsumptionPausedAtStartup
起動時にメッセージの挿入を休止 サーバ起動時にこのテンプレートを使用する送り先で、新しいメッセージの挿入が休止されるかどうかを指定します。
- false
サーバ起動時のメッセージ挿入の休止がこのテンプレートでは無効化されます。
- true
サーバ起動時のメッセージ挿入の休止がこのテンプレートでは有効化されます。
MBean 属性 (アプリケーション モジュールには適用しない) :
TemplateBean.InsertionPausedAtStartup
順序単位名を自動生成 このテンプレートを使用する送り先に対して、統計的にユニークな、システムで生成される順序単位名を WebLogic Server が作成するかどうかを指定します。このような送り先に届き、まだ順序単位に属していないメッセージは、このデフォルト名を割り当てられます。
MBean 属性 (アプリケーション モジュールには適用しない) :
TemplateBean.DefaultUnitOfOrder
センダ資格をアタッチ このテンプレートを使用する送り先に届くメッセージに送信側ユーザの資格が添付されている必要があるかどうかを指定します。
- Supports
必要な場合は、JMSXUserID プロパティが送信側ユーザのセキュリティ プリンシパルに設定されます。ConnectionFactory で
AttachJMSXUserID="true"
と指定することにより、送信側はメッセージに ID を添付するように要求できます。- Never
JMSXUserID プロパティは、送信側ユーザのセキュリティ プリンシパルに設定されません。
- Always
JMSXUserID プロパティは、送信側ユーザのセキュリティ プリンシパルに常に設定されます。
このプロパティは動的にコンフィグレーションできます。動的に変更した場合は、更新後に受信したメッセージにのみ影響します。
MBean 属性 (アプリケーション モジュールには適用しない) :
TemplateBean.AttachSender
SAF エクスポート ポリシー ユーザが、ストア アンド フォワードを使用して、このテンプレートを使用する送り先にメッセージを送信できるかどうかを指定します。
- All
すべてのユーザは、ストア アンド フォワードを使用する送り先にメッセージを送信できます。
- None
リモート ユーザは、ストア アンド フォワードを使用する送り先にメッセージを送信できません。
このプロパティは動的にコンフィグレーションできます。動的に変更した場合は、更新後に送信されたメッセージにのみ影響します。
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