Handling broker reports

 

The WebSphere MQ JMS implementation uses report messages from the broker to confirm whether registration and de-registration requests have been successful. These report messages are sent to the queue, SYSTEM.JMS.REPORT.QUEUE, on the local queue manager and are normally consumed by the WebSphere MQ JMS. Under some error conditions, however, they might remain on the queue.

WebSphere MQ JMS supplies a Java™ application, PSReportDump, which dumps the contents of the queue, SYSTEM.JMS.REPORT.QUEUE, in plain text format. The information in the dump can be analyzed by you or by IBM support staff. We can also use the application to delete all the messages in the queue after a problem is diagnosed or fixed.

The compiled form of the application is in the <MQ_JAVA_INSTALL_PATH>/bin directory. To start the application, change to this directory and use the following command:

java -Djava.library.path=library_path
     PSReportDump [-m queueManager] [-clear]

where library_path is the path to the WebSphere MQ Java libraries (see The WebSphere MQ Java libraries), and:

-m queueManager

Specifies the name of the queue manager to use

-clear

Causes all the messages on the queue to be deleted after their contents have been dumped

Attention: Do not use this option if you are using a broker based subscription store. Instead, run the manual cleanup utility in FORCE mode.

The output from the application is sent to the screen, or we can redirect it to a file.

uj25290_