[jboss-cvs] JBossAS SVN: r78302 - projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Sep 9 22:03:53 EDT 2008
Author: irooskov at redhat.com
Date: 2008-09-09 22:03:53 -0400 (Tue, 09 Sep 2008)
New Revision: 78302
Added:
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.ent
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.xml
Removed:
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Appendix.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.ent
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.xml
Modified:
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/An_Introduction_to_the_JTA.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Book_Info.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Configuring_JBossJTA.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Examples.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JDBC_and_Transactions.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Revision_History.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/The_Resource_Manager.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transaction_Recovery.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transactions.xml
projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Using_JBossJTA_in_Application_Servers.xml
Log:
updated for build system
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/An_Introduction_to_the_JTA.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/An_Introduction_to_the_JTA.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/An_Introduction_to_the_JTA.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,8 +4,6 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-An_Introduction_to_the_JTA">
<title>An Introduction to the JTA</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-An_Introduction_to_the_JTA-The_Java_Transaction_API">
<title>The Java Transaction API</title>
<para>
Deleted: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Appendix.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Appendix.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Appendix.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -1,13 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<appendix id="appe-Transactions_JTA_Programmers_Guide-Revision_History">
- <appendixinfo>
- <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- </appendixinfo>
- <title>Revision History</title>
- <para>
- </para>
-</appendix>
-
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Book_Info.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Book_Info.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -3,11 +3,11 @@
]>
<bookinfo id="book-Transactions_JTA_Programmers_Guide-Transactions_JTA_Programmers_Guide">
- <title>JTA Programmers Guide</title>
- <subtitle>for Use with JBoss Enterprise Application Platform</subtitle>
+ <title>JBoss Transactions JTA Programmers Guide</title>
+ <subtitle>for Use with JBoss Enterprise Application Platform 4.3</subtitle>
<edition>2.0</edition>
<pubsnumber>1</pubsnumber>
- <productname>JBoss Transactions</productname>
+ <productname>JBoss Enterprise Application Platform</productname>
<productnumber>4.3</productnumber>
<abstract>
<para>This book is about the Transactions JTA from the view of the
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Configuring_JBossJTA.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Configuring_JBossJTA.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Configuring_JBossJTA.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,8 +4,6 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-Configuring_JBossJTA">
<title>Configuring JBossJTA</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-Configuring_JBossJTA-Configuring_options">
<title>Configuring options</title>
<para>
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Examples.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Examples.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Examples.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,8 +4,6 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-Examples">
<title>Examples</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-Examples-JDBC_example">
<title>JDBC example</title>
<para>
@@ -144,11 +142,11 @@
<para>
This class implements the <interfacename>XAResourceRecovery</interfacename> interface for <code>XAResources</code>. The parameter supplied in setParameters can contain arbitrary information necessary to initialize the class once created. In this instance it contains the name of the property file in which the db connection information is specified, as well as the number of connections that this file contains information on (separated by ;).
</para>
- <caution>
+ <important>
<para>
This is only an <emphasis>example</emphasis> of the sorts of things an <code>XAResourceRecovery</code> implementer could do. This implementation uses a property file that is assumed to contain sufficient information to recreate connections used during the normal run of an application so that we can perform recovery on them. It is not recommended that information such as user name and password appear in such a raw text format as it opens up a potential security hole.
</para>
- </caution>
+ </important>
<para>
The db parameters specified in the property file are assumed to be in the format:
</para>
Added: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.ent
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.ent (rev 0)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.ent 2008-09-10 02:03:53 UTC (rev 78302)
@@ -0,0 +1,5 @@
+<!ENTITY PRODUCT "Enterprise Application Platform">
+<!ENTITY BOOKID "Transactions_JTA_Programmers_Guide">
+<!ENTITY HOLDER "Red Hat, Inc">
+<!ENTITY YEAR "2008">
+<!ENTITY VERSION "4.3.0.CP01">
Added: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.xml (rev 0)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JBoss_Transactions_JTA_Programmers_Guide.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -0,0 +1,19 @@
+<?xml version='1.0'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="An_Introduction_to_the_JTA.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="The_Resource_Manager.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Transaction_Recovery.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="JDBC_and_Transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Examples.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Configuring_JBossJTA.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Using_JBossJTA_in_Application_Servers.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
+
+</book>
+
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JDBC_and_Transactions.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JDBC_and_Transactions.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JDBC_and_Transactions.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,8 +4,6 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-JDBC_and_Transactions">
<title>JDBC and Transactions</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-JDBC_and_Transactions-Using_the_transactional_JDBC_driver">
<title>Using the transactional JDBC driver</title>
<para>
Deleted: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.ent
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.ent 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.ent 2008-09-10 02:03:53 UTC (rev 78302)
@@ -1,5 +0,0 @@
-<!ENTITY PRODUCT "Enterprise Application Platform">
-<!ENTITY BOOKID "Transactions_JTA_Programmers_Guide">
-<!ENTITY HOLDER "Red Hat, Inc">
-<!ENTITY YEAR "2008">
-<!ENTITY VERSION "4.3.0.CP01">
Deleted: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/JTA_Programmers_Guide.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -1,20 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<book>
- <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="An_Introduction_to_the_JTA.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="The_Resource_Manager.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Transaction_Recovery.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="JDBC_and_Transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Examples.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Configuring_JBossJTA.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Using_JBossJTA_in_Application_Servers.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Appendix.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
-
-</book>
-
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Revision_History.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Revision_History.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Revision_History.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -1,21 +1,26 @@
<?xml version='1.0'?>
-<!DOCTYPE revhistory PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
]>
-<revhistory>
- <revision>
- <revnumber>1.0</revnumber>
- <date></date>
- <author>
- <firstname></firstname>
- <surname></surname>
- <email></email>
- </author>
- <revdescription>
- <simplelist>
- <member></member>
- </simplelist>
- </revdescription>
- </revision>
-</revhistory>
+<appendix id="appe-Publican-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>1.0</revnumber>
+ <date></date>
+ <author>
+ <firstname></firstname>
+ <surname></surname>
+ <email></email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member></member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/The_Resource_Manager.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/The_Resource_Manager.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/The_Resource_Manager.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -100,11 +100,11 @@
<para>
In the cases where neither of these options are viable, JBossTS does support the enlistment of multiple one-phase aware resources within the same transaction. In order to do this, see the section on the Last Resource Commit Optimization.
</para>
- <caution>
+ <important>
<para>
Even when this support is enabled, JBossTS will issue warnings when it detects that the option has been enabled ("You have chosen to enable multiple last resources in the transaction manager. This is transactionally unsafe and should not be relied upon.”) and when multiple one-phase resources are enlisted within the transaction (“This is transactionally unsafe and should not be relied on.”).
</para>
- </caution>
+ </important>
</section>
<section id="sect-Transactions_JTA_Programmers_Guide-Test-Opening_a_Resource_Manager">
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transaction_Recovery.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transaction_Recovery.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transaction_Recovery.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,8 +4,6 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-Transaction_Recovery">
<title>Transaction Recovery</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-Transaction_Recovery-Failure_recovery">
<title>Failure recovery</title>
<para>
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transactions.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transactions.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Transactions.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,18 +4,16 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-Transactions">
<title>Transactions</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-Transactions-The_API">
<title>The API</title>
<para>
The Java Transaction API consists of three elements: a high-level application transaction demarcation interface, a high-level transaction manager interface intended for application server, and a standard Java mapping of the X/Open XA protocol intended for transactional resource manager. All of the JTA classes and interfaces occur within the <package>javax.transaction</package> package, and the corresponding JBossJTA implementations within the <package>com.arjuna.ats.jta</package> package.
</para>
- <caution>
+ <important>
<para>
Each Xid that JBossTS creates must have a unique node identifier encoded within it and JBossTS will only recover transactions and states that match a specified node identifier. The node identifier to use should be provided to JBossTS via the <property>com.arjuna.ats.arjuna.xa.nodeIdentifier</property> property. You must make sure this value is unique across your JBossTS instances. If you do not provide a value, then JBossTS will fabricate one and report the value via the logging infrastructure. The contents of this should be alphanumeric.
</para>
- </caution>
+ </important>
<formalpara id="form-Transactions_JTA_Programmers_Guide-The_API-UserTransaction">
<title>UserTransaction</title>
<para>
Modified: projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Using_JBossJTA_in_Application_Servers.xml
===================================================================
--- projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Using_JBossJTA_in_Application_Servers.xml 2008-09-10 01:54:30 UTC (rev 78301)
+++ projects/docs/enterprise/4.3/Transactions/Transactions_JTA_Programmers_Guide/en-US/Using_JBossJTA_in_Application_Servers.xml 2008-09-10 02:03:53 UTC (rev 78302)
@@ -4,8 +4,6 @@
<chapter id="chap-Transactions_JTA_Programmers_Guide-Using_JBossJTA_in_Application_Servers">
<title>Using JBossJTA in Application Servers</title>
- <para>
- </para>
<section id="sect-Transactions_JTA_Programmers_Guide-Using_JBossJTA_in_Application_Servers-JBoss_Application_Server">
<title>JBoss Application Server</title>
<formalpara id="form-Transactions_JTA_Programmers_Guide-JBoss_Application_Server-Service_Configuration">
More information about the jboss-cvs-commits
mailing list