PK01477: ENLIST ERRORS CAUSE MESSAGE-DRIVEN BEANS TO STOP DETECTING MESSAGES, AND THE APPLICATION SERVER TO HANG WHEN SHUTTING DOWN

 Fixes are available

5.1.1.17: WebSphere Application Server V5.1.1 Cumulative Fix 17 for AIX
5.1.1.17: WebSphere Application Server V5.1.1 Cumulative Fix 17 for HP-UX
5.1.1.19: WebSphere Application Server V5.1.1 Cumulative Fix 19 for Linux
5.1.1.16: WebSphere Application Server V5.1.1 Cumulative Fix 16 for AIX
5.1.1.18: WebSphere Application Server V5.1.1 Cumulative Fix 18 for AIX
5.1.1.18: WebSphere Application Server V5.1.1 Cumulative Fix 18 for HP-UX
5.1.1.18: WebSphere Application Server V5.1.1 Cumulative Fix 18 for Solaris
5.1.1.18: WebSphere Application Server V5.1.1 Cumulative Fix 18 for Windows
5.1.1.18: WebSphere Application Server V5.1.1 Cumulative Fix 18 for Linux
5.1.1.17: WebSphere Application Server V5.1.1 Cumulative Fix 17 for Linux
5.1.1.17: WebSphere Application Server V5.1.1 Cumulative Fix 17 for Solaris
5.1.1.17: WebSphere Application Server V5.1.1 Cumulative Fix 17 for Windows
6.0.2: WebSphere Application Server V6.0 Refresh Pack 2 for AIX platforms
5.0.2.17: WebSphere Application Server 5.0.2 Cumulative Fix 17 for Solaris
5.0.2.17: WebSphere Application Server 5.0.2 Cumulative Fix 17 for Windows
5.0.2.14: WebSphere Application Server 5.0.2 Cumulative Fix 14 for Solaris
5.1.1.10: WebSphere Application Server V5.1.1 Cumulative Fix 10 for Windows
5.1.1.10: WebSphere Application Server V5.1.1 Cumulative Fix 10 for AIX
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for AIX
5.0.2.14: WebSphere Application Server 5.0.2 Cumulative Fix 14 for Linux
5.1.1.19: WebSphere Application Server V5.1.1 Cumulative Fix 19 for AIX
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for Windows
5.1.1.19: WebSphere Application Server V5.1.1 Cumulative Fix 19 for Windows
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for HP-UX
5.1.1.9: WebSphere Application Server V5.1.1 Cumulative Fix 9 for Solaris
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for Solaris
5.0.2.15: WebSphere Application Server 5.0.2 Cumulative Fix 15 for Windows
5.0.2.15: WebSphere Application Server 5.0.2 Cumulative Fix 15 for Solaris
5.0.2.15: WebSphere Application Server 5.0.2 Cumulative Fix 15 for AIX
5.1.1.9: WebSphere Application Server V5.1.1 Cumulative Fix 9 for AIX
5.0.2.15: WebSphere Application Server 5.0.2 Cumulative Fix 15 for Linux
6.0.2: WebSphere Application Server V6.0 Refresh Pack 2 for HP-UX platforms
6.0.2: WebSphere Application Server V6.0 Refresh Pack 2 for OS/400 platforms
5.0.2.12: WebSphere Application Server 5.0.2 Cumulative Fix 12
5.1.1.6: WebSphere Application Server Version 5.1.1 Cumulative Fix 6
5.1.1.7: WebSphere Application Server Version 5.1.1 Cumulative Fix 7
5.0.2.14: WebSphere Application Server 5.0.2 Cumulative Fix 14 for HP-UX
5.0.2.14: WebSphere Application Server 5.0.2 Cumulative Fix 14 for AIX
5.1.1.4: WebSphere Application Server Version 5.1.1 Cumulative Fix 4
5.1.1.9: WebSphere Application Server V5.1.1 Cumulative Fix 9 for Windows
5.0.2.17: WebSphere Application Server 5.0.2 Cumulative Fix 17 for HP-UX
5.0.2.17: WebSphere Application Server 5.0.2 Cumulative Fix 17 for AIX
5.1.1.11: WebSphere Application Server V5.1.1 Cumulative Fix 11 for AIX
5.0.2.17: WebSphere Application Server 5.0.2 Cumulative Fix 17 for Linux
5.1.1.10: WebSphere Application Server V5.1.1 Cumulative Fix 10 for HP-UX
6.0.2: WebSphere Application Server V6.0 Refresh Pack 2 for Solaris platforms
5.1.1.10: WebSphere Application Server V5.1.1 Cumulative Fix 10 for Linux
5.1.1.9: WebSphere Application Server V5.1.1 Cumulative Fix 9 for HP-UX
5.1.1.9: WebSphere Application Server V5.1.1 Cumulative Fix 9 for Linux
5.0.2.16: WebSphere Application Server 5.0.2 Cumulative Fix 16 for HP-UX
5.1.1.12: WebSphere Application Server V5.1.1 Cumulative Fix 12 for Windows
5.0.2.16: WebSphere Application Server 5.0.2 Cumulative Fix 16 for Solaris
5.0.2.16: WebSphere Application Server 5.0.2 Cumulative Fix 16 for Windows
5.0.2.16: WebSphere Application Server 5.0.2 Cumulative Fix 16 for AIX
PK09325; 5.1.1.4: Deadlock conditions after server sessions are returned to pool
5.1.1.11: WebSphere Application Server V5.1.1 Cumulative Fix 11 for Windows
5.1.1.16: WebSphere Application Server V5.1.1 Cumulative Fix 16 for Solaris
5.0.2.18: WebSphere Application Server 5.0.2 Cumulative Fix 18 for Solaris
5.1.1.11: WebSphere Application Server V5.1.1 Cumulative Fix 11 for Linux
5.0.2.18: WebSphere Application Server 5.0.2 Cumulative Fix 18 for Windows
5.0.2.18: WebSphere Application Server 5.0.2 Cumulative Fix 18 for HP-UX
5.0.2.18: WebSphere Application Server 5.0.2 Cumulative Fix 18 for AIX
5.1.1.16: WebSphere Application Server V5.1.1 Cumulative Fix 16 for Windows
5.1.1.14: WebSphere Application Server V5.1.1 Cumulative Fix 14 for Solaris
5.0.2.14: WebSphere Application Server 5.0.2 Cumulative Fix 14 for Windows
5.1.1.12: WebSphere Application Server V5.1.1 Cumulative Fix 12 for AIX
5.1.1.12: WebSphere Application Server V5.1.1 Cumulative Fix 12 for Linux
5.1.1.12: WebSphere Application Server V5.1.1 Cumulative Fix 12 for HP-UX
5.1.1.12: WebSphere Application Server V5.1.1 Cumulative Fix 12 for Solaris
5.1.1.11: WebSphere Application Server V5.1.1 Cumulative Fix 11 for Solaris
5.1.1.13: WebSphere Application Server V5.1.1 Cumulative Fix 13 for AIX
5.1.1.13: WebSphere Application Server V5.1.1 Cumulative Fix 13 for Windows
5.0.2.13: WebSphere Application Server 5.0.2 Cumulative Fix 13
5.1.1.13: WebSphere Application Server V5.1.1 Cumulative Fix 13 for HP-UX
5.1.1.15: WebSphere Application Server V5.1.1 Cumulative Fix 15 for Solaris
5.1.1.13: WebSphere Application Server V5.1.1 Cumulative Fix 13 for Solaris
5.1.1.13: WebSphere Application Server V5.1.1 Cumulative Fix 13 for Linux
5.1.1.14: WebSphere Application Server V5.1.1 Cumulative Fix 14 for AIX
5.1.1.14: WebSphere Application Server V5.1.1 Cumulative Fix 14 for Linux
5.1.1.14: WebSphere Application Server V5.1.1 Cumulative Fix 14 for Windows
6.0.2: WebSphere Application Server V6.0 Refresh Pack 2 for Windows platforms
6.0.2: WebSphere Application Server V6.0 Refresh Pack 2 for Linux platforms
5.1.1.15: WebSphere Application Server V5.1.1 Cumulative Fix 15 for Windows
5.0.2.18: WebSphere Application Server 5.0.2 Cumulative Fix 18 for Linux
5.1.1.11: WebSphere Application Server V5.1.1 Cumulative Fix 11 for HP-UX
5.1.1.14: WebSphere Application Server V5.1.1 Cumulative Fix 14 for HP-UX
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for Linux
5.0.2.15: WebSphere Application Server 5.0.2 Cumulative Fix 15 for HP-UX
6.0.1.2: WebSphere Application Server Version 6.0.1 Fix Pack 2
5.0.2.16: WebSphere Application Server 5.0.2 Cumulative Fix 16 for Linux
5.1.1.10: WebSphere Application Server V5.1.1 Cumulative Fix 10 for Solaris
PK02976; 5.1.1.3: JAVA Message service listener port deadlock
5.1.1.15: WebSphere Application Server V5.1.1 Cumulative Fix 15 for AIX
5.1.1.15: WebSphere Application Server V5.1.1 Cumulative Fix 15 for HP-UX
PK09325; 5.1.1.4: Deadlock conditions after server sessions are returned to pool
5.1.1.16: WebSphere Application Server V5.1.1 Cumulative Fix 16 for HP-UX
5.1.1.16: WebSphere Application Server V5.1.1 Cumulative Fix 16 for Linux
5.1.1.15: WebSphere Application Server V5.1.1 Cumulative Fix 15 for Linux
5.1.1.19: WebSphere Application Server V5.1.1 Cumulative Fix 19 for HP-UX



