dspmqtrc (display formatted trace)

Format and display IBM MQ trace.

Purpose

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

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

Syntax

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 AMQ yyyyy. 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 UNIX platforms other than AIX and HP Integrity NonStop Server, the default value is as follows:

 MQ_INSTALLATION_PATH/lib/amqtrc.fmt

MQ_INSTALLATION_PATH represents the high-level directory in which IBM 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