skip to main content
Using the Driver : Configuring and Connecting to Data Sources : Data Source Configuration on Windows
  

Try DataDirect Drivers Now

Data Source Configuration on Windows

On Windows, data sources are stored in the Windows Registry. You can configure and modify data sources through the ODBC Administrator using a driver Setup dialog box, as described in this section.
When the driver is first installed, the values of its connection options are set by default. These values appear on the driver Setup dialog box tabs when you create a new data source. You can change these default values by modifying the data source. In the following procedure, the description of each tab is followed by a table that lists the connection options for that tab and their initial default values. This table links you to a complete description of the options and their connection string attribute equivalents. The connection string attributes are used to override the default values of the data source if you want to change these values at connection time.
To configure an Oracle data source:
1. Start the ODBC Administrator by selecting its icon from the DataDirect Connect program group.
2. Select a tab:
*User DSN: If you are configuring an existing user data source, select the data source name and click Configure to display the driver Setup dialog box.
If you are configuring a new user data source, click Add to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.
*System DSN: If you are configuring an existing system data source, select the data source name and click Configure to display the driver Setup dialog box.
If you are configuring a new system data source, click Add to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.
*File DSN: If you are configuring an existing file data source, select the data source file and click Configure to display the driver Setup dialog box.
If you are configuring a new file data source, click Add to display a list of installed drivers; then, select a driver. Click Advanced if you want to specify attributes; otherwise, click Next to proceed. Specify a name for the data source and click Next. Verify the data source information; then, click Finish to display the driver Setup dialog box.
3. The General tab of the Setup dialog box appears by default.
Figure 1. General tab
The General tab of the ODBC Oracle Wire Protocol Driver Setup dialog box
On this tab, provide values for the options in the following table; then, click Apply. The table provides links to descriptions of the connection options. The General tab displays fields that are required for creating a data source. The fields on all other tabs are optional, unless noted otherwise.
Connection Options: General
Description
Specifies the name of a data source in your Windows Registry or odbc.ini file.
Default: None
Specifies an optional long description of a data source. This description is not used as a runtime connection attribute, but does appear in the ODBC.INI section of the Registry and in the odbc.ini file.
Default: None
The name or the IP address of the server to which you want to connect.
Default: None
Specifies the port number of the server listener.
Default: None
SID
The Oracle System Identifier that refers to the instance of Oracle running on the server.
Default: None
Note: This option is mutually exclusive with the LDAP Distinguished Name, Service Name, Server Name, and TNSNames File options.
Note: If no values are specified for the LDAP Distinguished Name, SID, Service Name, and TNSNames options, the driver attempts to connect to the ORCL SID by default.
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
Default: None
Note: This option is mutually exclusive with the LDAP Distinguished Name, Service Name, Server Name, and TNSNames File options.
Note: If no values are specified for the LDAP Distinguished Name, SID, Service Name, and TNSNames options, the driver attempts to connect to the ORCL SID by default.
Specifies the distinguished name for the LDAP entry that contains your connection information. Using an LDAP entry provides simplified maintenance by allowing you to centrally store and access connection information. LDAP entries specify the Host, Port Number, and Service Name or SID for the target database using the orclNetDescString attribute.
Note: This option is mutually exclusive with the Host, Port Number, SID, and Service Name options.
Note: If a value is specified for this option, the Host and Port Number options are used to specify the host and port number for the LDAP directory server.
Specifies a net service name that exists in the tnsnames.ora file. The corresponding net service name entry in the tnsnames.ora file is used to obtain Host, Port Number, and Service Name or SID information.
Default: None
Note: This option is mutually exclusive with the LDAP Distinguished Name, Host, Port Number, SID, and Service Name options.
Specifies the name of the tnsnames.ora file.
Default: None
Note: If no values are specified for the LDAP Distinguished Name, SID, Service Name, and TNSNames options, the driver attempts to connect to the ORCL SID by default.
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.
Default: None
4. At any point during the configuration process, you can click Test Connect to attempt to connect to the data source using the connection options specified in the driver Setup dialog box. A logon dialog box appears (see "Using a Logon Dialog Box" for details). Note that the information you enter in the logon dialog box during a test connect is not saved.
5. To further configure your driver, click on the following tabs. The corresponding sections provide details on the fields specific to each configuration tab:
*Advanced tab allows you to configure advanced behavior.
*Security tab allows you to specify security data source settings.
*Performance tab allows you to specify performance data source settings.
*Failover tab allows you to specify failover data source settings.
*Pooling tab allows you to specify connection pooling settings.
*Bulk tab allows you to specify data source settings for DataDirect Bulk Load.
*Client Monitoring tab allows you to specify additional data source settings.
*Advanced Security tab allows you to specify settings for Oracle Advanced Security (OAS).
*Proxy tab allows you to specify settings for connecting through an HTTP proxy.
6. Click OK. When you click OK, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.
* Advanced Tab
* Security Tab
* Performance Tab
* Failover Tab
* Pooling Tab
* Bulk tab
* Client Monitoring Tab
* Advanced Security Tab
* Proxy Tab