MH06: WebSphere MQ - Trace Tools

Downloadable files


This SupportPac provides simple command line tools (mqtrcfrmt, mqoptions, and mqapitrcstats) to aid in using MQ traces.

Download Description

The tools provided in this SupportPac aid in formatting MQ data structures and fields into a more human readable format. The mqtrcfrmt tool takes a distributed MQ trace as input and writes out as output the trace file contents but with MQ data structures and fields (i.e. msgdesc, objdesc, reason code) expanded into human readable lines that show the individual data fields and also what constants the numerical values represent.

The mqoptions tools take the numerical value of an MQ option field (i.e. GMO) and display the MQ constant values (i.e. MQGMO_WAIT) that the numerical value represents.

The mqapitrcstats tool produces a performance statistics report from the trace.

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:

  • Mqoptions executable has been changed to a Java MQOptions.class that is more portable and robust when working with deciphering MQ options.
  • Pub/Sub support for distributed traces.
  • Pub/Sub and Callback support for z/OS traces.
  • Report option added to mqoptions.
  • Manual in PDF format.
  • v8 support.
  • Windows 64 bit trace formatting support.
  • Application Activity Trace formatting support.

  • Very significant performance improvements, especially for large traces with numerous threads.
  • More data structures are expanded, and z/OS user parameter trace control block formatting is added.
  • Formatting and alignment is changed to support a user customizable summary API trace.
  • Windows executable is now provided for all tools.
  • New tool to produce a performance statistics report from the trace.

Author: Tim Zielke, CICS/MQ Systems Programmer for Aon
 Category: 4
Released: 26Nov13
Last updated: 27Jul15
Current SupportPac Version: 1.0.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 WebSphere MQ V7 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 readme.txt explains how to use the mqoptions, mqtrcfrmt, and mqapitrcstats tools.

Download package

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options 27 Jul 2015 US English 540548 FTP

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.

Document information

More support for:

WebSphere MQ

Software version:

7.1, 7.5, 8.0

Operating system(s):

Linux, Solaris, Windows, z/OS

Reference #:


Modified date:


Translate my page

Content navigation