Mit dem Befehl mqsireadlog werden die Tracesätze für die angegebene Komponente abgerufen.
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 Parameter size des Befehls mqsichangetrace auf weniger als 500 MB, da 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.
Zum Formatieren des Protokolls mithilfe des Befehls mqsiformatlog muss ein Dateiname angegeben werden. Wenn Sie keinen Dateinamen angeben, wird der Protokollinhalt in die Standardausgabe (stdout) geschrieben. Als Dateierweiterung sollte .xml verwendet werden.
Wenn Sie diese Option angeben, stoppen Sie die Traceverarbeitung (mithilfe von mqsichangetrace), bevor Sie den Befehl mqsireadlog verwenden. Wenn die Protokolldatei bei Eingabe des Befehls mit diesem Flag gerade verwendet wird, werden unter Umständen unvollständige XML-Datensätze 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 mithilfe eines Texteditors mögliche Teileinträge vom Ende, bevor Sie den Befehl mqsiformatlog verwenden. Teileinträge können vom Formatierungsbefehl nicht gelesen werden.
Diese Optionen sollten nur verwendet werden, wenn Sie vom IBM Support Center oder in einer BIPxxxx-Nachricht dazu aufgefordert werden.
In der Tabelle unten sind alle gültigen qualifier/component-Kombinationen für den Service-Trace aufgeführt.
Diese Option wird normalerweise für einen Trace der Befehle selbst verwendet. Soll ein Trace für einen bestimmten Befehl durchgeführt werden, müssen Sie den betreffenden Befehl zunächst mit der Umgebungsvariablen MQSI_UTILITY_TRACE (die auf debug oder normal gesetzt ist) ausführen, bevor Sie diesen Befehl eingeben, um die Traceausgabe zu lesen.
Geben Sie diese Werte genau wie angegeben ein.
Der Trace agent wird eingeleitet, wenn Sie das Flag -b im Befehl mqsichangetrace angeben. Dies sollte nur geschehen, wenn Sie dazu in einer WebSphere Message Broker-Fehlernachricht oder vom IBM Support Center aufgefordert werden.
mqsireadlog <Brokername> -t -b service -f -o service.xmlDies sollte nur geschehen, wenn Sie dazu in einer WebSphere Message Broker-Fehlernachricht oder vom IBM Support Center aufgefordert werden.
Qualifier | Component= Brokername | Component= Konfigurationsmanagername | 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 | |||
mqsilist | 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 | ||||
httplistener | x |
Bei Angabe des Flags -f auf allen Windows-Plattformen muss die Benutzer-ID, unter der dieser Befehl aufgerufen wird, Zugriff auf die Tracedatei haben. Wird -f nicht angegeben, muss die Benutzer-ID, unter der der Befehl ausgeführt wird, zur Gruppe mqbrkrs gehören.
Auf Linux- und UNIX-Plattformen muss die Benutzer-ID zur Gruppe mqbrkrs gehören. Bei Angabe des Flags -f muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, außerdem Zugriff auf die Tracedatei haben.
Benutzertrace für Broker WBRK_BROKER abrufen:
mqsireadlog WBRK_BROKER -u -e default -o trace.xml
Service-Trace für Komponente ConfigMgr abrufen:
mqsireadlog ConfigMgr -t -b agent -f -o trace.xml
Service-Trace für Dienstprogramm mqsiformatlog abrufen:
mqsireadlog utility -t -b agent -f -o trace.xml
Die Protokolldatei (im obigen Beispiel trace.xml) kann mithilfe des Befehls mqsiformatlog formatiert oder mithilfe eines XML-Editors oder einer XML-Anzeige angezeigt werden.