Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awEnd | awEndTransaction
 
awEndTransaction
BrokerError awEndTransaction(
BrokerClient client,
char *transaction_id,
int mode,
int *reply_tag);
client
The Broker client that is beginning the transaction.
transaction_id
The identifier representing the transaction to be ended.
mode
Identifies the transaction mode and should be one of the following values:
*TRANSACTION_MODE_COMMIT
*TRANSACTION_MODE_ROLLBACK
*TRANSACTION_MODE_SAVEPOINT
reply_tag
If not NULL, indicates that a reply is requested and the * tag value of this event is returned. This parameter is used for output.
Performs commit, rollback, or savepoint processing for a transaction by publishing an Adapter::endTransaction event for the given transaction identifier. If reply_tag is not NULL, it will be set with the tag value of the event published so that you can match it to the acknowledgment that will follow. If reply_tag is NULL, no acknowledgment reply will be sent. This function should be used in conjunction with the awBeginTransaction function.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The client parameter is not NULL and has been destroyed or disconnected.
AW_ERROR_NO_PERMISSION
The client does not have permission to publish the Adapter::endTransaction event type.
AW_ERROR_NULL_PARAM
The transaction_id parameter is NULL.
AW_ERROR_OUT_OF_RANGE
The mode parameter contains an illegal value.
See also: