WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

AggregateControl-Knoten

Mit dem AggregateControl-Knoten markieren Sie den Ausgangspunkt für die Verteilung von Anforderungen, die Teil einer Aggregation sind.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Bei einer Aggregation handelt es sich um eine Erweiterung des Request/Reply-Modells. Sie vereint die Generierung und Verteilung von zusammengehörigen Anfragen durch das Sammeln der entsprechenden Antwortnachrichten und kompiliert diese Antworten in eine einzelne, aggregierte Antwortnachricht.

Die Aggregationsfunktion wird von folgenden drei Knoten unterstützt:
  • Der AggregateControl-Knoten markiert den Ausgangspunkt für die Verteilung von Anforderungen, die Teil einer Aggregation sind. Er sendet eine Steuernachricht, mit der der AggregateReply-Knoten die unterschiedlichen Anfragen abstimmt, die getätigt wurden. Zu den vom Steuerterminal weitergegebenen Informationen gehören die Broker-ID, die Eigenschaft 'Aggregatname' und die Eigenschaft 'Zeitlimit'. Die Aggregationsinformationen, die durch den AggregateControl-Knoten zu der Nachrichtenumgebung hinzugefügt wurden, dürfen nicht geändert werden.
  • Der AggregateRequest-Knoten erkennt, dass die Anforderungsnachrichten gesendet wurden. Darüber hinaus sammelt er Informationen, auf deren Grundlage der AggregateReply-Knoten die zusammengefasste Antwortnachricht erstellt. Die Informationen, die durch den AggregateControl-Knoten zur Nachrichtenumgebung hinzugefügt wurden, müssen übernommen werden, da die Aggregation sonst fehlschlägt.
  • Der AggregateReply-Knoten markiert den Endpunkt einer Aggregation gesammelter Antwortnachrichten. Er sammelt Antworten und fasst sie zu einer aggregierten Antwortnachricht zusammen.

Dieser Knoten erstellt den Ordner LocalEnvironment.ComIbmAggregateControlNode. Dieser Ordner und die darin enthaltenen Felder werden intern von WebSphere Message Broker verwendet, d. h., bei der Entwicklung eigener Nachrichtenflüsse sollte weder auf ihr Vorhandensein noch auf darin enthaltene Werte Bezug genommen werden.

Der AggregateControl-Knoten befindet sich im Ablagefach Routing der Palette und wird in der WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für AggregateControl-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Die folgenden Mustercodes verdeutlichen die Verwendung dieses Knotens:

Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des AggregateControl-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern gekennzeichnet.

In der folgenden Tabelle werden die AggregateControl-Knotenterminals beschrieben .

Terminal Beschreibung
Eingangsterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die Verarbeitung erfolgreich abgeschlossen wurde.
Steuerterminal Das Ausgabeterminal, an das eine Steuernachricht geleitet wird. Die Steuernachricht wird an einen entsprechenden AggregateReply-Knoten gesendet.

Das Steuerterminal wird in Version 6.0 nicht weiter unterstützt; Informationen zur Verwendung von Verbindungen vom Steuerterminal finden Sie unter Verwendung der Steuernachricht in Aggregationsflüssen.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des AggregateControl-Knotens beschrieben:

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Der Knotentyp (AggregateControl) Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die Grundeinstellungseigenschaften des AggregateControl-Knotens beschrieben:

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Aggregationsname Ja Ja   Über diesen Namen wird der Verteilernachrichtenfluss dem Sammelnachrichtenfluss zugeordnet. Dieser Wert muss im jeweiligen Kontext innerhalb eines Brokers eindeutig sein.

Anhand dieses Namens wird auch der konfigurierbare Aggregationsservice ermittelt (sofern vorhanden), der vom Knoten verwendet werden soll.

aggregateName
Zeitlimit (Sekunden) Ja Nein 0 Die Zeit in Sekunden, die auf den Eingang von Antworten an der Sammelstelle gewartet wird.

Der Standardwert ist null. Wenn Sie diesen Wert übernehmen, wird das Zeitlimit für Verteilungen von diesem Knoten aus inaktiviert (d. h., er wartet unbegrenzte Zeit auf Antworten). Wenn nicht alle Antworten empfangen werden, wartet der Nachrichtenfluss weiterhin und kann nicht abgeschlossen werden. Legen Sie einen Wert größer als null fest, um sicherzustellen, dass der Nachrichtenfluss auch dann beendet werden kann, wenn nicht alle Antworten empfangen werden. Weiter Informationen zu Zeitlimitüberschreitungen finden Sie unter AggregateReply-Knoten.

z/OS platformWenn für die Eigenschaft 'Zeitlimit' unter z/OS nicht null festgelegt wurde, muss der WS-Manager-Parameter EXPRYINT auf 5 gesetzt werden.

Der Wert der Eigenschaft Zeitlimit (Sekunden) wird durch den Wert der Eigenschaft timeoutSeconds des konfigurierbaren Aggregationsservice überschrieben, falls ein Wert festgelegt ist. Die durch den Knoten und den konfigurierbaren Service angegebenen Zeitlimitwerte werden durch den in der Nachricht definierten Zeitlimitwert überschrieben (dieser wird in der Nachricht an der durch die Eigenschaft Adresse des Zeitlimitwerts des AggregateControl-Knotens festgelegten Position angegeben).

 

In der folgenden Tabelle werden die erweiterten Eigenschaften des AggregateControl-Knotens beschrieben:

Eigenschaft O K Standardwert Beschreibung
Zeitlimitposition Nein Nein '$LocalEnvironment/Aggregation/Timeout' Die Position in der Nachrichtenbaumstruktur, an welcher der Wert für das Aggregationszeitlimit definiert ist. Der in der Nachrichtenbaumstruktur angegebene Wert überschreibt die Eigenschaft Zeitlimit (Sekunden) des AggregateControl-Knotens und die Eigenschaft timeoutSeconds des konfigurierbaren Aggregationsservice.
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standardwert Beschreibung
Ereignisse Nein Nein Ohne Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:19:54


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac04740_