A fix is available
APAR status
Closed as program error.
Error description
When IMS rejects a message with some sense code and the queue manager will then try to put the message to the dead-letter queue but the page set where it resides is full, CSQ2004E is issued with the reason for failure (MQRC=2192). Then the process which gets messages from the IMS Bridge queue will end, and it will be restarted by get-disable/enabling the IMS Bridge queue or restarting the queue manager. Stop / start the TPIPE also solves the issue. No specific console message is produced alerting that the process which gets message from an IMS Bridge queue is not running any more. This APAR was raised to issue a message alerting this fact, so a System Automation tool can catch the message and notify about the concern.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM MQ for z/OS Version 9 * * Release 0 Modification 0, Release 1 * * Modification 0, Release 2 Modification 0 and * * Release 3 Modification 0. * **************************************************************** * PROBLEM DESCRIPTION: When the queue manager is unable to put * * messages rejected by IMS to the dead * * letter queue, processing of messages on * * the IMS bridge queue is stopped. No * * console message is written to indicate * * this and messages build up on the * * bridge queue. * **************************************************************** If the dead letter queue cannot be written to for a rejected message, for example due to lack of space, IMS bridge processing is stopped for the bridge queue concerned. Processing is only restarted by GET disabling and re-enabling the IMS bridge queue or restarting the queue manager. However there is no console message to indicate which IMS bridge queue is affected.
Problem conclusion
Message CSQ2007I will now be issued in this case to provide the name of the bridge queue for which processing has stopped. The following information is added to the IBM Documentation for IBM MQ for z/OS: IBM MQ Reference Messages and reason codes IBM MQ for z/OS messages, completion, and reason codes Messages for IBM MQ for z/OS IBM MQ-IMS bridge Messages (CSQ2...) CSQ2007I csect-name PROCESSING HAS STOPPED FOR IMS BRIDGE QUEUE q-name, XCFGNAME=gname XCFMNAME=mname TPIPE=tpipename Explanation This message follows message CSQ2004E, for csect name CSQ2PUTD failing to put a message in the dead-letter queue. The process which gets messages from the IMS bridge queue ends. The information provided in the message is: q-name The name of the IMS bridge queue. gname The XCF group to which the partner belongs. mname The member name of the partner. tpipename The name of the Tpipe used by the partner. System action Messages on this queue are no longer processed by the IMS bridge on this member. System programmer response To resume processing, GET disable and re-enable the IMS bridge queue or restart the Tpipe for the queue.
Temporary fix
Comments
APAR Information
APAR number
PH37455
Reported component name
IBM MQ Z/OS V9
Reported component ID
5655MQ900
Reported release
000
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-05-21
Closed date
2022-08-25
Last modified date
2022-10-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI80772 UI80773 UI80774 UI80775 UI80776 UI80777 UI80778 UI80779
UI80780 UI80781 UI80782 UI80783 UI80784 UI80785 UI80786 UI80787
UI80788
Modules/Macros
CSQ2QCP0 CSQF2DIC CSQF2DIE CSQF2DIF CSQF2DIK CSQF2DIU CSQFMTXC CSQFMTXE CSQFMTXF CSQFMTXK CSQFMTXU
Fix information
Fixed component name
IBM MQ Z/OS V9
Fixed component ID
5655MQ900
Applicable component levels
R100 PSY UI80778
UP22/07/01 P F206
R101 PSY UI80779
UP22/07/01 P F206
R102 PSY UI80780
UP22/07/01 P F206
R103 PSY UI80781
UP22/07/01 P F206
R104 PSY UI80782
UP22/07/01 P F206
R105 PSY UI80783
UP22/07/01 P F206
R200 PSY UI80772
UP22/07/01 P F206
R201 PSY UI80773
UP22/07/01 P F206
R202 PSY UI80774
UP22/07/01 P F206
R203 PSY UI80775
UP22/07/01 P F206
R204 PSY UI80776
UP22/07/01 P F206
R205 PSY UI80777
UP22/07/01 P F206
R300 PSY UI82098
UP22/09/17 P F209
R301 PSY UI82099
UP22/09/17 P F209
R302 PSY UI82100
UP22/09/17 P F209
R303 PSY UI82101
UP22/09/17 P F209
R304 PSY UI82102
UP22/09/17 P F209
R305 PSY UI82103
UP22/09/17 P F209
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.
Document Information
Modified date:
07 October 2022