[jboss-svn-commits] JBL Code SVN: r37902 - labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US.

[jboss-svn-commits at lists.jboss.org]

Author: tomjenkinson
Date: 2012-03-05 06:46:28 -0500 (Mon, 05 Mar 2012)
New Revision: 37902

Added:
   labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Important_Log_Messages.xml
Modified:
   labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Development_Guide.xml
Log:
JBPAPP-3949 added some notes on important log messages

Modified: labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Development_Guide.xml
===================================================================
--- labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Development_Guide.xml	2012-03-01 16:56:42 UTC (rev 37901)
+++ labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Development_Guide.xml	2012-03-05 11:46:28 UTC (rev 37902)
@@ -12,6 +12,7 @@
   <xi:include href="General_Transaction_Issues.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="Configuration_Options.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="Important_Log_Messages.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <!-- <index /> -->
 </book>

Added: labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Important_Log_Messages.xml
===================================================================
--- labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Important_Log_Messages.xml	                        (rev 0)
+++ labs/jbosstm/branches/JBOSSTS_4_16/docs/development_guide/en-US/Important_Log_Messages.xml	2012-03-05 11:46:28 UTC (rev 37902)
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Development_Guide.ent">
+<!ENTITY PRODUCT "JBoss Transactions">
+<!ENTITY BOOKID "Development_Guide">
+<!ENTITY VERSION "4.16">
+<!ENTITY YEAR "2011">
+<!ENTITY HOLDER "JBoss.org">
+<!ENTITY APPSERVER "JBoss Application Server">
+<!-- <!ENTITY APPSERVER "Enterprise Application Platform Server"> -->]>
+<chapter>
+    <title>Important Log Messages</title>
+    <para>The transaction manager can generate a lot of logging information when configured to log in trace level.
+    Here is a list of some of the log messages to check for.</para>
+    <section>
+        <title>Transaction State Change</title>
+        <para>	The following table  </para>
+        <informaltable>
+            <tgroup cols="2">
+                <tbody>
+                    <row>
+                        <entry>Transaction Begin</entry>
+                        <entry>
+                            <para>When a transaction begins the following code is executed:</para>
+            				<para>com.arjuna.ats.arjuna.coordinator.BasicAction::Begin:1342</para>
+            				<para>tsLogger.logger.trace("BasicAction::Begin() for action-id "+ get_uid());</para>
+                        </entry>
+                    </row>
+                    <row>
+                        <entry>Transaction Commit</entry>
+                        <entry>
+                            <para>When a transaction commits the following code is executed:</para>
+                            <para>com.arjuna.ats.arjuna.coordinator.BasicAction::End:1342</para>
+                            <para>tsLogger.logger.trace("BasicAction::End() for action-id "+ get_uid());</para>
+                        </entry>
+                    </row>
+                    <row>
+                        <entry>Transaction Rollback</entry>
+                        <entry>
+                            <para>When a transaction commits the following code is executed:</para>
+                            <para>com.arjuna.ats.arjuna.coordinator.BasicAction::Abort:1575</para>
+                            <para>tsLogger.logger.trace("BasicAction::Abort() for action-id "+ get_uid());</para>
+                        </entry>
+                    </row>
+                    <row>
+                        <entry>Transaction Timeout</entry>
+                        <entry>
+                            <para>When a transaction times out the following code is executed:</para>
+                            <para>com.arjuna.ats.arjuna.coordinator.TransactionReaper::doCancellations:349</para>
+                            <para>tsLogger.logger.trace("Reaper Worker " + Thread.currentThread() + " attempting to cancel " + e._control.get_uid());</para>
+                            <para>You will then see the same thread rolling back the transaction as shown above</para>
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </informaltable>
+        <important>
+            <para>There are many more logging messages to check for, above are those that we are often asked about.</para>
+        </important>
+    </section>
+</chapter>