Powered by Zoomin Software. For more details please contactZoomin

DataDirect ODBC ReadMe

Oracle ODBC 8.0.2 UNIX

  • Last Updated: May 8, 2026
  • 19 minute read
    • OpenAccess SDK
    • Documentation

     README
     Progress (R) DataDirect (R)
     
     Progress(R) DataDirect(R) for ODBC for Oracle(TM) Wire Protocol Driver

     UNIX and Linux Platforms (32- and 64-bit)
     Release 8.0.2

     April 2026


***********************************************************************
Copyright (C) 2026 Progress Software Corporation and/or its 
subsidiaries or affiliates. All Rights Reserved.

***********************************************************************

This README file contains information for Progress(R) DataDirect(R)  
for ODBC for Oracle(TM) Wire Protocol Driver. 

This README file contains information not included in the PROGRESS
DATADIRECT(R) FOR ODBC FOR ORACLE WIRE PROTOCOL DRIVER USER'S GUIDE AND 
REFERENCE.


CONTENTS

Post-GA Product Announcements
Requirements
Installation Directory
Data Source and Platform Support
Third-party Components Compatibility Matrix 
Changes Since 8.0.2 GA 
Changes for 8.0.2 GA 
Changes for 8.0.1 GA   
Configuring Data Sources
Driver WorkAround Options
Notes, Known Problems, and Restrictions
Documentation
Installed Files for the 32-bit Driver
Installed Files for the 64-bit Driver 


   Post-GA Product Announcements

