2 Using The Product : Environment-Specific Information

Environment-Specific Information
The sections “For Windows Users” and “For UNIX and Linux Users” contain information specific to your operating environment.
The following sections refer to threading models. Refer to Chapter 3 “Threading” in the DataDirect Connect Series for ODBC Reference for an explanation of threading.
Windows iconFor Windows Users
The following are requirements for the 32- and 64-bit drivers on Windows operating systems.
32-Bit Drivers
n
All required network software that is supplied by your database system vendors must be 32-bit compliant.
n
If your application was built with 32-bit system libraries, you must use 32-bit drivers. If your application was built with 64-bit system libraries, you must use 64-bit drivers (see “64-Bit Drivers”). The database to which you are connecting can be either 32-bit or 64-bit enabled.
n
 
n
The following operating systems are supported for DataDirect Connect for ODBC. All editions are supported unless otherwise noted.
n
The following operating systems are supported for DataDirect Connect XE for ODBC. All editions are supported unless otherwise noted.
n
An application that is compatible with components that were built using Microsoft Visual Studio 2005 compiler version 8 and the standard Win32 threading model
n
You must have ODBC header files to compile your application. For example, Microsoft Visual Studio includes these files.
64-Bit Drivers
n
All required network software that is supplied by your database system vendors must be 64-bit compliant.
n
 
n
The following operating systems are supported for DataDirect Connect64 for ODBC. All editions are supported unless otherwise noted.
 
n
The following operating systems are supported for DataDirect Connect64 XE for ODBC. All editions are supported unless otherwise noted.
 
n
For Itanium II: an application that is compatible with components that were built using Microsoft C/C++ Optimizing Compiler Version 13.10.2240.8 and the standard Windows 64 threading model
n
For x64: an application that is compatible with components that were built using Microsoft C/C++ Optimizing Compiler Version 14.00.40310.41 and the standard Windows 64 threading model
n
You must have ODBC header files to compile your application. For example, Microsoft Visual Studio includes these files.
Setup of the Drivers
The drivers must be configured before they can be used. See Chapter 1 “Quick Start Connect” for information about using the Windows ODBC Administrator. See the individual driver chapters for details about driver configuration.
Driver Names
The prefix for all 32-bit driver file names is IV. The prefix for all 64-bit driver file names is DD. The file extension is .DLL, which indicates dynamic link libraries. For example, the 32-bit DB2 Wire Protocol driver file name is IVDB2nn.DLL, where nn is the revision number of the driver.
Refer to the readme file shipped with the product for the file name of each driver.
UNIX iconFor UNIX and Linux Users
The following are requirements for the 32- and 64-bit drivers on UNIX/Linux operating systems.
32-Bit Drivers
n
All required network software that is supplied by your database system vendors must be 32-bit compliant.
n
If your application was built with 32-bit system libraries, you must use 32-bit drivers. If your application was built with 64-bit system libraries, you must use 64-bit drivers (see “64-Bit Drivers”). The database to which you are connecting can be either 32-bit or 64-bit enabled.
AIX
n
n
n
An application compatible with components that were built using CSet++ 5.0 and the AIX native threading model
NOTE FOR TERADATA USERS: When compiling an application on AIX for use with the driver for the Teradata database, you must use the -brtl option. For example:
cc -o pgm pgm.o –brtl -lodbc
or
ld -o pgm –brtl pgm.o -lodbc
HP-UX
n
n
n
For PA-RISC: An application compatible with components that were built using HP aC++ 3.30 and the HP-UX 11 native (kernel) threading model (posix draft 10 threads)
n
For IPF: An application compatible with components that were built using HP aC++ 5.36 and the HP-UX 11 native (kernel) threading model (posix draft 10 threads)
NOTE: DataDirect Connect XE for ODBC is not supported on IPF. Only the following DataDirect Connect for ODBC drivers are supported on IPF:
 
n
Linux
n
n
n
An application compatible with components that were built using g++ GNU project C++ Compiler version 3.4.6 and the Linux native pthread threading model (Linuxthreads).
NOTE: All drivers are supported on Linux except for the Informix driver.
Solaris
n
n
n
For Sun SPARC: An application compatible with components that were built using Sun Workshop v. 6 update 2 and the Solaris native (kernel) threading model
n
For x86/x64: An application compatible with components that were built using Sun C++ 5.8 and the Solaris native (kernel) threading model
NOTE: DataDirect Connect XE for ODBC is not supported on x86/x64. Only the following DataDirect Connect for ODBC drivers are supported on x86/x64:
 
