NonStop SOAP 4.1 User's Manual

Configuring the Level of Transaction Support
You can configure the level of transaction management support for services deployed in NonStop
SOAP 4 using the TMFTransactionSupport attribute. The TMFTransactionSupport attribute
is configured at the operation level.
The TMFTransactionSupport attribute can be set to one of the following values:
• Required
All operations in the SOAP request must be performed within a TMF transaction.
◦ If the client request does not include a transaction header block in the SOAP request
header, NonStop SOAP 4 begins a TMF transaction before invoking the service and
subsequently commits or aborts the transaction once a response is received from the
service. For more information, see “SOAP Server Transaction Management” (page 238).
◦ If the client request does include a transaction header block in the SOAP request header,
NonStop SOAP proceeds to examine the value of the Command attribute in the transaction
header block and processes the TMF transaction. For information on the Command attribute,
see “SOAP Client Transaction Management” (page 238).
• Supports
Operations in the SOAP request may be performed within a TMF transaction.
◦ If the client request does not include a transaction header block in the SOAP request
header, no TMF transaction calls will be made and the service will be invoked outside
any TMF transaction. For example, a browse or get operation does not need to be
performed inside a transaction.
◦ If the client request includes a transaction header block in the SOAP request header,
NonStop SOAP 4 proceeds to examine the value of the Command attribute in the
Transaction header block and proceeds to perform the requested action. For more
information on the Command attribute, see “SOAP Client Transaction Management”
(page 238).
• Never
Operations in the SOAP request must not be performed within a TMF transaction. If the client
request includes a transaction header block in the SOAP request header element, NonStop
SOAP 4 will return a SOAP fault response.
NOTE: Previous versions of NonStop SOAP used values for the TMFTransactionSupport
attribute of yes and no. When migrating from SOAP 3 to SOAP 4, these values will be mapped
by the SoapAdminCL tool to Required and Never respectively.
To configure the level of transaction support for your service, complete the following steps:
1. Open the services.xml configuration file located in <NonStop SOAP 4 Deployment
Directory>/services/<service_name>.
where,
<service_name> is the name of the service for which you want to set the level of transaction
management.
2. Set the value of the TMFTransactionSupport attribute to either Required, Supports,
or Never.
<operation>
.
.
TMFTransactionSupport="[Required | Supports | Never]"
.
Configuring the Level of Transaction Support 245