AggregateControl ノード

AggregateControl ノードは、 集約の一部である要求のファンアウトの始まりをマークするために使用します。

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

目的

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

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

このノードは、LocalEnvironment.ComIbmAggregateControlNode フォルダーを作成します。 このフォルダーとその中にあるフィールドは、WebSphere® Message Broker が内部で使用するためのものであり、メッセージ・フローを開発する時にそれらのフィールドの存在やそれらの値に依存すべきではありません。

AggregateControl ノードはパレットの「ルーティング」ドロワーに含まれていて、ワークベンチ内では次のアイコンによって表されます。

AggregateControl ノード・アイコン

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

このノードが使用される方法に関しては、次のサンプルを参照してください。 サンプルは、Message Brokers Toolkit と統合されているインフォメーション・センターを使用する場合にのみ表示できます。

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

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

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

ターミナル 説明
In ノードが処理するメッセージを受け入れる入力ターミナル。
Out 処理が正常に終了した時にもとのメッセージがルーティングされる出力ターミナル。
Control 制御メッセージがルーティングされる出力ターミナル。制御メッセージは、対応する AggregateReply ノードへ送信されます。

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

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

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

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

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

プロパティー M C デフォルト 説明
集約名 はい はい   ファンアウト・メッセージ・フローとファンイン・メッセージ・フローを関連付けるために使用される名前。この値は、ブローカー内の文脈で固有である必要があります。
タイムアウト (秒) はい いいえ 0 応答がファンインに到着するまで待つ時間 (秒単位)。

デフォルト値はゼロです。このデフォルト値を受け入れた場合、このノードからのファンアウトに対するタイムアウトは使用できなくなります。(つまり、応答を無限に待つことになります。) 応答がすべて受信されない場合、メッセージ・フローはずっと応答を待ち続け、完了しません。 すべての応答を受け取らなくてもメッセージ・フローを完了できるように、ゼロより大きい値を設定します。 タイムアウトについて詳しくは、AggregateReply ノードを参照してください。

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

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

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:42:44

ac04740_