A fix is available
APAR status
Closed as program error.
Error description
The problem occurs when retained publications are put under an implicit syncpoint, so when not specifying MQPMO_SYNCPOINT or MQPMO_NO_SYNCPOINT. The root cause of the problem is incorrect checking for a syncpoint put in CSQMTPUT. This can result in messages incorrectly building up on the SYSTEM.RETAINED.PUB.QUEUE. If messages are backed out then this can also result in retained publications incorrectly being deleted from the SYSTEM.RETAINED.PUB.QUEUE.
Local fix
To address the incorrect syncpoint issue for retained publications, users can specify either MQPMO_SYNCPOINT or MQPMO_NO_SYNCPOINT explicitly when putting messages. This ensures that the syncpoint handling is correctly managed, preventing unintended message buildup or deletion on the SYSTEM.RETAINED.PUB.QUEUE.
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM MQ for z/OS Version 9 * * Release 3 Modification 0 and Release 4 * * Modification 0 * **************************************************************** * PROBLEM DESCRIPTION: The issue arises when retained * * publications do not explicitly set a * * syncpoint value (without specifying * * MQPMO_SYNCPOINT or MQPMO_NO_SYNCPOINT). * * This incorrect checking for a syncpoint * * leads to messages incorrectly building * * up on the SYSTEM.RETAINED.PUB.QUEUE. * * Additionally, if messages are backed * * out, retained publications may be * * incorrectly deleted from the queue. * **************************************************************** The root cause of the problem is the incorrect handling of implicit syncpoints when publishing using the retained publication option. This results in unintended message buildup and deletion behaviours on the SYSTEM.RETAINED.PUB.QUEUE.
Problem conclusion
The issue of incorrect syncpoint handling for retained publications has been identified. By ensuring the correct resolution, we can prevent unintended behaviour on the SYSTEM.RETAINED.PUB.QUEUE
Temporary fix
Comments
APAR Information
APAR number
PH65978
Reported component name
IBM MQ Z/OS V9
Reported component ID
5655MQ900
Reported release
300
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2025-04-03
Closed date
2025-07-02
Last modified date
2025-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UO03897 UO03898
Modules/Macros
CSQMTPUT
Fix information
Fixed component name
IBM MQ Z/OS V9
Fixed component ID
5655MQ900
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"300","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]
Document Information
Modified date:
02 August 2025