|
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
- Detailed description of the application topology and when the problem
scenario occurs.
- Is the resource (data source, J2C Connector, or a Message handling
queue) starting the transaction a one-phase or two-phase (XA) commit?
- What are the application server's transaction timeout and transaction
inactivity timeout?
- Are there any third-party Resource Managers involved (for example:
Tuxedo, CICS® Transaction Manager, Unisys Transaction Manager, and so
forth)?
- Collecting log files
- Resource properties (included in the XML export of the Application
Server configuration).
- Application Server stderr, stdout, and
activity.log files.
- For releases of WebSphere Application Server
V4.0, the files are located in the directory:
- 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. |
|
|