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

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

AggregateControl ノード

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

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

目的

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

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

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

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

AggregateControl ノード・アイコン

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

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

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

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

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

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

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

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

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

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

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

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

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

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

aggregateName
タイムアウト (秒) はい いいえ 0 応答がファンインに到着するまで待つ時間 (秒単位)。

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

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

「タイムアウト (秒)」プロパティーで指定された値は、集約構成可能サービスの timeoutSeconds プロパティーで設定される値 (設定されている場合) によってオーバーライドされます。 ノードとサービス構成可能サービスで指定されるタイムアウト値は、AggregateControl ノードの「タイムアウト場所」プロパティーで指定される場所にあるメッセージ内で定義されるタイムアウト値によってオーバーライドされます。

 

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

プロパティー M C デフォルト 説明
タイムアウトの場所 いいえ いいえ '$LocalEnvironment/Aggregation/Timeout' メッセージ・ツリー内の、集約タイムアウト値の定義場所。 メッセージ・ツリー内で指定された値は、AggregateControl ノードの「タイムアウト (秒)」プロパティー、および集約構成可能サービスの timeoutSeconds プロパティーをオーバーライドします。
ノードのモニター・プロパティーが、次の表に説明されています。
プロパティー M C デフォルト 説明
イベント いいえ いいえ なし ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。

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

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

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

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


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