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.