Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 10.0.1 » SQL Anywhere Server - Programming » SQL Anywhere Embedded SQL » Library function reference

db_stop_database function Next Page

db_stop_engine function


unsigned int db_stop_engine( SQLCA * sqlca, char * parms );


sqlca    A pointer to a SQLCA structure. For information, see The SQL Communication Area (SQLCA).

parms    A null-terminated string containing a semicolon-delimited list of parameter settings, each of the form KEYWORD=value. For example,


For a list of connection parameters, see Connection parameters.


Terminates execution of the database server. The steps carried out by this function are:

By default, this function does not stop a database server that has existing connections. If Unconditional is yes, the database server is stopped regardless of existing connections.

A C program can use this function instead of spawning dbstop. A return value of TRUE indicates that there were no errors.

The use of db_stop_engine is subject to the permissions set with the -gk server option. See -gk server option.