Meaning of <track-connection-by-tx>

[benoitm]

I am using JBoss 3.2.0 with the (new?) <xa-datasource> configuration with the XA compatible SAPDB driver... I discovered that I had to set <track-connection-by-tx> to true like with Oracle. Can you explain what this switch does. Everything works fine (with beta 3), but I don't like setting switches which I do not understand.

On another note, when will the documentation be updated for 3.2 which explains these configuration elements?

Thanks

[davidjencks]

track-connection-by-tx true means once a connection is associated with a transaction, only that transaction can be associated with it until it commits. False means after every operation it is disociated from the transaction and put back in the pool. IMO working with the false setting is required by the xa spec, but most driver writers seem to disagree.