db_start_database Function

Starts the database on an existing server, if possible. Otherwise, a new server is started.

Syntax

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

Parameters

sqlca – A pointer to a SQLCA structure.
parms – A null-terminated string containing a semicolon-delimited list of parameter settings, each of the form KEYWORD=value. For example:
```
"UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"
```

Returns

Non-zero if successful; 0 otherwise.

Remarks

The database is started on an existing server, if possible. Otherwise, a new server is started.

If the database was already running or was successfully started, the return value is true (non-zero) and SQLCODE is set to 0. Error information is returned in the SQLCA.

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

The privilege required to start and stop a database is set on the server command line using the -gd option.