unsigned int db_string_connect( 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.
Provides extra functionality beyond the embedded SQL CONNECT command.
For a description of the algorithm used by this function, see 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.