Download
Abstract
This SupportPac provides a Java command line tool called mqtrcfrmt to aid in reading IBM MQ traces.
Download Description
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:
25Aug20:
- 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.
Details:
Author: Tim Zielke, CICS/MQ Systems Programmer for Alight Solutions
e-mail: tim.zielke@alight.com
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.
Prerequisites
This SupportPac requires a current version of IBM MQ running on a supported operating system platform.
Installation Instructions
1. Download mh06.zip to a temporary location.
2. Decompress mh06.zip 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.
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.
Was this topic helpful?
Document Information
Modified date:
28 September 2023
UID
swg24036430