PH37455: NEW MESSAGE TO ALERT THAT THE IBM MQ-IMS BRIDGE PROCESS THAT READS THE IMS BRIDGE QUEUE STOPPED

Obtain the fix for this APAR.

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 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.