Powered by Zoomin Software. For more details please contactZoomin

DataDirect ODBC ReadMe

SAP ASE ODBC 8.0.2 UNIX

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

     README
     Progress(R) DataDirect(R)
     Progress DataDirect for ODBC for SAP ASE 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 SAP ASE(TM) Wire Protocol Driver. 

This README file contains information not included in the PROGRESS 
DATADIRECT FOR ODBC FOR SAP ASE WIRE PROTOCOL DRIVER USER'S GUIDE.



CONTENTS

Post-GA Product Announcements
Requirements
Installation Directory
Data Source and Platform Support
Third-party Components Compatibility Matrix 
Changes for 8.0.2 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

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

  /opt/Progress/DataDirect/ODBC    


    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 for 8.0.2 GA

Driver Enhancements
-------------------
* The driver binaries now include debugging symbols that can be used for 
  diagnosing and debugging issues in the driver.

* 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 driver: From libivicu28.a to libivicu.a
	- 64-bit driver: 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 driver: From libivicu28.so to libivicu.so
	- 64-bit driver: 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 driver: From libivicu28.so to libivicu.so
	- 64-bit driver: 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 on
	your machine. 

  - 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 on
	your machine.  
	
  - 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 on your machine.

* The driver has been enhanced to support Sybase Extended Password Encryption
  and Sybase Extended Plus Encrypted Password, which use an asymmetrical key 
  type. This provides stronger password encryption for the secure transmission
  of public key passwords over networks.

* The driver has been enhanced to support binary and varbinary data types when 
  using the bulk load protocol.

* 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.

* The drivers using base version B0548 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.

* 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.

* The driver supports the QUERY_TIMEOUT statement 
  attribute on all UNIX/Linux platforms. This was formerly supported 
  only on Windows.

Changed Behavior
----------------
* The driver has been updated to return Adaptive Server Enterprise as the 
  DBMS name, instead of SQL Server, for the following:
  - SQLGetInfo calls
  - Error messages

* The TLSv1.1 and TLSv1.0 cryptographic protocols are now disabled by default 
  and have been removed as selectable options 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 them for legacy servers that do not 
  support more secure protocols.

 
    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 SAP ASE WIRE PROTOCOL DRIVER USER'S GUIDE.
 
 
    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

Real Data Type Limitation
--------------------------
For values of the real data type, to comply with the SAP ASE 
server, the driver ensures the accuracy of the values 
loaded through bulk load only up to 6 digits.

Money Data Type Limitation
-------------------------
For values of the money data type, to comply with the SAP ASE 
server, if an application provides a scale (number of digits to 
the right of the decimal) greater than 4, the driver truncates
it to 4.

No Support for Inserting LOB columns Using Bulk Load Protocol
-------------------------------------------------------------
The driver does not support inserting data containing LOB columns 
using the bulk load protocol. In such cases, the driver throws a 
warning and falls back to the native protocol to continue executing 
the inserts.   

Bulk Insert Fails When Non-identity Columns are Omitted
-------------------------------------------------------
When using Bulk load to execute an insert statement, the operation 
will fail with an error message if non-identity columns are omitted 
from the statement.

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.

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 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.


    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 SAP ASE WIRE PROTOCOL DRIVER USER'S GUIDE.


    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.


     Documentation

PROGRESS DATADIRECT FOR ODBC FOR SAP ASE WIRE PROTOCOL DRIVER 
DOCUMENTATION SET
---------------------------------------------------------------
The user's guide is available as an HTML help system on the DataDirect 
documentation web page:

https://docs.progress.com/category/datadirect-sap-sybase

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


    Installed Files for the 32-bit Driver

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

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

/opt/Progress/DataDirect/ODBC:

/<install_dir>/:
----------------
IVODBC.LIC                       DataDirect license file
license.txt                      Progress DataDirect license agreement
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


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


/FIXES/:
--------
fixes8.0.txt                     List of fixes since last release

                                 
/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


/install/:
---------
*.*                              Files associated with the installer program


