[jboss-svn-commits] JBL Code SVN: r32130 - labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Thu Mar 18 00:34:01 EDT 2010
Author: misty at redhat.com
Date: 2010-03-18 00:34:00 -0400 (Thu, 18 Mar 2010)
New Revision: 32130
Added:
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Appendix_IDL_Definitions.xml
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Bibliography.xml
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Configuring_JTS.xml
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/ORB_Specific_Configurations.xml
Modified:
labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Chapter.xml
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/Transaction_Processing_Overview.xml
Log:
Finished the initial conversion
Added: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Appendix_IDL_Definitions.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Appendix_IDL_Definitions.xml (rev 0)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Appendix_IDL_Definitions.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -0,0 +1,227 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<appendix>
+ <title>IDL Definitions</title>
+ <para>
+ The following sections detail the idl files which form the core of JBossTS.
+ </para>
+ <note>
+ <para>
+ because of differences between ORBs, and errors in certain ORBs, the idl available with JBossTS may differ from that shown below. You should always inspect the idl files prior to implementation to determine what, if any, differences exist.
+ </para>
+ </note>
+ <section>
+ <title><filename>CosTransactions.idl</filename></title>
+ <screen>
+ #ifndef COSTRANSACTIONS_IDL_
+ #define COSTRANSACTIONS_IDL_
+ module CosTransactions
+ {
+ enum Status { StatusActive, StatusMarkedRollback, StatusPrepared,
+ StatusCommitted, StatusRolledback, StatusUnknown,
+ StatusPreparing, StatusCommitting, StatusRollingBack,
+ StatusNoTransaction };
+
+ enum Vote { VoteCommit, VoteRollback, VoteReadOnly };
+ // Standard exceptions - some Orb supports them
+ exception TransactionRequired {};
+ exception TransactionRolledBack {};
+ exception InvalidTransaction {};
+ // Heuristic exceptions
+ exception HeuristicRollback {};
+ exception HeuristicCommit {};
+ exception HeuristicMixed {};
+ exception HeuristicHazard {};
+ // Exception from ORB
+ exception WrongTransaction {};
+ // Other transaction related exceptions
+ exception SubtransactionsUnavailable {};
+ exception NotSubtransaction {};
+ exception Inactive {};
+ exception NotPrepared {};
+ exception NoTransaction {};
+ exception InvalidControl {};
+ exception Unavailable {};
+ exception SynchronizationUnavailable {};
+ // Forward references for later interfaces
+ interface Control;
+ interface Terminator;
+ interface Coordinator;
+ interface Resource;
+ interface RecoveryCoordinator;
+ interface SubtransactionAwareResource;
+ interface TransactionFactory;
+ interface TransactionalObject;
+ interface Current;
+ interface Synchronization;
+ // Formally part of CosTSInteroperation
+ struct otid_t
+ {
+ long formatID;
+ long bequal_length;
+ sequence <octet> tid;
+ };
+ struct TransIdentity
+ {
+ Coordinator coord;
+ Terminator term;
+ otid_t otid;
+ };
+ struct PropagationContext
+ {
+ unsigned long timeout;
+ TransIdentity currentTransaction;
+ sequence <TransIdentity> parents;
+ any implementation_specific_data;
+ };
+ interface Current : CORBA::Current
+ {
+ void begin () raises (SubtransactionsUnavailable);
+ void commit (in boolean report_heuristics) raises (NoTransaction, HeuristicMixed, HeuristicHazard, TransactionRolledBack);
+ void rollback () raises (NoTransaction);
+ void rollback_only () raises (NoTransaction);
+
+ Status get_status ();
+ string get_transaction_name ();
+ void set_timeout (in unsigned long seconds);
+
+ Control get_control ();
+ Control suspend ();
+ void resume (in Control which) raises (InvalidControl);
+ };
+ interface TransactionFactory
+ {
+ Control create (in unsigned long time_out);
+ Control recreate (in PropagationContext ctx);
+ };
+ interface Control
+ {
+ Terminator get_terminator () raises (Unavailable);
+ Coordinator get_coordinator () raises (Unavailable);
+ };
+ interface Terminator
+ {
+ void commit (in boolean report_heuristics) raises (HeuristicMixed, HeuristicHazard, TransactionRolledBack);
+ void rollback ();
+ };
+ interface Coordinator
+ {
+ Status get_status ();
+ Status get_parent_status ();
+ Status get_top_level_status ();
+
+ boolean is_same_transaction (in Coordinator tc);
+ boolean is_related_transaction (in Coordinator tc);
+ boolean is_ancestor_transaction (in Coordinator tc);
+ boolean is_descendant_transaction (in Coordinator tc);
+ boolean is_top_level_transaction ();
+
+ unsigned long hash_transaction ();
+ unsigned long hash_top_level_tran ();
+
+ RecoveryCoordinator register_resource (in Resource r) raises (Inactive);
+ void register_synchronization (in Synchronization sync) raises (Inactive, SynchronizationUnavailable);
+ void register_subtran_aware (in SubtransactionAwareResource r) raises (Inactive, NotSubtransaction);
+
+ void rollback_only () raises (Inactive);
+
+ string get_transaction_name ();
+
+ Control create_subtransaction () raises (SubtransactionsUnavailable, Inactive);
+
+ PropagationContext get_txcontext () raises (Unavailable);
+ };
+ interface RecoveryCoordinator
+ {
+ Status replay_completion (in Resource r) raises (NotPrepared);
+ };
+ interface Resource
+ {
+ Vote prepare () raises (HeuristicMixed, HeuristicHazard);
+ void rollback () raises (HeuristicCommit, HeuristicMixed, HeuristicHazard);
+ void commit () raises (NotPrepared, HeuristicRollback, HeuristicMixed, HeuristicHazard);
+ void commit_one_phase () raises (HeuristicHazard);
+ void forget ();
+ };
+ interface SubtransactionAwareResource : Resource
+ {
+ void commit_subtransaction (in Coordinator parent);
+ void rollback_subtransaction ();
+ };
+ interface TransactionalObject
+ {
+ };
+ interface Synchronization : TransactionalObject
+ {
+ void before_completion ();
+ void after_completion (in Status s);
+ };
+ };
+ #endif
+ </screen>
+ </section>
+
+ <section>
+ <title><filename>ArjunaOTS.idl</filename></title>
+
+ <screen>
+ #ifndef ARJUNAOTS_IDL_
+ #define ARJUNAOTS_IDL_
+
+ #include <idl/CosTransactions.idl>
+ module ArjunaOTS
+ {
+ exception ActiveTransaction {};
+ exception BadControl {};
+ exception Destroyed {};
+ exception ActiveThreads {};
+ exception InterpositionFailed {};
+
+ interface UidCoordinator : CosTransactions::Coordinator
+ {
+ readonly attribute string uid;
+ readonly attribute string topLevelUid;
+ };
+ interface ActionControl : CosTransactions::Control
+ {
+ CosTransactions::Control getParentControl ()
+ raises (CosTransactions::Unavailable,
+ CosTransactions::NotSubtransaction);
+ void destroy () raises (ActiveTransaction, ActiveThreads, BadControl,
+ Destroyed);
+ };
+
+ interface ArjunaSubtranAwareResource :
+ CosTransactions::SubtransactionAwareResource
+ {
+ CosTransactions::Vote prepare_subtransaction ();
+ };
+ interface ArjunaTransaction : UidCoordinator, CosTransactions::Terminator
+ {
+ };
+
+ interface OTSAbstractRecord : ArjunaSubtranAwareResource
+ {
+ readonly attribute long typeId;
+ readonly attribute string uid;
+
+ boolean propagateOnAbort ();
+ boolean propagateOnCommit ();
+
+ boolean saveRecord ();
+
+ void merge (in OTSAbstractRecord record);
+ void alter (in OTSAbstractRecord record);
+
+ boolean shouldAdd (in OTSAbstractRecord record);
+ boolean shouldAlter (in OTSAbstractRecord record);
+ boolean shouldMerge (in OTSAbstractRecord record);
+ boolean shouldReplace (in OTSAbstractRecord record);
+ };
+ };
+ </screen>
+ </section>
+
+</appendix>
+
Added: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Bibliography.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Bibliography.xml (rev 0)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Bibliography.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -0,0 +1,32 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE bibliography PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<bibliography>
+ <title>References</title>
+
+ <biblioentry>
+ <abbrev>OMG95</abbrev>
+ <copyright>
+ <year>1995</year>
+ <holder>Object Management Group.</holder></copyright>
+ <publisher>
+ <publishername>Object Management Group</publishername>
+ </publisher>
+ <title>CORBAServices: Common Object Services Specification, Revised Edition</title>
+ <subtitle>Document Number 95-3-31</subtitle>
+ </biblioentry>
+
+ <biblioentry>
+ <abbrev>JTA99</abbrev>
+ <copyright>
+ <year>1999</year>
+ <holder>Sun Microsystems</holder>
+ </copyright>
+ <publisher>
+ <publishername>Sun Microsystems</publishername>
+ </publisher>
+ <title>Java Transaction API</title>
+ </biblioentry>
+
+</bibliography>
+
Modified: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Chapter.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Chapter.xml 2010-03-18 01:59:59 UTC (rev 32129)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Chapter.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -1,31 +1,24 @@
<?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 id="chap-JTS_Programmers_Guide-Test_Chapter">
- <title>Test Chapter</title>
- <para>
- This is a test paragraph
- </para>
- <section id="sect-JTS_Programmers_Guide-Test_Chapter-Test_Section_1">
- <title>Test Section 1</title>
- <para>
- This is a test paragraph in a section
- </para>
- </section>
-
- <section id="sect-JTS_Programmers_Guide-Test_Chapter-Test_Section_2">
- <title>Test Section 2</title>
- <para>
- This is a test paragraph in Section 2
- <orderedlist>
- <listitem>
- <para>
- listitem text
- </para>
- </listitem>
- </orderedlist>
- </para>
- </section>
+<chapter>
+ <title></title>
+ <para>
+ </para>
+ <section>
+ <title></title>
+ <para>
+
+ </para>
+ </section>
+
+ <section>
+ <title></title>
+ <para>
+
+ </para>
+ </section>
+
</chapter>
Added: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Configuring_JTS.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Configuring_JTS.xml (rev 0)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Configuring_JTS.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -0,0 +1,55 @@
+<?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>Configuring <application>JBoss Transaction Service</application></title>
+
+ <section>
+ <title>Options</title>
+ <para>
+ The following table shows the configuration features, with default values shown in brackets. For more detailed information, the relevant section numbers are provided.
+ </para>
+
+ <table>
+ <title>JBoss Transaction Service Configuration Options</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry><para>Configuration Name</para></entry>
+ <entry><para>Possible Values</para></entry>
+ <entry><para>Relevant Section or Comment</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><para>com.arjuna.ats.jta.supportSubtransactions</para></entry>
+ <entry><para>[YES]</para><para>NO</para></entry>
+ <entry />
+ </row>
+ <row>
+ <entry><para>com.arjuna.ats.jta.jtaTMImplementation</para></entry>
+ <entry><para>com.arjuna.ats.internal.jta.transaction.arjunacore.TransactionManagerImple</para><para>com.arjuna.ats.internal.jta.transaction.jts.TransactionManagerImple</para></entry>
+ <entry />
+ </row>
+ <row>
+ <entry><para>com.arjuna.ats.jta.jtaTMImplementation</para></entry>
+ <entry><para>com.arjuna.ats.internal.jta.transaction.arjunacore.TransactionManagerImple</para><para>com.arjuna.ats.internal.jta.transaction.jts.TransactionManagerImple</para></entry>
+ <entry />
+ </row>
+ <row>
+ <entry><para>com.arjuna.ats.jta.xaBackoffPeriod</para></entry>
+ <entry />
+ <entry />
+ </row>
+ <row>
+ <entry><para>com.arjuna.ats.jts.ots_1_0.timeoutPropagation</para></entry>
+ <entry><para>YES</para><para>[NO]</para></entry>
+ <entry><para>Turn on OTS 1.0 timeout propagation (default sends timeout remaining in PropagationContext, whereas OTS 1.0 sent original timeout value).</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </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-18 01:59:59 UTC (rev 32129)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/JTS_Programmers_Guide.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -13,6 +13,10 @@
<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="Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="ORB_Specific_Configurations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Configuring_JTS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Appendix_IDL_Definitions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Bibliography.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/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/ORB_Specific_Configurations.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/ORB_Specific_Configurations.xml (rev 0)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/ORB_Specific_Configurations.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -0,0 +1,18 @@
+<?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>ORB Specific Configurations</title>
+ <section>
+ <title>JacORB</title>
+ <warning>
+ <para>
+ Care should be taken to use only the patched version of JacORB shipped with <application>JBoss Transaction Service</application>. Correct functioning of the transaction system, particularly with regard to crash recovery, is unlikely with an unpatched JacORB.
+ </para>
+ </warning>
+ <para>
+ For each deployment of JacORB, ensure that the value of <varname>jacorb.implname</varname> in the <filename>jacorb.properties</filename> file is unique.
+ </para>
+ </section>
+</chapter>
+
Modified: labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Transaction_Processing_Overview.xml
===================================================================
--- labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Transaction_Processing_Overview.xml 2010-03-18 01:59:59 UTC (rev 32129)
+++ labs/jbosstm/enterprise/tags/EAP_5_0_1/Transactions_JTS_Programmers_Guide/en-US/Transaction_Processing_Overview.xml 2010-03-18 04:34:00 UTC (rev 32130)
@@ -2,7 +2,7 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
]>
<chapter id="chap-JTS_Programmers_Guide-Test_Chapter">
- <title>An overview of transactin processing</title>
+ <title>An overview of transaction processing</title>
<section>
<title>What is a transaction?</title>
<para>
More information about the jboss-svn-commits
mailing list