
                     Software Installer for OS/2 - READ.ME
                     -------------------------------------

Welcome to Software Installer v1.2.4 for OS/2.

This READ.ME file contains information you need for installing Software
Installer, as well as information that was not available for our
printed publications.  This READ.ME is divided into the following categories:
   -  Before You Install Software Installer
   -  Getting Help
   -  Installing Software Installer
   -  Late-Breaking News
   -  Trademarks


Before You Install Software Installer
-------------------------------------
   Software Requirements
   ---------------------
   -  IBM Operating System/2(*) (OS/2) Version 2.0, 2.1, or Warp 3.0.
      ServicePak XR06055 is recommended if you are using 2.0.

      NOTE:  Without the ServicePak, your installation will not return the
             correct results from application-specific exits even though
             the exit completes correctly.  Also, Workplace Shell objects
             created during an installation will not use the specified icon.

   -  IBM Developer's Toolkit for OS/2 Version 2.0 or 2.1.

      NOTE:
           - If the resource compiler (RC.EXE) is installed with the
             version of OS/2 you are using, the toolkit is only
             required if you:
             -  Create application exits that must be compiled
             -  Change the online help and must use the IPFC.EXE compiler
             -  Compile the EPFIHOOK.DLL to customize directory processing.
             If the resource compiler is installed and you do not do
             these tasks for your installation, you can disregard any
             notices about requiring the toolkit that you receive
             during the rename process.

           - Users of your product do not need the toolkit on their systems
             to install your products.

   -  To install from an AS/400 host system, you need IBM PC Support/400
      (Program Number 5738-PC1) Version 2 Release 2.

   -  To install from a VM, MVS, or VSE host system, you need IBM Extended
      Services for OS/2 2.0 with Communications Manager or Communication
      Manager/2 installed.


   Hardware Requirements
   ---------------------
   -  A personal computer that runs OS/2 Version 2.0, 2.1, or Warp 3.0

      NOTE:  For more information on the OS/2 Version 2.0 machine requirements,
             refer to the IBM OS/2 Version 2.0 Information and Planning Guide
             (G326-0160).

   -  6 MB of hard disk space above that required by OS/2

      NOTE:  Approximately 1.3 MB of this is for a temporary copy of
             Software Installer that is removed after installation.

   -  .5 MB of memory above that required by OS/2

   -  2-button mouse or other pointing device


