mqsichangetrace command

Use the mqsichangetrace command to set the tracing characteristics for an integration node.

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.
  • Trace nodes. Specify the -n option to switch Trace nodes on or off. You can significantly improve the performance of a flow by switching Trace nodes off.

You can initiate, modify, or end user tracing (or service tracing) for an integration node.

You can switch Trace nodes for an integration node on and off, but you cannot use this command to initiate service tracing for the IBM App Connect Enterprise Toolkit.

If you specify an integration node, or any of its resources (integration server or message flow), you must have deployed them before you can start trace. If you want to use the mqsichangetrace command to start or stop user trace, you must ensure the integration node is running. But for service trace, you can also use the mqsichangetrace command to enable or disable trace when the integration node is in a shutdown state. This allows you to trace the startup of the integration node components.

The output for service and user trace generated by these commands is written to trace files in the log subdirectory.

The log files are written in plain text.

When you set tracing on, you cause additional processing to be executed for every activity in the integration node that you are tracing. Expect performance to be affected when trace is active.

If you want to trace the command processes themselves, you can specify the -v | --trace parameter. Alternatively, you can set the environment variables MQSI_UTILITY_TRACE and MQSI_UTILITY_TRACESIZE before you initiate trace.

You can set MQSI_UTILITY_TRACE to normal or debug, depending whether you want normal or debug tracing, and you should set MQSI_UTILITY_TRACESIZE to the maximum size of the trace file that you require in kilobytes (KB), the default being 102400 (100MB).

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. For more information about MQSI_UTILITY_TRACE and MQSI_UTILITY_TRACESIZE, see Starting service trace.

You can also start and stop tracing activity for integration servers and message flows by using the web user interface and the REST API; for more information, see User trace.

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