mqsichangetrace command

Use the mqsichangetrace command to set the tracing characteristics for a component.

Supported platforms

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

Purpose

This command is valid for:
  • User trace. Specify the -u option.
  • Service trace. Specify the -t option. 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 end user tracing for a broker, or initiate, modify, or end 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 output for service and user trace 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 run this command must be a member of the group mqbrkrs.

Related tasks
Using trace
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:22:32

an07260_