WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

AggregateReply ノード

AggregateReply ノードは、集約のファンインの終わりをマークするために使用します。 このノードは、応答を収集して結合し、単独の複合応答メッセージにします。

このトピックには、以下のセクションが含まれています。

目的

集約は、要求/応答アプリケーション・モデルを拡張したものです。 集約は、いくつもの関連した要求の生成およびファンアウトと、それに対応する応答のファンインを結合し、それらの応答をコンパイルして、単一の集約された応答メッセージを作成します。

集約関数は以下の 3 つのノードにより提供されます。

  • AggregateControl ノードは、集約の一部である要求のファンアウトの始まりをマークします。 このノードは AggregateReply ノードが複数の要求のマッチングを行うために使用する制御メッセージを送信します。 Control ターミナルから伝搬される情報には、ブローカー ID、集約名プロパティー、およびタイムアウト・プロパティーが含まれます。 メッセージ環境に AggregateControl ノードによって追加された集約情報は、変更できません。
  • AggregateRequest ノードは、要求メッセージが送信されたという事実を記録します。 このノードは、AggregateReply ノードが集約された応答メッセージを構成するための情報も収集します。 メッセージ環境に AggregateRequest によって追加された情報は保存する必要があります。そうしないと集約は失敗します。
  • AggregateReply ノードは、集約のファンインの終わりをマークします。 このノードは、応答を収集して結合し、単独の集約された応答メッセージにします。

AggregateReply ノードはパレットの「ルーティング」ドロワーに含まれていて、WebSphere® Message Broker Toolkit 内では次のアイコンによって表されます。

AggregateReply ノード・アイコン

集約に対するすべての応答を受け取る前に AggregateReply ノードによって着信メッセージが保管される場合、メッセージの持続性により、メッセージが再始動するかどうかが決定されます。

集約中に、AggregateReply ノードによって 1 つ以上の応答メッセージが受け取られない場合、 通常のタイムアウトまたは不明メッセージ処理は、すでに受け取られている応答を取り扱います。

AggregateReply メッセージの MQMD.Expiry 値は、複合出力メッセージ内で -1 に設定されます。 この値が設定されるのは、応答メッセージが WebSphere MQ トランスポート上に存在しなくなり、集約プロセス中にブローカーによって保管されると、MQMD.Expiry 値は意味がなくなるためです。

メッセージ・フロー内でのこのノードの使用

このノードが使用される方法に関しては、次のサンプルを参照してください。

サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。

ターミナルおよびプロパティー

AggregateReply ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。

AggregateReply ノードのターミナルについては、次の表に説明されています。

ターミナル 説明
Control 対応する AggregateControl ノードから送信された制御メッセージを受け入れる入力ターミナル。

Control ターミナルはバージョン 6.0 では使用すべきではなくなったので、Control ターミナルへの接続を使用するには、集約フローでの制御メッセージの使用を参照してください。

In ノードが処理するメッセージを受け入れる入力ターミナル。
Failure 処理で障害が検出された場合に、メッセージがルーティングされる出力ターミナル。
Unknown メッセージが正しい応答メッセージとして識別できなかった場合にルーティングされる出力ターミナル。
Out 処理が正常に終了した時に複合メッセージがルーティングされる出力ターミナル。
Timeout 対応する AggregateControl ノードで指定されたタイムアウト間隔が過ぎた時に、 未完了の複合メッセージがルーティングされる出力ターミナル。
Catch 例外がダウンストリームでスローされ、このノードによってキャッチされた場合に、メッセージがルーティングされる出力ターミナル。

以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。

AggregateReply ノードの「説明」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
ノード名 いいえ いいえ ノード・タイプ (AggregateReply) ノードの名前。
簡略説明 いいえ いいえ   ノードの簡単な説明
詳細説明 いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト

AggregateReply ノードの「基本」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
集約名 はい はい   ファンイン・メッセージ・フローとファンアウト・メッセージ・フローを関連付けるために使用される名前。 この値は、ブローカー内の文脈で固有である必要があります。

さらにこの名前は、ノードによって使用される集約構成可能サービス (存在する場合) を識別するために使用されます。

aggregateName
不明なメッセージ・タイムアウト いいえ いいえ 0 応答として識別できないメッセージを Unknown ターミナルに伝搬するまでのメッセージ保持時間 (秒)。

デフォルト値はゼロです。このデフォルト値を受け入れた場合、タイムアウトは使用不可になり、不明なメッセージは受信されるとすぐに Unknown ターミナルに伝搬されます。

z/OS platformz/OS® 上で、「不明なメッセージ・タイムアウト」プロパティーをゼロに設定しない場合は、キュー・マネージャー・パラメーター EXPRYINT を 5 に設定してください。

 
トランザクション・モード はい いいえ 選択されている このプロパティーは、このメッセージのトランザクション特性を定義します。
  • チェック・ボックスを選択すると (デフォルト)、後続のメッセージ・フローがトランザクション制御されます。 この設定値は、MQOutput ノードが明示的にトランザクション状況を上書きしない限り、 出力メッセージより派生して MQOutput ノードにより生成されるメッセージに対しても適用されます。 他のノードでは出力メッセージのトランザクション特性を変更できません。
  • チェック・ボックスを選択しない場合には、後続のメッセージ・フローはトランザクション制御されません。 この設定値は、MQOutput ノードがメッセージを同期点下に置くように指定しない限り、出力メッセージより派生して MQOutput ノードにより生成されるメッセージに対しても適用されます。
 
ノードのモニター・プロパティーが、次の表に説明されています。
プロパティー M C デフォルト 説明
イベント いいえ いいえ なし ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。

「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:45:26


参照トピック参照トピック | バージョン 8.0.0.5 | ac04750_