Befehl 'mqsireadlog'

Unterstützte Plattformen

Zweck

Mit dem Befehl mqsireadlog wird das Traceprotokoll für die angegebene Komponente abgerufen. Dieser Befehl wird für die folgenden Tracefunktionen verwendet:
Benutzertrace
Geben Sie die Option -u an.
Service-Trace
Geben Sie die Option -t an. Diese Option sollte nur angegeben werden, wenn Sie in einer BIPxxxx-Nachricht oder vom IBM Support Center dazu aufgefordert werden.

Sie können angeben, ob die Ausgabe in eine Datei oder in die Standardausgabe (stdout) übertragen werden soll. Die Tracesätze werden von diesem Befehl im XML-Format zurückgegeben und können mit einem XML-Browser angezeigt werden. Wenn Sie angeben, dass die Ausgabe in eine Datei übertragen werden soll, erhalten die Daten die Codierung utf-8. Die Datei ist daher plattformunabhängig und kann mit dem Befehl mqsiformatlog auf andere Systeme übertragen und dort angezeigt oder formatiert werden.

Setzen Sie unter HP-UX den Paramter size (Größe) des Befehls mqsichangetrace auf einen Wert unter 500 MB. Beachten Sie, dass XML-generierte Dateien oftmals halb so groß sind wie die ursprüngliche Tracedatei. Wenn der Wert des Parameters size mehr als 500 MB beträgt, kann dies zu Problemen führen.

Wenn diese Datei auf ein anderes System übertragen wird, müssen Sie sicherstellen, dass Sie ein Dateiübertragungsprogramm verwenden, das keine Daten konvertiert (beispielsweise durch Angabe einer Option für binäre Übertragung).

Broker oder Brokerressourcen (Ausführungsgruppe oder Nachrichtenfluss), die angegeben werden, müssen implementiert worden sein, bevor der Trace gestartet und die Protokolldateien gelesen werden können.

Syntax

Benutzertrace

Service-Trace

Parameter

component
(Erforderlich) Der Name der Komponente, für die das Protokoll gelesen werden soll. Hier kann der Name eines Brokers oder des Konfigurationsmanagers oder die festen Werte , UserNameServer, Workbench oder utility angegeben werden (unter Linux- und UNIX-SystemenBeginn der Änderungund unter z/OSEnde der Änderung muss die Groß-/Kleinschreibung beachtet werden).
-u
(Optional) Lesen Sie im Benutzertraceprotokoll die Inhalte des Protokolls. Diese Funktion ist nur gültig, wenn Sie die Komponente Broker ausgewählt haben.
-e Ausführungsgruppe
(Optional) Bezeichnung für die Ausführungsgruppe, für die die Protokollinformationen gelesen werden.
-o Ausgabedatei
(Optional) Name der Datei, in die die Protokolldaten geschrieben werden. Wenn Sie einen vollständigen Pfadnamen angeben, wird die Datei im angegebenen Verzeichnis erstellt. Wenn Sie nur den Dateinamen angeben, wird die Datei im aktuellen Arbeitsverzeichnis gespeichert. Die Inhalte der Datei werden in die Codepage utf-8 geschrieben. Diese Codepage ist plattformunabhängig und speichert Daten wie beispielsweise DBCS-Zeichen.

Zum Formatieren des Protokolls mit Hilfe des Befehls mqsiformatlog muss ein Dateiname angegeben werden. Wenn Sie keinen Dateinamen angeben, werden die Inhalte des Protokolls in die Standardausgabe geschrieben. Es wird empfohlen, die Dateierweiterung .xml zu verwenden.

-f
(Optional für Benutzertrace; erforderlich für Service-Trace). Lesen Sie die Protokolldatei direkt aus dem Dateisystem. Wenn Sie diese Option nicht angeben, wird durch den Befehl eine XML-Nachricht an die Komponente gesendet, um die Protokollinhalte anzufordern. Wenn Sie -t (Service-Trace) angegeben haben, müssen Sie dieses Flag auch angeben. Weitere Informationen dazu finden Sie im Abschnitt Zusätzliche Parameter bei der Service-Tracefunktion.

Wenn Sie diese Option angeben, stoppen Sie die Tracefunktion (mit Hilfe von mqsichangetrace), bevor Sie den Befehl mqsireadlog verwenden. Wenn die Protokolldatei beim Aufrufen des Befehls mit dem angegebenen Flag verwendet wird, werden XML-Einträge möglicherweise nur teilweise zurückgegeben. Dieses Risiko können Sie minimieren, indem Sie -m safe im Befehl mqsichangetrace angeben. Wenn die Komponente, für die ein Trace durchgeführt wird, sich selbst beendet, müssen Sie nicht den Befehl mqsichangetrace eingeben.

Wenn die Tracefunktion vor dem Aufrufen dieses Befehls nicht gestoppt wird, überprüfen Sie den Inhalt der erstellten Protokolldatei und entfernen Sie mit Hilfe eines Texteditors mögliche Teileinträge vom Ende, bevor Sie den Befehl mqsiformatlog verwenden. Teileinträge können vom Formatierungsbefehl nicht gelesen werden.

Zusätzliche Parameter bei der Service-Tracefunktion

Verwenden Sie diese Option nur, wenn Sie vom IBM Support Center oder durch eine BIPxxxx-Nachricht dazu aufgefordert werden.

-t
(Erforderlich) Lesen Sie im Service-Traceprotokoll die Inhalte des Protokolls.
-b Qualifikationsmerkmal
(Erforderlich) Lesen Sie die Inhalte des Protokolls für den Brokeragenten, den Agenten des Konfigurationsmanagers oder den Agenten des Benutzernamensservers, oder für das angegebene Dienstprogramm des Befehls. Diese Option ist nur gültig, wenn -t angegeben wurde (Service-Trace).

