Mit dem Collector-Knoten können Sie Nachrichtensammlungen erstellen. Dabei gelten die im Knoten konfigurierten Regeln.
Dieses Thema enthält folgende Abschnitte:
Eine Nachrichtensammlung wird erstellt, sobald die erste Nachricht bei einem der dynamischen Eingabeterminals auf dem Collector-Knoten eingeht. Nachrichtensammlungen werden in einer WebSphere MQ-Warteschlange gespeichert.
Wenn die Bedingungen, die vom Ereignishandler für eine Nachrichtensammlung gesetzt wurden, erfüllt sind, ist die Nachrichtensammlung vollständig und kann weitergeleitet werden. Wenn Sie beispielsweise die Ereignishandler auf dem Collector-Knoten so eingestellt haben, dass diese auf den Empfang von 2 Nachrichten von den jeweiligen Eingabeterminals warten sollen, ist die Nachrichtensammlung vollständig, wenn jeweils 2 Nachrichten von den Terminals empfangen wurden. Wenn die nächste Nachricht beim Eingabeterminal eingeht, wird sie zu einer neuen Nachrichtensammlung hinzugefügt. Sie können für die Koordination der Weitergabe von Nachrichten zwischen einer Reihe von Möglichkeiten wählen. Sie können festlegen, dass die Nachrichtensammlung automatisch zur Verarbeitung weitergeleitet wird. Alternativ können Sie festlegen, dass die Nachrichtensammlungen beim Empfang einer Steuernachricht weitergeleitet wird.
Über eine Eigenschaft auf dem Collector-Knoten können Sie auch ein Verfallszeitlimit für Nachrichtensammlungen angeben, die nicht in einem angemessenen Zeitraum fertiggestellt werden. Die Verfallszeit beginnt, wenn die erste Nachricht zu einer Nachrichtensammlung hinzugefügt wird. Wenn das Zeitlimit abläuft und die Nachrichtensammlung nicht vollständig ist, wird die unvollständige Nachrichtensammlung an das Terminal Expire weitergeleitet. Legen Sie einen Wert für das Objektgruppenzeitlimit fest, um sicherzustellen, dass unvollständige Nachrichtensammlungen nicht endlos in einer Warteschlange gespeichert werden. Fügen Sie Ihrem Nachrichtenfluss die entsprechende Verarbeitung zur Handhabung von unvollständigen Nachrichtensammlungen hinzu.
Der Collector-Knoten befindet sich im Ablagefach Routing der Nachrichtenflussknotenpalette und wird in Workbench durch folgendes Symbol dargestellt:
Unter Beispielprogramm 'Collector Node' finden Sie ein Beispiel für die Verwendung dieses Knotens. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Der Collector-Knoten verfügt über ein statisches Eingabeterminal ('Control') sowie vier statische Ausgabeterminals (Out, Expire, Failure und Catch). Diese statischen Terminals sind immer im Knoten vorhanden. Zusätzlich zu den statischen Eingabe- und Ausgabeterminals können Sie dynamische Eingabeterminals für jede Eingabequelle, die Sie mit dem Collector-Knoten verwenden möchten, hinzufügen.
Sie können beliebig viele Eingabeterminals zum Collector-Knoten hinzufügen und konfigurieren. Sie können die Eigenschaften eines jeden Eingabeterminals separat konfigurieren, um das Hinzufügen der an den jeweiligen Eingabeterminals empfangenen Nachrichten zur entsprechenden Nachrichtensammlung zu steuern.
Über das Terminal Control können Sie die Ausgabe abgeschlossener Nachrichtensammlungen vom Collector-Knoten auslösen. Konfigurieren Sie die Eigenschaft Ereigniskoordination, und legen Sie damit das Verhalten des Collector-Knotens fest, wenn Nachrichten am Terminal Control empfangen werden.
Eine erfolgreich abgeschlossene Nachrichtensammlung kann an das Ausgangsterminal (Out) weitergegeben werden. Ist für die Eigenschaft Objektgruppenablauf ein Wert größer null angegeben, werden alle unvollständigen Nachrichtensammlungen an das Terminal Expire weitergegeben.
Eine neue Transaktion wird erstellt, wenn eine Nachrichtensammlung vollständig ist und an den nächsten Knoten weitergegeben wird. Wenn Ausnahmebedingungen von nachgeordneten Knoten abgefangen werden, wird die Nachrichtensammlung zusammen mit einer Ausnahmeliste an das Terminal Catch auf dem Collector-Knoten geleitet. Wenn das Catch-Terminal nicht an andere Knoten angeschlossen ist, wird die Transaktion zurückgesetzt. Nachrichten in der Nachrichtensammlung werden in der Warteschlange des Collector-Knotens zurückgesetzt. Die Ausnahmeliste wird in das Systemprotokoll geschrieben. Dieser Schritt wird wiederholt bis die Nachrichtensammlung erfolgreich verarbeitet wurde. Um zu vermeiden, dass die Weiterleitung einer Nachrichtensammlung aufgrund einer Ausnahmebedingung fehlschlägt, müssen Sie sicherstellen, dass Sie das Terminal Catch zur Handhabung von Ausnahmebedingungen mit einem Fluss verbinden. Zudem müssen Sie sicherstellen, dass Sie ein Verfallszeitlimit für die Weitergabe von unvollständigen Nachrichtensammlungen definieren.
Nachdem Sie eine Instanz des Collector-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 Sternchen gekennzeichnet.
Im Folgenden wird die Konfiguration des Collector-Knotens beschrieben:
Wenn das Korrelationsmuster leer ist, muss der gesamte Text des Korrelationspfads von der eingehenden Nachricht abgeglichen werden.
Wenn Sie weitere Instanzen eines Nachrichtenflusses oder mehrere Eingaben in den Collector-Knoten verwenden, können Sie mit den Eigenschaften Korrelationspfad und Korrelationsmuster sicherstellen, dass zusammengehörige Nachrichten der gleichen Nachrichtensammlung hinzugefügt werden. Bei weiteren Instanzen oder mehreren Eingaben in den Collector-Knoten ist die Reihenfolge der Nachrichten in der Nachrichtensammlung unvorhersehbar. Dies gilt auch, wenn Sie WebSphere MQ-Clusterwarteschlangen als Eingaben in den Collector-Knoten verwenden.
In der folgenden Tabelle werden die Terminals des Collector-Knotens beschrieben.
| Terminal | Beschreibung |
|---|---|
| Control | Das statische Eingangsterminal, das Steuernachrichten annimmt. Alle Nachrichten, die vom Terminal 'Control' empfangen werden, werden als Steuernachrichten behandelt. |
| Out | Das Ausgabeterminal, an das die vollständige Nachrichtensammlung weitergeleitet wird, wenn die empfangenen Nachrichten die konfigurierten Bedingungen für die Nachrichtensammlung erfüllen. |
| Expire | Das Ausgabeterminal, an das die unvollständige Nachrichtensammlung weitergeleitet wird, wenn die empfangenen Nachrichten die konfigurierten Bedingungen innerhalb des für die Eigenschaft 'Objektgruppenablauf' angegebenen Zeitraumes nicht erfüllen. Wenn Sie keinen Wert für die Eigenschaft 'Objektgruppenablauf' angegeben haben, wird dieses Terminal nicht verwendet. |
| Failure | Das Ausgabeterminal, an das die Nachrichtensammlung geleitet wird, wenn während der Verarbeitung ein Fehler auftritt. |
| Catch | Das Ausgabeterminal, an das die Nachrichtensammlung geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten aufgefangen wurde. |
Der Collector-Knoten kann über weitere dynamische Eingabeterminals verfügen.
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C 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 Collector-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Der Knotentyp, Collector | 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. |
Der Collector-Knoten weist zwei Arten von Basiseigenschaften auf. Sie können in der Tabelle 'Definition der Objektgruppe' in den Grundeinstellungen Eigenschaften für die jeweiligen Eingabeterminals, die Sie zum Collector-Knoten hinzugefügt haben, festlegen. Mit den Eigenschaften in der Tabelle 'Definition der Objektgruppe' werden die Ereignishandler für Nachrichten definiert, die bei den einzelnen Eingabeterminals eingehen. In der nachfolgenden Tabelle werden die Eigenschaften erläutert, die Sie für die jeweiligen dynamischen Eingabeterminals einrichten können.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Terminal | Ja | Nein | Der Terminalname | Dies ist keine Eigenschaft des Knotens, sondern eine Bezeichnung zur Angabe des Namens des dynamischen Eingabeterminals. |
| Quantity | Ja | Nein | 1 | Gibt die Anzahl der Nachrichten an, die das Eingabeterminal zum Hinzufügen zu einer Nachrichtensammlung akzeptiert. Wenn Sie null auswählen oder keinen Wert für diese Eigenschaft angeben, ist die Anzahl der akzeptierten Namen nicht beschränkt. In diesem Fall muss der Wert für die Eigenschaft Zeitlimit größer als null sein. |
| Zeitlimit | Ja | Nein | Gibt die maximale Zeit in Sekunden an, die das Eingabeterminal auf Nachrichten wartet. Wenn Sie null auswählen oder keinen Wert für diese Eigenschaft angeben, ist die Wartezeit für den Empfang von Nachrichten nicht beschränkt. In diesem Fall muss der Wert für die Eigenschaft Menge größer als null sein. | |
| Korrelationspfad | Nein | Nein | Mit dieser Eigenschaft wird der Pfad in der eingehenden Nachricht angegeben, aus dem ein Wert für die Korrelationszeichenfolge extrahiert werden soll. Nachrichten werden anhand des Wertes aus dem Korrelationspfad gruppiert. Der Korrelationspfad wird unter Verwendung von XPath definiert. Definieren Sie einen eigenen Korrelationspfad unter Verwendung von XPath, oder wählen Sie einen Pfad aus den vordefinierten Pfaden aus:
|
|
| Korrelationsmuster | Nein | Nein | Diese Eigenschaft gibt ein Muster an, mit dem die Inhalte eines Wertes für den Korrelationspfad abgeglichen werden. Sie müssen die Eigenschaft Korrelationspfad setzen, bevor Sie die Eigenschaft Korrelationsmuster verwenden. Wenn Sie das Korrelationsmuster definieren, müssen Sie einen Stern * verwenden, dem optional weiterer Text hinzugefügt werden kann. Beispiel: *.dat. |
In der nachfolgenden Tabelle werden die Basiseigenschaften des Collector-Knotens gezeigt:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Objektgruppenname | Nein | Nein | Diese Eigenschaft gibt den Namen der Nachrichtensammlung an.
|
|
| Objektgruppenablauf | Nein | Ja | 0 | Zeit in Sekunden, die der Collector-Knoten auf den Eingang von Nachrichten wartet. Nach Ablauf dieser Zeitspanne läuft eine unvollständige Nachricht ab und wird an das Ausgabeterminal 'Expire' geleitet. Wenn diese Eigenschaft nicht definiert ist, wird eine Warnung ausgegeben. |
| Ereigniskoordination | Ja | Nein | Disabled (Inaktiviert) | Diese Eigenschaft gibt an, wie am Terminal 'Control' empfangene Nachrichten zur Ereigniskoordinationsverarbeitung im Collector-Knoten gehandhabt werden.
|