The UserTransaction interface is typically accessed by EJBs that use bean-managed transactions (BMTs). An EJB generally uses BMTs if it needs to start and end several transactions within the space of a single method. Other J2EE components, such as servlets and JSP tags, can also access the UserTransaction object. However, there are some restrictions; for example, EJBs using container-managed transactions cannot access the UserTransaction object. The full set of restrictions is found in the EJB specification.

The standard way for a J2EE application to get a pointer to the UserTransaction object is by resolving the JNDI name java:comp/UserTransaction. To ensure that this reference works properly, you should configure the Nucleus component /atg/dynamo/transaction/TransactionManager to point to the appropriate class. For information about how to do this, see the ATG Installation and Configuration Guide.