Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awTx | awTxDeliverEvent
 
awTxDeliverEvent
BrokerError awTxDeliverEvent(
BrokerTxClient txclient,
char *dest_id,
BrokerEvent event);
txclient
The Broker client that is transactionally delivering the event.
dest_id
Identifies the Broker client to which the event is to be delivered.
event
The event that is to be delivered.
Transactionally sends the specified event to the Broker client with the client identifier represented by dest_id. The event is sent to the Broker which, in turn, forwards it to the destination Broker client. The tcclient that is to receive the delivered event is not required to have registered a subscription for the event type, but its client group must allow the Broker client to receive the event type.
A typical use of this function is when your Broker client replies to a request event from another Broker client. In such a case, you can obtain the dest_id by extracting it from the envelope of the request event, as described on Delivering Events.
Note:
An error will not be returned if the recipient, represented by dest_id, no longer exists.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The Broker client, represented by the client parameter, has been destroyed or disconnected.
AW_ERROR_INVALID_CLIENT_ID
The destination client ID contains illegal characters.
AW_ERROR_INVALID_EVENT
The event is not valid.
AW_ERROR_NO_PERMISSION
The txclient does not have permission to publish the event type.
AW_ERROR_NULL_PARAM
The parameter dest_id is NULL.
AW_ERROR_UNKNOWN_EVENT_TYPE
The event type for the event does not exist on the Broker.
See also: