*********************************************************************** ** ** ** (c) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1997. ** ** ALL RIGHTS RESERVED. ** ** ** *********************************************************************** Welcome to IBM* DB2 Universal Database* (DB2*) Extenders for Windows 3.1 Version 5.0 The file tewin.zip contains the DB2 Extenders*, which provide a run-time environment for use with DB2 Extenders applications. This file also includes a Software Developer's Kit (SDK) for building DB2 Extenders applications. INSTALLATION REQUIREMENTS _________________________ The DB2 Extenders comprise the DB2 Image Extender, DB2 Audio Extender, DB2 Video Extender, and DB2 Text Extender. Before you install the DB2 Extenders in Windows 3.1, ensure you meet the installation requirements. The DB2 Extenders can be installed in a Windows 3.1 client for use with DB2 Extenders server components installed in a Windows NT, OS/2, AIX, Solaris, or HP-UX server. Installation of the DB2 Extenders in Windows 3.1 pre- requires installation of the DB2 Version 5.0 (or above) Personal Edition, DB2 Version 5.0 (or above) Client Application Enabler, or DB2 Version 5.0 (or above) Software Developer's Kit for Windows 3.1. INSTALLING THE DB2 EXTENDERS IN WINDOWS 3.1 ___________________________________________ To install the DB2 Extenders in Windows 3.1, you perform the following steps: 1. Download tewin.zip in binary mode to a directory on the d drive for example. 2. pkunzip -d tewin.zip 3. From the Program Manager's FILE menu, select RUN. Type d:\db2ext\windows\en\extender\install in the command line field. 4. Press ENTER. The Instructions for Installing DB2 Extenders window is displayed. 5. After you have read the installation instructions in the window, click the CONTINUE button. The install window is displayed. There are two check boxes in the install window: o UPDATE CONFIG.SYS\AUTOEXEC.BAT o OVERWRITE FILES By default, the UPDATE CONFIG.SYS\AUTOEXEC.BAT check box is selected. During the installation process the AUTOEXEC.BAT file will be automat- ically updated with the settings required to run the DB2 Extenders. Deselect this box if you want to store the required changes in the AUTOEXEC.ADD file on the boot drive, and not update AUTOEXEC.BAT file. However, the DB2 Extenders administration commands cannot run until these changes have been added to the AUTOEXEC.BAT file. By default, the OVERWRITE FILES check box is not selected. This means that the installation program will prompt you if it encounters any DB2 Extenders files in the installation location. Select this check box if you want to overwrite DB2 Extenders files without prompting. 6. Click the OK button. The Install - directories window is displayed. This window contains a list of all the components that are available for installation. To display a description of a component, select from the SELECT THE COMPONENTS THAT YOU WANT TO INSTALL list, then click the DESCRIPTIONS button. 7. Select the components you want to install from the list. When you select a component or click the SELECT ALL button, the number of bytes needed for installation is shown. 8. Click the DISK SPACE button to check that there is sufficient space to install the DB2 Extenders. The Disk Space window is displayed. This window shows how much space is available on all drives to which you have access, including read-only access. The DB2 Extenders cannot be installed on read-only drives. 9. Select a drive from the list on the Disk Space window. This displays the amount of space available and whether installation of the component is possible on that drive. After you select a drive from the BYTES AVAILABLE ON DRIVE list, select the CHANGE DIRECTORIES TO SELECTED DRIVE check box. This specifies that the DB2 Extenders will be installed on the selected drive. 10. Click the OK button to close the Disk Space window. 11. By default, the DB2 Extenders are installed in the C:\DMB directory. If you want to install the DB2 Extenders in another directory or on another drive, overtype the following fields: INSTALLATION DIRECTORY and TEMPORARY FILES. 12. Click the INSTALL button to install the components you selected. When started, the installation program checks that your workstation fulfills the DB2 Extenders software requirements. See the section "Installation Requirements" for a description of DB2 Extenders requirements. If a requirement is not met, the installation program displays an explanatory message and stops. The Install - Progress window is displayed. If you need to stop the installation at any point, click the STOP button. You are then given the option of removing any files already copied during installation. A message is displayed when installation is complete, The message informs you whether you need to shut down and restart the workstation before using the DB2 Extenders. 13. Click the OK button in the message window. 14. Click the EXIT button in the DB2 Extenders window. 15. If necessary, shut down and restart the workstation. Installation of the DB2 Extenders is complete. You now have a DB2 Extenders program group in the Program Manager containing the extenders command-line processors, installation utility, and online documentation (if you chose to install it). INSTALLING THE DB2 EXTENDERS SDK IN WINDOWS 3.1 _______________________________________________ Before you install the DB2 Extenders SDK, you must install the DB2 Extenders. After you install the DB2 Extenders, perform the following steps. 1. From the Program Manager's FILE menu, select RUN. Type d:\db2ext\windows\en\sdk\install in the command line field. 2. Press ENTER. The Instructions for Installing DB2 Extenders SDK window is displayed. 3. After you have read the installation instructions in the window, click the CONTINUE button. The install window is displayed. There are two check boxes in the install window: o UPDATE CONFIG.SYS\AUTOEXEC.BAT o OVERWRITE FILES By default, the UPDATE CONFIG.SYS\AUTOEXEC.BAT check box is selected. During the installation process the AUTOEXEC.BAT file will be automat- ically updated with the settings required to develop DB2 Extenders applications. Deselect this box if you want to store the required changes in the AUTOEXEC.ADD file on the boot drive, and not update AUTOEXEC.BAT file. By default, the OVERWRITE FILES check box is not selected. This means that the installation program will prompt you if it encounters any DB2 Extenders SDK files in the installation location. Select this check box if you want to overwrite DB2 Extenders SDK files without prompting. 4. Click the OK button. The Install - directories window is displayed. This window contains a list of all the components that are available for installation. To display a description of a component, select from the SELECT THE COMPONENTS THAT YOU WANT TO INSTALL list, then click the DESCRIPTIONS button. 5. Select the components you want to install from the list. When you select a component or click the SELECT ALL button, the number of bytes needed for installation is shown. 6. Click the DISK SPACE button to check that there is sufficient space to install the DB2 Extenders SDK. The Disk Space window is displayed. This window shows how much space is available on all drives to which you have access, including read-only access. The DB2 Extenders SDK cannot be installed on read-only drives. 7. Select a drive from the list on the Disk Space window. This displays the amount of space available and whether installation of the component is possible on that drive. After you select a drive from the BYTES AVAILABLE ON DRIVE list, select the CHANGE DIRECTORIES TO SELECTED DRIVE check box. This specifies that the DB2 Extenders SDK will be installed on the selected drive. 8. Click the OK button to close the Disk Space window. 9. By default, the DB2 Extenders SDK is installed in the C:\DMB directory. If you want to install the DB2 Extenders SDK in another directory or on another drive, overtype the INSTALLATION DIRECTORY field. It is recommended that you install the DB2 Extenders SDK in the same directory as the DB2 Extenders. 10. Click the INSTALL button to install the components you selected. The Install - Progress window is displayed. If you need to stop the installation at any point, click the STOP button. You are then given the option of removing any files already copied during installation. A message is displayed when installation is complete, The message informs you whether you need to shut down and restart the workstation before using the DB2 Extenders SDK. 11. Click the OK button in the message window. 12. Click the EXIT button in the DB2 Extenders SDK window. 13. If necessary, shut down and restart the workstation. Installation of the DB2 Extenders SDK is complete. RUN-TIME FEATURE DISTRIBUTION _____________________________ You may copy the DB2 Extenders run-time feature for applications you develop onto client and server machines. To copy the DB2 Extenders run-time feature, copy the files that are in the DB2EXT\WINDOWS\EN, DB2EXT\WINDOWS\EN\EXTENDER, and DB2EXT\WINDOWS\COMMON\EXTENDER directories to your source installation media, for example, to a CD-ROM. Preserve the directory structure as it is on the DB2 Extenders CD-ROM. Your application's installation procedure should include the instructions in the section "Installing the DB2 Extenders in Windows 3.1" above. Instruct installers to type the location of the source installation media in step 2. If you are using the DB2 Extenders CD-ROM as your source media, instruct installers to enter the location shown in step 2. You can also instruct installers to optionally follow the steps in the file DOCREAD.TXT to view and print the DB2 Extenders documentation. DB2 EXTENDER NOTES __________________ The following notes supplement the information in the DB2 Extender books. For additional notes, see the README.TXT file in the root directory. o DB2 Extender UDFs must run under the same user ID as the DB2 Extender instance. In addition, if you create a DB2 instance or use an existing DB2 instance, you need to make sure that the DB2 Extender UDFs run under the same user ID as the DB2 instance. o DB2 needs to be configured properly to ensure the proper operation of the DB2 Extenders, especially the operation of UDFs. In particular, the following parameters need to be set properly: Database configuration parameters: APP_CTL_HEAP_SZ APPLHEAPSZ Database manager configuration parameters: ASLHEAPSZ UDF_MEM_SZ QUERY_HEAP_SZ * are trademarks or registered trademarks of IBM Corporation. ** are trademarks or registered trademarks of their respective owners.