Throw-Knoten

Mit dem Throw-Knoten geben Sie innerhalb eines Nachrichtenflusses eine Ausnahmebedingung aus.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Eine Ausnahme kann von folgenden Elementen erkannt und verarbeitet werden:

  • Einem vorangestellten TryCatch-Knoten
  • Dem Empfangsknoten des Nachrichtenflusses (die integrierten Knoten, z. B. HTTPInput- und MQInputknoten, verfügen über Catch-Terminals)
  • Einem vorangestellten AggregateReply-Knoten

Mit dem Throw-Knoten kann ein Fehlerpfad durch den Nachrichtenfluss erzwungen werden, falls die Nachricht unerwartete Daten enthält. Um beispielsweise eine Nachricht zurückzusetzen, die ein bestimmtes Feld nicht enthält, können Sie überprüfen (mit einem Filter-Knoten), ob das Feld vorhanden ist. Ist es nicht vorhanden, kann die Nachricht an einen Throw-Knoten übergeben werden, der Details zu der Ausnahme in der untergeordneten ExceptionList-Baumstruktur (Ausnahmeliste) in der Nachricht protokolliert.

Der Throw-Knoten befindet sich im Ablagefach Aufbau der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Ausnahmeknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Die folgenden Beispielprogramme verdeutlichen die Verwendung dieses Knotens: Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

Schließen Sie einen Throw-Knoten zusammen mit einem TryCatch-Knoten in Ihren Nachrichtenfluss ein, damit der Systemadministrator über eine mögliche Fehlersituation benachrichtigt wird. Wenn beispielsweise ein Compute-Knoten eine Zahl berechnet, können Sie das Ergebnis prüfen und eine Ausnahmebedingung auslösen, wenn eine bestimmte Summe überschritten wird. Der TryCatch-Knoten fängt diese Ausnahme ab und gibt die Nachricht an eine Folge von Knoten weiter, die den Fehler verarbeiten.

Throw-Knoten konfigurieren

Nachdem Sie eine Instanz des Throw-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn 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.

Konfigurieren Sie den Throw-Knoten folgendermaßen:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellungen:
    1. Geben Sie unter Nachrichtenkatalog den vollständig qualifizierten Pfad und Dateinamen des Nachrichtenkatalogs an, der die Nachrichtenquelle enthält. Bei dieser Datei kann es sich um Ihren eigenen Nachrichtenkatalog oder den mit WebSphere Message Broker gelieferten Standardnachrichtenkatalog handeln. Wenn Sie diesen Standardkatalog verwenden möchten, lassen Sie die Eigenschaft leer.
    2. Geben Sie unter Nachrichtennummer die Fehlernummer der ausgelösten Ausnahmebedingung an.
      • Wenn Sie Ihren eigenen Nachrichtenkatalog erstellt haben, geben Sie die Nummer für die Nachricht in den Katalog ein, die verwendet werden soll, wenn diese Ausnahme ausgelöst wird.
      • Wenn Sie den Standardnachrichtenkatalog verwenden, geben Sie eine Zahl zwischen 3001 und 3049 an. Diese Zahlen werden im WebSphere Message Broker-Katalog für Sie reserviert. Der Text der Nachrichten im Standardnachrichtenkatalog ist identisch. Sie können jedoch jeweils eine andere Zahl aus diesem Bereich für Situationen verwenden, in der Sie eine Ausnahmebedingung auslösen. Mit Hilfe der Zahl können Sie den genauen Grund für den Fehler identifizieren.

      Die standardmäßige Nachrichtennummer lautet 3001.

    3. Geben Sie unter Nachrichtentext zusätzlichen Text mit freiem Format ein, der in die Nachricht aufgenommen werden soll. Wenn Sie beispielsweise die Existenz eines bestimmten Feldes in einer Nachricht überprüft und eine Ausnahmebedingung ausgelöst haben, wenn das Feld nicht gefunden wurde, können Sie folgenden Text einschließen:
      Erforderliches Feld ist nicht in Nachricht enthalten: Zweignummer
      Wenn Sie den Standardnachrichtenkatalog verwenden, wird dieser Text als &1 in den Nachrichtentext eingefügt.

Terminals und Eigenschaften

In der nachfolgenden Tabelle wird das Terminal des Throw-Knotens beschrieben.

Terminal Beschreibung
Eingangsterminal Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt

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 Throw-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp 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

In der folgenden Tabelle werden die grundlegenden Eigenschaften des Throw-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtenkatalog Nein Nein   Der Name des Nachrichtenkatalogs, aus dem der Fehlertext für die Fehlernummer der Ausnahme extrahiert wird. Der Standardwert (leer) zeigt an, dass die Nachricht aus dem mit WebSphere Message Broker gelieferten Nachrichtenkatalog stammt.
Nachrichtennummer Nein Nein 3001 Die Fehlernummer der ausgelösten Ausnahmebedingung.
Nachrichtentext Nein Nein   Zusätzlicher Text zur Erläuterung der Fehlerursache.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac04830_