NonStop Server for Java 6.0 Programmer's Reference

javax.transaction Interfaces
The Sun Microsystems JTA package, javax.transaction, defines the following interfaces:
• Status
• Synchronization
• Transaction
• TransactionManager
• UserTransaction
NonStop Server for Java Transaction API supports all of the preceding interfaces, but only
UserTransaction is available to client programs.
UserTransaction allows the client to control transaction boundaries programmatically.
UserTransaction methods do the following:
• Begin transaction
• Commit transaction
• Obtain transaction status
• Mark transaction for rollback
• Rollback transaction
• Set timeout for transaction
javax.transaction Exceptions
The Sun Microsystems JTA package, javax.transaction, defines the following exceptions.
NonStop Server for Java Transaction API supports all of them.
• HeuristicCommitException
• HeuristicMixedException
• HeuristicRollbackException
• InvalidTransactionException
• NotSupportedException
• TransactionRequiredException
• TransactionRolledbackException
• SystemException
Examples
The following examples are identical except that:
• The first example uses “NonStop Server for Java Transaction API-TMF by Default” (page 74)
• The second example requests “NonStop Server for Java Transaction API-TMF by Request”
(page 75)
• The third example requests “NonStop Server for Java Transaction API-JTS” (page 75)
NonStop Server for Java Transaction API-TMF by Default
The following code gets a reference to UserTransaction based on TMF (by default). It then
starts and ends a transaction.
import javax.transaction.UserTransaction;
import com.tandem.jta.JTAFactory;
74 Transactions