Mit dem Befehl mqsiformatlog wird das mit dem Befehl mqsireadlog erstellte XML-Protokoll verarbeitet. Mit diesem Befehl werden alle Nachrichten aus dem XML-Protokoll abgerufen und in ein für die Ländereinstellung des Benutzers, der den Befehl eingegeben hat, lesbares Format gebracht.
Dieser Befehl interpretiert eine Eingabeprotokolldatei, die auf einem System in einer plattformunabhängigen Codepage (utf-8) erstellt wurde. Damit erhalten Sie eine formatierte Ausgabe von Eingabeprotokolldateien, der aus anderen Systemen auf das System übertragen wird, auf dem der Befehl eingegeben wird. Bei Verwendung dieser Funktion müssen Sie sicherstellen, dass Sie ein Dateiübertragungsprogramm verwenden, das keine Daten konvertiert (beispielsweise durch Angabe einer Option für binäre Übertragung).
Diese Ausgabe kann in eine Datei oder eine Befehlsshell übertragen werden.
Die Ausgabe, die von diesem Befehl geschrieben wird (in eine Datei oder in die Standardausgabe) hat eine Codierung, die für die Ländereinstellung des aktuellen Benutzers lesbar ist.
die Benutzer-ID, unter der dieser Befehl eingegeben wird, muss Lesezugriff auf die Eingabedatei und Schreibzugriff auf die Ausgabedatei haben.
Auf Linux- und UNIX-Systemen muss die Benutzer-ID zur Gruppe mqbrkrs gehören.
mqsiformatlog -i trace.xml -o formattrace.log
Der folgende Auszug ist ein Beispiel für eine von diesem Befehl erstellte Ausgabe:
Timestamps are formatted in local time, local time is GMT. . . . 2003-02-12 12:57:21.895999 388 UserTrace BIP2638E: MQPUT an Warteschlange 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' in Warteschlangenmanager 'WBRK_QM': MQ-Beendigungscode=0, MQ-Ursachencode=0; Knoten: ConfigurationMessageFlow.outputNode'. Der Knoten 'ConfigurationMessageFlow.outputNode' hat versucht, eine Nachricht an die angegebene Warteschlange 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' zu schreiben, die mit dem Warteschlangenmanager 'WBRK_QM' verbunden ist. Der MQ-Beendigungscode lautete 0, der MQ-Ursachencode 0. Keine Benutzeraktion erforderlich. 2003-02-12 12:57:21.895999 388 UserTrace BIP2622I: Message successfully output by output node 'ConfigurationMessageFlow.outputNode' to queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' on queue manager 'WBRK_QM'. Der WebSphere MQ-Sendeknoten ConfigurationMessageFlow.outputNode' successfully wrote an output message to the specified queue SYSTEM.BROKER.EXECUTIONGROUP.REPLY connected to queue manager WBRK_QM. Keine Benutzeraktion erforderlich. . . . Threads encountered in this trace: 335 388