
       Welcome to IBM* DB2 Universal Database* (DB2*) Extenders for OS/2
                        Version 7.1
                 ------------------------------

    This CD-ROM contains the DB2 Extenders*, which provide a run-time
    environment for use with DB2 Extenders applications.  The CD-ROM also
    includes a Software Developer's Kit (SDK) for building DB2 Extenders
    applications.

    This file describes how to install DB2 Extenders Version 7.1 for OS/2.
    It also describes how to create and manage multiple instances and how
    to distribute the run-time feature.


    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 OS/2, ensure you meet the installation requirements for their
    server and client components.


    SERVER REQUIREMENTS

    The server components for the DB2 Extenders can be installed in an OS/2
    server.  The server components require the installation of DB2 Version
    7.1 (or above) for OS/2.


    CLIENT REQUIREMENTS

    The client components for the DB2 Extenders can be installed in an OS/2
    client.  The client components require installation of the DB2 Version
    7.1 (or above) Personal Edition, DB2 Version 7.1 (or above) Client
    Application Enabler, or DB2 Version 7.1 (or above) Software Developer's
    Kit for OS/2.


    INSTALLING THE DB2 EXTENDERS IN OS/2
    ____________________________________

    To install the DB2 Extenders server or client components in OS/2, you
    perform the following steps.

    1. Insert the CD-ROM into the CD-ROM drive on your server or client
       workstation.

    2. Open an OS/2 window.  Change the directory to: e:\db2ext\os2\en\extender

       where e is the CD-ROM drive letter.  Use a different drive letter if
       appropriate.

    3. Type INSTALL and press ENTER.  The Instructions for Installing DB2
       Extenders window is displayed.

    4. After you have read the installation instructions in the window, click
       the CONTINUE button.  The Installation and Maintenance window is dis-
       played.  It lists the DB2 Extenders installation environments: server
       and client.  Select server if you are installing the DB2 Extenders in
       an OS/2 server or in an OS/2 single-user environment.  Select client
       if you are installing the DB2 Extenders in an OS/2 client environment.

    5. Select INSTALL from the Action menu.  The install window is displayed.
       There is a check box in the install window:

        -- UPDATE CONFIG.SYS

       By default, the UPDATE CONFIG.SYS check box is selected.  During the
       installation process the CONFIG.SYS file will be automatically updated
       with the settings required to run the DB2 Extenders.  Deselect this box
       if you want to store the required changes in the CONFIG.ADD file on the
       boot drive, and not update CONFIG.SYS.  However, the DB2 Extenders
       administration commands cannot run until these changes have been added
       to the CONFIG.SYS file.

    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.

    10. After you select a drive from the BYTES AVAILABLE ON DRIVE list, click
        the OK button to close the Disk Space window.  This specifies that
        the DB2 Extenders will be installed on the selected drive.

    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 folder on your desktop containing the extenders command-line
        processors, installation utility, and online documentation (if you
        chose to install it).


    INSTALLING THE DB2 EXTENDERS SDK IN OS/2
    ________________________________________

    Before you install the DB2 Extenders SDK, you must install the DB2
    Extenders.

    After you install the DB2 Extenders, perform the following steps.

    1. Insert the CD-ROM into the CD-ROM drive on your server or client
       workstation.

    2. Open an OS/2 window.  Change the directory to: e:\db2ext\os2\en\sdk

       where e is the CD-ROM drive letter.  Use a different drive letter if
       appropriate.

    3. Type INSTALL and press ENTER.  The Instructions for Installing DB2
       Extenders SDK window is displayed.

    4. After you have read the installation instructions in the window, click
       the CONTINUE button.  The install window is displayed.  There is a
       check box in the install window:

        -- UPDATE CONFIG.SYS

       By default, the UPDATE CONFIG.SYS check box is selected.  During the
       installation process the CONFIG.SYS file will be automatically updated
       with the settings required to develop DB2 Extenders applications.
       Deselect this box if you want to store the required changes in the
       CONFIG.ADD file on the boot drive, and not update CONFIG.SYS.

    5. 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.

    6. 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.

    7. 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.

    8. 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.

    9. After you select a drive from the BYTES AVAILABLE ON DRIVE list, click
       the OK button to close the Disk Space window.  This specifies that
       the DB2 Extenders SDK will be installed on the selected drive.

   10. 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.

   11. 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.

   12. Click the OK button in the message window.

   13. Click the EXIT button in the DB2 Extenders SDK window.

   14. 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 on the DB2 Extenders CD-ROM that are in the
    DB2EXT\OS2\EN, DB2EXT\OS2\EN\EXTENDER, and DB2EXT\OS2\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.
    You can also use the DB2 Extenders CD-ROM as your source installation media.

    Your application's installation procedure should include the instructions in
    the section "Installing the DB2 Extenders in OS2" above.  Instruct installers
    to change the directory to your 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
    section "Creating Multiple Instances" to create multiple instances.
    Installers should copy files for printable documentation from the
    following directory:

       doc\language\pdf
           ________

    where language is a two-character abbreviation for the language
          ________
    (for example en for English). For information on viewing and printing
    documentation, see the file docread.txt.


    **************************************************************************
    **                                                                      **
    **  (c) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2000.     **
    **                    ALL RIGHTS RESERVED.                              **
    **                                                                      **
    **************************************************************************

    *  are trademarks or registered trademarks of IBM Corporation.
    ** are trademarks or registered trademarks of their respective owners.