/lib/:
-----
ivase28.so                       SAP ASE WP driver  
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]
ivtrc28.so                       Progress DataDirect trace library
libivicu.a                       Unicode conversion tables for AIX platforms
libivicu.so                      Unicode conversion tables for Linux and 
                                 Solaris platforms                              
libodbc.so                       ODBC Driver Manager
libodbcinst.so                   ODBC Installer


/locale/en_US/LC_MESSAGES/:
--------------------------
ivase28.mo                       SAP ASE WP driver message file
ivase28.po                       SAP ASE WP driver message file source
odbc.m                           ODBC Driver Manager message file
odbc.po                          ODBC Driver Manager message source


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


/READMES/:
---------
ODBC for SAP ASE v8.0
readme.txt                       This file


/samples/bulk/:
---------------
bulk                             Bulk application
bulk.c                           Bulk example source
bulk.mak                         Bulk example make file
bulk.txt                         Bulk example description
ddlogging.properties             Log configuration file for the
                                 SAP ASE driver


/samples/bulkstrm/:
-------------------
bulk.cpp                         Bulk streaming example source
bulk.hpp                         Bulk streaming example header
bulkstrm                         Bulk streaming example application
bulkstrm.txt                     Bulk streaming example description
ddlogging.properties             Log configuration file for the
                                 SAP ASE driver
main.cpp                         Bulk streaming example source
msgprintf.hpp                    Bulk streaming example header
streambulk.mak                   Bulk streaming example make file


/samples/example/:
------------------
example                          Example application
example.c                        Example source
example.h                        Example header
example.mak                      Example make file
ddlogging.properties             Log configuration file for the
                                 SAP ASE driver


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


/uninstall/:
------------
*.*                              Files used to uninstall the product


    Installed Files for the 64-bit Driver

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

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

/opt/Progress/DataDirect/ODBC_64bit:

/<install_dir>/:
----------------
DDODBC.LIC                       DataDirect license file
license.txt                      Progress DataDirect license agreement
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


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


/FIXES/:
--------
fixes8.0.txt                     List of fixes since last release


/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


/install/:
---------
*.*                              Files associated with the installer program


/lib/:
-----
ddase28.so                       SAP ASE WP driver  
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]
ddtrc28.so                       Progress DataDirect trace library
fips.so                          Support file for FIPS provider
libddicu.a                       Unicode conversion tables for AIX platforms
libddicu.so                      Unicode conversion tables for Linux and Solaris 
                                 platforms 							                               
libodbc.so                       ODBC Driver Manager
libodbcinst.so                   ODBC Installer
openssl.cnf                      Configuration file for FIPS provider


/locale/en_US/LC_MESSAGES/:
--------------------------
ddase28.mo                       SAP ASE WP driver message file
ddase28.po                       SAP ASE WP driver message file source
odbc.m                           ODBC Driver Manager message file
odbc.po                          ODBC Driver Manager message source


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


/READMES/:
---------
ODBC for SAP ASE v8.0
readme.txt                       This file


/samples/bulk/:
---------------
bulk                             Bulk application
bulk.c                           Bulk example source
bulk.mak                         Bulk example make file
bulk.txt                         Bulk example description
ddlogging.properties             Log configuration file for the
                                 SAP ASE driver


/samples/bulkstrm/:
-------------------
bulk.cpp                         Bulk streaming example source
bulk.hpp                         Bulk streaming example header
bulkstrm                         Bulk streaming example application
bulkstrm.txt                     Bulk streaming example description
ddlogging.properties             Log configuration file for the
                                 SAP ASE driver
main.cpp                         Bulk streaming example source
msgprintf.hpp                    Bulk streaming example header
streambulk.mak                   Bulk streaming example make file


/samples/example/:
-------------------
example                          Example application
example.c                        Example source
example.h                        Example header
example.mak                      Example make file
ddlogging.properties             Log configuration file for the
                                 SAP ASE driver


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

   
/uninstall/:
------------
*.*                              Files used to uninstall the product

   
~~~~~~~~~~~~~~~~~
April 2026
End of README

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