IBM Support

MH06: IBM WebSphere MQ - Trace Tools



This SupportPac provides a Java command line tool called mqtrcfrmt to aid in reading IBM MQ traces.

Download Description

The mqtrcfrmt Java tool provided in this MH06 Trace Tools SupportPac takes as input IBM MQ trace files such as IBM MQ distributed trace, z/OS API trace, and  amqsact trace, then writes out the passed-in trace file contents  with more helpful formatting around some of the trace data.  For example, an IBM MQ data structure like a GMO has all the GMO structure fields broken out into their individual names, and the field values printed in a human-readable format with IBM MQ constants also provided.

Because mqtrcfrmt is written in Java, it can be run on any IBM MQ platform that supports Java, which is pretty much any platform.  However, mqtrcfrmt was tested primarily on the Linux, Windows, and z/OS platforms. 

The mqtrcfrmt tool can also be run to take a passed in IBM MQ field name and value (e.g. MQGMO.Options = 1), then display the IBM MQ constant values (e.g. MQGMO_WAIT) that the numerical value represents as output.  Mqtrcfrmt also provides other functionality, such as searching for messages that have a certain string, extracting messages in traces to a file, and giving performance reports of how long the API methods are taking to complete.  More details of the MH06 SupportPac functionality can be found in the MH06.pdf manual.

Possible Uses:
Aid for reading
IBM MQ traces.
Aid for converting
IBM MQ options numerical values to their constant values.
Aid for getting performance statistics reports from distributed trace.
Skill Level Required:
This SupportPac requires a working knowledge of IBM MQ administration.

New in this Release:


  • Supports IBM MQ 9.2.
  • Enhanced amqsact (Application Activity Trace sample) formatting in mqtrcfrmt.
  • Multi line search capability for -s command line argument in mqtrcfrmt.
  • Over 50% wall time reduction by changing to buffered I/O for writing to output trace files for mqtrcfrmt.
  • New -b command line argument to provide percentage status of how much of the total trace lines has been processed by mqtrcfrmt.
  • Corrected mqtrcfrmt bug for when you specify only the -f and -v command line options, it was incorrectly requiring a -i command line argument.
  • Corrected mqtrcfrmt parsing issue with recent windows strmqtrc that added non trace bytes between the dump hex prefix and actual dump bytes.

Author: Tim Zielke, CICS/MQ Systems Programmer for Alight Solutions
 Category: 4
Released: 26Nov13
Last updated: 08Sept20
Current SupportPac Version: 1.4
»Please note that the version number shown in the right-hand pane is the version of the IBM MQ or IBM WebSphere Message Broker product that this SupportPac applies to. The date is the last web page refresh.

To view the complete portfolio of IBM MQ SupportPacs, visit the IBM WebSphere MQ SupportPacs home page.


This SupportPac requires a current version of IBM MQ running on a supported operating system platform.

Installation Instructions

1. Download to a temporary location.
2. Decompress with your favorite tool to a location of your choice.
3. This creates the necessary files and directory.
4. The MH06.pdf manual gives more details on how to use the MH06 Trace Tools SupportPac.

[{"DNLabel":"","DNDate":"25 Aug 2020","DNLang":"US English","DNSize":"753601 B","DNPlat":{"label":"Other","code":"PF059"},"DNURL":"","DNURL_FTP":"","DDURL":null}]

Technical Support

Category 4 SupportPacs are provided by third-party suppliers (for example, customers, business partners, vendors) and not by IBM. The material is provided without any warranty or support from IBM. Any special support arrangements might be described within any downloaded material, or on the third-party supplier's website.

By making any material available for downloading from this site, IBM is making no endorsement of any of these third-party suppliers, or of their products.

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"ARM Category":[{"code":"a8m50000000ClNjAAK","label":"MQ Supported Versions"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"All Version(s)"}]

Document Information

Modified date:
28 September 2023