IBM DB2 Universal Database* for SGI IRIX** Version 7 FixPak 9 Contents About this FixPak readme for IBM DB2 Universal Database* for SGI IRIX** Version 7 FixPak 9 1.1 Who should read this readme file 1.2 How to get help SGI installation notes 2.1 Prerequisites 2.2 Prior to installation 2.3 Installation instructions 2.4 After installation 2.4.1 Updating instances 2.4.2 Enabling the new SQL built-in scalar functions 2.4.3 Rebinding bind files 2.4.3.1 Rebinding to non-DRDA DB2 databases 2.4.3.2 Rebinding to DRDA databases 2.4.3.3 Rebinding specific packages 2.4.3.4 Binding db2sch.bnd to existing databases 2.5 Uninstalling FixPaks on UNIX 2.6 Alternate Unicode conversion tables for CCSID 943 2.7 Known problems and workarounds 2.7.1 Data corruption after moving from DB2 Version 7 FixPak 8 or earlier to a later Version 7 FixPak or to DB2 Version 8 2.7.2 Application Development and supported software update 2.7.3 Informix Federated support for DB2 Relational Connect 2.7.4 Loss of Control Center functionality 2.7.5 Merant Driver Manager 2.7.6 Updates into local tables in federated systems Notices About this FixPak readme for IBM DB2 Universal Database* for SGI IRIX** Version 7 FixPak 9 IBM DB2 Universal Database* for SGI IRIX** Version 7 FixPak 9 FixPak U486946 VRMF: 7.1.0.77 Note: If you have received special fixes from IBM support since 03/03/2003, then you must contact IBM support to request an updated version of the special fixes instead of installing this FixPak. By doing this, you are assured that your system is in a consistent state and no special fixes are lost. This readme file contains information for the following products and components: DB2 Application Development Client, Version 7.2 DB2 Run-Time Client, Version 7.2 1.1 Who should read this readme file The information in this readme file should be read by database administrators who seek to upgrade their present version of DB2 with the latest FixPak. This readme file contains platform specific information about the latest changes and known problems and workarounds for DB2. 1.2 How to get help Web-based support for DB2 products, including documentation, FixPaks, and APAR information, is provided at http://www.ibm.com/software/data/db2/udb/winos2unix/support and http://www.ibm.com/software/data/db2/udb/support.html. DB2 FixPaks can also be downloaded from IBM's anonymous FTP server at ftp.software.ibm.com. Go to ps/products/db2/fixes/%L/%P/ where %L is the appropriate locale (for example, english-us, spanish, german), and %P is the product name/version (for example db2sgiv7). The main Usenet newsgroup for DB2-related questions is comp.databases.ibm-db2. To contact DB2 Customer Service by phone: In the United States, call 1-800-237-5511. In Canada, call 1-800-IBM-SERV (426-7378). Worldwide, call 1-404-238-1234 (charges may apply). For information on IBM offices in your country or region, consult IBM's Directory of Worldwide Contacts at http://www.ibm.com/planetwide. For additional information on changes to the product, review the product Release Notes: /opt/IBMdb2/V7.1/Readme/%L/Release.Notes where %L is the locale name. SGI installation notes 2.1 Prerequisites You must have DB2 UDB Version 7.2 or DB2 UDB Version 7.1 with FixPak 3 or greater already installed before installing this FixPak. Use the following command to determine the current level of DB2 installed on the system: pkginfo -l db2cliv71 | grep VERSION Look for the following output, where x is 40 or higher. If you receive an error, DB2 version 7 is not installed on your system. VERSION: 7.1.0.x 2.2 Prior to installation Log on as root and enter the following commands for each instance: su - iname . $HOME/sqllib/db2profile db2 terminate exit where iname represents the instance owner name. 2.3 Installation instructions In previous FixPaks, a script called installallpatch was used to start the FixPak installation process. Beginning with FixPak 6, the installation script has been called installFixPak. The installFixPak script is the recommended method for installing this FixPak. To install the FixPak: su - root cd ./installFixPak where is the top directory in which the FixPak image is located. 2.4 After installation 2.4.1 Updating instances Note: You need to be logged on as root to update the instances. For each instance, issue the command: /opt/IBMdb2/V7.1/instance/db2iupdt iname where iname represents the instance name. For the DAS instance, issue the command: /opt/IBMdb2/V7.1/instance/dasiupdt dasname where dasname represents the DAS instance name. For more information on the db2iupdt or dasiupdt commands, run db2iupdt or dasiupdt with the "-h" option. 2.4.2 Enabling the new SQL built-in scalar functions FixPak 2 and later of Version 7 delivers new SQL built-in scalar functions. Refer to the SQL Reference and updates in the Release Notes for a description of these new functions. The new functions are not automatically enabled on each database when the database server code is upgraded to FixPak 2 or later of Version 7.1. To enable these new functions, you must login as the instance (or a SYSADM user) and issue the command db2updv7, specifying each database for each instance. This command makes an entry in the database that ensures that database objects created prior to executing this command use existing function signatures that may match the new function signatures. Note: FixPak 8 is the minimum prerequisite if you want to use a Version 8 client to connect to a Version 7 server. Therefore, anyone updating to FixPak 8 will also have to run the db2updv7 command. ATTENTION : If you intend to issue the db2updv7 command, you must be aware that it will change the database so it runs only with Version 7.1 FixPak 2 (or higher) of the database manager. You will not be able to run this database with any previous FixPak level. You must perform a full offline backup of the database prior to running db2updv7 in order to have the ability to restore to a previous FixPak level. 2.4.3 Rebinding bind files Due to the new bind (.bnd) files that have been shipped with this FixPak, you will need to rebind your DB2 utilities against all your databases after the FixPak installation. This step is necessary for the fixes in this FixPak to become effective. The procedure of rebinding, which follows, only needs to be performed once per database. 2.4.3.1 Rebinding to non-DRDA DB2 databases After applying fixes, you must do the following: - At a command prompt: db2 terminate db2 CONNECT TO db2 BIND /@db2ubind.lst BLOCKING ALL GRANT PUBLIC db2 BIND /@db2cli.lst BLOCKING ALL GRANT PUBLIC db2 terminate or, - At the DB2 command line: TERMINATE CONNECT TO BIND /@db2ubind.lst BLOCKING ALL GRANT PUBLIC BIND /@db2cli.lst BLOCKING ALL GRANT PUBLIC TERMINATE Where is the name of a database to which the utilities should be bound, and where is the full path name of the directory where the bind files are located, such as /sqllib/bnd. DB2UBIND.LST and DB2CLI.LST contain lists of commonly required bind files that are used for DB2. 2.4.3.2 Rebinding to DRDA databases If you are using DB2 Connect to connect to host databases, you will also need to bind the new bind files to the host. As above, use the DB2 Command Line Processor to connect to the host database, and then bind the utilities as follows: HOST COMMAND ======= =================================================== MVS BIND /@ddcsmvs.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE VM BIND /@ddcsvm.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE VSE BIND /@ddcsvse.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE OS400 BIND /@ddcs400.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE See "Binding Applications and Utilities" in the DB2 Connect User's Guide for a list of bind files that are used for your specific client operating system. If a bind file changes and your clients do not use that bind file, you do not need to rebind it. 2.4.3.3 Rebinding specific packages If you want to bind only the specific .bnd files to the database, issue the following commands for each database. - At a command prompt: db2 terminate db2 CONNECT TO db2 BIND / BLOCKING ALL GRANT PUBLIC db2 terminate or, - At the DB2 command line: TERMINATE CONNECT TO BIND / BLOCKING ALL GRANT PUBLIC TERMINATE where represents the name of the bind file, and represents the name of your database. 2.4.3.4 Binding db2sch.bnd to existing databases For FixPak installations on the server, an additional bind file needs to be bound to existing databases after applying the FixPak. This requirement does not apply to clients. Prerequisites If support for DB2 Version 8.1 clients is required, the db2updv7 command must be run following the installation of FixPak 8 or 9. If support for DB2 Version 8.1 clients is not needed, then db2sch.bnd does not need to be bound to existing databases. Procedure To bind db2sch.bnd on the server, execute these commands: At a command prompt: db2 terminate db2 CONNECT TO db2 BIND /db2sch.bnd BLOCKING ALL GRANT PUBLIC sqlerror continue db2 terminate or, At the DB2 command line: TERMINATE CONNECT TO BIND /db2sch.bnd BLOCKING ALL GRANT PUBLIC sqlerror continue TERMINATE where represents the name of a database to which the utilities should be bound, and where represents the full path name of the directory where the bind files are located. 2.5 Uninstalling FixPaks on UNIX Note: If you have received special fixes from IBM Support that you have applied to your current FixPak level, you will lose all of the special fixes when you uninstall the current FixPak. The special fixes you received from IBM Support are only applicable to the current FixPak. You should not apply the same special fixes on top of any backlevel FixPak. If this applies to you, contact IBM Support before uninstalling your FixPak. Before uninstalling FixPaks, ensure that you: Stop all instances, including the DAS instance Backup your data AIX If the FixPak was installed and the filesets were just applied but not committed, then the FixPak can be uninstalled using smit. See the smit documentation for more details. If the filesets were committed when the FixPak was installed, which is the default, then the FixPak cannot be uninstalled. The only course of action available is to uninstall DB2 from your system, reinstall DB2, and then apply the appropriate FixPak. HP-UX FixPak filesets can be uninstalled using the sam utility. If you use swlist or sam, you can list all filesets for the DB2 FixPaks and receive output similar to the following: PDB2_712050005 7.1.0.55 PDB2_712050031 7.1.0.55 PDB2_712081005 7.1.0.75 PDB2_712081006 7.1.0.75 PDB2_712081032 7.1.0.75 The installation signature is combined with the name of the fileset. You should uninstall the group of PDB2_* filesets with the same signature starting with the largest number. You can remove the latest FixPak applied, or the latest FixPak plus the second last, etc. You can also select them all. Linux (Intel and s/390) You cannot uninstall a DB2 FixPak on Linux (Intel and s/390). The only course of action available is to uninstall DB2 from your system, reinstall DB2, and then apply the appropriate FixPak. A db2_deinstall script is provided with the FixPak which will uninstall DB2 from your system. Dynix, Solaris Operating Environment, and SGI The backoutallpatch script is provided with all FixPak images. Run this script to uninstall the FixPak and leave the system in the state that it was before installing the FixPak. You can find this script in /var/sadm/patch. The script will be named backoutallpatch.7.1.x.y where 7.1.x.y corresponds to the VRMF of the FixPak. You must uninstall FixPaks from highest to lowest level until you've uninstalled the FixPak(s) that you want to remove. For example if you're at FixPak 7, you wouldn't be able to uninstall FixPak 5 unless you've uninstalled FixPak 6 and FixPak 7. Update all instances, including the DAS instance. 2.6 Alternate Unicode conversion tables for CCSID 943 Some characters in CCSID 943 have two code points each: "NEC" code point "IBM" code point Some other characters are also represented two code points each: a "NEC" code point and a "JIS" code point. For example, both X'8754' ("NEC") and X'FA4A' ("IBM") refer to the same Roman numeral one character in CCSID 943; and both X'879C' ("NEC") and X'81BE' ("JIS") refer to the same mathematical union symbol in CCSID 943. When using the DB2 default CCSID 943 to Unicode conversion table, both the "NEC" and "IBM"/"JIS" code points are converted to the same Unicode character; but on the reverse, the Unicode character is converted to the "IBM"/"JIS" code point. When using the Microsoft version of the CCSID 943 to Unicode conversion table, both "NEC" and "IBM"/"JIS" code points are also converted to the same Unicode character; but on reverse, the Unicode character is converted to the "NEC"/"JIS" code point. For example: X'8754' or X'FA4A' ==> U+2160 ==> X'FA4A' (using the DB2 default CCSID 943<-->Unicode conversion tables) X'8754' or X'FA4A' ==> U+2160 ==> X'8754' (using the Microsoft version of CCSID 943<-->Unicode conversion tables) X'879C' or X'81BE' ==> U+222A ==> X'81BE' (using either the DB2 default or Microsoft version of CCSID 943<-->Unicode conversion tables) There are also some characters in CCSID 943 that can be converted into two different Unicode characters, depending on whether the DB2 default conversion table or the Microsoft version of the conversion table is used. For example, the double-byte dash character X'815C' in CCSID 943 is converted to the Unicode character U+2014 when using the DB2 default CCSID 943 to Unicode conversion table, but X'815C' is converted to the Unicode character U+2015 instead when using the Microsoft version of the conversion table. If you want DB2 to use the Microsoft version of the conversion tables, follow the procedure below after installation is complete. Prerequisites Before replacing the existing external code page conversion table files in the sqllib/conv directory, you may want to back them up first. On UNIX, sqllib/conv/ is linked to the install path of DB2. Procedure To use the Microsoft version of the CCSID 943 to/from Unicode conversion table files: Copy: sqllib/conv/ms/0943ucs2.cnv to sqllib/conv/0943ucs2.cnv sqllib/conv/ms/ucs20943.cnv to sqllib/conv/ucs20943.cnv sqllib/conv/ms/0941ucs2.cnv to sqllib/conv/0941ucs2.cnv sqllib/conv/ms/ucs20941.cnv to sqllib/conv/ucs20941.cnv Restart DB2. The use of these Microsoft conversion tables is restricted to closed environment between DB2 943 database and DB2 943 clients using the Microsoft version of the conversion tables. If we have a DB2 943 client using the default DB2 conversion tables, and another DB2 943 client using the Microsoft version of the conversion tables, and both clients are connected to the same DB2 943 database, then the same character may be stored as two different code points in the DB2 943 database. 2.7 Known problems and workarounds 2.7.1 Data corruption after moving from DB2 Version 7 FixPak 8 or earlier to a later Version 7 FixPak or to DB2 Version 8 If you are using JDBC and JTA to connect to a Unicode database, you may experience corruption for in your CHAR, VARCHAR, and CLOB data after you migrate to DB2 UDB Version 7 FixPak 9, or to DB2 UDB Version 8. The corruption only affects data with a hexadecimal value between 80 and FF. Characters in the normal ASCII range are not affected. For more information, refer to the "Data corruption after moving from DB2 Version 7 FixPak 8 or earlier to a later Version 7 FixPak or to DB2 Version 8" technote. 2.7.2 Application Development and supported software update For application development and supported software updates, visit the DB2 application development Web site at: http://www.ibm.com/software/data/db2/udb/ad/v7 2.7.3 Informix Federated support for DB2 Relational Connect Informix Federated support for DB2 Relational Connect was added in DB2 FixPak 4. If you have problems during installation or configuration (informix script and/or related libraries not installed with FixPak 4), you should call DB2 Support Team for help. 2.7.4 Loss of Control Center functionality There should be no problems introduced against back-level Control Center clients by applying FixPak 2 or FixPak 3 to a DB2 server. However, in DB2 Version 7.2, back-level Control Center clients will lose nearly all functionality. Back-level in this case refers to any Version 6 client prior to FixPak 6, and any Version 7 client prior to FixPak 2. Version 5 clients are not affected. The suggested fix is to upgrade any affected clients. Version 6 clients must be upgraded to FixPak 6 or later, and Version 7 clients must be upgraded to FixPak 2 or later. 2.7.5 Merant Driver Manager If you are using the Merant Driver Manager, see "Merant Driver Manager and the DB2 UDB Version 7 ODBC Driver on UNIX" in the General Installation, Migration and Configuration Information section of the Release Notes. 2.7.6 Updates into local tables in federated systems You can perform insert, update, and delete operations into local tables in an MPP federated environment. Although a workaround for INSERT statements was provided in FixPak 4, the workaround is no longer needed. This capability is fully enabled in FixPak 9. Notices IBM may not offer the products, services, or features discussed in this document in all countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country/region or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country/region where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product, and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information that has been exchanged, should contact: IBM Canada Limited Office of the Lab Director 8200 Warden Avenue Markham, Ontario L6G 1C7 CANADA Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems, and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements, or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility, or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information may contain examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious, and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information may contain sample application programs, in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. Each copy or any portion of these sample programs or any derivative work must include a copyright notice as follows: (C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. _enter the year or years_. All rights reserved. IBM, DB2, Universal Database, and S/390 are trademarks of International Business Machines Corporation in the United States, other countries, or both. Windows is a registered trademark of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. ------------------------------------------------------------------------------- * are trademarks or registered trademarks of IBM Corporation. ** are trademarks or registered trademarks of their respective owners. ------------------------------------------------------------------------------- ******************************************************************************* ** ** (c) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1999-2003. ** ALL RIGHTS RESERVED. ** *******************************************************************************