IBM Support

PI75819: WMQ IN QUEUE SHARING GROUP A QMGR KEEPS ENQUEUE AGAINST BSDS OF ANOTHER QSG MEMBER

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • In a queue sharing group a member is restarted. At that
    time the member will attempt to access the BSDS of another
    member that is currently inactive. That ENQueue will continue
    until the member is stopped.
    Change Team finds the problem occurs as CSQJXCFT is using
    XCFUData.ConnState to determine whether the peer queue manager
    is active, but XCFUData.ConnState is not current if the peer
    queue manager has been canceled.
    ADDITIONAL INFORMATION :
    Syslog may contain messages such as IEC161I 056-084
    specifying the BSDS name.
    CSQE006I IGD104I
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All users of IBM MQ for z/OS Version 9 Release 0             *
    * Modification 0.                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * After a queue manager performs Peer Level Recovery (PLR) for *
    * a failed queue manager in the same queue sharing group, the  *
    * queue managers fails to release an ENQ on the failed queue   *
    * manager's BSDS.                                              *
    * This ENQ can prevent MQ utilities (for example CSQJUCNV)     *
    * running against the failed queue manager's BSDS until the    *
    * other queue manager has been stopped.                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * None                                                         *
    ****************************************************************
    During PLR, the queue manager allocates and opens the failed
    peer's BSDS if necessary to determine the true state of an
    incomplete unit of work, resulting in an ENQ being held on the
    peer's BSDS.
    When the queue manager attempts to close the BSDS, it should
    deallocate and close the BSDS, however an incorrect check on the
    state of the peer causes it to skip closing the dataset and
    consequently skip releasing the ENQ.
    

Problem conclusion

  • CSQJXCFT is changed to correctly determine the state of the peer
    queue manager when determining if it should close and deallocate
    the peer's BSDS.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI75819

  • Reported component name

    MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-02-01

  • Closed date

    2017-02-13

  • Last modified date

    2017-02-13

  • APAR is sysrouted FROM one or more of the following:

    PI68106

  • APAR is sysrouted TO one or more of the following:

    UI44616

Modules/Macros

  • CSQJXCFT
    

Fix information

  • Fixed component name

    MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY

       UP



Document information

More support for: z/OS family

Software version: 9.0

Reference #: PI75819

Modified date: 13 February 2017