Collector-Knoten

Mit dem Collector-Knoten können Sie Nachrichtensammlungen erstellen. Dabei gelten die im Knoten konfigurierten Regeln.

Dieses Thema enthält folgende Abschnitte:

Zweck

Mit dem Collector-Knoten können Sie eine Nachrichtensammlung aus einer oder mehreren Quellen auf Basis von konfigurierbaren Kriterien erstellen. Beispielsweise müssen Sie Informationen aus drei verschiedenen Quellen extrahieren, kombinieren und umsetzen. Die Nachrichten aus den verschiedenen Quellen werden zu unterschiedlichen Zeiten und in unbekannter Reihenfolge an den Eingabeterminals empfangen. Datensammlungen werden durch Konfiguration eines Ereignishandlers für die einzelnen Eingabeterminals definiert. Jeder Ereignishandler steuert die Annahme einer Nachricht in einer Datensammlung unter Berücksichtigung der folgenden Eigenschaften:
  • Anzahl der Nachrichten
  • Nachrichten für einen festgelegten Zeitraum erfassen
  • Inhalte eines Korrelationspfads abgleichen
  • Inhalte mit einem Korrelationsmuster abgleichen
Mit Hilfe der Korrelationseigenschaften können Datensammlungen entsprechend dem Inhalt der Nachrichten erstellt werden. Der Inhalt wird unter Verwendung eines XPath-Ausdrucks angegeben. Der Collector-Knoten sorgt dafür, dass jede Datensammlung eingabeübergreifend eine identische Korrelationszeichenfolge enthält. Weitere Informationen zur Abfragesyntax von XPath 1.0 finden Sie im Abschnitt XPath.

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:

Symbol für Collector-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

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.

Mit dem Collector-Knoten können Sie Nachrichten aus unterschiedlichen Quellen in Nachrichtensammlungen auf Basis einer oder mehrerer der folgenden Regeln gruppieren. Eine Nachrichtensammlung kann nur von folgenden Knoten verarbeitet werden:
  • Compute
  • JavaCompute
Wenn Sie versuchen, eine Nachrichtensammlung mit einem Knoten zu verarbeiten, der keine Nachrichtensammlungen unterstützt, werden möglicherweise Fehler generiert.

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.

