Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awTx | awTxDeliverEvents
 
awTxDeliverEvents
BrokerError awTxDeliverEvents(
BrokerTxClient txclient,
char *dest_id,
int n,
BrokerEvent *events);
txclient
The Broker client that is transactionally sending the events.
dest_id
The identifier of the Broker client to which the events are to be delivered.
n
The number of events in the array.
events
The array of events that are to be delivered.
Deliver multiple events. Gives an array of events to the Broker to have them all delivered to the txclient with the given client ID. Either all of the events or none of them are delivered. n is the number of events in the events array. No error is returned if there is no client using the destination client ID.
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 txclient 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 invalid.
AW_ERROR_NO_PERMISSION
The txclient does not have permission to publish the event type.
AW_ERROR_NULL_PARAM
The parameter dest_id or events is NULL.
AW_ERROR_OUT_OF_RANGE
The parameter n is less than zero.
AW_ERROR_UNKNOWN_EVENT_TYPE
The event type does not exist on the Broker.
See also: