WebSphere Message Brokers
File: au14270_
Writer: Jane Brockbank

Task topic

This build: July 31, 2007 21:39:20

Starting service trace

Activate service traces only when you receive an error message that instructs you to start service trace, or when directed to do so by your IBM Support Center.

Use the mqsichangetrace command to start WebSphere Message Broker service trace facilities.

You can select only one broker on each invocation of the command, but you can activate concurrent traces for more than one broker by invoking the command more than once.

You must specify the individual component that you want to trace; for example the broker, Configuration Manager, or User Name Server, to limit the scope of a trace.

If you want to trace the command executable files themselves, set the environment variables MQSI_UTILITY_TRACE and MQSI_UTILITY_TRACESIZE before you initiate trace. Ensure that you reset these variables when the command that you are tracing has completed. If you do not do so, all subsequent commands are also traced, and their performance is therefore degraded.

If the trace cannot be associated with a specific component, the component name part of the file name is set to utility, for example, when tracing a command such as mqsilist, when no arguments are used.

In order to trace the mqsideploy, mqsistartmsgflow, mqsistopmsgflow, mqsicreateexecutiongroup, and mqsideleteexecutiongroup commands, use the -v parameter. This takes an argument that is the name of the file to which trace will be written.

Example: starting service trace for the User Name Server

To start debug level service tracing for the User Name Server, on distributed systems, enter the command

mqsichangetrace UserNameServer -t -b -l debug

where:

-t specifies service trace
-b specifies that trace for the agent subcomponent of the specified component
is to be started
-l specifies the level of trace (in this case, debug)

z/OS platform On z/OS, enter the command
F MQPIUNS,ct t=yes, b=yes, l=debug
Related concepts
Trace
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:39:20

au14270_ This topic's URL is: