IBM Support

MH06: WebSphere MQ - Trace Tools



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

Download Description

The mqtrcfrmt Java tool provided in this MH06 Trace Tools SupportPac will take MQ trace files like an MQ distributed trace, z/OS API trace, amqsact trace as input and write out as output the passed in trace file contents but with more helpful formatting around some of the trace data.  For example, an MQ data structure like a GMO will have all the GMO structure fields broken out into their individual names and the field values printed in a human-readable format with 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 MQ field name and value (e.g. MQGMO.Options = 1) and then display the MQ constant values (e.g. MQGMO_WAIT) that the numerical value represents as output.  Mqtrcfrmt also provides other functionality like searching for messages that have a certain string, extracting messages in traces to a file, performance reports of how long the API methods are taking to complete, etc.  More details of the MH06 SupportPac functionality can be found in the MH06.pdf manual

Possible Uses:
Aid for reading MQ traces.
Aid for converting 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 WebSphere 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 WebSphere MQ or WebSphere Message Broker product that this SupportPac applies to. The date is the last webpage refresh.

To view the complete portfolio of WebSphere MQ SupportPacs please visit the WebSphere MQ SupportPacs homepage.


This SupportPac requires a current version of MQ running on the supported Operating System platforms.

Installation Instructions

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

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

Technical Support

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

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":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"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:
08 September 2020