How do I set the Transaction Timeout?


    Transaction timeout (unit is always seconds) can be configured in various ways:

    This argument is the same no matter if you are using JBossTM(<=4.0.5) or JBossJTA-Arjuna(>=4.2).


    • Globally: You can change this behavior globally by modifying the TransactionManagerService in /conf/jboss-service.xml (or /deploy/jta-service.xml for 4.0.3)


    Version <= 4.0.5

    <mbean code="com.arjuna.ats.jbossatx.jta.TransactionManagerService"
       <attribute name="TransactionTimeout">300</attribute>


    Version >= 4.2

    <mbean code="com.arjuna.ats.jbossatx.jta.TransactionManagerService" 
       <attribute name="TransactionTimeout">300</attribute>
       <attribute name="ObjectStoreDir">${}/tx-object-store</attribute> 


    This part is the same for either JBossTM or JBossJTA and is the same for ejb2 and ejb3

    • Per-method basis: Modifying the <transaction-timeout> element inside the <method> element of a session or entity bean. This is located in the META-INF/jboss.xml deployment descriptor of a session bean. When the transaction timeout is specified at the method level, it overrides the default timeout. Further information about this element can be found in jboss-x.x.x/docs/dtd/jboss_4_0.dtd. Example taken from the testsuite:

    <?xml version="1.0"?>
    • Using BMT: Calling javax.transaction.UserTransaction.setTransactionTimeout(int seconds). Please, be aware that this only applies to transactions started after this invocation on the same thread. Example:

    UserTransaction ut = (UserTransaction)ctx.lookup("java:comp/UserTransaction");



    • Using it with EJB3 annotations..

    For MBDs, you can specify it as an activation configuration that applies to the entire bean:

    @ActivationConfigProperty(propertyName="transactionTimeout", propertyValue="1")

    For the rest of beans, you can use @TransactionTimeout annotation that can be applied either at class level or method level: