mqsiformatlog command

Use the mqsiformatlog command to process the XML log created by mqsireadlog. The command retrieves and formats any messages that the XML log contains into a form suitable for the locale of the user who runs the command.

Purpose

The mqsiformatlog command interprets an input log file that has been created on any system in a platform-independent code page, utf-8. Use this command to produce formatted output from input log files transferred from other systems to the system on which you issue the command. If you use this facility, ensure that you use a file transfer program that does not convert the data (for example, by specifying a binary transfer option).

You can direct the output to a file, or to the command shell.

Syntax

Read syntax diagramSkip visual syntax diagrammqsiformatlog -i Inputfilename  -o Outputfilename

Parameters

-i Inputfilename
(Required) The filename of the XML log file that is to be formatted. This file is created by the mqsireadlog command; it is encoded in utf-8.
-o Outputfilename
(Optional) The filename of the file into which the formatted log output is to be written. If this is not specified, the formatted log data is written to stdout.

Output written by this command (to file or stdout) is written in a code page suitable for the current user locale.

Examples

mqsiformatlog -i trace.xml -o formattrace.log

The following extract shows the output that is generated by this command:

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 
'IBQMGR': 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 'IBQMGR'.
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 
'IBQMGR'. The WebSphere MQ output node ConfigurationMessageFlow.outputNode' 
successfully wrote an output message to the specified queue 
SYSTEM.BROKER.EXECUTIONGROUP.REPLY connected to queue manager IBQMGR.
No user action required.
.
.
.
Threads encountered in this trace:  335  388