NonStop SOAP User's Manual

NonStop SOAP Features and Functions
NonStop SOAP User’s Manual—520501-012
4-17
Committing a Transaction
Committing a Transaction
To commit a transaction, causing all the changes to take effect, the client sends a
SOAP message, specifying a value of “End” for the CurrentTransactionCommand
attribute of the Session element of the NonStop SOAP header. The SOAP server
commits the transaction before it processes the body of the request. The body of the
request can be empty. This attribute cannot be specified within a request to start a new
session. The server returns a fault if
•
The request to commit a transaction does not specify the session ID.
•
The specified session ID is invalid (for example, the session has timed out).
•
No transaction was in progress for the specified session.
•
An error occurred when the server attempted to commit the transaction
Aborting a Transaction
To abort a transaction, causing all the changes to be undone, the client sends a SOAP
message, specifying a value of “Abort” for the CurrentTransactionCommand
attribute of the Session element of the NonStop SOAP header. The SOAP server
aborts the transaction before it processes the body of the request. The body of the
request can be empty. This attribute cannot be specified within a request to start a new
session. The server returns a fault if
•
The request to abort a transaction does not specify the session ID.
•
The specified session ID is invalid (for example, the session has timed out).
•
No transaction was in progress for the specified session.
•
An error occurred when the server attempted to abort the transaction
Ending One Transaction and Starting Another Transaction
The same message can commit or abort a transaction (by specifying a value for the
CurrentTransactionCommand attribute) and start a new transaction (by specifying “yes”
as the value of the BeginNewTransaction attribute). However, these actions cannot
take place in a message requesting a new session.
The server returns a fault if
•
The request specifies “Begin” as the value of the SessionCommand attribute (that
is, the message requests a new session).
•
The request does not include a session ID.
•
The specified session ID is invalid.
•
No transaction was in progress for the specified session.
•
An error occurred when the server attempted to abort or commit the transaction.