Trace (-T)

Use the Trace adapter command (-T) to produce a trace file that contains information about connections to IBM® MQ, message sizes, IBM MQ error messages, and adapter error messages.

The default filename is mqstrace.log and it is created in the map directory unless otherwise specified.

For z/OS® Batch and CICS® environments, mqstrace.log does not conform to the naming convention. For z/OS Batch and CICS environments, the trace output is written to the dataset indicated by the ddname MQTRACE that is (in most cases) defined in the JCL as : //MQTRACE DD SYSOUT=*

If the trace file does not already exist, it is created. If it already exists it is automatically appended.

-T[E|S] [full_path]

Option

Description

E

Error mode. Produces a trace file containing only the adapter errors that occurred during map execution.

S

Summary mode. Use this option to reduce the size of the trace file. The summary trace file excludes polling information and function entries and exits-reporting only minimal information, such as the activity that occurs within a function (when applicable).

full_path

Create a trace file with the specified name in the specified directory. By default, the directory is where the map is located and the file name is mqstrace.log.

You can override the adapter command line trace options dynamically using the Management Console. For detailed information, see "Dynamic Adapter Tracing" in the Launcher documentation .