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 Kapitel enthält folgende Abschnitte:

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überhinaus 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 Workbench 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 einen Neustart überdauert.

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 Beispielprogramme verdeutlichen die Verwendung dieses Knotens: Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Brokers Toolkit integriert ist.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des AggregateReply-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste und anschließend auf Eigenschaften. 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.

Eingangsterminal Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt.
Fehlerterminal 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.
Ausgabeterminal Das Ausgabeterminal, an das die Verbundnachricht bei erfolgreicher Verarbeitung geleitet wird.
Zeitlimit 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
Aggregationsname Ja Ja   Über diesen Namen wird der Sammelnachrichtenfluss dem Verteilernachrichtenfluss zugeordnet. Dieser Wert muss im jeweiligen Kontext innerhalb eines Brokers eindeutig sein.
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 platform Wenn 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 ausgegeben 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 ausgegeben werden, es sei denn, der MQOutput-Knoten gibt an, dass die Nachricht unter Synchronisationspunktsteuerung gestellt werden soll.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:28:12

ac04750_