Getting Help
------------
   Available Documentation
   -----------------------
   -  Getting Started
      This book gives an overview of Software Installer and provides a
      simple example of enablement.

   -  Software Installer Reference
      This program item in the Software Installer folder is an online
      document that describes in detail how to enable your products for
      installation.

   -  EPFIPGR.EPS
      This file is a PostScript** formatted file of the online reference.  You
      can print a copy of the online reference by sending this file to a
      PostScript printer.

   Service and Technical Support
   -----------------------------
   We are ready to help you with your Software Installer questions.  You can
   contact us through one of the following:

   For Technical Support:
      -  IBM OS/2 BBS TALKLINK:  INSTALL2 FORUM
         For information about Talklink registration and access, call
         1-800-547-1283.

         NOTE:  For IBM internal customers, this is INSTALL2 CFORUM
                on IBMPC.

      -  CompuServe:  GO OS2DF2 ,Section 8
         For information about CompuServe registration and access, call:

         US: 1-800-848-8199  (representative #239)
         UK: 0800-289-378
         Germany: 0130-86-4643

   For Product Information:
      -  IBM SWS Development Lab, RTP,NC
            - US:         1-800-426-2279
            - Outside US: 1-919-254-4760
            - Fax:        1-919-254-4820

   Defect Reporting
   ----------------
   If you believe you have found a product defect, fill out the Problem
   Report Form, PROBREP.DOC.  Please write in English, imbed the form in a note 
   and send it to installr@vnet.ibm.com . You may also print this form and fax
   it to the Software Installer Development Team at (919)254-4914.

 

   NOTE:  For IBM internal customers, submit defects according to the
          Software Installer Internal Service Process.  For a copy of this
          process, at a VM prompt enter:
               REQUEST RULES FROM INSTALLR AT CARVM3


Installing Software Installer
-----------------------------
   From a CD Drive
   ---------------------
   1. Insert CD into CD reader.  

   2. Type the following an the OS/2 command prompt:
            INSTALL

   3. Press Enter.

   4. Follow the on-screen prompts.

   From a Local Area Network Server
   --------------------------------
   If you have purchased a license to the Developer's Connection for OS/2, 
   consider placing  Software Installer on a LAN server for easier access.
   To do this, follow these steps:

      1. Create a directory on the LAN server to store the Software Installer
         files.  For example:
            MKDIR J:\INSTALL2

      2. Copy each Software Installer diskette into this directory.  You can
         do this using the OS/2 XCOPY command.  For example:
            XCOPY A:* J:\INSTALL2 /S

      3. Give all licensed users access to the LAN drive you copied the
         diskettes into (in this example, the J drive).

   After these steps are complete, users with access to the LAN drive can
   access the alias drive and directory and install Software Installer by
   typing:
            INSTALL

   After following the installation dialog with Software Installer,
   the LAN users are ready to use Software Installer on their workstations.


Late-Breaking News
------------------
   Registration Form
   -----------------
   Please complete the registration form and return it to us.  The file, 
   REGISTER.FRM, contains the registration form.  Please write in English,
   imbed the form in a note and send it to installr@vnet.ibm.com.  You may
   also print this form and fax it to the Software Installer Development Team
   at (919)254-4914.

   Service History
   ---------------
   Updates included in Software Installer v1.2.4 PTF:

      APARs

      - PN58581:  Unable to install 900+ files
      - PN58873:  Receiving messages EPFIW138 and EPFIW141 for files that are
                  "in use"
      - PN59183:  Not returning 0x0000 return code on success even when any
                  other unrelated error message was displayed
      - PN59234:  Directory entered in Target entry field of EPFIDLDS.EXE during
                  a host install is incorrectly used by the Install Utility on
                  an update
      - PN59235:  Host install onto a workstation using Korean codepage fails
      - PN60250:  Various OS/2 v2.11 problems
         - INFO1_WINDOW button in EPFIDLDS.EXE have the wrong focus
         - Correct ending message not displayed when CONFIG.SYS has been changed
      - PN60319:  DIREMPTY fails when ADDSTR ends in a ';'
      - PN60497:  Update fails on LAN Server 3.0 with AD attributes set on
      - PN60758:  When using the Diskette Generator, upload to a host computer
                  fails if the source drive is the same as the host session
      - PN62089:  User-defined variables with similar names not saved properly

      Other Bug Fixes

      - Documented the restriction that the package filename cannot be changed
        from one release to the next.
      - Restore action operational on OS/2 v2.11 and OS/2 v3.0.

      New Features

      - When installing from a host running OS/400, a retry is automatically
        performed if the first attempt to transfer the file from the host fails.
      - All entries added to the error and history logs are preceded with a
        date/time stamp.


   Updates included in Software Installer v1.2.3 PTF:

      APARs

      - PN49382:  EPFISOURCEDIR not set correctly
      - PN49474:  Documentation changes
         - Clarified expected Installation Utility host file names
         - Corrected help for message EPFIE198
         - Corrected maximum allowable length for the LEVEL keyword of the
           SERVICELEVEL entry type
      - PN49708:  VSE host installs
         - Could not start Installation Utility
         - Could not download catalog file
         - Package file name truncated to 7 characters
      - PN50465:  Install continues after an error during delete/reinstall
                  action when selected in EPFIDLDS.EXE
      - PN51237:  Temporary file directory bit should not be set; if it is set,
                  display message EPFIE132
      - PN52989:  Using DIREMPTY would not delete the item from the CONFIG.SYS
                  when the directory did not exist
      - PN53817:  Last line of CONFIG.SYS omitted when line did not end with
                  CR/LF
      - PN53909:  LOCATION keyword included twice by Diskette Generator

      Other Bug Fixes

      - Can install when INSTALL.EXE cannot find any local hard disks
      - Documentation/help changes
         - Message EPFIE208 displays the correct maximum number of
           components
         - .DLL entry points must be in uppercase
         - Help for message EPFIQ139 is correct for the "NO" response
      - Dialogs positioned on screen correctly
      - DISKGEN
         - Component is installed during an unattended installation
         - FILE/COMPONENT Size keywords updated when the /UAD option is used
         - Lower case "yes" on UNPACK keyword packs the file
         - Temporary files are created in correct directory
         - /A option appends directory name when PACKFILE is used
         - PWSPath value of "PWSFILE" remains unchanged
         - Location keyword of ADDCONFIG entry type not added twice
         - When uploading to a host, the PC code page is used during the file
           transfer
      - Rename utility no longer accepts an incorrect prefix
      - Response file can be on a read-only drive
      - 'Delete-reinstall' dialog does not continue in a deferred delete
      - If the help file cannot be loaded, a message is displayed and
        installation continues
      - /P: parameter passed to EPFIDLDS.EXE correctly overrides
        STARTPARM_PRODUCT in the IIRC.RC file
      - Parameter ending with a '\' correctly interpreted

      New Features

      - Improved delete scenario
         - Deleting from a command line is seamlessly detected
      - CONFIG.SYS changes
         - Ending message displayed based upon whether CONFIG.SYS was actually
           changed
         - Added the NAME keyword to select a filename other than CONFIG.SYS
         - Added the CASESENSITIVE keyword to specify case sensitivity of
           searching
         - ADDCONFIG entry type only
            - Added the DELETELINE keyword to select to physically delete lines
              from the CONFIG.SYS
            - Added the PARTIALSTRING keyword to specify whether a search within
              an rvalue (not just the entire rvalue) is allowed during a delete
         - UPDATECONFIG entry type only
            - Added the DELIMITER keyword to specify an alternate delimiter
            - Added the BEFORELAN keyword value to the LINELOCATION keyword of
              the UPDATECONFIG entry type to specify that a path is to be
              inserted before the first LAN drive
      - Installation Utility creates an error log when /L1: parameter is
        present, regardless of whether action is attended
      - Changed samples to use CREATEWPSOBJECT instead of ADDPROG
      - Changed samples to use ADDCONFIG entry type instead of ADDCONFIG exit
      - Documentation/help changes
         - Added a CD-ROM section to the on-line reference
         - Clarified the use of EPFIHOOK.DLL
         - Clarified the DISK entry type
         - Clarified comments in IIRC.RC host vs. workstation usage
         - Added list of predefined WPS IDs to CREATEWPSOBJECT exit information
         - Specified conditions requiring response file keywords
      - Changed <varsfp.h> to "varsfp.h" in EPFIHOOK.C
      - Shipped OS/2 v2.1 pack/unpack routines
      - Changed icons on messages EPFIW177 and EPFIW178 to the stop icon
      - Host installations
         - Selectable host code page
         - MVS, VSE host dataset automatically passed to EPFINSTS.EXE as /S:
         - destination directory automatically passed to EPFINSTS.EXE as /T:
         - For MVS/VSE /S: parameter will work with and without an ending '.'


    Updates included in Software Installer v1.2.2 PTF:

      APARs

      - PN48450:  Trailing spaces in CONFIG.SYS removed.
      - PN49467:  Documented restriction that when either the NUMBER or FEATURE
                  keyword values of the PACKAGE entry in a catalog file are
                  changed in successive releases the NAME keyword value must
                  also be changed.
      - PN50231:  Correct text displayed on Progress window when Stop button
                  is pressed.
      - PN49474:  Correctly documented the name of the EPFICLEARHOST environment
                  variable in the on-line reference (was incorrectly documented
                  as EPFIHOSTCLEAR).
      - PN50465:  Changed processing of return codes to affect the
                  delete/re-install scenario.  Added support for the CID defined
                  REMOTE_INSTALL_STATE environment variable.
      - PN48452:  Display correct error messages when using HPFS386 with local
                  security enabled.

      New Features

      - Increased the maximum number of components allowed in a package file to
        100.
      - Added the UPDATECONFIGSYS keyword to the catalog PACKAGE entry type to
        control the 'Update CONFIG.SYS' check box on the Install window.
      - Enhanced searching for user exit .DLLs by additionally searching in the
        directory where the Install Utility is running; also enhanced
        BLDINST.CMD to take optional parameters to include additional files
        within INSTALL.IN_.  Both enhancements allow user exit .DLLs to be
        referenced in a package file EXIT entry type without first installing
        the .DLLs onto the workstation.
      - Enhanced the EPFIHOOK.DLL processing so the .DLL is called prior to
        displaying the Install-directories window, allowing the .DLL to affect
        the window during its creation.


    Updates included in Software Installer v1.2.1b PTF:

      APARs

      - PN43830:  Diskette Generator dynamically loads the HLLAPI DLL.
      - PN43300:  Correct the option string for binary transfers from VSE/ESA
                  host to PC.
      - PN45267:  Monocase directories used in user exits.
      - PN45265:  Deferred processing .CMD (EPFIDEFI.CMD) is generated
                  correctly.
      - PN45405:  Spaces in command line parameters are handled correctly.

      Other Bug Fixes

      - Documentation corrected for value returned by the EPFISOURCE
        installation variable.
      - Diskette Generator recognizes the ADDCONFIG, UPDATECONFIG, and
        OPTIONS entry types.
      - The step-by-step instructions corrected for host installation.
      - Documentation corrected for CD-ROM installation.
      - Selectable clear of host screen.


Trademarks
----------
   (*)   Trademark of the IBM Corporation in the United States and other
         countries.
   (**)  Trademark of Adobe Systems Incorporated.

