svn commit: r1558046 - /db/derby/docs/trunk/src/ref/rrefdeclaretemptable.dita

[ch...@apache.org]

Author: chaase3
Date: Tue Jan 14 14:31:31 2014
New Revision: 1558046

URL: http://svn.apache.org/r1558046
Log:
DERBY-4750  add documentation to declare global temporary tables to explain expected behavior when used with XA transactions.

Modified a Reference Manual topic.

Patch: DERBY-4750-2.diff

Modified:
    db/derby/docs/trunk/src/ref/rrefdeclaretemptable.dita

Modified: db/derby/docs/trunk/src/ref/rrefdeclaretemptable.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefdeclaretemptable.dita?rev=1558046&r1=1558045&r2=1558046&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefdeclaretemptable.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefdeclaretemptable.dita Tue Jan 14 14:31:31 2014
@@ -168,6 +168,19 @@ Temporary Tables: <ul>
 <li>LONG VARCHAR FOR BIT DATA</li>
 <li>VARCHAR FOR BIT DATA</li>
 <li>XML</li>
-</ul></p></section>
+</ul></p>
+<p>Global temporary tables can be used in XA transactions, but can be declared
+and accessed only within the scope of a single XA transaction.
+<ph conref="../conrefs.dita#prod/productshortname"></ph> can support access to
+the table only until one of the following methods of the
+<i>javax.transaction.xa.XAResource</i> interface is called:
+<ul>
+<li><i>XAResource.end</i></li>
+<li><i>XAresource.prepare</i></li>
+<li><i>XAResource.commit</i></li>
+</ul></p>
+<p>When the XA transaction commits or aborts, the temporary table is
+dropped.</p>
+</section>
 </refbody>
 </reference>