Dieses Kapitel enthält folgende Abschnitte:
Mit dem Traceknoten erstellen Sie Tracesätze, die Text, Nachrichteninhalt sowie Datums- und Zeitangaben enthalten und damit die Überwachung des Nachrichtenflussablaufs ermöglichen.
Sie können die Sätze in die Benutzertracedatei, eine andere Datei oder in das lokale Fehlerprotokoll schreiben (welches Fehlermeldungen und Informationsnachrichten enthält, die von allen anderen WebSphere Message Broker-Knoten geschrieben wurden). Wenn Sie Traces in das lokale Fehlerprotokoll schreiben, können Sie eine Nachricht aus dem Standardnachrichtenkatalog ausgeben, der zum Lieferumfang von WebSphere Message Broker gehört, oder einen eigenen Nachrichtenkatalog erstellen.
Der Betrieb des Traceknotens hängt nicht von den Einstellungen des Benutzertracings für den Nachrichtenfluss ab, in dem er sich befindet. Der Traceknoten schreibt auch dann Sätze in das Benutzertraceprotokoll, wenn die Benutzertrace gerade nicht für den Nachrichtenfluss aktiviert ist.
Der Traceknoten wird in der Workbench durch folgendes Symbol dargestellt:
Die nachfolgenden Beispiele erläutern die Verwendung dieses Knotens:
Schließen Sie einen Traceknoten mit ein, um Fehler im Nachrichtenfluss zu diagnostizieren. Durch die Verfolgung des Nachrichteninhalts an verschiedenen Stellen im Nachrichtenfluss können Sie die Verarbeitungsreihenfolge bestimmen. Sie können den Traceknoten auch so konfigurieren, dass der Nachrichteninhalt aufgezeichnet und die Aktion eines bestimmten Knotens in der Nachricht geprüft wird. Sie können beispielsweise einen Traceknoten unmittelbar nach einem Rechenknoten einschließen, um zu prüfen, ob die Ausgabenachricht das erwartete Format hat.
Entfernen Sie die Traceknoten aus dem Nachrichtenfluss, nachdem Sie ihn auf seinen ordnungsgemäßen Betrieb überprüft haben.
Mit dem Traceknoten können Sie auch Informationen zur Fehlerbehandlung in Ihren Nachrichtenflüssen bereitstellen. So können Sie beispielsweise mit diesem Knoten Störungen bei der Verarbeitung auf Grund von fehlerhaftem Nachrichteninhalt oder Nachrichtenformat protokollieren.
Wenn Sie eine Instanz des Traceknotens in einen Nachrichtenfluss gestellt haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die grundlegenden Eigenschaften des Knotens angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind dort mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den Traceknoten wie folgt:
Die Informationen, die Sie in den Tracesatz einschließen, werden in folgende Ziele geschrieben:
Wenn Sie diese Option auswählen, müssen Sie die Nummer der Tracenachricht, die geschrieben werden soll, und den Nachrichtenkatalog, in dem die Nachricht definiert ist, angeben.
Sie müssen auch die Fehlernummer des Satzes unter Nachrichtennummer eingeben. Dazu sind sind im (Standard)Katalog von WebSphere Message Broker die Zahlen 3051 bis 3099 reserviert. Der Text der Nachrichten im Standardnachrichtenkatalog ist identisch. Wenn Sie jedoch jeweils eine andere Zahl aus diesem Bereich für Situationen verwenden, in denen Sie die Tracefunktion ausführen, können Sie den genauen Grund für den Fehler identifizieren.Die Standardnachrichtennummer ist 3051.
Zudem müssen Sie unter Nachrichtennummer die entsprechende Nummer für die Nachricht in den Katalog eingeben, die in das lokale Fehlerprotokoll geschrieben werden soll. Bei einigen Plattformen sind Nachrichten, die mit 00 enden, zur Verwendung durch das System reserviert. Nehmen Sie keine Nachrichten mit Zahlen wie 3100 in Ihren Nachrichtenkatalog auf.
Diese Sätze werden unabhängig von der Einstellung der Benutzertrace-Eigenschaft für den implementierten Nachrichtenfluss geschrieben.
Die Benutzertrace wird in der Unterverzeichnis \log des Stammverzeichnisses geschrieben (das Standardstammverzeichnis in Windows 2000 lautet z. B. c:\Programme\IBM\WebSphere Message Broker). Der Dateiname setzt sich aus dem Namen des Brokers, der Broker-UUID und dem Suffix userTrace.bin zusammen (z. B. broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0). Führen Sie, bevor Sie das Benutzertraceprotokoll anzeigen, die Befehle mqsireadlog und mqsiformatlog aus.
Wenn Sie diese Option auswählen, müssen Sie auch unter Dateipfad den vollständig qualifizierten Pfadnamen für den Trace angeben. Wenn Sie den Pfad nicht angeben, richtet sich der Standort der Datei nach dem jeweiligen System. In z/OS wird die Datei beispielsweise im Ausgangsverzeichnis der Broker-Service-ID erstellt.
Sie können der Tracedatei einen beliebigen Namen geben, beispielsweise c:\$user\trace\trace.log.
Wenn Sie eine Datei angeben, die noch nicht vorhanden ist, wird sie erstellt. Verzeichnisse werden jedoch nicht erstellt, daher muss der vollständige Pfad bereits vorhanden sein.
Das nachfolgende Muster zeigt einige der verfügbaren Optionen. Es schreibt eine erste Textzeile, protokolliert zwei Elemente der aktuellen Nachricht und fügt eine einfache Zeitmarke hinzu:
Nachricht mit folgenden Feldern übermittelt: Speichername ist ${Body.storedetailselement.storename} Gesamtsumme ist ${Body.totalselement.totalsales} Zeit: ${EXTRACT(HOUR FROM CURRENT_TIMESTAMP)} :${EXTRACT(MINUTE FROM CURRENT_TIMESTAMP)}
Daraus ergibt sich folgender Tracesatz:
Nachricht mit folgenden Feldern übermittelt: Speichername ist 'SRUCorporation' Gesamtsumme ist '34,98' Zeit: 11:19
Ein Muster mit Syntaxfehlern verhindert nicht, dass ein Nachrichtenfluss, der einen Traceknoten enthält, implementiert wird. Der Knoten schreibt allerdings keine Tracesätze.
Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.
In der nachfolgenden Tabelle werden die Terminals des Traceknotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Ausgangsterminal | Das Ausgabeterminal, über das die Nachricht weitergegeben 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 Basiseigenschaften des Traceknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Zieladresse | Ja | Nein | Benutzertrace | Zieladresse des vom Knoten geschriebenen Tracesatzes. Gültige Werte sind Benutzertrace, Datei, Lokales Fehlerprotokoll und Keine. |
Dateipfad | Nein | Ja | Vollständig qualifizierter Name der Datei, in die Tracesätze geschrieben werden. Nur gültig, wenn als Zieladresse die Option Datei ausgewählt wurde. | |
Muster | Nein | Nein | Die Daten, die in den Tracesatz eingeschlossen werden sollen. | |
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 mitgelieferten Nachrichtenkatalog stammt. | |
Nachrichtennummer | Nein | Nein | 3051 | Die Fehlernummer der Nachricht, die geschrieben wird. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Traceknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |