Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awSet | awSetTxClientStateShareLimit
 
awSetTxClientStateShareLimit
BrokerError awSetTxClientStateShareLimit(
BrokerTxClient txclient,
int limit);
txclient
The Broker client whose share limit is to be set.
limit
The maximum number of clients that may share state with txclient. If set to -1, an unlimited number of clients may share state with txclient.
Sets the maximum number of Broker clients that can share state with txclient. A client's state consists of its event queue and its event subscriptions. If limit is less than the current number of clients sharing the state, all of the Broker clients are allowed to remain connected. However, no new clients will be allowed to share the client state until the number of clients drops below limit.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The txclient has been destroyed or disconnected.
AW_ERROR_NO_PERMISSION
The txclient has an unshared client state.
AW_ERROR_OUT_OF_RANGE
The parameter limit is zero or less than -1.
See also: