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

dspmqtrc  -t FormatTemplate -h -s -o OutputFilename InputFileName


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

Command Description
endmqtrc End trace
strmqtrc (Start trace) Start trace


Related reference