www.openlinksw.com
docs.openlinksw.com

Book Home

Contents
Preface

Overview
New Features in OpenLink UDA
ODBC Client Components
Generic Client for Windows
Generic Client For Macintosh OS 8.6+
Mac OS X
Generic Client for UNIX
New Features
Oracle Connection Pooling Support
Oracle 10g Instant Client: Connection String Formats
Multi-Tier-specific Connection-Pooling
ADO.NET Data Providers
OLE-DB Client Provider
Server Components Installation
Request Broker Administration
Server Agent Administration
Securing a Multi-Tier connection using SSL
Zero Configuration Networking
JDBC Components
Distributed Transaction Processing (XA)
Real Application Cluster (RAC) / TAF Support
iODBC Driver Manager SDK
Sample Applications
Bugs Fixed
Technical Appendix

Abstract

This chapter describes the ODBC client component of OpenLink Universal Data Access (UDA).

ODBC stands for Open Database Connectivity, a data-access API implementation from Microsoft that conforms to the X/Open SQL CLI specification. ODBC links ODBC compliant applications to ODBC Drivers via the ODBC Driver Manager.

ODBC Driver Managers exist on other platforms such as Mac, Unix and Linux. These platforms usually make use of the "iODBC Driver Manager". Additional information regarding iODBC can be obtained from: www.iodbc.org.

Table of Contents

3.1. Generic Client for Windows
3.1.1. Installation (32-bit)
3.1.2. Installation (64-bit)
3.1.3. Data Source Configuration
3.1.4. ODBC System & User Data Sources
3.1.5. Creating a File Data Source
3.1.6. Advanced Settings
3.2. Generic Client For Macintosh OS 8.6+
3.2.2. Installation
3.2.3. Data Source Configuration
3.2.4. Tracing Data Sources
3.2.5. Testing Data Sources
3.3. Mac OS X
3.3.2. Installation
3.3.3. Data Source Configuration
3.3.4. Testing Data Sources
3.3.5. Troubleshooting ODBC Connections and Sessions
3.4. Generic Client for UNIX
3.4.1. Installation
3.4.2. Configuration
3.4.3. Sample Application
3.4.4. UDBC Data Source Configuration
3.5. New Features
3.6. Oracle Connection Pooling Support
3.6.1. What it is
3.6.2. Benefits
3.6.3. How it Works
3.6.4. The OpenLink Perspective: what you do to use it
3.8. Oracle 10g Instant Client: Connection String Formats
3.8.1.

3.7. Multi-Tier-specific Connection-Pooling

3.7.1. Multi-Tier-specific configuration

The required parameters are configured through environment-variables - either use the web-based Administrative Assistant (normally located at <http://server:8000/>) navigating through `Server Components Administration', `Database Agent Administration', `Database Agent Settings by Form', select the name of the agent section used, and scroll to the section `OpenLink Agent Startup Parameters', or edit the rulebook file (oplrqb.ini) directly, to assert settings for the OCI_CONNPOOL_* settings below:

[Environment ORACLE90]
ORACLE_HOME        = /dbs/oracle90
ORACLE_SID         = ORCL
;ORACLE_SERVER      = T
;TWO_TASK           = P:
;ODBC_CATALOGS      = Y         ; Uncomment after loading odbccat9.sql
;MULTIPLEX_LDA      = 5         ; Allow 5 OpenLink clients on a single lda
;OPL_USR_TBLS_FIRST = Y         ; Sort SQLTables starting with user tables
SHOW_REMARKS       = N  ; Retrieve SQLColumns REMARKS field
CURSOR_SENSITIVITY = LOW        ; Set to HIGH after loading odbccat9.sql
;OCI_PREFETCH_ROWS  = 100       ; Number of rows to prefetch
;OCI_PREFETCH_MEMORY = 65535    ; Amount of memory to use for prefetching
;LD_LIBRARY_PATH = /dbs/oracle81/lib    ; Find shared libraries
;SHLIB_PATH      = /dbs/oracle81/lib    ; Find HP/UX shared libraries
;LIBPATH         = /dbs/oracle81/lib    ; Find AIX shared libraries
;NLS_LANG        = AMERICAN_AMERICA.UTF8 ; Uncomment for Unicode connections
OCI_CONNPOOL_MIN = 0         ; minimum initial connections in pool
OCI_CONNPOOL_INCR = 1        ; number of new connections when others busy
OCI_CONNPOOL_MAX = 1         ; sum of MIN+INCR
OCI_CONPOOL_WAIT = TRUE      ; whether new query waits or errors when all busy
OCI_CONNPOOL_LINGER = 0      ; seconds to linger after last connection cleared

OCI connection pooling is disabled by setting a minimum connection pool size of 0.