Collector-Knoten konfigurieren

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:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Auf dieser Registerkarte können Sie auch den Namen des Knotens ändern.
  2. Auf der Registerkarte Grundeinstellung:
    1. Geben Sie in der Tabelle 'Definition der Objektgruppe' für jedes dynamische Eingabeterminal, das Sie zum Collector-Knoten hinzugefügt haben, Werte für die Ereignishandlereigenschaften ein.
      1. Geben Sie einen Wert für Menge ein. Mit diesem Wert wird die Anzahl der Nachrichten angegeben, die dieses Eingabeterminal akzeptiert und zu einer Sammlung hinzufügt. Der Standardwert ist 1; wenn Sie diesen Standardwert akzeptieren, wird nur eine Nachricht zu einer Sammlung hinzugefügt. Wenn eine zweite Nachricht vom Terminal empfangen wird, wird eine neue Sammlungsinstanz erstellt. 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. Diese Eigenschaft ist obligatorisch; Sie müssen einen Wert eingeben.
      2. Geben Sie für Zeitlimit einen Wert in Sekunden ein. Dieser Wert gibt die Zeit in Sekunden an, die dieses Eingabeterminal auf den Eingang von Nachrichten maximal wartet. Wenn Sie den Standardwert null akzeptieren, ist das Zeitlimit inaktiviert, und die Wartezeit für den Empfang von Nachrichten ist nicht beschränkt. In diesem Fall muss der Wert für die Eigenschaft Menge größer als null sein. Diese Eigenschaft ist obligatorisch; Sie müssen einen Wert eingeben.
      3. Geben Sie einen Wert für den Korrelationspfad an. Mit dieser Eigenschaft wird der Pfad in der eingehenden Nachricht angegeben, aus dem ein Wert für die Korrelationszeichenfolge extrahiert werden soll. Es werden nur Nachrichten in eine Nachrichtensammlung aufgenommen, die über dieselbe Korrelationszeichenfolge verfügen. Wenn die Nachricht eine andere Korrelationszeichenfolge aufweist, wird sie der nächsten Sammlung in der Warteschlange angeboten. Wenn die Nachricht von keiner der vorhandenen Sammlungen akzeptiert wird, wird eine neue Sammlung mit der Korrelationszeichenfolge der Nachricht erstellt.

        Nachrichten werden anhand des Wertes aus dem Korrelationspfad gruppiert. Definieren Sie einen eigenen Korrelationspfad unter Verwendung von XPath, oder wählen Sie einen Pfad aus den vordefinierten Pfaden aus. Wenn Sie einen Wert für Korrelationspfad auswählen, können Sie optional ein Korrelationsmuster konfigurieren.
      4. Geben Sie einen Wert für das Korrelationsmuster an. Dieser Wert wird verwendet, um ein Muster anzugeben, mit dem die Inhalte eines Wertes für den Korrelationspfad abgeglichen werden. Sie müssen die Eigenschaft Korrelationspfad setzen, bevor Sie einen Wert für Korrelationsmuster festlegen. Wenn Sie das Korrelationsmuster definieren, müssen Sie (maximal) einen Stern * verwenden, dem optional weiterer Text hinzugefügt werden kann. Beispiel: *.dat.

        Wenn das Korrelationsmuster leer ist, muss der gesamte Text des Korrelationspfads von der eingehenden Nachricht abgeglichen werden.

    2. Geben Sie einen Wert für Korrelationsname an. Mit diesem Wert wird der Name der Nachrichtensammlung angegeben. Wenn die Eigenschaft das Platzhalterzeichen * enthält, wird das Platzhalterzeichen durch die Korrelationszeichenfolge aus dem entsprechenden Ereignishandler ersetzt. Wenn Sie diese Eigenschaft leer lassen oder * eingeben und kein Wert für die Korrelationszeichenfolge angegeben ist, enthält der Objektgruppenname eine leere Zeichenfolge.
    3. Geben Sie für Objektgruppenablauf einen Wert in Sekunden ein. Dieser Wert gibt die Zeit in Sekunden an, die der Collector-Knoten auf den Eingang von Nachrichten wartet. Nach Ablauf dieser Zeitspanne läuft eine unvollständige Nachrichtensammlung ab und wird an das Ausgabeterminal 'Expire' geleitet. Der Standardwert ist null. Wenn Sie diesen Wert übernehmen, wird der Objektgruppenablauf inaktiviert, und der Collector-Knoten wartet unbegrenzte Zeit auf Nachrichten. Legen Sie einen Wert größer als null fest, um sicherzustellen, dass die Nachrichtensammlung auch dann verarbeitet werden kann, wenn nicht alle Nachrichten empfangen werden. Wenn diese Eigenschaft nicht definiert ist, wird eine Warnung ausgegeben.
  3. Auf der Registerkarte Erweitert:
    1. Geben Sie einen Wert für Ereigniskoordination an. Mit diesem Wert wird angegeben, wie Nachrichten aus dem Eingabeterminal 'Control' für die Ereigniskoordinationsverarbeitung im Collector-Knoten gehandhabt werden. Der Standardwert ist Inaktiviert; wenn Sie diesen Standardwert akzeptieren, werden Nachrichten an das Terminal 'Control' ignoriert, und Objektgruppen werden weitergeleitet, wenn sie vollständig sind. Wenn Sie Alle vollständigen Objektgruppen auswählen, werden vollständige Nachrichtensammlungen in eine WebSphere MQ-Warteschlange eingereiht. Wenn eine Nachricht am Terminal 'Control' empfangen wird, werden alle vollständigen Nachrichtensammlungen in der WebSphere MQ-Warteschlange an das Terminal 'Out' weitergeleitet. Wenn Sie Erste vollständige Objektgruppe auswählen, werden vollständige Nachrichtensammlungen in eine WebSphere MQ-Warteschlange eingereiht. Wenn eine Nachricht am Terminal 'Control' empfangen wird, wird die erste vollständige Nachrichtensammlung in der WebSphere MQ-Warteschlange an das Terminal 'Out' weitergeleitet. Die Objektgruppen werden in der Reihenfolge, in der sie komplettiert werden, weitergeleitet. Wenn die WebSphere MQ-Nachrichtenschlange beim Empfang einer Nachricht am Terminal 'Control' leer ist, wird die Nachrichtensammlung, die als nächstes vollständig ist, sofort an das Terminal 'Out' weitergeleitet. Diese Eigenschaft muss angegeben werden.
    2. Geben Sie einen Wert für den Permanenzmodus ein. Mit diesem Wert wird angegeben, ob Nachrichten permanent in den Warteschlangen des Collector-Knotens gespeichert 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.

Terminals und Eigenschaften

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:
  • $Root/Properties/WildcardMatch
  • $Root/MQMD/CorrelID
  • $LocalEnvironment/FileInput/Name
  • $Root/JMSTransport/Transport_Folders/Header_Values/JMSCorrelationID
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.
  • Wenn die Eigenschaft das Platzhalterzeichen * enthält, wird das Platzhalterzeichen durch die Korrelationszeichenfolge aus dem entsprechenden Ereignishandler ersetzt.
  • Wenn Sie diese Eigenschaft leer lassen oder * eingeben und kein Wert für die Korrelationszeichenfolge angegeben ist, enthält der Objektgruppenname eine leere Zeichenfolge.
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.
  • Wenn Sie Disabled (Inaktiviert) auswählen, werden Nachrichten an das Terminal 'Control' ignoriert, und Objektgruppen werden weitergeleitet, wenn sie vollständig sind.
  • Wenn Sie Alle vollständigen Objektgruppen auswählen, werden vollständige Nachrichtensammlungen in eine WebSphere MQ-Warteschlange eingereiht. Wenn eine Nachricht am Terminal 'Control' empfangen wird, werden alle Nachrichtensammlungen in der WebSphere MQ-Warteschlange an das Terminal 'Out' weitergeleitet.
  • Wenn Sie Erste vollständige Objektgruppe auswählen, werden vollständige Nachrichtensammlungen in eine WebSphere MQ-Warteschlange eingereiht. Wenn eine Nachricht am Terminal 'Control' empfangen wird, wird die erste Nachrichtensammlung in der WebSphere MQ-Warteschlange an das Terminal 'Out' weitergeleitet. Wenn die WebSphere MQ-Nachrichtenschlange bei Empfang einer Nachricht am Terminal 'Control' leer ist, wird die Nachrichtensammlung, die als nächstes vollständig ist, sofort an das Terminal 'Out' weitergeleitet.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac37820_