Dieses Kapitel enthält folgende Abschnitte:
Mit dem Traceknoten können Sie Tracesätze generieren, 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 der Benutzertraceverarbeitung für den Nachrichtenfluss ab, in dem er sich befindet. Der Traceknoten schreibt auch dann Sätze in das Benutzertraceprotokoll, wenn der 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:
Die Aufname eines Traceknotens erleichtert die Fehlerdiagnose im Nachrichtenfluss. 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 standardmäßige Nachrichtennummer lautet 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 eingesetzten Nachrichtenfluss geschrieben.
Der Benutzertrace wird in das Unterverzeichnis \log des Stammverzeichnisses geschrieben (das Stammverzeichnis unter Windows 2000 lautet beispielsweise 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 vor der Anzeige des Benutzertraceprotokolls 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 die Trace angeben. Wenn Sie den Pfad nicht angeben, richtet sich der Standort der Datei nach dem jeweiligen System. Unter z/OS wird die Datei beispielsweise im Ausgangsverzeichnis der Broker-Service-ID erstellt.
Für die Tracedatei kann jeder beliebige Name verwendet werden. Beispiel: c:\$user\trace\trace.log.
Wenn Sie den Namen einer noch nicht vorhandenen Datei angeben, wird diese für 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)}
Der daraus resultierende Tracesatz lautet wie folgt:
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, eingesetzt 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 | Standard | Beschreibung |
---|---|---|---|---|
Zieladresse | Ja | Nein | Benutzertrace | Die 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. Diese Option ist nur gültig, wenn die Zieladresse auf Datei geschrieben wurde. | |
Muster | Nein | Nein | Die in den Tracesatz aufzunehmenden Daten. | |
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 geschriebenen Nachricht. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Traceknotens 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 |