IBM Informix Release Notes for IBM Informix Client SDK (CSDK) 2.90.xC4 1 December 2005 Contents 1.

0 Release Notes 1.1 Legal Notice 1.2 Purpose of these release notes 1.3 Getting Started with Client SDK 1.4 International Informix User Group 1.5 Versions of components in this release 1.6 Client-server testing 1.7 New Information Center for Product Documentation 1.8 Technical Support Online Resources 1.9 Installation Notes 1.10 New Features in Client SDK 1.11 Incorrect Server Version Can Be Returned 1.12 The dbping Utility 1.13 DataDirect Driver Manager Not Included 1.14 Connectivity Protocols 1.15 IPv6 Platform Support 1.16 Known Issues 1.0 Release Notes 1.1 Legal Notice (C) Copyright IBM Corp. 1994, 2005 1.1.1 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: Description: Information Development 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. 1.2 Purpose of these release notes The purpose of these release notes for IBM Informix Client SDK (CSDK) Version 2.90 is to: * Tell you about any special things you need to do to configure and use the Client SDK products * Describe new features in this release * Describe any changes in old features * Describe known problems with this release and give workarounds if any are available These release notes are not intended to be all-inclusive; they should be used as an addendum to the product manuals. 1.2.1 Who should read these release notes? You should read these release notes if you are: * A system administrator who installs IBM Informix database servers * A database administrator who controls access to IBM Informix databases * A developer who writes applications using Client SDK, Version 2.90. 1.3 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. 3. Read the documentation notes for the IBM Informix Client Products Installation Guide, client_install_docnotes_2.90.html. 1.3.1 Component-specific online notes Release notes specific to the component products of the Client SDK Version 2.90 are in different files. These files are available in the /doc directory of your product media prior to installation. The following table list the release notes filenames for each Client SDK product. +-------------------------------+-------------------------------------+ | Product | Files | +-------------------------------+-------------------------------------+ | IBM Informix Object Interface | cpp_relnotes_2.90.html or | | for C++ | cpp_relnotes_2.90.txt | +-------------------------------+-------------------------------------+ | IBM Informix ESQL/C | esqlc_relnotes_2.90.html or | | | esqlc_relnotes_2.90.txt |

+-------------------------------+-------------------------------------+ | IBM Informix Global Language | gls_relnotes_4.00.html or | | Support (GLS) | gls_relnotes_4.00.txt | +-------------------------------+-------------------------------------+ | IBM Informix ODBC Driver | odbc_relnotes_2.90.html or | | | odbc_relnotes_2.90.txt | +-------------------------------+-------------------------------------+ | IBM Informix .NET Provider | dotnet_relnotes_2.90.html or | | | dotnet_relnotes_2.90.txt | +-------------------------------+-------------------------------------+ | IBM Informix OLE DB Provider | oledb_relnotes_2.90.html or | | | oledb_relnotes_2.90.txt | +-------------------------------+-------------------------------------+ Documentation notes for the manual associated with each product have are located in the same directory and have similar names, with docnotes in the filename instead of relnotes. 1.4 International Informix User Group The International Informix User 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 Client SDK. You need to be a member of the IIUG to obtain the software, but membership is free. 1.5 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.0 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. 1.6 Client-server testing For information on which database servers each CSDK component supports, see the individual release notes files for those components. 1.7 New Information Center for Product Documentation The Informix Dynamic Server Information Center integrates the entire IBM Informix Dynamic Server 10.0 and IBM Informix Client SDK (CSDK) 2.90 documentation sets in both HTML and PDF formats. The Information Center provides full text search, logical categories, easy navigation, and links to troubleshooting and support files. The URL for the Informix information center is: http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp. For information about CSDK, click on Connecting from within the Contents frame. 1.8 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: * Search: search for a term, phrase, error code, or APAR number * Self help: access tech notes, Red books, product documentation, problem determination tutorials, the platform availability matrix, and the storage manager support matrix * Problem submission: submit a problem to IBM Technical Support * Flashes: read about common problems and their solutions * Downloads: find IBM Informix fixpacks * Links to other useful sites 1.9 Installation Notes This section describes installation issues. 1.9.1 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 2.90.xC4 on Windows, you must restart your computer if the following three conditions are true: * You are upgrading from a previous release of CSDK that you installed in the default location. * You plan to install CSDK 2.90.xC4 in the default location. * Your applications have a dependency on Windows services. The COM+ application (an application that uses MTS) is an example of such application. All other applications do not require a restart after upgrading. 1.9.2 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. 1.9.3 New installation options on UNIX and Linux You can install CSDK on UNIX or Linux using the new installation application in console, GUI, or silent mode. For detailed instructions, see the IBM Informix Client Products Installation Guide. You can also install CSDK simultaneously with Dynamic Server using the Dynamic Server installation application. For more information, see the appropriate Dynamic Server installation guide. 1.9.4 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. 1.9.5 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.

