WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

User trace

User trace is one of two types of optional trace that are available in WebSphere® Message Broker and provides more information than that provided by the entries that are written to the Administration log. User trace is inactive by default; you must activate it explicitly by using a command, or by selecting options in the WebSphere Message Broker Toolkit.

For more information about logs, see Logs.

Typically, you use user trace for debugging your applications, as it can trace brokers, execution groups, and deployed message flows.

You can use the WebSphere Message Broker Toolkit to control most of the trace activity that you need. You can also use the WebSphere Message Broker Toolkit to start and stop tracing on remote systems.

When you activate user trace, you cause additional processing for every activity in the component that you are tracing. Large quantities of data are generated by the components. Expect to see some effect on performance while user trace is active. You can limit this additional processing by being selective about what you trace, and by restricting the time during which trace is active.

The user trace log files

When trace is active for any component, information is recorded in binary form.

The location of the trace logs depends on your environment:
Windows platformWindows
If you set the work path by using the -w parameter of the mqsicreatebroker command, the location is workpath\log.
If you have not specified the broker work path, the default location is %ALLUSERSPROFILE%\IBM\MQSI\common\log where %ALLUSERSPROFILE% is the environment variable that defines the system working directory. The default directory depends on the operating system.
  • On Windows XP and Windows Server 2003: C:\Documents and Settings\All Users\IBM\MQSI\common\log
  • On Windows Vista and Windows Server 2008: C:\ProgramData\IBM\MQSI\common\log
Your computer might not use the standard value; use %ALLUSERSPROFILE% to ensure that you access the correct location.
Linux platformUNIX platformLinux and UNIX
/var/mqsi/common/log
z/OS platformz/OS®
/component_filesystem/log

The file names reflect the component and subcomponent for which the trace is active. For example, the broker name and unique execution group identifier form part of the file name when you are tracing activity within that execution group.

For example, if you have created a broker called MB8BROKER, you might see the following files in the log subdirectory:
MB8BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.1
MB8BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.2

You cannot view these files directly; use the commands that are provided to access the trace information and convert it to a viewable format. Use the mqsireadlog command to retrieve the trace log for the specified component. Issue the command on the computer on which the log was generated. You can specify the output to be directed to a file, which is independent of operating system, and can be transferred to other systems for browsing or formatting by using the mqsiformatlog command.

Using a Trace node

If you include a Trace node in your message flows when you are developing and testing them, this option not only gives you the ability to trace messages and activity in the flow, but also allows you to specify an alternate target file for the trace contents to isolate the detail in which you are interested. For details of how to use and configure a Trace node, see the Trace node topic.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:15


Reference topicReference topic | Version 8.0.0.7 | an01310_