Tracing WebSphere MQ File Transfer Edition commands
You can trace any of the WebSphere® MQ File Transfer Edition commands to help with problem determination from the command line.
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.
Syntax
>>-fteCommandName-- -trace--(classes=level)---------------------> >--+-------------------------------+--------------------------->< '- -tracePath--(directory path)-'
Parameters
- -trace (classes=level)
- Required. Level to set the trace and which classes to apply the
trace to. Specify the following format:
For example:classes=level
which traces all WebSphere MQ File Transfer Edition classes.com.ibm.wmqfte=all
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 and available only if you have enabled the Version 7.0.4.1
function. Specify the directory that you want the trace to be written
to. For example, c:\temp.
If you do not specify this parameter, the value is the directory that the command was issued from.
This parameter is valid only when the -trace parameter is specified.
Example
In this example the trace level is set to all, meaning that all of the classes belonging to AGENT.NAME are traced for the fteStartAgent command:fteStartAgent -trace com.ibm.wmqfte=all AGENT.NAME
In
this example the trace level is set to moderate for the com.ibm.wmqfte.common
classes for the agent AGENT.NAME. A moderate amount of trace is captured
for the ftePingAgent command:ftePingAgent -trace com.ibm.wmqfte.common=moderate AGENT.NAME
ftePingAgent -trace com.ibm.wmqfte.common=moderate -tracePath c:\$user AGENT.NAME