SMA and LLA Guide : solidDB® Server Control API (SSC API) : SSC API reference : SSCStopServer
  
SSCStopServer
The SSCStopServer function stops a linked library access (LLA) server or a shared memory access (SMA) server.
You can use explicit methods (for example, SSCStopServer) to shut down a server that was started with implicit methods (for example, SQLConnect). The converse is not true; for example, you cannot use SQLDisconnect to stop a server that was started with SSCStartServer.
An application is not limited to starting and stopping the server once each time that the application is run. After the server has been stopped, the application can restart the server by using, for example, SSCStartServer.
SscRetT SSC_CALL SSCStopServer(SscServerT h, bool force)
Parameters
Parameter
Usage type
Description
h
in, use
Handle to server
force
in
Options are:
▪TRUE - stop server in all cases.
▪FALSE - stop server if there are no open connections. Otherwise, stop fails.
Return value
▪SSC_SUCCESS - The server is stopped.
▪SSC_CONNECTIONS_EXIT - There are open connections.
▪SSC_UNFINISHED_TASKS - Tasks that are executing.
▪SSC_ABORT
▪SSC_ERROR
Comments
Remote users can stop solidDB® by using ADMIN COMMAND 'shutdown'. For more information, see Linked library access parameters
The FALSE option does not permit shutdown if there are open connections to the database or existing users. This option is equivalent to solidDB® SQL extension ADMIN COMMAND 'shutdown'.
The SSCSetState() function with the SSC_STATE_OPEN option prevents new connections to the solidDB® server.
Related reference:
SSCSetState
SSCStartServer
SSCStartSMAServer
See also
SSC API reference