txControlResponseType

SOAP/AM Server Development > Managing Transactions >

txControlResponseType

Previous pageReturn to chapter overviewNext page

txControlResponseType is a complex type. It is a sequence of three elements, all of which occur exactly once and in the order shown.

 

<header-or-parameter-name xmlns="http://soapam.com/types/">

<txURL> </txURL>

<txOutcome> </txOutcome>

<txResult> </txResult>

</header-or-parameter-name>

 

A header or parameter of type txControlResponseType is included in responses from methods whose definitions include a <transactionControl> element with its clientControl attribute set to "1". An element of type txControlResponseType is also returned from the built-in TransactionControl service's BeginTransaction, CommitTransaction and AbortTransaction methods.

 

See Client Transaction Control for more information.

 

element name

content data type

usage

default value

description

 

txURL

xsd:string

required

 

   A transaction URL which uniquely identifies the transaction. If the requested transaction control operation was to begin a new transaction, txURL is the new transaction identifier. Otherwise, it is the same transaction identifier specified in the request.

 

txOutcome

txOutcomeEnum

required

 

  One of: "suspended", "committed", "aborted" or "unknown" indicating the outcome of the transaction control operation.

 

txResult

xsd:int

required

0

   The result code (file system error number) of the NSK transaction control API, e.g. ENDTRANSACTION() used by SOAP/AM Server to execute the requested transaction control operation. If non-zero, the status of the transaction is "unknown" as indicated by txOutcome.

Remarks

Always examine the txResult element contained in the response. If non-zero, the status of the transaction is unknown.

Example

txControlResponseType as header in SOAP response

<?xml version="1.0" encoding="UTF-8"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

   <SOAP-ENV:Header>

       <txControlResponse xmlns="http://soapam.com/types/">

         <txURL>soapamtx://\MYSYS.0.12345678</txURL>

         <txOutcome>committed</txOutcome>

         <txResult>0</txResult>

       </txControlResponse>

   </SOAP-ENV:Header>

   <SOAP-ENV:Body>

... detail omitted ...

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>