A fix is available
APAR status
Closed as program error.
Error description
Background info: A JMS consumer.receiveBody() method works by first browse locking the candidate message and then performing the destructive get of the message. Error info: When browse locking a message on a shared queue, the message is moved to an internal browse lock queue, represented by a coupling facility list, so that other applications don't see the message. The destructive get for the message is then done by matching on the MsgToken. MQ uses coupling facility list authorities to track changes to shared queues, and we have identified a defect which causes MQ to use the wrong list authority when getting a browse locked message by MsgToken. This leads to 5C6-00C9FEEE and 5C6-00E7014F abends.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM MQ for z/OS Version 9 * * Release 1 Modification 0 and Release 2 * * Modification 0. * **************************************************************** * PROBLEM DESCRIPTION: When getting a browse-locked message by * * MsgToken from a shared queue with * * MQMO_MATCH_MSG_TOKEN, ABEND * * 5C6-00C9FEEE and 5C6-00E7014F may * * occur. * * * * This can occur when using the JMS * * consumer.receiveBody() method. * **************************************************************** MQ uses XES List Authorities to keep in-memory copies of MQ shared queue control blocks up to date. A defect in the MQGET by MsgToken logic results in the QMGR using the wrong list authority for browse-locked messages.
Problem conclusion
The code has been changed to use the correct list authority when getting a browse-locked message by MsgToken from a shared queue.
Temporary fix
Comments
APAR Information
APAR number
PH32169
Reported component name
IBM MQ Z/OS V9
Reported component ID
5655MQ900
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2020-11-30
Closed date
2020-12-16
Last modified date
2021-02-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI73170 UI73171
Modules/Macros
CSQEMGEK
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.
[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"100"}]
Document Information
Modified date:
02 February 2021