Tracing WebSphere MQ Managed File Transfer commands

Purpose

Use the -trace parameter for any command to enable trace at a specified level. The trace files produced are located in your current working directory.

Because running trace can affect your performance significantly and can produce a large amount of trace data, run trace with care and only when necessary. Typically, enable trace only when asked to do so by your IBM® service representative.

You can set further trace properties, for example trace file size and the number of trace files to keep, in the agent.properties file. These properties are described in Advanced agent properties.

Parameters

-trace(classes=level)

Required. Level to set the trace and which classes to apply the trace to. Specify the following format:

classes=level

For example:

com.ibm.wmqfte=all

which traces all WebSphere MQ Managed File Transfer classes.

Specify a colon-separated list of class specifications that you want the level of trace to apply to. If you do not specify this parameter, the trace level is applied to all agent classes.

If (classes) start with a plus sign (+), the list of trace classes following the plus sign are added to any existing trace classes currently being traced.

The valid trace level options are as follows and are listed in ascending order of trace file size and detail:

off

Switches the agent trace off but continues to write information to the log files. This is the default option.

flow

Captures data for trace points associated with processing flow in the agent.

moderate

Captures a moderate amount of diagnostic information in the trace.

verbose

Captures a verbose amount of diagnostic information in the trace.

all

Sets agent trace to run on all agent classes.

-tracePath(directory path)

Optional. Specify the directory that you want the trace to be written to. For example, c:\temp.

This parameter is valid only when the -trace parameter is specified.