ODBC_DRIVER_CONNECT Function
Connect to an ODBC compliant data source.
 
Restriction
See "Supported Platforms Guide" on the PV-WAVE Documentation website to check if this function is available on your operating system.
Usage
connect_handle = ODBC_DRIVER_CONNECT(env_handle, driver_info)
Input Parameters
env_handle—An ODBC environment handle, as returned by ODBC_INIT.
Driver_info—String identifying driver specific information.
Returned Value
connect_handle—An ODBC connection handle, used to identify this data source connection in other function calls. If the function fails, -1 is returned.
Keywords
Auto_commit—An integer value that specifies whether to use autocommit or manual-mode.
*Manual commit mode (Auto_commit = 0) - In this mode users must explicitly use the ODBC_COMMIT function to commit any changes.
*Autocommit mode (Auto_commit = 1) - In this mode users do not have to use the ODBC_COMMIT function. All changes are committed right after the SQL statement is executed.
Output—If successful, this variable contains the completed connection string.
Discussion
This function is an alternative to the ODBC_CONNECT function. It supports data sources that require more connection information.
Driver_Info is a connection string that must contain all of the required information to connect to a data source. The default system information such as system DSN will not be used by this function. Please check your driver specific documents for all the available values that can be used within a connection string.
Example
This is an example for an SQL Server.
oid = odbc_init()
driver_info = "DSN=MyDSN;SERVER=MyServer;UID="";PWD="";DATABASE=pubs;"
oid2=odbc_driver_connect(oid,driver_info,output=output)