MustGather: Java Transaction Service (JTS) problems in V4.0, V5.0, V5.1 and V6.0
 Technote (FAQ)
 
Problem
MustGather for problems with the WebSphere® Application Server JTS component for all releases of V4.0, V5.0, V5.1 and V6.0. Gathering this information before calling IBM® support helps familiarize you with the troubleshooting process and saves you time.
 
Solution
If you already contacted support, continue to the component-specific MustGather information. Otherwise, click MustGather: Read first for all WebSphere Application Server products.


Java™ Transaction Services (JTS) specific MustGather information
  • General questions
    1. Detailed description of the application topology and when the problem scenario occurs.

    2. Is the resource (data source, J2C Connector, or a Message handling queue) starting the transaction a one-phase or two-phase (XA) commit?

    3. What are the application server's transaction timeout and transaction inactivity timeout?

    4. Are there any third-party Resource Managers involved (for example: Tuxedo, CICS® Transaction Manager, Unisys Transaction Manager, and so forth)?

  • Collecting log files
    1. Resource properties (included in the XML export of the Application Server configuration).

    2. Application Server stderr, stdout, and activity.log files.
      • For releases of WebSphere Application Server V4.0, the files are located in the directory:

        install_root\logs

      • For releases of WebSphere Application Server V5.0, V5.1 and V6.0, the SystemErr.log and SystemOut.log files are located in directory:

        install_root\logs\server1

        The first-failure data capture (FFDC) logs are located in the directory:

        install_root\logs\ffdc

  • Analyzing log files
    After collecting the Application Server logs, identify the exceptions issued in the time frame surrounding the abnormal behavior. When looking through the exception stack (which reads bottom-up), you might encounter a transaction problem in which the last method called in the exception stack contains a class method with suffix com.ibm.ejs.jts.*. Some keywords and exceptions that can suggest a JTS problem:
    • TransactionRolledBackException
    • CSITransactionRolledbackException
    • XAER_RMERR
    • Transaction has timed out after nnn seconds

  • Collecting Transactions trace
    The JTS trace on its own can often show there is a problem, but might not indicate the origin of the problem. The JTS trace is most useful when combined with EJB Container and Connection Manager traces.
    • For releases of WebSphere Application Server V4.0 and V5.0, the following Transaction traces are required:

      com.ibm.ejs.container.*=all=enabled
      com.ibm.ejs.csi.*=all=enabled
      com.ibm.ejs.persistence.*=all=enabled
      com.ibm.ejs.cm.*=all=enabled
      com.ibm.ejs.jts.*=all=enabled
      com.ibm.ws.LocalTransaction.*=all=enabled
      (V5.0 only)

    • For releases of WebSphere Application Server V5.1 and V6.0, the following Transaction traces are required:

      com.ibm.ejs.container.*=all=enabled
      com.ibm.ejs.csi.*=all=enabled
      com.ibm.ejs.persistence.*=all=enabled
      com.ibm.ejs.cm.*=all=enabled
      WAS.j2c=all=enabled
      WAS.database=all=enabled
      com.ibm.ws.Transaction.*=all=enabled
      com.ibm.ws.LocalTransaction.*=all=enabled

  • Collecting ActivityService and ActivitySessions trace
    The ActivityService is an underlying Unit of Work Service that is used by a growing number of components. Also, ActivitySessions provides a higher level of Unit of Work analysis than normal JTS Transactions.
    • For releases of WebSphere Application Server V5.0, the following ActivityService and ActivitySessions traces are required:

      com.ibm.websphere.ActivitySession.*=all=enabled
      com.ibm.ws.ActivitySession.*=all=enabled
      com.ibm.ws.javax.activity.*=all=enabled
      com.ibm.ws.activity.*=all=enabled

    • For releases of WebSphere Application Server V5.1 and V6.0, the following Transaction traces are required:

      com.ibm.websphere.ActivitySession.*=all=enabled
      com.ibm.ws.ActivitySession.*=all=enabled
      com.ibm.ws.javax.activity.*=all=enabled
      com.ibm.ws.activity.*=all=enabled

  • Follow instructions to send diagnostic information to IBM support.

For a listing of all technotes, downloads, and educational materials specific to the JTS component, search the WebSphere Application Server support site.
 
Related information
Submitting information to IBM support
Steps to getting support
MustGather: Read first
Troubleshooting guide
 
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Java Transaction Service (JTS)
Operating system(s): HP-UX
Software version: 4.0
Software edition:
Reference #: 1153216
IBM Group: Software Group
Modified date: Mar 2, 2005