64-Bit Drivers
All required network software that is supplied by your database system vendors must be 64-bit compliant.
AIX
n
n
n
An application compatible with components that were built using Visual Age C++ version 5.0.2.0 and the AIX native threading model
HP-UX
n
n
n
Linux
n
n
NOTE: The Oracle (client) driver is not supported on the Red Hat x64 operating system.
n
For Itanium II: an application compatible with components that were built using g++ GNU project C++ Compiler version 3.3.2 and the Linux native pthread threading model (Linuxthreads)
n
For x64: an application compatible with components that were built using g++ GNU project C++ Compiler version 3.4 and the Linux native pthread threading model (Linuxthreads)
NOTE: DataDirect Connect64 XE for ODBC is not supported on Linux Itanium II.
Solaris
n
n
n
For Sun SPARC: An application compatible with components that were built using Sun Workshop v. 6 update 2 and the Solaris native (kernel) threading model
n
For x64: An application compatible with components that were built using Sun C++ Compiler version 5.8 and the Solaris native (kernel) threading model
NOTE: DataDirect Connect64 XE for ODBC is not supported on Solaris x64. Only the following drivers are supported on Solaris x64:
 

 
AIX
If you are building 64-bit binaries, you must pass the define ODBC64. Demoodbc provides an example of this. See the installed file demoodbc.txt and “The demoodbc Application” for details.
You must also include the correct compiler switches if you are building 64-bit binaries. For example, to build demoodbc, you would use:
xlC_r –DODBC64 -q64 -qlonglong -qlongdouble -qvftable -o demoodbc
-I../include demoodbc.c -L../lib -lc_r -lC_r -lodbc
HP-UX 11 aCC
The ODBC drivers require certain runtime library patches. The patch numbers are listed in the readme file for your product. HP‑UX patches are publicly available from the HP Web site www.hp.com.
HP updates the patch database regularly; therefore, the patch numbers in the readme file may be superseded by newer versions. If you search for the specified patch on an HP site and receive a message that the patch has been superseded, download and install the replacement patch.
If you are building 64-bit binaries, you must pass the define ODBC64. Demoodbc provides an example of this. See the installed file demoodbc.txt and “The demoodbc Application” for details. You must also include the +DD64 compiler switch if you are building 64-bit binaries. For example, to build demoodbc, you would use:
aCC -Wl,+s +DD64 -DODBC64 -o demoodbc -I../include demoodbc.c -L../lib -lodbc
Linux
If you are building 64-bit binaries, you must pass the define ODBC64. Demoodbc provides an example of this. See the installed file demoodbc.txt and “The demoodbc Application” for details.
You must also include the correct compiler switches if you are building 64-bit binaries. For example, to build demoodbc, you would use:
g++ -o demoodbc -DODBC64 -I../include demoodbc.c -L../lib -lodbc -lodbcinst
-lc
Solaris
If you are building 64-bit binaries, you must pass the define ODBC64. Demoodbc provides an example of this. See the installed file demoodbc.txt and “The demoodbc Application” for details.
You must also include the -xarch=v9 compiler switch if you are building 64-bit binaries. For example, to build demoodbc, you would use:
CC -mt –DODBC64 -xarch=v9 -o demoodbc -I../include demoodbc.c -L../lib -lodbc
–lCrun
Setup of the Environment and the Drivers
On UNIX and Linux, several environment variables and the system information file must be configured before the drivers can be used. See Chapter 1 “Quick Start Connect” for a brief description of these variables and information about using the DataDirect ODBC Data Source Administrator for UNIX/Linux. See the individual driver chapters for details about driver configuration. See Chapter 4 “Configuring the Product on UNIX/Linux” for complete information about using the drivers on UNIX and Linux.
Driver Names
The drivers are ODBC API-compliant dynamic link libraries, referred to in UNIX and Linux as shared objects. The prefix for all 32-bit driver file names is iv. The prefix for all 64-bit driver file names is dd. The driver file names are lowercase and the extension is .so, the standard form for a shared object. For example, the 32-bit DB2 Wire Protocol driver file name is ivdb2nn.so, where nn is the revision number of the driver. For drivers on HP-UX PA-RISC only, the extension is .sl, for example, ivdb2nn.sl.
Refer to the readme file shipped with your DataDirect product for the file name of each driver.