ASA Programming Guide
  Embedded SQL Programming
    Library function reference

db_string_connect function

Prototype 

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

Provides extra functionality beyond the embedded SQL CONNECT command. This function carries out a connection using the algorithm described in Troubleshooting connections.

The return value is true (non-zero) if a connection was successfully established and false (zero) otherwise. Error information for starting the server, starting the database, or connecting is returned in the SQLCA.