You can specify the output to be directed to file, or to stdout. The trace records returned by this command are in XML format and can be browsed with an XML browser. If you direct output to file, the data is written in code page utf-8. The file is therefore platform-independent, and can be transferred to other systems for browsing or formatting using the mqsiformatlog command.
On HP-UX you are recommended to set the size parameter of the mqsichangetrace command to be less than 500 MB. Note that the size of the XML generated files is often half as much again as the original trace file, and setting the value of the size parameter to be greater than 500 MB can cause problems.
If you transfer this file to another system, ensure that you use a file transfer program that does not convert the data (for example, by specifying a binary transfer option).
If you specify a broker, or any of its resources (execution group or message flow) you must have deployed them before you can start trace and read the log files.
You must specify a file name if you want to format the log using the mqsiformatlog command. If you do not specify a filename, the contents of the log are written to stdout. You are recommended to use a file extension of .xml.
If you specify this option, stop tracing (using mqsichangetrace) before you use the mqsireadlog command. If the log file is in use when you issue this command with this flag specified, partial XML records might be returned. You can reduce the risk of this happening by specifying -m safe on the mqsichangetrace command. If the component being traced has itself stopped, you do not then need to issue a mqsichangetrace command.
If you do not stop tracing before you issue this command, check the contents of the log file created and remove any partial records from the end using a text editor before using the mqsiformatlog command, as partial records cannot be read by the format command.
Use these options only when directed to do so by your IBM Support Center or by a BIPxxxx message.
The following table shows the valid combinations of qualifier and component for service trace.
This option is generally used to trace the commands themselves. If you want to trace a particular command, run that command with environment variable MQSI_UTILITY_TRACE set to debug or normal before you issue this command to read the trace output generated.
Enter these values exactly as shown.
The agent trace is initiated when you specify the -b flag on the mqsichangetrace command. Do this only when directed to do so by a WebSphere Message Broker error message or when instructed to do so by your IBM Support Center.
mqsireadlog <brokername> -t -b service -f -o service.xmlDo this only when directed to do so by a WebSphere Message Broker error message or when instructed to do so by your IBM Support Center.
Qualifier | Component= <broker_name> | 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 | |||
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 |
On UNIX platforms, the user ID must be a member of the mqbrkrs group. If the -f flag is specified, the user ID used to invoke this command must also have access to the trace file.
On Windows platforms, if the -f flag is specified, the user ID used to invoke this command must have access to the trace file. If the -f flag is not specified, the user ID used to issue the command must have mqbrkrs authority.
User trace for broker WBRK_BROKER:
mqsireadlog WBRK_BROKER -u -e default -o trace.xml
Service trace for component ConfigMgr:
mqsireadlog ConfigMgr -t -b agent -f -o trace.xml
Service trace for utility mqsiformatlog:
mqsireadlog utility -t -b agent -f -o trace.xml
You can format the log file (trace.xml in the above examples) using the command mqsiformatlog, or view it using an XML editor or viewer.
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
an07300_ |