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.

TryCatch-Knoten

Mit dem TryCatch-Knoten stellen Sie eine besondere Steuerroutine für die Verarbeitung von Ausnahmen bereit.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Ursprünglich wird die Eingabenachricht an das Try-Terminal weitergeleitet, das Sie mit den übrigen, nicht fehlerverarbeitenden Knoten des Nachrichtenflusses verbinden müssen. Wenn ein nachgeschalteter Knoten (z. B. ein Throw-Knoten) eine Ausnahmebedingung auslöst, wird sie vom TryCatch-Knoten abgefangen. Er leitet die Originalnachricht an das zugehörige Catch-Terminal weiter. Verbinden Sie das Catch-Terminal mit weiteren Knoten, um eine Fehlerverarbeitung der Nachricht nach einer Ausnahme zu ermöglichen. Wenn das Catch-Terminal angeschlossen ist, wird die Nachricht dorthin weitergegeben. Wenn das Catch-Terminal nicht angeschlossen ist, wird die Nachricht verworfen.

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

Symbol für TryCatch-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Das folgende Beispiel zeigt, wie dieser Knoten verwendet wird:

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.

Verwenden Sie den Throw-Knoten und den TryCatch-Knoten, wenn Sie mit dem Compute-Knoten eine Gesamtsumme berechnen. Sie können eine Nachricht erstellen, die an den Systemadministrator gesendet wird, wenn die berechnete Summe den Höchstwert für das Gesamtsummenfeld übersteigt.

Verbindungen zu Terminals herstellen

Der TryCatch-Knoten besitzt keine konfigurierbaren Eigenschaften, die sich auf diesen Vorgang auswirken. Sie legen seine Verarbeitung fest, indem Sie die Ausgabeterminals an nachfolgende Knoten im Nachrichtenfluss anschließen.

  1. Verbinden Sie das Try-Terminal mit dem ersten Knoten in der Knotenfolge, in der die normale (fehlerlose) Verarbeitungsphase dieser Nachricht bereitgestellt wird. Diese Folge kann aus einem oder mehreren Knoten bestehen, die jede gültige Verarbeitung ausführen. Die Knotenfolge kann optional mit einem Sendeknoten abschließen.
  2. Verbinden Sie das Catch-Terminal mit dem ersten Knoten in der Knotenfolge, in der die Fehlerverarbeitung für diesen Nachrichtenfluss stattfindet. Diese Folge kann aus einem oder mehreren Knoten bestehen, die jede gültige Verarbeitung ausführen. Die Knotenfolge kann optional mit einem Sendeknoten abschließen.

    Wenn durch explizite Verwendung des Throw-Knotens oder durch die ESQL-Anweisung THROW oder dadurch, dass der Broker eine implizite Ausnahme auslöst, wenn er einen Fehler feststellt, den die Nachricht nicht bearbeiten kann, eine Ausnahmebedingung im Nachrichtenfluss ausgelöst wird, übernimmt der TryCatch-Knoten wieder die Kontrolle.

    Der Knoten gibt die Nachricht an die Knotenfolge weiter, die mit dem Catch-Terminal verbunden ist (d. h. an den Abfangdatenfluss), und die von Ihnen festgelegte Fehlerbehandlung wird eingeleitet. Der Inhalt der weitergegebenen Nachrichtenbaumstruktur ist mit dem Inhalt identisch, der an das Try-Terminal weitergegeben wurde. Dabei handelt es sich um den Inhalt, den die Baumstruktur hatte, als sie zuerst vom TryCatch-Knoten empfangen wurde. Der Knoten erweitert die Nachrichtenbaumstruktur um die neuen Ausnahmeinformationen, die er in die Baumstruktur für Ausnahmelisten geschrieben hat. Änderungen oder Hinzufügungen, die die Knoten im Try-Datenfluss vorgenommen haben, sind in der Nachrichtenbaumstruktur, die an den Abfangdatenfluss übergeben wird, nicht enthalten.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des TryCatch-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

In der folgenden Tabelle werden die TryCatch-Knotenterminals beschrieben .

Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Catch-Terminal Das Ausgabeterminal, an das die Nachricht weitergegeben wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde.
Try-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie nicht abgefangen wird.

In der folgenden Tabelle 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 TryCatch-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Der Knotentyp: TryCatch 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
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:56


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac04850_