IBM Informix

Release Notes for IBM Informix Client SDK (CSDK)

3.00.xC3DE 22 October 2007

Contents

Release Notes
Legal Notice
Purpose of these release notes
Getting Started with Client SDK
International Informix Users Group
Versions of components in this release
Client-server testing
Technical Support Online Resources
New Features in Client SDK
Information Center for Product Documentation
Installation Notes
Enabling Connections on Microsoft Windows Vista
Embed Manifests in VS2005 Applications
Incorrect Server Version Can Be Returned
The dbping Utility
Connectivity Protocols
IPv6 Platform Support
Enhanced .NET Data Provider
Documentation Notes and Corrections

Release Notes

Legal Notice

Copyright IBM Corp. 1994, 2007

Proprietary Data

THIS DOCUMENT CONTAINS TRADE SECRET DATA WHICH IS THE PROPERTY OF IBM CORPORATION.

THIS DOCUMENT IS SUBMITTED TO RECIPIENT IN CONFIDENCE. INFORMATION CONTAINED HEREINMAY NOT BE USED, COPIED OR DISCLOSED IN WHOLE OR IN PART EXCEPT AS PERMITTED BY WRITTEN AGREEMENT SIGNED BY AN OFFICER OF IBM SOFTWARE, INC. THIS MATERIAL IS ALSO COPYRIGHTED AS AN UNPUBLISHED WORK UNDER SECTIONS 104 AND 408 OF TITLE 17 OF THE UNITED STATES CODE. UNAUTHORIZED USE, COPYING OR OTHER REPRODUCTION IS PROHIBITED BY LAW. THIS PRODUCT INCLUDES CRYPTOGRAPHIC SOFTWARE WRITTEN BY ERIC YOUNG (eay@mincom.oz.au).

IT IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Owner Group:
Information Development
Description:
Release notes file (without fixed and known bugs) for Client SDK product.
Important: Please note that product names and documentation that include the word "Informix" are now "IBM Informix." Except for pathnames, configuration parameters, environment variables. and user informix, the "IBM" should be prefixed for any reference to "Informix" in any context of the product, documentation, and other "Informix" items.

Purpose of these release notes

The purpose of these release notes for IBM Informix Client SDK (CSDK) Version 3.00 is to:

These release notes are not intended to be all-inclusive; they should be used as an addendum to the product manuals.

Who should read these release notes?

You should read these release notes if you are:

Getting Started with Client SDK

To help you prepare for installing or upgrading Client SDK, follow these steps:

  1. Read these notes and the component-specific release notes. For more information, see the following section.
  2. Read the IBM Informix Client Products Installation Guide. This manual is available in PDF format in the /doc directory on the product media prior to installation.

Component-specific online notes

Release and documentation notes specific to the component products of the Client SDK Version 3.00 are in different files. These files are available in the /doc directory of your product media prior to installation. Both the release and the documentation notes are located in the same product file. The following table list the release notes filenames for each Client SDK product.

Product Files
IBM Informix Object Interface for C++ libcpp_release_notes_3.00.html
or
libcpp_release_notes_3.00.txt
IBM Informix ESQL/C esqlc_release_notes_3.00.html
or
esqlc_release_notes_3.00.txt
IBM Informix Global Language Support (GLS) glsapi_release_notes_3.00.html
or
glsapi_release_notes_3.00.txt
IBM Informix ODBC Driver odbc_release_notes_3.00.html
or
odbc_release_notes_3.00.txt
IBM Informix .NET Provider dotnet_release_notes_3.00.html
or
dotnet_release_notes_3.00.txt
IBM Informix OLE DB Provider oledb_release_notes_3.00.html
or
oledb_release_notes_3.00.txt

International Informix Users Group

