TryCatch-Knoten

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem TryCatch-Knoten stellen Sie eine besondere Steuerroutine für die Verarbeitung von Ausnahmebedingungen bereit. Ursprünglich wird die Eingabenachricht an das Try-Terminal dieses Knotens geleitet, das Sie mit den übrigen, nicht-fehlerverarbeitenden Knoten des Nachrichtenflusses verbinden müssen. Wenn ein nachgeschalteter Knoten (z. B. ein Ausnahmeknoten) 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.

Auf diese Weise stoppen Ausnahmebedingungen die Verarbeitung des Nachrichtenflusses und verhindern eine Auswirkung auf weitere ausgeführte Transaktionen. Wenn das Catch-Ausgabeterminal angeschlossen ist, wird die Nachricht dorthin weitergegeben. Wenn das Catch-Ausgabeterminal nicht angeschlossen ist, wird die Nachricht verworfen.

Der TryCatch-Knoten wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Versuchs-/Abfangknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Das folgende Beispielprogramm verdeutlicht die Verwendung dieses Knotens:

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

TryCatch-Knoten konfigurieren

Wenn Sie eine Instanz des Versuchs-/Abfangknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren.

Klicken Sie dazu in der Editoransicht mit der rechten Maustaste auf den Knoten, und klicken Sie auf Eigenschaften. Daraufhin werden die Beschreibungseigenschaften angezeigt.

Geben Sie eine kurze und/oder ausführliche Beschreibung ein.

Klicken Sie auf Übernehmen, um die Änderungen am Versuchs-/Abfangknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen, oder klicken Sie auf OK, um die Änderungen vorzunehmen 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.

Schließen Sie jetzt die Terminals des Knotens an, um seine Funktionsweise in diesem Nachrichtenfluss zu bestimmen.

Verbindungen zu Terminals herstellen

Der TryCatch-Knoten besitzt keine konfigurierbaren Eigenschaften, die sich auf diesen Vorgang auswirken. Sie legen den Ablauf fest, indem Sie die Ausgabeterminals an nachfolgende Knoten in Ihrem Nachrichtenfluss anschließen.

  1. Verbinden Sie das Try-Terminal mit dem ersten Knoten in der Knotenfolge, die die normale (fehlerlose) Verarbeitungsphase dieser Nachricht bereitstellt. Hierbei kann es sich um eine Folge aus einem oder mehreren Knoten handeln, die jede gültige Verarbeitung ausführen. Sie kann mit einem Sendeknoten enden, aber dies ist nicht zwingend erforderlich.
  2. Verbinden Sie das Catch-Terminal mit dem ersten Knoten in der Knotenfolge, die die Fehlerverarbeitung für diesen Nachrichtenfluss vornimmt. Hierbei kann es sich um eine Folge aus einem oder mehreren Knoten handeln, die jede gültige Verarbeitung ausführen. Sie kann mit einem Sendeknoten enden, aber dies ist nicht zwingend erforderlich.

    Wenn durch explizite Verwendung des Ausnahmeknotens oder durch die ESQL-Anweisung THROW oder dadurch, dass der Broker beim Feststellen eines Fehlers, den die Nachricht nicht bearbeiten kann, eine implizite Ausnahme auslöst, eine Ausnahmebedingung im Nachrichtenfluss ausgelöst wird, übernimmt der TryCatch-Knoten wieder die Kontrolle.

    Die Nachricht wird über das Catch-Terminal weitergegeben, und die von Ihnen entwickelte Fehlerbehandlung wird ausgeführt. Die Nachricht, die über dieses Terminal weitergegeben wird, hat denselben Inhalt wie an der Stelle, an der die Ausnahme ausgelöst wurde, einschließlich der vollständigen Beschreibung der Ausnahme in der Ausnahmeliste.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des TryCatch-Knotens beschrieben.

Terminal Beschreibung
Eingangsterminal Das Eingangsterminal, 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 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 Beschreibungseigenschaften des TryCatch-Knotens 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
ac04850_