IBM DB2 Universal Database* for OS/2* Version 5.2 FixPak WR09073 +-- Note: ----------------------------------------------------------------+ | | To read this file more easily, set your font to monospace. | | Before installing this DB2 for OS/2 FixPak, please ensure that the line | in your CONFIG.SYS file which initializes the HPFS file system is at the | beginning of the file if HPFS is being used. You can identify this line | by looking for one similar to the following: | | IFS=C:\OS2\HPFS.IFS /CACHE:2048 /CRECL:4 /AUTOCHECK:CDE | | If it is not at the beginning of your CONFIG.SYS, please move it there | before the DB2 FixPak installation. | | If you have received interim fixes from IBM support after 09/26/98, | then you must contact IBM support instead of installing this FixPak, to | request an updated version of the interim fixes. By doing this, you are | assured that your system is in a consistent state and no interim fixes | are lost. | | Throughout this document X: is used to refer to the cdrom drive into | which the FixPak CD is placed and C:\SQLLIB is where the DB2 products | are installed. +-------------------------------------------------------------------------+ This README file contains information for the following products and components: OS/2 Specific ------------- DB2 Connect Personal Edition, V5 DB2 Connect Enterprise Edition, V5 DB2 Universal Database Enterprise Edition, V5 DB2 Universal Database Workgroup Edition, V5 DB2 Universal Database Personal Edition, V5 DB2 Software Developer's Kit, V5 DB2 Client Application Enabler, V5 --------------------------------------------------------------------------- 1. Contents of FixPak 2. Installation Notes 2.1 Pre-requisites 2.1.1 Prerequisites for APAR IX73249 2.2 Prior to Installation 2.3 Installation Instructions 2.4 Unattended Installation Instructions 2.5 After Installation 2.5.1 Rebinding to non-DRDA DB2 databases 2.5.2 Rebinding to DRDA databases 2.5.3 Rebinding Specific Packages 2.5.4 APAR IX80098 - Journal Job History Timestamps get out of sync 2.5.5 Building 32-bit Microfocus Cobol applications for UDB on OS/2 2.5.6 DB2 Support for ADSM Version 3 Clients 2.5.7 DB2MEMDISCLAIM 2.5.8 DB2MEMMAXFREE 3. Miscellaneous 3.1 Product and Service Technical Library 3.2 Customer Support 3.3 Corrective Service For additional information please see the following files: C:\SQLLIB\RELEASE.TXT X:\APARLIST.TXT =========================================================================== 2. Installation Notes 2.1 Pre-requisites To determine if the required pre-requistes are installed, do the following: -Double-click on the 'Installation Utility' icon in the 'DB2 for OS/2' folder. -Select 'View', 'Installed Products'. -Select the appropriate DB2 product. -Select 'Details', 'Product Status'. The version should be 05.00.00, 05.02.00 or 05.02.01. 2.1.1 Prerequisites for APAR IX73249 Incorrect Output for DB2 LIST DCS APPLICATIONS SHOW DETAIL The MVS APAR PQ11645 must be applied in conjunction with DB2 Connect APAR IX73249 in order to provide the meaningful correlation token display on both the LIST DCS APPLICATIONS and the DB2 MVS DSP THD commands. 2.2 Prior to Installation You must stop all database activity before applying this FixPak. Stop all applications and issue the commands: db2stop db2admin stop 2.3 Installation Instructions To start the FixPak install, type X:\DB2\\INSTALL\INSTALL where is the appropriate language directory. You will be presented with a list of products currently installed. Select a product and then select UPDATE from the Action pull-down menu. You must install the FixPak for every product listed (it is not necessary to re-boot after each one even if the completion message says so, it is sufficient to re-boot after all products have been updated). If you use ODBC applications, re-run the ODBC Installer after re-booting, by double-clicking on the icon. IMPORTANT: Do not select the "Save a backup version?" checkbox. This will not properly backup the changes, and restoring from the backup may damage the installed DB2 UDB product(s). This will be remedied in the future. 2.4 Unattended Installation Instructions The FixPak install program (INSTALL.EXE) supports unattended installation via a response file. The syntax for this feature is documented in the Quick Beginnings book. A response file (DB2FIXPK.RSP) is provided for your convenience. It can be used without modification. o Each product must be updated separately. o Every DB2 UDB product that is installed on the system must be updated with this FixPak at the same time. You cannot mix service levels between the products. o A /P:"product name" command line parameter is required. The following sample command files are provided with the FixPak for your convenience: DB2CONPE.CMD DB2 Connect Personal Edition DB2CONEE.CMD DB2 Connect Enterprise Edition DB2ENTR.CMD DB2 Universal Database Enterprise Edition DB2WORK.CMD DB2 Universal Database Workgroup Edition DB2PERS.CMD DB2 Universal Database Personal Edition DB2SDK.CMD DB2 Software Developer's Kit DB2CAE.CMD DB2 Client Application Enabler 2.5 After Installation Due to the new bind (.bnd) files that have been shipped with this FixPak, you will need to rebind your 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, outlined below, only needs to be performed once per database. 2.5.1 Rebinding to non-DRDA DB2 databases After applying fixes, you must do the following: db2 terminate db2 CONNECT TO db2 BIND C:\SQLLIB\BND\@db2ubind.lst GRANT PUBLIC db2 BIND C:\SQLLIB\BND\@db2cli.lst GRANT PUBLIC db2 terminate Where is the name of a database to which the utilities should be bound. Examine the DB2PATH environment variable to determine the correct path. DB2UBIND.LST and DB2CLI.LST contain lists of commonly required bind files used for DB2. If is a DB2 v1.x database, do not bind db2cli.lst. Instead, use the db2cliv1.lst or specifically bind db2clics.bnd, db2cliur.bnd, db2clirr.bnd, and db2cliv1.bnd individually. 2.5.2 Rebinding to DRDA databases If you are using DB2 Connect to access host databases, you will also need to bind the new bind files. As above, connect to the host database, and then bind the utilities as follows: HOST COMMAND ===== =================================================================== MVS BIND C:\SQLLIB\BND\@ddcsmvs.lst BLOCKING ALL SQLEROR CONTINUE GRANT PUBLIC VM BIND C:\SQLLIB\BND\@ddcsvm.lst BLOCKING ALL SQLEROR CONTINUE GRANT PUBLIC VSE BIND C:\SQLLIB\BND\@ddcsvse.lst BLOCKING ALL SQLEROR CONTINUE GRANT PUBLIC OS400 BIND C:\SQLLIB\BND\@ddcs400.lst BLOCKING ALL SQLEROR CONTINUE GRANT PUBLIC 2.5.3 Rebinding Specific Packages If you wish to bind only the specific .bnd files to the database, issue the following command for each database (where is the name of the bind file, and is the name of your database). db2 terminate db2 CONNECT TO db2 BIND C:\SQLLIB\BND\ BLOCKING ALL GRANT PUBLIC db2 terminate 2.5.4 APAR IX80098 - Journal Job History Timestamps get out of sync APAR IX80098 involves a new attribute on the job summary profile. To allow the changes in this APAR to take effect, you must start off with new profiles in order to receive this fix. Before erasing your existing profiles, you should backup the current db2jobht.prf and db2jobsm.prf files. You can do this by renaming the *.prf files to *.bak. NOTE: Renaming the current db2jobht.prf and db2jobsm.prf profiles will cause your current job history, schedule jobs and running jobs to be deleted. 2.5.5 Building 32-bit Microfocus Cobol applications for UDB on OS/2 When building 32-bit Microfocus Cobol applications for UDB on OS/2, you may encounter the following error when linking to db2gmf32.lib: "link386: fatal error 1104 x:\sqllib\lib\db2gmf32.lib: not a valid library" This is because the db2gmf32.lib library is not compatible with the link386 linker. Ilink must be used to link the library. Microfocus Cobol 4.0.20 and later will look first for the ilink executable in PATH. If it isn't found, Microfocus will call link386. The ilink linker is available at ftp.software.ibm.com under /ps/products/db2/tools. The file is called ilink.zip. It contains a readme with instructions for installing ilink. Note that the prerequisite for Microfocus Cobol is still 4.0.20 (or later). 2.5.6 DB2 Support for ADSM Version 3 Clients DB2 | DB2 Server |Planned | DB2 Service| ADSM Service Level Release | Platform |Availability* | Level | ========+============+==============+============+======================= DB2 UDB | AIX 4.1.x |June 30, 1998 | PTF: | ADSM Client V313 V5.0 | | | U457227 | (U454538) | | | | (with AIX41313G patch) --------+------------+--------------+------------+----------------------- DB2 UDB | AIX 4.2.x |June 30, 1998 | PTF: | ADSM Client V313 V5.0 | AIX 4.3.x | | U457227 | (U454539) | | | | (with AIX42313G patch) --------+------------+--------------+------------+----------------------- DB2 UDB | All Other |Sept 30, 1998 | To Be | To Be Determined V5.0 | | | Determined | --------+------------+--------------+------------+----------------------- DB2 | AIX 4.1.x |July 31, 1998 | PTF: | ADSM Client V313 V2.1.2 | | | U458628 | (U454538) | | | | (with AIX41313G patch) --------+------------+--------------+------------+----------------------- DB2 | AIX 4.2.x |July 31, 1998 | PTF: | ADSM Client V313 V2.1.2 | AIX 4.3.x | | U458628 | (U454539) | | | | (with AIX42313G patch) --------+------------+--------------+------------+----------------------- DB2 DB | AIX 4.1.x |July 31, 1998 | PTF: | ADSM Client V313 Server | | | U458629 | (U454538) V4.1.2 | | | | (with AIX41313G patch) --------+------------+--------------+------------+----------------------- DB2 DB | AIX 4.2.x |July 31, 1998 | PTF: | ADSM Client V313 Server | AIX 4.3.x | | U458629 | (U454539) V4.1.2 | | | | (with AIX42313G patch) --------+------------+--------------+------------+----------------------- DB2 | OS/2 |Oct 30, 1998 | To Be | To Be Determined V2.1.2 | | | Determined | --------+------------+--------------+------------+----------------------- DB2 | All Other |None | N/A | N/A V2.1.2 | | | | --------+------------+--------------+------------+----------------------- DB2 PE | AIX |None | N/A | N/A V1.2 | | | | * Note: The planned availability dates for the required DB2 fix packs are subject to change. 2.5.7 DB2MEMDISCLAIM Platform: AIX Default: (not set) Values: YES or NO Description: Depending on the workload being executed and the pool agents configuration you may run into a situation where the committed memory for each DB2 agent will stay above 32MB even when the agent is idle. This behaviour is expected and usually results in good performance as the memory is kept for fast re-use, however, on a memory constrained system, this may not be a desirable side effect. To avoid this condition issue the following: db2set DB2MEMDISCLAIM=yes Disclaiming memory tells the AIX operating system to stop paging the area so that it no longer occupies any real storage. Setting DB2MEMDISCLAIM to YES tells DB2 UDB to disclaim some or all memory once freed, depending on DB2MEMMAXFREE. This will ensure that the memory is made readily available for other processes as soon as it is freed. See also DB2MEMMAXFREE. 2.5.8 DB2MEMMAXFREE Platform: AIX Default: (not set) Values: 4000000 to 256000000 Description: DB2MEMMAXFREE specifies the amount of free memory that is retained by each DB2 agent. The default is 256Mb. You may set this variable to a value between 4 to 256 Mb. We recommend that if you use this feature, you specify a value of 8Mb. See also DB2MEMDISCLAIM. db2set DB2MEMMAXFREE=8000000 3. Miscellaneous 3.1 Product and Service Technical Library For a complete and up-to-date source of DB2 information, including information on issues discovered after this readme was published, use the Product and Service Technical Library on the World Wide Web at: http://www.software.ibm.com/data/db2/library 3.2 Customer Support To speak to an IBM representative regarding assistance with this product, please call 1-800-237-5511. Customer support is also provided via Electronic Question and Answer (Q&A) forums. These forums are accessible through CompuServe, IBMLink, and Usenet Newsgroup. (1) CompuServe - To access the forums on CompuServe, execute GO IBMDB2. - If you don't have access to CompuServe, call 1-800-848-8199 for membership information in Canada or the US. (2) Usenet Newsgroup: comp.databases.ibm-db2 - This Internet Newsgroup is a general forum for discussing questions and/or problems encountered using the DB2 family of products. (3) (IBMLink) Talklink OS/2 BBS - To access the forums on IBMLink, go to the OS2BBS section. - If you don't have access IBMLink, call 1-800-547-1283 for membership information in Canada or the US. 3.3 Corrective Service Corrective service can be downloaded electronically by either: (1) FTP to anonymous server ftp.software.ibm.com (previously known as ps.boulder.ibm.com) at 198.17.57.66. Go to ps/products/db2/fixes/%L/%P/ where %L is the appropriate locale (e.g. english-us, spanish, german, etc.), and %P is the product name/version (eg. db22v5, db2aixv5, etc.). (2) Use a World Wide Web (WWW) browser to connect to the DB2 Service and Support Page at: http://www.software.ibm.com/data/db2/db2tech/index.html (3) On CompuServe, execute GO IBMDB2. Then go to the appropriate library to find the FixPak. (4) On IBM PCC BBS (in US), call (919) 517-0001 (in Raleigh, North Carolina) and then type "db2" on the main menu to find the FixPaks. If you do not have access to any of the above locations, please call 1-800-237-5511 to request these FixPaks be sent to you in the mail. For countries other than US and Canada, please contact your local DB2 Customer Service number for assistance in obtaining them. --------------------------------------------------------------------------- * are trademarks or registered trademarks of IBM Corporation. ** are trademarks or registered trademarks of their respective owners. --------------------------------------------------------------------------- *************************************************************************** ** ** (c) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1998. ** ALL RIGHTS RESERVED. ** ***************************************************************************