Session.commit() etc should require TransactionInProgressException to be thrown if called in a JTA transaction

The JMS 1.1 javadoc for TransactionInProgressException
http://docs.oracle.com/javaee/6/api/javax/jms/TransactionInProgressException.html
states:

This exception is thrown when an operation is invalid because a transaction is in progress. For instance, an attempt to call Session.commit when a session is part of a distributed transaction should throw a TransactionInProgressException.

However the javadoc for Session.commit does not list this as a mandatory exception.
http://docs.oracle.com/javaee/6/api/javax/jms/Session.html#commit%28%29

This is inconsistent.

It is hereby proposed that the definition of Session.commit and Session.rollback should be modified to require a TransactionInProgressException to be thrown when the session is in a JTA transaction.

Note that the corresponding methods on XASession already require these exceptions.

(and inconsistent with XASession.commit.

Affected Versions

[1.1]

Start with the Session.commit() and Session.rollback() API definitions and compare their exception requirements with the corresponding XASession methods. Review the JMS TransactionInProgressException documentation and the JTA transaction context described in the issue. Done means the affected method definitions consistently require this exception when called during a JTA transaction.