APAR status
Closed as program error.

Error description
After the following error messages appear in the WebSphere
Application Server system log :

XATransaction E J2CA0030E: Method enlist caught
javax.transaction.SystemException: Failed to start the
transaction association.
at
com.ibm.ejs.jts.jta.TransactionImpl.enlistResource(TransactionIm
pl.java(Compiled Code))
at com.ibm.ejs.jts.jta.JTSXA.enlist(JTSXA.java(Compiled Code))
...
while trying to enlist resources from datasource < queue
connection factory> with the Transaction Manager for the current
transaction, and threw a ResourceException.

ConnectionEve A J2CA0056I: The Connection Manager received a
fatal connection error from the Resource Adaptor for resource
<nam>.  The exception which was received is
javax.jms.JMSException: Enlist failed

ExceptionUtil E CNTR0020E: Non-application exception occurred
while processing method "onMessage" on bean <message driven
bean>. Exception data:
java.lang.reflect.InvocationTargetException:
javax.jms.JMSException: Enlist failed
at
com.ibm.ejs.jms.JMSCMUtils.mapToJMSException(JMSCMUtils.java(Com
piled Code))
at
com.ibm.ejs.jms.JMSManagedSession.enlist(JMSManagedSession.java(
Compiled Code))

the message-driven beans (MDBs) named in the errors stop
receiving messages.

Occassionally, following this error, the application server will
hang when shutting down.

This problem only occurs if the MDBs named in the errors are
using Listener Ports that have their Maximum sessions property
set to a value greater than 1. APAR 
PK00582 describes a problem
with similar symptoms - however, that APAR only applies if
the Maximum sessions property for the Listener Port is set to
the value 1.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: This problem affects customers who use the   *
*                 Java Message Service (JMS) functionality     *
*                 provided with WebSphere Application Server   *
*                 Version 5.x.                                 *
****************************************************************
* PROBLEM DESCRIPTION: After the following error messages      *
*                      appear in the WebSphere Application     *
*                      Server system log :                     *
*                                                              *
*                      J2CA0030E: Method enlist caught         *
*                        javax.transaction.SystemException:    *
*                        Failed to start the transaction       *
*                        association.                          *
*                      at com.ibm.ejs.jts.jta.                 *
*                        TransactionImpl.enlistResource        *
*                        (TransactionIm pl.java(Compiled       *
*                         Code))                               *
*                      at com.ibm.ejs.jts.jta.JTSXA.enlist     *
*                        (JTSXA.java(Compiled Code))           *
*                      ...                                     *
*                                                              *
*                      while trying to enlist resources from   *
*                      datasource <queue connection factory>   *
*                      with the Transaction Manager for the    *
*                      current transaction, and threw a        *
*                      ResourceException.                      *
*                                                              *
*                      J2CA0056I: The Connection Manager       *
*                        received a fatal connection error     *
*                        from the Resource Adaptor for         *
*                        resource <name>.  The exception       *
*                        which was received is                 *
*                        javax.jms.JMSException:               *
*                        Enlist failed                         *
*                                                              *
*                                                              *
*                      the message-driven beans (MDBs) named   *
*                      in the errors stop receiving messages,  *
*                      and the application server hangs when   *
*                      shutting down.                          *
*                                                              *
*                      This problem only occurs if the MDBs    *
*                      named in the errors are using           *
*                      Listener Ports that have their          *
*                      Maximum sessions property set to a      *
*                      value greater than 1.                   *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
When the Enlist error occurs, a deadlock is reached as we
have multiple Server Sessions blocked on a Connection Handle
object that is in use by the first Session that detected the
error - however, this first Server Session is blocked as it
is waiting for the other Sessions to finish processing the
error.
Problem conclusion
The application server's Server Session Pool has been
rewritten to prevent the deadlock condition from being
reached.

The fix for this APAR is currently targeted for inclusion
in Cumulative Fix 11 for WebSphere Application Server Version
5.0.2, Cumulative Fix 4 for WebSphere Application Server
Version 5.1.1 and Cumulative Fix 3 for WebSphere Application
Server Version 6.0.0. Please refer to the Recommended Updates
page for delivery dates:

  
http://www-1.ibm.com/support/
docview.wss?rs=180&context=SSEQTP&uid=swg27004980
Temporary fix Comments
APAR information
APAR number PK01477
Reported component name WAS BASE 5.0
Reported component ID 5630A3600
Reported release 00S
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2005-02-22
Closed date 2005-03-09
Last modified date 2005-03-09

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
MSGING          

Publications Referenced

Fix information

Applicable component levels
R003 PSY    UP
R00A PSY    UP
R00H PSY    UP
R00I PSY    UP
R00P PSY    UP
R00S PSY    UP
R00W PSY    UP
R103 PSY    UP
R10A PSY    UP
R10H PSY    UP
R10I PSY    UP
R10P PSY    UP
R10S PSY    UP
R10W PSY    UP


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s):
Software version: 00S
Software edition:
Reference #: PK01477
IBM Group: Software Group
Modified date: Mar 9, 2005