NonStop SOAP 4.1 User's Manual

Abort a Transaction
To abort an active TMF transaction, the client must set the value of the TransactionID attribute
(in the transaction header block of the NonStop SOAP request header element) to the value of the
TransactionID attribute provided by a previous response from NonStop SOAP 4 associated
with that transaction, and set the Command attribute to Abort.
NOTE: HP recommends that the body of a request that aborts a transaction be empty. The
sequence of the following events indicates that the transaction is aborted before any service
invocation. This means that there will not be an active transaction when the service is invoked.
When a message is received by the SOAP server to abort a message, the following occurs:
1. The SOAP server resumes the TMF transaction specified in the TransactionID attribute of
the Transaction header block of the SOAP request header element.
2. The SOAP server issues an abort transaction request to the TMF subsystem.
3. If the SOAP message body requests a target service, it will be invoked, but there will not be
any active TMF transaction, because it has been aborted in step 2.
4. NonStop SOAP 4 returns the response from the service. The response message will not contain
a transaction header block because there is no TransactionID value to communicate back
to the client.
Example 24 shows a request/response pair of messages to abort a transaction.
Example 24 Abort a Transaction
Client Request
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:compaq_nsk_oss_TransactionHeader">
<soapenv:Header>
<urn:Transaction TransactionID="234567" Command="Abort"/>
</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>
</soapenv:Header>
<soapenv:Body>
.
.
.
</soapenv:Body>
</soapenv:Envelope>
where,
234567
is the identifier of the transaction to be aborted, and was provided in a previous response from
NonStop SOAP.
244 Transaction Management