dspmqtrc

Format and display IBM® WebSphere® MQ trace.

Purpose

The dspmqtrc command is supported on UNIX and HP Integrity NonStop Server systems only. Use the dspmqtrc command to display WebSphere MQ formatted trace output.

The runtime SSL trace files have the names AMQ.SSL.TRC and AMQ.SSL.TRC.1. You cannot format any of the SSL trace files. The SSL trace files are binary files and, if they are transferred to IBM support by FTP, they must be transferred in binary transfer mode.

Syntax

Read syntax diagramSkip visual syntax diagramdspmqtrc -t FormatTemplate -h -s -o OutputFilenameInputFileName

Required parameters

InputFileName
The name of the file containing the unformatted trace, for example:
/var/mqm/trace/AMQ12345.01.TRC
If you provide one input file, dspmqtrc formats it to the output file you name. If you provide more than one input file, any output file you name is ignored, and formatted files are named AMQyyyyy.zz.FMT, based on the PID of the trace file.

Optional parameters

-t FormatTemplate
The name of the template file containing details of how to display the trace. If this parameter is not supplied, the default template file location is used:
For AIX® systems, the default value is as follows:
MQ_INSTALLATION_PATH/lib/amqtrc2.fmt
For all HP Integrity NonStop Server, and UNIX systems other than AIX systems, the default value is as follows:
MQ_INSTALLATION_PATH/lib/amqtrc.fmt
MQ_INSTALLATION_PATH represents the high-level directory in which IBM WebSphere MQ is installed.
-h
Omit header information from the report.
-s
Extract trace header and put to stdout.
-o output_filename
The name of the file into which to write formatted data.

Related commands

Command Description
endmqtrc End trace
strmqtrc Start trace