Troubleshooting
Problem
Operations performed on persistent messages passing through an IBM MQ queue manager are logged. This document provides a tool and set of instructions to read that log data for a distributed IBM MQ queue manager, extract the persistent messages, and see the transactions and operations performed (puts/gets/commits/rollbacks).
Symptom
Example situations where you might use this document:
Warning: For persistent messages sent outside of syncpoint, there is a possibility that messages will not be written to the recovery log.
- An application team using persistent messages is asking "Where's my message?", or asserting "IBM MQ lost my message", and you want to look back in time and see what happened to the message in IBM MQ to help explain the situation to the application team and show IBM MQ was not at fault..
- An application has processed a set of messages incorrectly, and needs to recover the original message payload in order to investigate the problem, or recover the business data.
- An application performed, or is performing, a long running unit of work, and you want to look back and see what messages and operations are involved in that unit of work.
- You require an audit log of transactions with persistent messages that pass through your IBM MQ infrastructure, and wish to exploit the recovery logging built into the product for this purpose, rather than implementing an additional layer of auditing on top.
Warning: For persistent messages sent outside of syncpoint, there is a possibility that messages will not be written to the recovery log.
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"ARM Category":[{"code":"a8m3p000000PCH0AAO","label":"Administration"}],"ARM Case Number":"TS019828725","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.2.0;9.3.0;9.4.0"}]
Log InLog in to view more of this document
This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.
Was this topic helpful?
Document Information
Modified date:
27 August 2025
UID
swg21660642