Retrieving user trace

Use the mqsireadlog to access the trace information recorded by the user trace facilities.

This command retrieves the trace details according to parameters that you specify on the command, and writes the requested records to a file, or to the command line window, in XML format. For a full description of this command (which, on z/OS, you run by customizing the BIPJLOG job), see mqsireadlog command.

Example: retrieving user trace information in XML format

On distributed platforms, to retrieve information for the user trace activated with the mqsichangetrace command, and write it to an output file, enter the command mqsireadlog WBRK_BROKER -u -e default -o trace.xml where:
-u
specifies user trace
-e
specifies the execution group (in this case, the default execution group)
-o
specifies the output file (in this case, trace.xml)
This sends a log request to the broker to retrieve the user trace log, and stores the responses in the file trace.xml. You can view this file using a plain text editor. An example of the output you get is shown below.
<?xml version="1.0" encoding="UTF-8" ?>
<UserTraceLog uuid="UserTraceLog"
userTraceLevel="none" traceLevel="none"
userTraceFilter="debugTrace" traceFilter="none" 
fileSize="1048576" fileMode="safe">
<UserTrace timestamp='2003-01-30 13:35:08.168000' thread='367'
function='ImbConfigurationNode::evaluate' type='ComIbmConfigurationNode'
name='ConfigurationNode' label='ConfigurationMessageFlow.ConfigurationNode'
text='Configuration changed successfully and committed to persistent store'
catalog='BIPV500' number='4040'
file='F:/build/S202_P/src/DataFlowEngine/ImbConfigurationNode.cpp' line='778'>
<Insert type='string'>default</Insert>
<Insert type='string'>2d193932-dd00-0000-0080-ab4b84e10d89</Insert>
<Insert type='string'>ConfigurationMessageFlow.ConfigurationNode</Insert>
</UserTrace>
<UserTrace timestamp='2003-01-30 13:35:08.187999' thread='367'
function='ImbMqOutputNode::putMessage' type='ComIbmMQOutputNode'
name='OutputNode' label='ConfigurationMessageFlow.outputNode'
text='MQPUT issued to put message to the specified output queue'
catalog='BIPV500' number='2638'
file='F:/build/S202_P/src/DataFlowEngine/ImbMqOutputNode.cpp' line='1474'>
<Insert type='string'>WBRK_QM</Insert>
<Insert type='string'>SYSTEM.BROKER.EXECUTIONGROUP.REPLY</Insert>
<Insert type='integer'>0</Insert>
<Insert type='integer'>0</Insert>
<Insert type='string'>ConfigurationMessageFlow.outputNode</Insert>
</UserTrace>

Related concepts
Trace

Related tasks
Diagnosing errors
Using trace
Starting user trace
Retrieving service trace

Related reference
User trace
mqsichangetrace command
mqsireadlog command
z/OS utility jobs