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.

AggregateReply-Knoten

Mit dem AggregateReply-Knoten markieren Sie den Endpunkt einer Sammlung zusammengehöriger Antwortnachrichten. Dieser Knoten sammelt Antworten und fasst sie zu einer Verbundnachricht zusammen.

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 AggregateRequest 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.

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

Symbol des AggregateReply-Knotens

Wenn eingehende Nachrichten vom AggregateReply-Knoten gespeichert werden, bevor alle Antworten für die Aggregation empfangen wurden, hängt es von der Permanenz der Nachricht ab, ob sie bei einem Neustart erhalten bleibt.

Wenn während einer Aggregation mindestens eine der Antwortnachrichten nicht vom AggregateReply-Knoten empfangen wird, bearbeiten die Terminals 'Zeitlimit' bzw. 'Unbekannt' die Antworten, die bereits empfangen wurden.

Für den Wert 'MQMD.Expiry' jeder AggregateReply-Nachricht wird in der Verbundausgabenachricht -1 festgelegt. Dieser Wert wird festgelegt, da der Wert MQMD.Expiry keine Bedeutung hat, sobald sich die Antwortnachricht nicht mehr im WebSphere MQ-Transport befindet und vom Broker beim Aggregationsprozess gespeichert wurde.

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 AggregateReply-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 AggregateReply-Knotenterminals beschrieben .

Terminal Beschreibung
Steuerterminal Das Eingabeterminal, das Steuernachrichten annimmt, die von einem entsprechenden AggregateControl-Knoten gesendet werden.

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

Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Verarbeitung ein Fehler auftritt.
Unbekannt Das Ausgabeterminal, an das Nachrichten weitergeleitet werden, wenn sie nicht als gültige Antwortnachrichten identifiziert werden können.
Ausgang Das Ausgabeterminal, an das die Verbundnachricht bei erfolgreicher Verarbeitung geleitet wird.
Timeout Das Ausgabeterminal, an das die unvollständige Verbundnachricht weitergeleitet wird, wenn das im entsprechenden AggregateControl-Knoten angegebene Zeitlimitintervall überschritten wurde.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und dann von diesem Knoten abgefangen wurde.

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 AggregateReply-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Der Knotentyp (AggregateReply) 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 grundlegenden Eigenschaften des AggregateReply-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Aggregationsname Ja Ja   Über diesen Namen wird der Sammelnachrichtenfluss dem Verteilernachrichtenfluss 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 bei unbekannten Nachrichten Nein Nein 0 Die Dauer in Sekunden, für die Nachrichten, die nicht als gültige Antworten identifiziert werden können, festgehalten werden, bevor sie an das unbekannte Terminal weitergegeben werden.

Der Standardwert ist null; wenn Sie diesen Standardwert übernehmen, wird das Zeitlimit inaktiviert, und unbekannte Nachrichten werden bei Empfang an das Unbekannt-Terminal weitergegeben.

z/OS platformWenn unter z/OS die Eigenschaft 'Zeitlimit bei unbekannten Nachrichten' nicht auf null gesetzt ist, muss der WS-Manager-Parameter EXPRYINT auf 5 gesetzt werden.

 
Transaktionsmodus Ja Nein Ausgewählt Diese Eigenschaft definiert die Transaktionsmerkmale dieser Nachricht:
  • Wenn Sie das Kontrollkästchen aktivieren (Standardeinstellung), unterliegt der nachfolgende Nachrichtenfluss der Transaktionssteuerung. Diese Einstellung gilt für Nachrichten, die aus der Ausgabenachricht abgeleitet und von einem MQOutput-Knoten produziert werden, es sei denn, der MQOutput-Knoten überschreibt explizit den Transaktionsstatus. Kein anderer Knoten kann die transaktionsorientierten Merkmale der Ausgabenachricht ändern.
  • Wenn Sie das Kontrollkästchen aktivieren, unterliegt der nachfolgende Nachrichtenfluss nicht der Transaktionssteuerung. Diese Einstellung gilt für Nachrichten, die aus der Ausgabenachricht abgeleitet und von einem MQOutput-Knoten produziert werden, es sei denn, der MQOutput-Knoten gibt an, dass die Nachricht unter Synchronisationspunktsteuerung gestellt werden muss.
 
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 | ac04750_