Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awTx | awTxDeliverErrorReplyEvent
 
awTxDeliverErrorReplyEvent
BrokerError awTxDeliverErrorReplyEvent(
BrokerTxClient txclient,
BrokerEvent request_event,
BrokerEvent error_event);
txclient
The Broker client that is transactionally delivering the event.
request_event
The original request event. Used to determine the client ID of the sender of the original request.
error_event
The error event to be delivered.
Sends a single error event to the Broker to be transactionally delivered to the Broker client that published the request_event. This function properly sets the tag, appSeqn, and appLastSeqn envelope fields.
If the trackId envelope field was set on request_event, that value is copied to the error_event event. If the request_event trackId envelope field was not set, the pubId envelope field from the request_eventwill be used instead.
The error_event will be delivered to the Broker client with the client ID contained in the errorsTo envelope field of request_event, if it was set by the requestor.
Note:
An error will not be returned if the recipient, represented by the pubId field in request_event, no longer exists.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The Broker client, represented by the txclient parameter, has been destroyed or disconnected.
AW_ERROR_INVALID_EVENT
The request_event or error_event is invalid, the request_event was not received from the Broker, or the error_event does not match its type definition.
AW_ERROR_NO_PERMISSION
The txclient does not have permission to publish the error_event.
AW_ERROR_UNKNOWN_EVENT_TYPE
The event type for error_event does not exist on the Broker.
See also: