Contents Index db_register_a_callback function db_start_engine function

ASA Programming Guide
  Embedded SQL Programming
    Library function reference

db_start_database function


Prototype 

unsigned int db_start_database( 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 

Start a database on an existing server if the database is not already running. The steps carried out to start a database are described in Starting a personal server

The return value is true if the database was already running or successfully started. Error information is returned in the SQLCA.

If a user ID and password are supplied in the parameters, they are ignored.

The permission required to start and stop a database is set on the server command line. For information, see The database server.


Contents Index db_register_a_callback function db_start_engine function