[jboss-svn-commits] JBL Code SVN: r32123 - labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US.

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

Author: misty at redhat.com
Date: 2010-03-17 02:14:11 -0400 (Wed, 17 Mar 2010)
New Revision: 32123

Added:
   labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTA_and_JTS.xml
Modified:
   labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml
Log:
Added JTS and JTA chapter


Added: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTA_and_JTS.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTA_and_JTS.xml	                        (rev 0)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTA_and_JTS.xml	2010-03-17 06:14:11 UTC (rev 32123)
@@ -0,0 +1,37 @@
+<?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" [
+]>
+<chapter>
+  <title>JTA and the JTS</title>
+  <para>
+
+  </para>
+  <section>
+    <title>Distributed JTA</title>
+    <para>
+      The <application>JBoss Transaction Service</application> manuals describe how to use the JTA (Java Transaction API) interfaces for purely local transactions. This is a high-performance implementation, but can only be used to execute transactions within the same process. If distributed transaction support is required, then it is necessary for the JTA to use the JTS (Java Transaction Service). This also has the added advantage of providing interoperability with other JTS-compliant transaction systems.
+    </para>
+    <note>
+      <para>
+	If using the JTS and JTA interfaces to manage the same transactions, it is important that the JTA is configured to be aware of the JTS. Otherwise, local transactions will be created which are unaware of their JTS counterparts.
+      </para>
+    </note>
+    <para>
+      This configuration of the JTA to be aware of the JTS is explicit and at the user’s control because it is possible that some applications may be using <application>JBoss Transaction Service</application> in a purely local manner or may want to differentiate between JTS and JTA managed transactions.
+    </para>
+    <para>
+      To make the JTA interfaces JTS-aware, set the following property values:
+    </para>
+    <orderedlist>
+      <listitem>
+	<para><code>.com.arjuna.ats.jta.jtaTMImplementation to com.arjuna.ats.internal.jta.transaction.jts.TransactionManagerImple</code></para>
+      </listitem>
+      <listitem>
+	<para><code>.com.arjuna.ats.jta.jtaUTImplementation to com.arjuna.ats.internal.jta.transaction.jts.UserTransactionImple</code></para>
+      </listitem>
+    </orderedlist>
+  </section>
+  
+
+</chapter>
+

Modified: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml	2010-03-17 06:01:06 UTC (rev 32122)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml	2010-03-17 06:14:11 UTC (rev 32123)
@@ -11,6 +11,7 @@
 	<xi:include href="Interfaces_for_Extending_OTS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="JBossTS-Example.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="Failure_Recovery.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="JTA_and_JTS.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>