WebSphere Message Brokers
File: an07260_
Writer: Bill Oppenheimer

Reference topic

This build: July 31, 2007 21:33:31

mqsichangetrace command

Supported platforms

  • Windows
  • Linux and UNIX systems
  • z/OS - as a console command

Purpose

Use the mqsichangetrace command to set the tracing characteristics for a component. This command is valid for:
  • User trace. Specify the -u option.
  • Service trace. Specify the -t option. You are recommended to use this option only if directed to do so by the action described in a BIPxxxx message, or by your IBM Support Center.

You can initiate, modify, or terminate user tracing for a broker, or initiate, modify, or terminate service tracing for a broker, a Configuration Manager, or the User Name Server (identified by component name). You cannot use this command to initiate service tracing for the workbench.

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.

The trace output generated by these commands is written to trace files in the log subdirectory. When you have completed the work you want to trace, use mqsireadlog to retrieve the log as an XML format file. Use either mqsiformatlog (to produce a formatted file) or an XML browser to view the XML records.

When you set tracing on, you cause additional processing to be executed for every activity in the component you are tracing. You must expect to see some impact on performance when trace is active.

If you want to trace the command processes themselves, set the environment variables MQSI_UTILITY_TRACE and MQSI_UTILITY_TRACESIZE before you initiate trace.

Ensure that you reset these variables when tracing for the selected command is complete. If you do not do so, all subsequent commands are also traced, and their performance degraded.

You can also start and stop tracing activity for execution groups and message flows using the facilities of the workbench. See User trace for more information.

Select the appropriate link for details of this command on the platform, or platforms, that your enterprise uses:

Authorization

On Windows, Linux, and UNIX systems the user ID used to issue the command must have mqbrkrs authority.

Related tasks
Using 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:33:31

an07260_ This topic's URL is: