NonStop SOAP 4.1 User's Manual

4. If the invoked service returns a fault and the AbortTransactionOnFault attribute is set
to yes, then the NonStop SOAP 4 server aborts the transaction and returns a SOAP fault to
the client. The NonStop SOAP 4 server generates a temporary session identifier, because the
current SessionID is no longer valid. The NonStop SOAP 4 server returns the session identifier
in the session block header of the response message and sets this value for the SessionID
attribute.
Example 21 shows a request/response pair of messages to begin a new transaction.
Example 21 Begin a New Transaction
Client Request
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:compaq_nsk_oss_TransactionHeader">
<soapenv:Header>
< urn:Transaction Command="Begin"/>
</soapenv:Header>
<soapenv:Body>
.
.
.
</soapenv:Body>
</soapenv:Envelope>
NonStop SOAP 4 Response
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:compaq_nsk_oss_TransactionHeader">
<soapenv:Header>
<urn:Transaction TransactionID="234567"/>
</soapenv:Header>
<soapenv:Body>
.
.
.
</soapenv:Body>
</soapenv:Envelope>
NOTE: The response includes the TMF transaction ID that will be used in all subsequent requests
associated with the transaction.
Continue a Transaction
To perform an operation under an active TMF transaction, the client must include a Transaction
header block that sets the Command attribute to Continue and sets the value of the TransactionID
attribute to the value of the TransactionID attribute provided by a previous response from
NonStop SOAP 4 associated with this transaction.
On receiving a SOAP request to perform an operation under an active transaction:
1. The SOAP server resumes the TMF transaction specified in the TransactionID attribute of
the transaction header block in the SOAP request header.
2. The operation specified in the body of the SOAP message is then invoked under the resumed
TMF transaction ID.
3. When the service responds back to NonStop SOAP 4, the TMF transaction is suspended once
again, the transaction ID value is set in the TransactionID attribute of the Transaction
header block, and the response message is sent back to the client.
4. If the invoked service returns a fault and the AbortTransactionOnFault attribute is set
to yes, then the NonStop SOAP 4 server aborts the transaction and returns a SOAP fault to
SOAP Client Transaction Management 241