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 to queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' on queue manager 'WBRK_QM': MQCC=0, MQRC=0; node ConfigurationMessageFlow.outputNode'. The node 'ConfigurationMessageFlow.outputNode' attempted to write a message to the specified queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' connected to queue manager 'WBRK_QM'. The MQCC was 0 and the MQRC was 0. No user action required. 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. No user action required. . . . Threads encountered in this trace: 335 388