The International Informix Users Group (IIUG) runs a web site (http://www.iiug.org) which, amongst other things, supports a Software Archive (http://www.iiug.org/software). The Software Archive contains the source code for a lot of utilities that might be of interest to you as you use IBM Informix Dynamic Server. Note, however, that these utilities are not supported by IBM.

Membership in the IIUG is free.

Versions of components in this release

Beginning with version 2.90 of IBM Informix Client SDK (CSDK), all components except for the global language support libraries (GLS) will have the same version number as the Client SDK that they are a part of. The GLS libraries are version 4.5 for this release of CSDK.

For some components this means that the version number for this release is lower than the version number for the CSDK release prior to 2.90.xC1. This affects only the number of the version. The component is not actually older than that included in the previous release of Client SDK.

Client-server testing

For information on which database servers each CSDK component supports, see the individual release notes files for those components.

Technical Support Online Resources

You can find the answers to many of your questions on the IBM Informix Dynamic Server Support Web site:

http://www-306.ibm.com/software/data/informix/ids/support/.

The IBM Informix Support Web site contains the following areas:

New Features in Client SDK

This section describes the new database server features that this release of CSDK supports. For new features specific to CSDK components, see the release notes files for each component.

Changes were made in this version of Client SDK to allow you to use these new features of IBM Informix Dynamic Server, version 11.10. See the IDS release notes for that version to learn more about the new features:

Information Center for Product Documentation

The Informix Dynamic Server Information Center for 11.10 (http://publib.boulder.ibm.com/infocenter/idshelp/v111/index.jsp) contains the following product documentation:

The Information Center provides full text search, logical categories, easy navigation, and links to troubleshooting and support files.

Installation Notes

This section describes installation issues.

Installation on Linux x86 RHEL 3 or Higher

Installation of IBM Informix ClientSDK/IBM Informix Connect might stop responding on Linux x86 RHEL 3 or higher if one of the following is true:

The solution is to unset JAVAHOME or JAVA_HOME, not to use the javahome option and to unset java from the path.

Restart Might be Required After Upgrade on Windows Platforms

The default directory install location was changed in CSDK 2.90.TC3 on Windows. After upgrading to CSDK 3.00 on Windows, you must restart your computer if the following three conditions are true:

All other applications do not require a restart after upgrading.

CSDK Built with Visual Studio 2005 Compiler

The 3.00 version of CSDK was built with the Visual Studio 2005 compiler.

C++ Runtime Required with IBM Informix Dynamic Server

The C++ runtime system is necessary to use IBM Informix Dynamic Server 9.40.xC1 or later. Dynamic Server 9.40.xC1 and later has enhanced its support of Unicode to Unicode Collation and code points beyond the Basic Multilingual Plane (BMP) of Unicode. This is accomplished by using International Components for Unicode (ICU), which is a C++ component and requires the C++ runtime system.

Limit on length of installation pathname

You cannot install Client SDK or IBM Informix Connect in a directory with more than 215 characters in the full pathname.

Do not mix 32-bit and 64-bit versions

Do not install the 32-bit version and the 64-bit version of the Client SDK and/or Informix Dynamic Server in the same INFORMIXDIR.

Error 1311 when installing on Windows operating systems

If you are installing on a Windows operating system you might get this error.

Error 1311. Source File "d:\data.cab" Not Found. 

The path to data.cab might be different in the error you get.

If you get this error it means that your computer has a security option set that prevents the System Account from accessing the CD-ROM drive. The install program runs using the System Account instead of the user account you logged in as. If the security option is set it cannot access the CD-ROM drive.

If you get this error you can either copy the CD-ROM onto your hard disk and install from there or disable the security feature.

To disable the security feature
  1. Log on as a user that has administrative privileges
  2. Choose one of the following:

    Control Panel --> Administrative Tools --> Local Security Settings

    Control Panel --> Administrative Tools --> Local Security Policy

  3. In the left-hand pane, choose Local Policies --> Security Options.
  4. In the right-hand pane, double click whichever of these lines is present:

    Devices: Restrict CD-ROM access to locally logged-on user only.

    Restrict CD-ROM access to locally logged-on user only.

  5. Select Disabled.
  6. Click OK.

After installation you can enable the security feature.

Enabling Connections on Microsoft Windows Vista

To enable connections between database servers on the Microsoft(R) Windows Vista operating system, you must enable network discovery and NetBIOS over TCP/IP.

To enable connections:

  1. From the Control Panel, double-click Network and Sharing.
  2. In the Sharing and Discovery section of the Network and Sharing Center, click Network discovery and then Turn on network discovery.
  3. In the Network section, click View Status next to the Local Area Connection.
  4. In the Local Area Connection Status dialog box, click Properties.
  5. In the Local Area Connection Properties dialog box, choose the appropriate Internet Protocol Version and click Properties.
  6. In the Internet Protocol Version Properties dialog box, click Advanced.
  7. On the WINS page of the Advanced TCP/IP Settings dialog box, click Enable NetBIOS over TCP/IP and then click OK.
  8. Continue clicking OK or Close until all dialog boxes are closed.

Embed Manifests in VS2005 Applications

If you create applications with Visual Studio 2005, you must embed the manifest in the executables and DLLs.

Use this command to embed a manifest file in a DLL:

mt.exe -manifest manifest_filename -outputresource:dll_name;2

Use this command to embed a manifest file in an executable file:

mt.exe -manifest manifest_filename -outputresource:dll_name;1

For more information about manifests, see the Microsoft website.

Incorrect Server Version Can Be Returned

Client APIs used to query the version of the server can return the incorrect string of "9.50.UC1" when used against Dynamic Server Version 10.00.UC1.

The dbping Utility

Starting with CSDK 2.90, the dbping utility has been removed from CSDK. This utility can be downloaded from the IBM external website at the following location: http://www-306.ibm.com/software/data/informix/downloads.html

The utility will now be an independently available installable utility and will be available for support "as-is".

Connectivity Protocols

Platform/OS BSTP IPSP IPSM TLTP TLIX MAXC
Solaris-32 onsoctcp onipcstr onipcshm ontlitcp ontlispx ontliimc
Solaris-64 onsoctcp onipcstr onipcshm ontlitcp ontliimc
HPUX-32 onsoctcp onipcstr onipcshm onsocimc
HPUX-64 onsoctcp onipcstr onipcshm onsocimc
AIX-32 onsoctcp onipcstr onipcshm onsocimc
AIX-64 onsoctcp onipcstr onipcshm onsocimc
Linux onsoctcp onipcstr onipcshm onsocimc
Unixware onipcshm ontlitcp ontlispx ontliimc
Solaris Operton onsoctcp onipcstr onipcshm ontlitcp onsocimc
HP Itanium 64 onsoctcp onipcstr onipcshm onsocimc
Linux AMD 64 onsoctcp onipcstr onipcshm onsocimc
Linux pSeries onsoctcp onipcstr onipcshm onsocimc
Linux zSeries onsoctcp onipcstr onipcshm onsocimc

BSTP - Berkeley sockets using TCP/IP

IPSP - IPC using stream pipe

IPSM - IPC using shared memory

TLTP - TLI using TCP/IP

TLIX - TLI using IPX/SPX

MAXC - MaxConnect

Notes:

IPv6 Platform Support

IPv6 is supported on the following platforms with CSDK 3.00:

Enhanced .NET Data Provider

The .NET Data Provider extends Informix server support for the ADO.NET interface. The .NET Data Provider delivers high-performing, secure access to Informix data. To develop and run applications that use .NET Data Provider you need the .NET Framework, Version 2.0 or 1.1.

In addition to the .NET Data Provider, there is also a collection of add-ins to the Microsoft(R) Visual Studio .NET IDE. The add-ins simplify the creation of applications that use the ADO.NET interface.

For more information, see the IBM Informix .NET Provider Reference Guide.

Documentation Notes and Corrections

This section describes the known corrections and changes that need to be made to the Client Products Installation Guide.

There are no known corrections or changes at this time.