[jboss-svn-commits] JBL Code SVN: r36244 - labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US.

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

Author: misty at redhat.com
Date: 2010-12-07 20:18:42 -0500 (Tue, 07 Dec 2010)
New Revision: 36244

Modified:
   labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml
Log:
Converted JTA_And_JTS.xml

Modified: labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml	2010-12-08 01:09:30 UTC (rev 36243)
+++ labs/jbosstm/trunk/ArjunaJTS/docs/ArjunaJTS_Development_Guide/en-US/JTA_And_JTS.xml	2010-12-08 01:18:42 UTC (rev 36244)
@@ -4,6 +4,41 @@
 %BOOK_ENTITIES;
 ]>
 <chapter id="chap-ArjunaJTS_Development_Guide-Test_Chapter">
-  <title></title>
+  <title>JTA and JTS</title>
+  
+  <section>
+    <title>Distributed JTA</title>
+    <para>
+      This guide describes how to use the JTA interfaces for purely local transactions. This is a high-performance
+      implementation, but you can only use it to execute transactions within the same process. If you need support for
+      distributed transactions, the JTA needs to use the JTS. Another advantage of this approach is interoperability
+      with other JTS-compliant transaction systems.
+    </para>
+    <note>
+      <para>
+        If you use the JTS and JTA interfaces to manage the same transactions, the JTA needs to be configured to be
+        aware of the JTS. Otherwise, local transactions will be unaware of their JTS counterparts.
+      </para>
+    </note>
+    <para>
+      You need to do this configuration manually, because some applications may be using JBossTS in a purely local
+      manner, or may need to differentiate between transactions managed by JTS and JTA.
+    </para>
+    <procedure>
+      <title>Making the JTA interfaces JTS-aware</title>
+      <step>
+        <para>
+          Set <varname>JTAEnvironmentBean.jtaTMImplementation</varname> to
+          <literal>com.arjuna.ats.internal.jta.transaction.jts.TransactionManagerImple</literal>.
+        </para>
+      </step>
+      <step>
+        <para>
+          Set <varname>JTAEnvironmentBean.jtaUTImplementation</varname> to
+          <literal>com.arjuna.ats.internal.jta.transaction.jts.UserTransactionImple</literal>.
+        </para>
+      </step>
+    </procedure>
+  </section>
 </chapter>