IBM Support

PH65978: INCORRECT SYNCPOINT ISSUE FOR SYSTEM.RETAINED.PUB.QUEUE

A fix is available

Subscribe

You can track all active APARs for this component.

 

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

  • R300 PSY UO03898

       UP25/07/12 P F507

  • R400 PSY UO03897

       UP25/07/12 P F507

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