The readme files will no longer be updated with product announcements and new 
features after the General Availability (GA) of the product. For the latest 
updates and enhancements, please refer to the release notes 
(https://www.progress.com/datadirect-connectors/whats-new).


    Requirements

* The installer program requires a JVM that is Java SE 11 or higher, including
  Oracle JDK, OpenJDK, and IBM SDK (Java) distributions.

* The driver requires the following runtime libraries:

  - AIX: C/C++ runtime libraries version 16.1 or higher
  - Linux: C/C++ runtime libraries version GCC 2.12 or higher
  - Solaris: C/C++ runtime libraries version 12.6 or higher

    Installation Directory

* The default installation directory for the 32-bit driver is:

  /opt/Progress/DataDirect/ODBC_32bit

* The default installation directory for the 64-bit driver is:

  /opt/Progress/DataDirect/ODBC_64bit


    Data Source and Platform Support

For the latest data source and platform support information, refer to the 
Product Compatibility Guide: 
https://docs.progress.com/bundle/datadirect-product-compatibility/resource/
datadirect-product-compatibility.pdf  


    Third-party Components Compatibility Matrix

For information about the third-party components that are installed with the 
product, refer to the ODBC Third-party Components Compatibility Matrix on the 
DataDirect Product Life Cycle page:
https://docs.progress.com/bundle/datadirect-product-life-cycle/page/topics/
datadirect_life_cycle/datadirect-product-life-cycle.html 
  

    Changes Since 8.0.2 GA
	
ICU Library Upgrade (74.1)
--------------------------
The ICU library files that are installed with the product have been upgraded 
to version 74.1. As a part of this upgrade, the following platforms and their 
file names have been updated:

* AIX platforms
  - 32-bit product package: From libivicu28.a to libivicu.a
  - 64-bit product package: From libddicu28.a to libddicu.a 
  Note - This upgrade is available starting in build 08.02.1072 of the ICU 
  library files.
	
* Linux platforms
  - 32-bit product package: From libivicu28.so to libivicu.so
  - 64-bit product package: From libddicu28.so to libddicu.so
  Note - This upgrade is available starting in build 08.02.0965 of the ICU 
  library files.
	
* Solaris platforms (Sparc and Solaris X)
  - 32-bit product package: From libivicu28.so to libivicu.so
  - 64-bit product package: From libddicu28.so to libddicu.so
  Note - This upgrade is available starting in build 08.02.1799 of the ICU 
  library files.	
	 
As part of the ICU 74.1 upgrade, the complier and runtime versions for the 
driver have been changed to the following:
  
* For AIX platforms, the compiler version has been upgraded to xlclang++ 16.1.
  As a result, you must have C/C++ runtime libraries of 16.1 or higher to 
  run the driver. 

* For Linux platforms, the compiler version has been upgraded to GCC 7.3.1. 
  As a result, you must have C/C++ runtime libraries of GCC 2.12 or higher to
  run the driver. 
	
* For Solaris platforms, the compiler version has been upgraded to Oracle 
  Developer Studio 12.6. As a result, you must have C/C++ runtime libraries 
  of 12.6 or higher to run the driver. 		

LDAP Authentication
-------------------
The driver has been enhanced to support both unencrypted and encrypted 
connections to the LDAP server. After connecting to the LDAP server, 
the driver retrieves the necessary connection details from it and then 
connects to the database server. Refer to the user's guide for details.

Feature details:
- Available: Driver version 08.02.4057 (B3466, U3460)
- Proposed by the following DataDirect Idea:
  https://datadirect.ideas.aha.io/ideas/CONN-I-1564

Debugging Symbols
------------------
The driver binaries now include debugging symbols that can be used for 
diagnosing and debugging issues in the driver.

Microsoft Entra ID Authentication
---------------------------------
The driver has been enhanced to support authentication using Microsoft Entra
ID (Azure Active Directory) access tokens. You can configure this 
authentication using the updated Authentication Method (AuthenticationMethod)
connection option and the new Entra Access Token (EntraAccessToken) connection
option.

JRE Requirement for the Installer
---------------------------------
The installer program now requires you to install a JRE that is Java SE 11 or
higher before running the installer. In earlier versions, the JRE used by the
installer program was included in the product. However, to avoid potential
security vulnerabilities, the installer program no longer includes a JRE.
Instead, the installer program uses the JRE in your environment to allow for
the most secure version of a JRE to be used.
 
Notes:
* This change does not affect the JVM requirements for the driver. For the latest 
  driver requirements, refer to the Product Compatibility Guide:
  https://docs.progress.com/bundle/datadirect-product-compatibility/resource/
  datadirect-product-compatibility.pdf
* The installer program cannot remove the already installed JRE files from the 
  install directory automatically. Remove them manually.


TLSv1.3 Support
---------------
The driver has been enhanced to support the TLSv1.3 cryptographic protocol. As
part of this enhancement, the default cryptographic protocols enabled by the 
driver have been updated to TLSv1.3 and TLSv1.2.

TLSv1.1 and TLSv1.0 Disabled
----------------------------
The TLSv1.1 and TLSv1.0 cryptographic protocols are now disabled by default
and have been removed as selectable values for the Crypto Protocol Version
(CryptoProtocolVersion) option on the Setup dialog. These protocols are no
longer considered secure and, therefore, are no longer recommended for use. 
However, the driver still supports TLSv1.1 and TLSv1.0 for legacy servers that
do not support more secure protocols.

ODBC Cursor Library
-------------------
The product package no longer includes the ODBC Cursor library file 
(odbccurs.so) because it has some known security vulnerabilities that 
could potentially expose you to security risks.

Note: The installer program cannot remove the ODBC Cursor library file 
automatically while installing a new version of the driver. Remove it 
manually.

Oracle Wallet Password Stores Configuration
-------------------------------------------
The valid value for the Authentication Method (AuthenticationMethod) option 
for retrieving credential information from Oracle Wallet Password Stores has 
been changed from 14 to 16. To support existing configurations of the driver, 
the original value, 14, will continue to be supported for this version of the
driver. 

SSL Enhancement (3.0.9)
-----------------------
Note: OpenSSL library 3.0.9 has been replaced with a later version. For 
the latest information about the third-party components that are installed 
with the product, refer to the ODBC Third-party Components Compatibility 
Matrix on the DataDirect Product Life Cycle page:
https://docs.progress.com/bundle/datadirect-product-life-cycle/page/topics/
datadirect_life_cycle/datadirect-product-life-cycle.html.

The default version of the OpenSSL library has been upgraded to version 
3.0.9, which fixes the security vulnerabilities listed on the following 
page: https://www.openssl.org/news/vulnerabilities-3.0.html

This upgrade is available in build 08.02.0595 of the following OpenSSL 
library files: 
- On AIX: libivopenssl30.a (32-bit) and libddopenssl30.a (64-bit)
- On other platforms: ivopenssl30.so [.sl] (32-bit) and ddopenssl30.so (64-bit)

Notes:
* The driver supports the following OpenSSL 3.0 providers: Default and 
  FIPS.

* The FIPS provider is supported only on the following platforms: 
  Windows 64-bit, Linux 64-bit, and AIX 64-bit.

* The following connection options have been added to configure the 
  driver to use OpenSSL 3.0: Enable FIPS (EnableFIPS), OpenSSL Config File
  (OpenSSLConfigFile), and OpenSSL Provider Path (OpenSSLProviderPath).
  For more information on the new connection options and how to configure
  the driver to use OpenSSL 3.0, refer to the user's guide.

* The following Oracle Advanced Security algorithms are not supported with 
  OpenSSL 3.0:
  - Data Integrity algorithms: MD5 and SHA1
  - Encryption algorithms: RC4_128, RC4_256, RC4_40, and RC4_56  
  
* When installing a new version of the product, the installer program will 
  automatically replace the OpenSSL 1.1.1 library files with the OpenSSL 3.0 
  library files in the install directory, which will impact all the DataDirect 
  ODBC drivers installed on a machine. Therefore:
  - If you are using multiple 8.0 drivers, upgrade all your drivers to the latest 
    version.
  - If you are using both 8.0 and 7.1 versions of the driver, copy the xxtls27.dll
    file to a different location before installing a new version of the 8.0 driver. 
    Copy it back to the install directory once the installation is complete.

* The driver is unable to establish a Kerberos connection with Oracle 18c. 
  Progress DataDirect is investigating this issue.
  (Bug: https://progresssoftware.atlassian.net/browse/XDBC-45964)  


End of Support for OpenSSL 1.1.1
--------------------------------
The product no longer includes version 1.1.1 of the OpenSSL library. 
The library will reach the end of its product life cycle in September 2023
and will not receive any security updates after that. Note that continuing 
to use the library after September 2023 can potentially expose you to 
security vulnerabilities.

Note: As a result of this change, when installing a new version of the product, 
the installer program will automatically remove version 1.1.1 of the library 
from the install directory, which will impact all the DataDirect ODBC drivers 
installed on a machine.


Installer Upgrade
-----------------
The installer program has been enhanced to use a more modern and
secure technology. As a result of this enhancement:

* The default installation location has been changed to:

  - For the 32-bit driver:
    /opt/Progress/DataDirect/ODBC_32bit

  - For the 64-bit driver:
    /opt/Progress/DataDirect/ODBC_64bit

* The new installer program does not support upgrading installations 
  made with earlier versions of the installer. You will need to 
  uninstall the existing installation and reinstall with the new 
  installer to resume upgrades in the same directory.

* The existing data sources cannot be used until they are 
  updated to point to the new installation location. To learn 
  how to update them, refer to the best practices documented 
  at https://community.progress.com/s/.

End of Support for OpenSSL 1.0.2
--------------------------------
The product no longer includes version 1.0.2 of the OpenSSL library. 
The library has reached the end of its product life cycle and is not 
receiving security updates anymore. Note that continuing to use the 
library could potentially expose you to security vulnerabilities.

Note: As a result of this change, when installing a new version of the 
driver, the installer program will automatically remove version 1.0.2 
of the library from the install directory.

Support for TLS/SSL server authentication in a serverless environment
---------------------------------------------------------------------
The driver has been enhanced to support TLS/SSL server authentication for 
the applications deployed in a serverless environment. The driver stores the 
TLS/SSL certificates in memory and lets applications use TLS/SSL server 
authentication without storing the truststore file on the disk. To use this 
enhancement, specify the content of the certificate in the refreshed 
Trust Store (Truststore) connection option or the new  
SQL_COPT_INMEMORY_TRUSTSTORECERT pre-connection attribute. Refer to the 
user's guide for details.

Bind Params As Unicode Option 
-----------------------------
The driver has been enhanced with the new Bind Params As Unicode 
(BindParamsAsUnicode) option, which specifies whether the driver converts data 
in bind parameters from the SQL_CHAR, SQL_VARCHAR, and SQL_LONGVARCHAR ODBC 
data types to the SQL_WCHAR, SQL_WVARCHAR, and SQL_WLONGVARCHAR types when C 
type is set to SQL_C_WCHAR. When certain applications bind SQL_C_WCHAR data to 
a non-Unicode ODBC type, this behavior may result in the substitution of some 
characters. Enabling this option allows you to avoid character substitution by
configuring the driver to use the corresponding Unicode ODBC type.

See "Notes, Known Problems, and Restrictions" for more information.

BatchFailureReturnsError Option
-------------------------------
The driver has been enhanced with the new BatchFailureReturnsError option, 
which determines the behavior of the driver when encountering an error in a 
parameter array insert with bulk load disabled. If set to 1 (enabled), the 
driver returns SQL_ERROR and rolls back the operation when encountering an 
error in any of the parameter sets. If set to 0 (Disabled), the driver returns 
SQL_ SUCCESS _WITH_INFO and commits the rows that were successfully inserted 
prior to encountering the error.

Password Encryption Tool
------------------------
A Password Encryption Tool, called ddencpwd, is now included with the product
package. It encrypts passwords for secure handling in connection strings and
odbc.ini files. At connection, the driver decrypts these passwords and passes
them to the data source as required.

XA Interface Support
--------------------
The driver has been enhanced to support distributed transactions. 
It implements the XA interface to enable support for distributed transactions.
For details, refer to the user's guide.

Documentation
-------------
Any product package made available after February 9, 2021 will not include the
HTML help system or user's guide PDF. The full documentation set, including
these items, is available from the Progress Information Hub:
https://docs.progress.com/category/datadirect-oracle

While the product packages will not include these documentation items, the
installation Help directory will provide an HTML redirect for direct access
to the HTML help.

Note that all Progress DataDirect for ODBC documentation has been migrated to
the Progress Information Hub:
https://docs.progress.com 

Extended Connection Failover Support for the TNSNAMES.ORA File Connections
--------------------------------------------------------------------------
The driver has been enhanced to support extended connection failover for the
connections established using the TNSNAMES.ORA file. Refer to the user's guide 
for details.

Timestamp Logging in Packet Logs
--------------------------------
The drivers using base version B0649 and later have been enhanced to 
include timestamp in the internal packet logs by default. If you want to
disable the timestamp logging in packet logs, set PacketLoggingOptions=1.
The internal packet logging is not enabled by default. To enable it, 
set EnablePacketLogging=1.

Oracle Wallet Password Store Support 
------------------------------------
The driver has been enhanced to support Oracle Wallet Password Stores. When 
this feature is enabled, the driver retrieves database credentials from an 
Oracle Wallet to be used for authentication to the server. The driver has also
been enhanced with the new Credentials Wallet Entry (CredentialsWalletEntry),
Credentials Wallet Path (CredentialsWalletPath), Wallet Password 
(CredentialsWalletPassword) options, which allow you to configure this feature.

Note: Oracle Wallet Password Store functionality requires the OpenSSL 1.1.1 
      library. Earlier versions of the library, including those installed with 
      the driver, are not supported by the feature. 

LDAP Support
------------
The driver has been enhanced to support using connection information stored in
an LDAP entry to establish a connection. You can configure the driver to use 
LDAP with the new LDAPDistinguishedName option and refreshed HostName and 
PortNumber options. 

Setting Unicode Encoding Type for Connections
---------------------------------------------
The Driver Manager for UNIX/Linux has been enhanced to support setting the 
Unicode encoding type for applications on a per connection basis. By passing a 
value for the SQL_ATTR_APP_UNICODE_TYPE attribute using SQLSetConnectAttr, your
application can specify the encoding at connection. This allows your 
application to pass both UTF-8 and UTF-16 encoded strings with a single 
environment handle. 

The valid values for the SQL_ATTR_APP_UNICODE_TYPE attribute are SQL_DD_CP_UTF8
and SQL_DD_CP_UTF16. The default value is SQL_DD_CP_UTF8.

This enhancement is available in build 08.02.0449 of the driver manager.

Support for Oracle Connection Manager
-------------------------------------
The driver has been enhanced to support connecting through Oracle Connection
Manager using the TNSNAMES.ORA file. Refer to the user's guide for details.

AllowedOpenSSLVersions
----------------------
Determines which version of the OpenSSL library file the driver uses for data
encryption when multiple versions are installed with the product. For example, 
when specifying a value of 1.1.1 (AllowedOpenSSLVersions=1.1.1), the driver 
uses the 1.1.1 version of the library stored in the /lib subdirectory. Refer to
the user's guide for more information.

Statement Attributes Enhancement
--------------------------------
The driver has been enhanced to support the following new statement attributes
that allow you to override connection option settings for an individual 
statement:
* SQL_ATTR_BULK_LOAD_ENABLED statement attribute overrides the EnableBulkLoad
  option
* SQL_ATTR_IANA_APP_CODE_PAGE statement attribute overrides the IANAAppCodePage
  option 

Refer to the User's Guide for more information.        
  
HTTP Proxy Support
------------------  
The driver has been enhanced to support connecting to a proxy server through
an HTTP connection. HTTP proxy support is configurable with the new ProxyHost,
ProxyMode, ProxyPassword, ProxyPort, and ProxyUser connection options. 

Note: The HTTP proxy connections do not currently support SSL data encryption. 
  
Oracle Database Vault
---------------------
Support has been added for Oracle Database Vault.

Impersonation Support 
--------------------- 
The driver has been enhanced with the new Impersonate User connection option
that allows you to specify the proxy user ID used for impersonation. The user
ID specified using this option determines your permissions and identity when 
executing queries. 

Setting the Service Name/SID in the Server listener.ora File 
------------------------------------------------------------
The driver has been enhanced to support using the default Service Name or SID
specified in the server-side listener.ora file.

Setting Array Size with SQL_ATTR_ROW_ARRAY_SIZE 
-----------------------------------------------
The setting of the Array Size option can now be overridden by specifying the 
number of rows to fetch using the SQL_ATTR_ROW_ARRAY_SIZE statement attribute.  
  
Oracle Database Exadata Cloud Service
-------------------------------------
Support has been added for the Oracle Database Exadata Cloud Service.
  
  
    Changes for 8.0.2 GA   
  
Enhanced Platform Support
-------------------------
Support for the following platforms is now generally available: 
 * Oracle Solaris x86 (32- and 64-bit)
 * Oracle Solaris on SPARC (32- and 64-bit)
  
Linux Itanium II Support 
------------------------  
Support for the Intel Itanium II (IPF) processor on the following 64-bit Linux
platforms is now generally available:  
 * CentOS Linux 4.x, 5.x, 6.x, and 7.x
 * Oracle Linux 4.x, 5.x, 6.x, and 7.x
 * Red Hat Enterprise Linux 4.x, 5.x, 6.x, and 7.x 
  
Oracle Wallet 
-------------
Support for Oracle Wallet, including:
 * Oracle Wallet SSL Authentication
 * Using Oracle Wallet as a keystore or truststore for SSL data encryption.
  
Oracle Internet Directory
-------------------------
The driver has been enhanced to support using Oracle Internet Directory for 
LDAP Authentication. No additional driver configuration is required when 
authenticating with Oracle Internet Directory.
  
Oracle Advanced Security 
------------------------
The driver has been enhanced to support the following new data integrity 
algorithms for Oracle 12c and higher: SHA256, SHA384, SHA512. To use these 
algorithms, specify their values using the DataIntegrityTypes connection 
option and enable data integrity checks with the DataIntegrityLevel 
connection option.  
  
As a result of this enhancement, the default value for the DataIntegrityTypes
connection option has changed to the following: 
MD5,SHA1,SHA256,SHA384,SHA512  
  
Maximum Identifier Length
-------------------------
The maximum supported length of identifiers has been increased to 128 bytes 
when connecting to Oracle 12c R2 (12.2) databases.
  
  
    Changes for 8.0.1 GA
   
Oracle 12 and 12a Authentication Protocols
------------------------------------------
The driver now supports the Oracle 12 and 12a authentication protocols, 
which provide improved security. 

SDUSize Connection Option
-------------------------
The new SDUSize connection option allows you to specify the size in bytes of
the Session Data Unit (SDU) that the driver requests when connecting to the 
server. 

SupportBinaryXML Connection Option
----------------------------------
The new SupportBinaryXML connection option enables the driver to support 
XMLType with binary storage on servers running Oracle 12c and higher. 

LOBPrefetchSize Connection Option
---------------------------------
The new LOBPrefetchSize connection option allows you to specify the size of
prefetch data the driver returns for BLOBs and CLOBs for Oracle database 
versions 12.1.0.1 and higher. With LOB prefetch enabled, the driver can return 
LOB meta-data and the beginning of LOB data along with the LOB locator during 
a fetch operation. This can have significant performance impact, especially for
smaller LOBs that can potentially be entirely prefetched, because the data is 
available without having to go through the LOB protocol. 

Implicit Result Sets
--------------------
The driver now supports implicit result sets returned from stored procedures.

Deprecated EnableNcharSupport Connection Option
-----------------------------------------------
The EnableNcharSupport connection option has been deprecated, and the driver 
behavior has been updated to always provide support for the N-types NCHAR, 
NVARCHAR2 and NCLOB. For compatibility purposes, the EnableNcharSupport 
attribute can still be manually specified for this release, but it will be 
deprecated in subsequent versions of the product.

Deprecated EnableTimestampwithTimezone Connection Option 
--------------------------------------------------------
The EnableTimestampwithTimezone connection option has been deprecated, and 
the driver behavior has been updated to always expose timestamps with timezones 
to the application. For compatibility purposes, the EnableTimestampwithTimezone
attribute can still be specified for this release, but it will be 
deprecated in subsequent versions of the product. 

Default Value for for the DataIntegrityLevel Connection Option
--------------------------------------------------------------
The default value for the DataIntegrityLevel connection option has been 
updated to 1 (Accepted). A data integrity check can now be made on data sent 
between the driver and the database server by default. 

Default Value for the EncryptionLevel  Connection Option
--------------------------------------------------------
The default value for the EncryptionLevel connection option has been updated 
to 1 (Accepted). By default, encryption is now used on data sent between the 
driver and the database server if the database server requests or requires it.
 
 
      Configuring Data Sources

Data sources are stored in the system information file (typically, 
odbc.ini). For details on configuring this file, see the PROGRESS DATADIRECT
FOR ODBC FOR ORACLE WIRE PROTOCOL DRIVER USER'S GUIDE AND REFERENCE.
 
 
      Driver WorkAround Options

Progress DataDirect has included non-standard connection options (workarounds)
for the driver that enable you to take full advantage of  packaged ODBC-enabled
applications requiring non-standard or extended behavior. Refer to the chapter
"WorkAround options" in THE PROGRESS DATADIRECT FOR ODBC DRIVERS REFERENCE for a
description of these options.
 
 
    Notes, Known Issues, and Restrictions   

Driver Crashes on Solaris Platforms
-----------------------------------
In testing, build 3072 of the driver has been observed to crash intermittently
on Solaris platforms. The incident rate is very low and specific to our testing
environment, but we are continuing to investigate the root cause of the crash.

Specifying values for the same connection option multiple times
--------------------------------------------------------------- 
The driver does not support specifying values for the same connection
option multiple times in a connection string or DSN. If a value is
specified using the same attribute multiple times or using both
long and short attributes, the connection may fail or the driver may
not behave as intended.

For Oracle 8 Server Users
-------------------------
The driver uses the XA protocol support in Oracle 8 to provide
distributed transaction support. For recovery to work correctly, you
must grant appropriate privileges on any server that will participate in
a distributed transaction. You must grant the SELECT privilege on
SYS.DBA_PENDING_TRANSACTIONS to all users that will use MTS. Refer to
the Oracle 8 documentation for details on using Oracle XA.

For SSL Users
-------------
When trying to connect to a database using SSL encryption, you may
receive an error message similar to: "PRNG not seeded". This is because
certain versions of some operating systems do not generate truly random
numbers necessary for encryption. For more information about this error
and available patches, please refer to the Web site:
http://www.openssl.org/support/faq.html#USER1
  
ODBC Development on UNIX and Linux Platforms
--------------------------------------------
All of the Release 8.0 Core Components (header files, etc.) needed for 
development of ODBC applications on UNIX and Linux are installed into 
the /include directory created by the product installer.

Please read the notices.txt file in the installation directory for 
licensing information regarding the ODBC Core Components. Contact your 
Progress DataDirect representative if you have any questions.

Developers using programming languages other than C++:
The DataDirect ODBC Driver Manager is a C++ shared library. The ODBC 
Driver Manager can be used with any language that supports loading a 
C++ shared library; however, if you are using a programming language 
other than C++, you must take additional steps to ensure that the C++ 
libraries are initialized properly when loaded. If you are not using 
C++, consult your compiler documentation for instructions on using C++ 
shared libraries with your application.

LANG Environment Setting on UNIX and Linux Platforms
----------------------------------------------------
A default installation of the product on UNIX and Linux assumes that 
the value of the LANG environment setting is en_US. If your locale is 
not set to en_US, the drivers may not return error messages properly. 
In this case, you must create a symbolic link in the 
<Install_Dir>/locale directory that has the same value as the LANG 
environment setting. This link must point to the 
<Install_Dir>/locale/en_US directory.

SQLColAttribute(s)
------------------
The column attributes 1001 and 1002, which were assigned as DataDirect- 
specific attributes, were inadvertently used as system attributes by
the Microsoft 3.0 ODBC implementation. Applications using those 
attributes must now use 1901 and 1902, respectively.
 
SQL_C_NUMERIC
-------------
Because of inconsistencies in the ODBC specification, users attempting 
to use SQL_C_NUMERIC parameters must set the precision and scale values 
of the corresponding structure and the descriptor fields in the 
Application Parameter Descriptor.
 
For Developers Using IIS
------------------------
One of the most common connectivity issues encountered while using IIS 
(Microsoft's Internet Information Server) concerns the use and settings 
of the account permissions. If you encounter problems using DataDirect 
drivers with an IIS server, refer to KnowledgeBase document number 4274 
on the Progress DataDirect web site:

http://knowledgebase.datadirect.com.
 
For AIX Users
-------------
Some IBM AIX C compilers, such as xlc 3.1.4, do not support the use 
of C++ build binaries. C developers on AIX should consult their 
compiler documentation and verify that their AIX C compiler supports 
the use of C++ shared libraries or the application could be unstable.

Unexpected behavior may occur randomly if the LIBPATH variable 
exceeds 178 characters AND the ORACLE_HOME variable is relatively 
long. To resolve this, create a shorter symbolic link for 
ORACLE_HOME.

For Oracle Users
----------------
If you are using Oracle 8.1.7, you must have the 8.1.7.1 server patch
installed. Otherwise, you may receive the Oracle error:"ORA-03120: 
two-task conversion routine: integer overflow" when fetching LOB data.

SQLProcedures and SQLProcedureColumns now include functions/procedures 
from Oracle packages. They are denoted in the result set as 
PackageName.ProcedureName for the PROCEDURE_NAME.

To use static scrollable cursors with result sets containing long 
columns, you must set EnableStaticCursorsForLongData (ESCLD) to 1 
(EnableStaticCursorsForLongData=1) in the data source entry of the 
Registry or in a connection string. The default setting is 0.

You must have a complete installation of the Oracle 8i client software 
for the Oracle (client) driver to operate properly when accessing 
remote Oracle 8i servers 8.0.5 or higher. Be sure that you have 
installed Oracle 8i Client 8.1.7, installation type:  Programmer.

NOTES: On Linux, you must use the Oracle Net8 Client version 8.1.6.1.


     Documentation

PROGRESS DATADIRECT FOR ODBC FOR ORACLE WIRE PROTOCOL DRIVER DOCUMENTATION SET
------------------------------------------------------------------------------
The driver documentation set is available from the Progress Information Hub:

https://docs.progress.com/category/datadirect-oracle

You can access the online help system directly via the HTML redirect in the
installation Help directory.


    Uninstalling the Driver 

You can uninstall the product or individual drivers by opening the 
uninstall_ODBC_80_<xx>bit file in the uninstall directory.


   Installed Files the 32-bit Driver

This file list assumes a full installation of the driver and 
documentation.

The installer copies the following files and subdirectories to the 
product installation directory, by default:

/opt/Progress/DataDirect/ODBC_32bit:


odbc.csh                         Setup script for C shell
odbc.ini                         Sample odbc.ini file
odbcinst.ini                     Sample odbcinst.ini file
odbc.sh                          Setup script for Bourne shell
IVODBC.LIC                       DataDirect license file
fixes.txt                        List of fixes since last release
license.txt                      Progress DataDirect license agreement

/bin:
ivtestlib                        Test application to check that required 
                                 libraries are present and loadable
                                 
/help: 
*.html                           HTML redirects to online connector help systems
                                 and documentation resources

/include:
odbcinst.h                       Include files
qesqlext.h
sql.h
sqlext.h
sqltypes.h
sqlucode.h
sqlunx.h

/lib:
ivopenssl30.so                   TLS/SSL support file (OpenSSL library 
                                 version 3.0) [libivopenssl30.a on AIX]
ivopenssl.so                     TLS/SSL support file (OpenSSL library 
                                 version 3.5) [libivopenssl.a on AIX]
ivora28.so                       Oracle WP driver  
ivtrc28.so                       Progress DataDirect trace library
libivcurl28.so                   Library used for HTTP connections [.a on AIX]
libivicu.a                       Unicode conversion tables for AIX platforms
libivicu.so                      Unicode conversion tables for Linux and 
                                 Solaris platforms
libivldap28.so                   Library for LDAP connections [.a on AIX]
libodbc.so                       ODBC Driver Manager [.a on AIX]
libodbcinst.so                   ODBC Installer [.a on AIX]
odbc.so                          ODBC Driver Manager (dynamically loadable) 
                                 [AIX only]
odbcinst.so                      ODBC Installer (dynamically loadable) 
                                 [AIX only]                                 

/locale/en_US/LC_MESSAGES:
ivora28.mo                       Oracle WP driver message file
ivora28.po                       Oracle WP driver message file source
odbc.mo                          ODBC Driver Manager message file
odbc.po                          ODBC Driver Manager message source

/NOTICES:
ODBC for Oracle 
v8.0 notices.txt                 Third-party vendor license agreements  


/READMES:
ODBC for Oracle 
v8.0 readme.txt                  This file

/samples:
/bulk/bulk                       Bulk application
/bulk/bulk.c                     Bulk example source
/bulk/bulk.mak                   Bulk example make file
/bulk/bulk.txt                   Bulk example description

/bulkstrm/bulk.cpp               Bulk streaming example source
/bulkstrm/bulk.hpp               Bulk streaming example header
/bulkstrm/bulkstrm               Bulk streaming example application
/bulkstrm/bulkstrm.txt           Bulk streaming example description
/bulkstrm/main.cpp               Bulk streaming example source
/bulkstrm/msgprintf.hpp          Bulk streaming example header
/bulkstrm/streambulk.mak         Bulk streaming example make file

/example/example                 Example application
/example/example.c               Example source
/example/example.h               Example header
/example/example.mak             Example make file

/tools:
ddencpwd                         Password Encryption Tool
ddextu                           License Extender utility
ddprocinfo                       Processor Information utility


    Installed Files for the 64-bit Driver

This file list assumes a full installation of all drivers and 
documentation. 

The installer copies the following files and subdirectories to the 
product installation directory, by default:

/opt/Progress/DataDirect/ODBC_64bit:

odbc.csh                         Setup script for C shell
odbc.ini                         Sample odbc.ini file
odbcinst.ini                     Sample odbcinst.ini file
odbc.sh                          Setup script for Bourne shell
DDODBC.LIC                       DataDirect license file
fixes.txt                        List of fixes since last release
license.txt                      Progress DataDirect license agreement

/bin:
ddtestlib                        Test application to check that required 
                                 libraries are present and loadable

/help: 
*.html                           HTML redirects to driver help systems

/include:
odbcinst.h                       Include files
qesqlext.h
sql.h
sqlext.h
sqltypes.h
sqlucode.h
sqlunx.h

/lib:
ddopenssl30.so                  TLS/SSL support file (OpenSSL library 
                                 version 3.0) [libddopenssl30.a on AIX]
ddopenssl.so                     TLS/SSL support file (OpenSSL library 
                                 version 3.5) [libddopenssl.a on AIX]
ddora28.so                       Oracle WP driver  
ddtrc28.so                       Progress DataDirect trace library
fips.so                         Support file for FIPS provider
libddcurl28.so                   Library used for HTTP connections [.a on AIX]
libddicu.a                       Unicode conversion tables for AIX platforms
libddicu.so                      Unicode conversion tables for Linux and Solaris 
                                 platforms 							  
libddldap28.so                   Library for LDAP connections [.a on AIX]
libodbc.so                       ODBC Driver Manager [.a on AIX]
libodbcinst.so                   ODBC Installer [.a on AIX]
odbc.so                          ODBC Driver Manager (dynamically loadable) 
                                 [AIX only]
odbcinst.so                      ODBC Installer (dynamically loadable) 
                                 [AIX only]
openssl.cnf                      Configuration file for FIPS provider                                 

/locale/en_US/LC_MESSAGES:
ddora28.mo                       Oracle WP driver message file
ddora28.po                       Oracle WP driver message file source
odbc.mo                          ODBC Driver Manager message file
odbc.po                          ODBC Driver Manager message source

/notices:
ODBC for Oracle
v8.0 notices.txt                 Third-party vendor license agreements  

/readmes:
ODBC for Oracle
v8.0 readme.txt                  This file

/samples:
/bulk/bulk                       Bulk application
/bulk/bulk.c                     Bulk example source
/bulk/bulk.mak                   Bulk example make file
/bulk/bulk.txt                   Bulk example description

/bulkstrm/bulk.cpp               Bulk streaming example source
/bulkstrm/bulk.hpp               Bulk streaming example header
/bulkstrm/bulkstrm               Bulk streaming example application
/bulkstrm/bulkstrm.txt           Bulk streaming example description
/bulkstrm/main.cpp               Bulk streaming example source
/bulkstrm/msgprintf.hpp          Bulk streaming example header
/bulkstrm/streambulk.mak         Bulk streaming example make file

/example/example                 Example application
/example/example.c               Example source
/example/example.h               Example header
/example/example.mak             Example make file
/example/example64.txt           Example description

/tools:
ddencpwd                         Password Encryption Tool
ddextu                           License Extender utility
ddprocinfo                       Processor Information utility            
  
  

~~~~~~~~~~~~~~~
April 2026
End of README.TXT

TitleResults for “How to create a CRG?”Also Available inAlert