skip to main content
Getting Started : Configuring and Connecting on UNIX and Linux : Configuring a Data Source in the System Information File
  

Try DataDirect Drivers Now

Configuring a Data Source in the System Information File

The default odbc.ini file installed in the installation directory is a template in which you create data source definitions. You enter your site-specific database connection information using a text editor. Each data source definition must include the keyword Driver=, which is the full path to the driver.
The following examples show the minimum connection string options that must be set to complete a test connection, where xx represents iv for 32-bit or dd for 64-bit drivers, yy represents the driver level number, and zz represents the extension. The values for the options are samples and are not necessarily the ones you would use.
[ODBC Data Sources]
Oracle=DataDirect 8.0 Oracle Wire Protocol Driver
[Oracle]
Driver=ODBCHOME/lib/xxorayy.zz
EditionName=oracle 1
HostName=199.226.224.34
PortNumber=1521
ServiceName=sales.us.acme.com
Connection Option Descriptions:
EditionName: Oracle 11g R2 and higher only. The name of the Oracle edition the driver uses when establishing a connection. Oracle 11g R2 and higher allows your database administrator to create multiple editions of schema objects so that your application can still use those objects while the database is being upgraded. This option is only valid for Oracle 11g R2 and higher databases and tells the driver which edition of the schema objects to use.
HostName: The name or the IP address of the server to which you want to connect.
PortNumber: The port number of your Oracle listener. Check with your database administrator for the number.
ServiceName:The Oracle service name that specifies the database used for the connection. The service name is a string that is the global database name—a name that is comprised of the database name and domain name, for example: sales.us.acme.com.
SID:The Oracle System Identifier that refers to the instance of Oracle running on the server.
Note: SID and ServiceName are mutually exclusive. Only one or the other can be specified in the data source; otherwise, an error is generated.
Note: If no values are specified for the SID, Service Name, and TNSNames options, the driver attempts to connect to the ORCL SID by default.