Trace (-T)

Use the Trace adapter command (-T) to produce a trace file that contains information about connections to MSMQ, getting and putting messages on the queues, and MSMQ error codes.

The default filename is msmqtrace.log and it is created in the map directory unless otherwise specified. However, it is recommended that you specify that the trace file is created in a root directory, such as c:\ on Windows, because the adapter logs some events before the full path of an optional destination directory is known.

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. Produce 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 msmqtrace.log.

You can override the adapter command line trace options dynamically using the Management Console. See Dynamic Adapter Tracing in the Launcher documentation for detailed information.