In der folgenden Tabelle werden die gültigen Kombinationen von Qualifikationsmerkmalen und Komponenten für den Service-Trace gezeigt.

Mit dieser Option werden allgemein Traces für die Befehle selbst durchgeführt. Wenn Sie einen Trace für einen bestimmten Befehl durchführen möchten, müssen Sie diesen Befehl mit der Umgebungsvariablen MQSI_UTILITY_TRACE durchführen, die vor dem Aufrufen des Befehls auf den Wert Debug oder Normal festgelegt wurde, um die generierte Traceausgabe zu lesen.

Geben Sie diese Werte entsprechend den Anweisungen ein.

Der Trace agent wird eingeleitet, wenn Sie das Flag -b im Befehl mqsichangetrace angeben. Führen Sie diese Aktion nur aus, wenn Sie durch eine WebSphere Event Broker-Fehlernachricht oder durch das IBM Support Center dazu aufgefordert werden.

Der Trace service wird eingeleitet, wenn Sie das Flag -b im Befehl mqsichangetrace angeben. Der Befehl hat folgendes Format:
mqsireadlog <Brokername> -t -b service -f -o service.xml
Führen Sie diese Aktion nur aus, wenn Sie durch eine WebSphere Event Broker-Fehlernachricht oder durch das IBM Support Center dazu aufgefordert werden.
-f
(Erforderlich) Lesen Sie die Protokolldatei direkt aus dem Dateisystem. Bei Verwendung mit dem Service-Trace hat dieser Flag die gleichen Merkmale wie bei der Verwendung mit dem Benutzertrace. Der Trace ist bei Angabe des Flags -e optional. Sie müssen diese Option bei Angabe des Flags -b angeben.
Qualifikationsmerkmal Component= <Brokername> Component= ConfigMgr_name Component= UserNameServer Component= Workbench Component= utility
mqsichangebroker x        
mqsichangeconfigmgr   x      
mqsichangetrace x x x    
mqsichangeusernameserver     x    
mqsiclearmqpubsub x        
mqsicreateaclentry         x
mqsicreatebroker x        
mqsicreateconfigmgr   x      
mqsicreateusernameserver     x    
mqsideleteaclentry         x
mqsideletebroker x        
mqsideleteconfigmgr   x      
mqsideleteusernameserver     x    
mqsiformatlog1         x
mqsijoinmqpubsub   x      
mqsilist2   x     x
mqsilistmqpubsub x        
mqsilistaclentry         x
mqsireadlog x x x   x
mqsireporttrace   x   x  
mqsistart x x x    
mqsistop x x x    
Agent x x x    
Service x x x    
Workbench       x  
Hinweise:
  1. Da in diesem Befehl kein Komponentenparameter enthalten ist, werden die Trace-Informationen in den Tracedateien der Komponente utility erfasst und von dort abgerufen. Weitere Informationen hierzu finden Sie unter dem Befehl mqsichangetrace.
  2. Wenn dieser Befehl ohne Komponente aufgerufen wird, werden die Trace-Informationen zusätzlich zu den komponentenspezifischen Dateien in den Tracedateien von utility erfasst und von dort abgerufen. Weitere Informationen hierzu finden Sie unter dem Befehl mqsichangetrace.

Autorisierung

Auf UNIX-Plattformen muss die Benutzer-ID der Gruppe mqbrkrs angehören. Bei Angabe des Flags -f muss die zum Aufrufen dieses Befehls verwendete Benutzer-ID ebenfalls über eine Zugriffsberechtigung auf die Tracedatei verfügen.

Bei Angabe des Flags -f muss auf Windows-Plattformen die zum Aufrufen dieses Befehls verwendete Benutzer-ID über eine Zugriffsberechtigung auf die Tracedatei verfügen. Wenn das Flag -f nicht angegeben wurde, muss die zum Aufrufen des Befehls verwendete Benutzer-ID über die Berechtigung mqbrkrs verfügen.

Antworten

  • BIP8020 Zugriff auf Datenbank nicht möglich
  • BIP8029 Broker nicht konfiguriert
  • BIP8032 Verbindung zu Warteschlange konnte nicht hergestellt werden
  • BIP8033 XML-Nachricht konnte nicht gesendet werden
  • BIP8035 Antwort wurde erst nach Ablauf der Zeitlimitüberschreitung empfangen
  • BIP8036 Negative Antwort empfangen
  • BIP8037 Eine nicht unterstützte Option wurde ausgewählt
  • BIP8038 Nicht unterstützte Befehlsoption
  • BIP8039 Ausführungsgruppe nicht verfügbar
  • BIP8040 Es konnte keine Verbindung zu der Datenbank hergestellt werden
  • BIP8132 Ungültiges Qualifikationsmerkmal

Beispiele

Benutzertrace für Broker WBRK_BROKER:

mqsireadlog WBRK_BROKER -u -e default -o trace.xml

Service-Trace für Komponente ConfigMgr:

mqsireadlog ConfigMgr -t -b agent -f -o trace.xml

Service-Trace für Dienstprogramm mqsiformatlog:

mqsireadlog utility -t -b agent -f -o trace.xml

Die Protokolldatei (im obigen Beispiel trace.xml) kann mit Hilfe des Befehls mqsiformatlog formatiert oder mit Hilfe eines XML-Editors oder einer XML-Anzeige angezeigt werden.

Zugehörige Tasks
Protokolle verwenden
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
an07300_