Fix (APAR):  PK02976

Status:  Fix

Release:  5.1.1.3,5.1.1.2,5.1.1.1,5.1.1,5.1.0.4,5.0.2.9,5.0.2.7,5.0.2.10

Operating System:  All

Supersedes Fixes:  PK01477, PK00582, PQ99224

CMVC Defect:  PK02976

Byte size of APAR:  3207863

Date: 2005-05-26

Abstract:  JMS Listener Ports hang if the connection to the JMS provider is lost

Description/symptom of problem:  After the following errors appears in the WebSphere Application Server system log:

WMSG0018E: Error on JMSConnection for MDB <MDB name> , JMSDestination <destination name> : 
javax.jms.JMSException: MQJMS2002: failed to get message from MQ queue
at com.ibm.mq.jms.services.ConfigEnvironment.newException(ConfigEnvironment.java(Inlined Compiled Code))
at com.ibm.mq.jms.MQQueueAgentThread.browse(MQQueueAgentThread.java(Compiled Code))
at com.ibm.mq.jms.MQQueueAgentThread.run(MQQueueAgentThread.java(Compiled Code))
at java.lang.Thread.run(Thread.java:568)
---- Begin backtrace for Nested Throwables
com.ibm.mq.MQException: MQJE001: Completion Code 2, Reason 2162
at com.ibm.mq.MQQueue.getMsg2(MQQueue.java(Compiled Code))
at com.ibm.mq.jms.MQQueueAgentThread.browse(MQQueueAgentThread.java(Compiled Code))
at com.ibm.mq.jms.MQQueueAgentThread.run(MQQueueAgentThread.java(Compiled Code))
at java.lang.Thread.run(Thread.java:568)

WMSG0057E: Error on JMSConnection for MDB <MDB name> , JMSDestination <destination name> , JMS Linked Exception :
com.ibm.mq.MQException: MQJE001: Completion Code 2, Reason 2162
at com.ibm.mq.MQQueue.getMsg2(MQQueue.java(Compiled Code))
at com.ibm.mq.jms.MQQueueAgentThread.browse(MQQueueAgentThread.java(Compiled Code))
at com.ibm.mq.jms.MQQueueAgentThread.run(MQQueueAgentThread.java(Compiled Code))
at java.lang.Thread.run(Thread.java:568)

the message-driven beans (MDBs) named in the errors stop receiving messages, and the application server hangs when shutting down.

Directions to apply fix:  

NOTE:  YOU MUST FIRST DOWNLOAD THE UPDATE INSTALLER TOOL IN ORDER TO INSTALL A FIX.
       The Fix Installer can be downloaded from the following link:
       http://www-3.ibm.com/software/webservers/appserv/support/index.html

1) Create temporary "fix" directory to store the jar file:
             UNIX: /tmp/WebSphere/fix
          Windows: c:\temp\WebSphere\fix

2) Copy jar file to the directory

3) Shutdown WebSphere

4) Follow the Fix installation instructions that are packaged with the Fix Installer on how to install the Fix.

5) Restart WebSphere

6) The temp directory may be removed.

Directions to remove fix:  
NOTE:  FIXES MUST BE REMOVED IN THE ORDER THEY WERE APPLIED.  DO NOT REMOVE A FIX UNLESS
     ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED.  YOU MAY REAPPLY ANY REMOVED FIX.

Example:  If your system has fix1, fix2, and fix3 applied in that order and fix2 is to be
          removed, fix3 must be removed first, fix2 removed, and fix3 re-applied.


1) Shutdown WebSphere

2) Follow the instructions that are packaged with the Fix Installer on how to uninstall the Fix.

3) Restart WebSphere

Directions to re-apply fix:  
1) Shutdown WebSphere

2) Follow the Fix instructions that are packaged with the Fix Installer on how to uninstall and reinstall the Fix.

3) Restart WebSphere



Additional Information: