Contents Index db_stop_database function db_string_connect function

ASA Programming Guide
  Embedded SQL Programming
    Library function reference

db_stop_engine function


Prototype 

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

Arguments 

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

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

"UID=DBA;PWD=SQL;DBF=c:\\db\\mydatabase.db"

For an available list of connection parameters, see Connection parameters.

Description 

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.

For more information, see -gk server option.


Contents Index db_stop_database function db_string_connect function