diff --git a/framework/service/dtd/services.xsd b/framework/service/dtd/services.xsd index 580466d49a..91606c3427 100644 --- a/framework/service/dtd/services.xsd +++ b/framework/service/dtd/services.xsd @@ -86,6 +86,12 @@ under the License. + + + If set to true and there is no transaction already in place the Service Engine will begin one. + If set to false or there is a transaction already in place the Service Engine will do nothing (this also means that if set to false and a transaction is already in place it will do nothing). + + @@ -94,6 +100,13 @@ under the License. + + + If set to true and there is a transaction already in place the Service Engine will suspend that transaction, begin a new one just for this service, commit or rollback the local transaction when the service is complete, and will resume the original transaction. + If set to true and there is no transaction already in place it will just begin a transaction and manage it as would be done for a normal user-transaction=true. + If use-transaction=false this setting is ignored. + + @@ -106,6 +119,8 @@ under the License. Defines the timeout for the transaction, in seconds. Defaults to the value set in the TransactionFactory being used (typically 60 seconds). + This value is only used if this service begins a transaction (either require-new-transaction=true, or use-transaction=true and there is no other transaction already in place). + If use-transaction=false this setting is ignored.