void setUserRouteData(void *, oscs_Uint32 length);

Sets the Server's routing data. The void* can point to any user-specified data, such as a character string. A thin client can specify routing data along with a request for execution of an operation, and the request is routed to a Server with matching routing data. Matches are identified with memcmp().

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setNumHandlingThreads()

void setNumHandlingThreads(oscs_Uint32 numthreads);

Sets the number of threads used by the Server to process client requests.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::addRouter()

void addRouterHostName(oscs_String routerhostname);

Specifies the network address for the system router.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setRouterFile()

void setRouterFile(oscs_String routerfilename);

Sets the file used by the router to maintain routes persistently, in case of failures or restarts.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setIncrementalTimeout()

void setIncrementalTimeout(oscs_Uint32 timeout);

Sets the timeout for access to incremental object sets on the Server. If the set is not accessed in the amount of time specified, the Server discards it.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setBoundTxnTimeout()

void setBoundTxnTimeout(oscs_Uint32 timeout);

Sets the timeout for bound transactions (that is, transactions started by the thin client with ostc_Session::beginTxn()). If a bound transaction is started but is not being used, it aborts when this timeout is exceeded. This prevents the Server from hanging if the client fails in the middle of a bound transaction.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setSharedTxnTimeout()

void setSharedTxnTimeout(oscs_Uint32 timeout);

Sets the timeout for shared (that is shared_update, read, or mvccRead) transactions. Shared transactions commit after a certain number of requests complete or this timeout is exceeded, whichever comes first.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setSharedMaxOps()

void setSharedMaxOps(oscs_Uint32 maxops);

Sets the number of requests that can use a shared transaction before a commit occurs. This parameter is ignored for isolated_update Servers.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setRouterPingInterval()

void setRouterPingInterval(oscs_Uint32 interval);

A router pings all its routes at this interval. This parameter is ignored for Servers that are not routers.

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

ostc_ApplicationServer::setLogging()

void setLogging(oscs_Bool logging);

Turns Server logging on or off. With logging on, the Server writes information to the file server.log in the directory from which the Server was executed. 

otcs_ArgsLocked is thrown if this function is called outside the dynamic scope of ostcConnect().

The client and Server APIs signal error conditions by throwing C++ exceptions. oscs_Exception is an ancestor of all exceptions that the APIs can throw (note that the prefix is oscs, not ostc).

Below is a list of all exceptions, together with the APIs that can throw each one:

Exception	Thrown By
ostc_DatatypeMismatch	ostc_Operation::getInt32Argument() ostc_Operation::getInt64Argument() ostc_Operation::getStringArgument() ostc_Operation::getFloatArgument() ostc_Operation::getDoubleArgument() ostc_Operation::getObjectArgument() ostc_Operation::getBinaryArgument() ostc_Operation::setArgument()
ostc_InvalidParm	ostccompsrvr
ostc_InvalidTxnType	ostc_Session::beginTxn()
ostc_MissingLib	ostccompsrvr
ostc_NoArguments	ostc_Operation::getInt32Argument() ostc_Operation::getInt64Argument() ostc_Operation::getStringArgument() ostc_Operation::getFloatArgument() ostc_Operation::getDoubleArgument() ostc_Operation::getObjectArgument() ostc_Operation::getBinaryArgument()
ostc_NoNestedTxn	ostc_Session::beginTxn()
ostc_NoTxnInProgress	ostc::connect() ostc_Session::commitTxn() ostc_Session::abortTxn()
ostc_RequiredParmMissing	ostccompsrvr
ostc_ServerException	ostc_Session::doOperation()

Updated: 03/27/98 16:58:29