Knoten für Aggregationsantworten (AggregateReply)

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem Knoten für Aggregationsantworten wird Endpunkt einer Aggregation gesammelter Antwortnachrichten markiert. Dieser Knoten sammelt Antworten und fasst sie zu einer Verbundnachricht zusammen.

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:

  1. Der Knoten zur Aggregationssteuerung markiert den Ausgangspunkt für die Verteilung von Anforderungen, die Teil einer Aggregation sind. Er sendet eine Steuernachricht, mit der der Knoten für Aggregationsantworten 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 Knoten zur Aggregationssteuerung zu der Nachrichtenumgebung hinzugefügt wurden, dürfen nicht geändert werden.
  2. Der Knoten für Aggregationsanforderungen (AggregateRequest) verzeichnet die Tatsache, dass die Anforderungsnachrichten gesendet wurden. Darüber hinaus sammelt er Informationen, auf deren Grundlage der Knoten für Aggregationsantworten die zusammengefasste Antwortnachricht erstellt.Die Informationen, die durch den Knoten für Aggregationsanforderungen zu der Nachrichtenumgebung hinzugefügt wurden, müssen übernommen werden, da die Aggregation sonst fehlschlägt.
  3. Der Knoten für Aggregationsantworten markiert den Endpunkt einer Aggregation gesammelter Antwortnachrichten. Er sammelt Antworten und fasst sie zu einer aggregierten Antwortnachricht zusammen.

Der Knoten für Aggregationsantworten wird in der Workbench durch folgendes Symbol dargestellt:

Symbol des Knotens für Aggregationsantworten

Wenn eingehende Nachrichten vom Knoten für Aggregationsantworten 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 Knoten für Aggregationsantworten empfangen wird, bearbeiten die Terminals 'Timeout' bzw. 'Unknown' die Antworten, die bereits empfangen wurden.

Diesen Knoten in einem Nachrichtenfluss verwenden

Die nachfolgenden Beispiele erläutern die Verwendung dieses Knotens:

Knoten für Aggregationsantworten konfigurieren

Wenn Sie eine Instanz des Knotens für Aggregationsantworten in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die grundlegenden Eigenschaften des Knotens angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind dort mit einem Sternchen gekennzeichnet.

Konfigurieren Sie den Knoten für Aggregationsantworten wie folgt:

  1. Geben Sie einen Wert für den Aggregationsnamen ein. Mit diesem Namen wird der Sammelnachrichtenfluss dem Verteilernachrichtenfluss zugeordnet. Dieser Name muss im jeweiligen Kontext innerhalb eines Brokers eindeutig sein. Diese Eigenschaft ist obligatorisch; Sie müssen einen Wert eingeben.
  2. Geben Sie einen Wert für das Zeitlimit bei unbekannten Nachrichten ein. Dieser Wert wird in Sekunden angegeben. Er gibt die Dauer an, für die Nachrichten, die nicht als gültige Antworten identifiziert werden können, festgehalten werden, bevor sie an das unbekannte Terminal weitergegeben werden.

    Wenn Sie den Wert 0 oder gar keinen Wert eingeben, wird das Zeitlimit inaktiviert, und unbekannte Nachrichten werden bei Empfang an das unbekannte Terminal weitergegeben.

  3. Wählen Sie die Option Transaktionsmodus, um die transaktionsorientierten Merkmale dieser Nachricht festzulegen:
    • Wenn Sie das Markierungsfeld aktivieren, wird der nachfolgende Nachrichtenfluss unter Transaktionssteuerung gestellt. Dies gilt für Nachrichten, die aus der Ausgabenachricht und der Ausgabe eines MQSendeknotens abgeleitet wurden, es sei denn, der MQSendeknoten überschreibt den Transaktionsstatus explizit. Dies ist die Standardeinstellung. (Kein anderer Knoten kann die transaktionsorientierten Merkmale der Ausgabenachricht ändern.)
    • Wenn Sie das Markierungsfeld aktivieren, wird der nachfolgende Nachrichtenfluss nicht unter Transaktionssteuerung gestellt. Dies gilt für Nachrichten, die aus der Ausgabenachricht und der Ausgabe eines MQSendeknotens abgeleitet wurden, ausgenommen, der MQSendeknoten gibt an, dass die Nachricht unter Synchronisationspunktsteuerung gestellt werden soll.
  4. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Beschreibung' aus, um ein kurze und/oder ausführliche Beschreibung einzugeben.
  5. Klicken Sie auf Übernehmen, um die Änderungen am Knoten für Aggregationsantworten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen.

    Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des Knotens für Aggregationsantworten beschrieben.

Terminal Beschreibung
Steuerterminal Das Eingabeterminal, das Steuernachricht annimmt, die von einem entsprechenden Knoten zur Aggregationssteuerung gesendet wurden.
Anmerkung: Das Steuerterminal wird in Version 6.0 nicht weiter unterstützt; Informationen zum Verwenden 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.
Ausgangsterminal 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 Knoten zur Aggregationssteuerung 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 der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).

In der nachfolgenden Tabelle werden die grundlegenden Eigenschaften des Knotens für Aggregationsantworten beschrieben.

Eigenschaft M C Standard Beschreibung
Aggregationsname Ja Ja   Mit diesem Namen kann der Sammelnachrichtenfluss dem Verteilernachrichtenfluss zugeordnet werden. Diese Eigenschaft muss angegeben werden.
Zeitlimit bei unbekannten Nachrichten Nein Nein 0 Die Dauer, für die Nachrichten, die nicht als gültige Antworten identifiziert werden können, festgehalten werden, bevor sie an das unbekannte Terminal weitergegeben werden.
Transaktionsmodus Ja Nein Ausgewählt Gibt an, ob die von diesem Knoten übergebenen Nachrichten transaktionsorientiert eingereiht werden. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Anmerkung: 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.

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Knotens für Aggregationsantworten beschrieben.

Eigenschaft M C Standard Beschreibung
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac04750_