1.9.6 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. 1.10 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. 1.10.1 New features of IDS 10.0 that are supported by Client SDK 2.90 Changes were made in this version of Client SDK to allow you to use these new features of IBM Informix Dynamic Server version 10.0. See the IDS release notes for that version to learn more about the new features. * Column-level encryption * Creating or dropping an index while the server is online using the new ONLINE SQL keyword

* Storing multiple table or index fragments in the same dbspace * Support for Internet Protocol version 6 (IPv6) * Support for TRUNCATE 1.10.2 New features of XPS 8.50 that are supported by Client SDK 2.90 Changes were made to this version of Client SDK to allow you to use these new features of IBM Informix Extended Parallel Server version 8.50. See the XPS release notes for that version to learn more about the new features. * * * * * Specifying default roles for new connections Specifying coserver ids in database names Upsert statements Scrubbed tables Immutable session variables

1.11 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. 1.12 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". 1.13 DataDirect Driver Manager Not Included DataDirect Driver Manager will not be shipped with CSDK after CSDK 2.90.xC1. 1.14 Connectivity Protocols +----------+---------+---------+----------+--------+--------+---------+ | Platform | BSTP | IPSP | IPSM | TLTP | TLIX | MAXC | | /OS | | | | | | | +----------+---------+---------+----------+--------+--------+---------+ | Solaris- | | onipcst | onipcshm | ontlit | ontlis | ontliim | | 32 | | r | | cp | px | c | +----------+---------+---------+----------+--------+--------+---------+ | Solaris- | | onipcst | onipcshm | ontlit | | ontliim | | 64 | | r | | cp | | c | +----------+---------+---------+----------+--------+--------+---------+ | IRIX-32 | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | IRIX-64 | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | Decalpha | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+

| HPUX-32 | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | HPUX-64 | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | AIX-32 | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | AIX-64 | onsoctc | onipcst | onipcshm | | | onsocim | | | p | r | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | Linux | onsoctc | | onipcshm | | | onsocim | | | p | | | | | c | +----------+---------+---------+----------+--------+--------+---------+ | Sequent | | onipcst | onipcshm | ontlit | | ontliim | | | | r | | cp | | c | +----------+---------+---------+----------+--------+--------+---------+ | Unixware | | | onipcshm | ontlit | ontlis | ontliim | | | | | | cp | px | c | +----------+---------+---------+----------+--------+--------+---------+ | SCO | | | onipcshm | ontlit | ontlis | | | | | | | cp | px | | +----------+---------+---------+----------+--------+--------+---------+ | Sinix-32 | onsoctc | onipcst | onipcshm | ontlit | | ontliim | | | p | r | | cp | | c | +----------+---------+---------+----------+--------+--------+---------+ | Sinix-64 | onsoctc | onipcst | onipcshm | ontlit | | ontliim | | | p | r | | cp | | c | +----------+---------+---------+----------+--------+--------+---------+ | DG-Intel | | onipcst | onipcshm | ontlit | | onsocim | | | | r | | cp | | c | +----------+---------+---------+----------+--------+--------+---------+ | Fujitsu | onsoctc | | onipcshm | ontlit | | | | | p | | | cp | | | +----------+---------+---------+----------+--------+--------+---------+ | NEC | | | onipcshm | ontlit | | | | | | | | cp | | | +----------+---------+---------+----------+--------+--------+---------+ | NCR | | onipcst | onipcshm | ontlit | | ontliim | | | | r | | cp | | c | +----------+---------+---------+----------+--------+--------+---------+ 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: * If you are using 64bit servers: Remote 32-bit applications/tools (example: ESQL/C, 4GL, ISQL) can only connect to the IBM Informix

Dynamic Server using the TCP/IP protocol. Local 32-bit applications/tools can connect to the 64-bit server using either TCP/IP protocols or IPC stream pipe protocols. Local 32-bit applications/tools cannot connect to the 64-bit server using IPC shared memory protocol. * If you are using a NUMA system and have several IP addresses configured on the same physical interface: The IBM Informix TCP listener thread binds to a particular IP address/port. It listens for incoming calls addressed to only one IP address. If there are multiple IP addresses configured on the system, a TLI client will not be able to connect to the server. (If DNS is configured to resolve the hostname on a rotary of the four IP addresses, you do not know which of those addresses has been selected by the IBM Informix TCP listener). The solution is that in the \$INFORMIXDIR/etc/sqlhosts file, use "*hostname" instead of "hostname". It will make the IBM Informix TCP listener bind to INADDR_ANY instead of a particular address. * For additional information, refer to the IBM Informix Dynamic Server machine notes. 1.15 IPv6 Platform Support IPv6 is supported on the following platforms with CSDK 2.90.xC4: * Solaris 32 bit and 64 bit * AIX 32 bit and 64 bit * Windows 32 bit * Intel x86 Linux 32 bit 1.16 Known Issues 1.16.1 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: * JAVAHOME or JAVA_HOME is set * The -javahome option is used to install the product * java is available in PATH The solution is to unset JAVAHOME or JAVA_HOME, not to use the javahome option and to unset java from the path.