Netscape Communicator 4.61 for OS/2(R) Warp
Installation and Configuration README

This README contains information on installing and configuring
this feature.

Note: To help you locate information in this README, you can use
      the Find option under the Edit menu of the OS/2 System
      Editor. You can print the file by dragging it to your
      printer object or by selecting Print from the file object's
      pop-up menu. Using the right mouse button, click the object
      to display the pop-up menu.

In the following sections, "Netscape Communicator 4.61" refers to
Netscape Communicator 4.61 for OS/2(R) Warp, and "Developer
Kits" refers to the IBM(R) OS/2 Warp Developer Kit, Java(TM)
Edition, Version 1.1.7 and IBM OS/2 Warp Developer Kit,
Java(TM) Technology Edition, Version 1.1.8.

All variables in path names are in lowercase.


CONTENTS
__________________________________________________________________

1.0 Hardware and Software Requirements
2.0 Installation and Configuration Instructions
3.0 WorkSpace On-Demand Installation and Configuration
    Instructions
4.0 CID Installation Information
5.0 Notices


1.0 HARDWARE AND SOFTWARE REQUIREMENTS
__________________________________________________________________

This section contains information on the minimum hardware and
software required to run Netscape Communicator 4.61. If you plan to
install and use the Developer Kits with Netscape Communicator 4.61,
you might need to consider additional hardware and software
requirements. See the minimum hardware and software requirements
for the version of the Developer Kits you have or plan to have
installed.

1.1 Minimum hardware requirements
------------------------------------------------------------------

To install and use Netscape Communicator 4.61, your workstation
needs at least:

  o A 486 microprocessor (a Pentium(R) or compatible
    microprocessor at 90 MHz or higher provides better
    results)

  o A VGA display (65536 colors or higher provides better
    results)

  o 16 MB of RAM (32 MB or higher provides better results)

  o 13 MB free hard disk space and 24 MB of temporary disk space

  o A connection to the Internet (modem, ISDN, or LAN)

1.2 Minimum software requirements
------------------------------------------------------------------

Netscape Communicator 4.61 for OS/2 is supported on the following:

  o OS/2 Warp 4

  o OS/2 Warp Server Version 4.0

  o OS/2 Warp Server Advanced Version 4.0

  o OS/2 Warp Server Advanced SMP Feature

  o OS/2 Warp Server for e-business

  o WorkSpace On-Demand 2.0

1.3 Required FixPaks and updates
------------------------------------------------------------------

Depending on your operating system, the following FixPaks or
updates might be required. To download FixPaks or Corrective
Service Diskette levels, go to the IBM(R) FixPak Database
Web site at http://service5.boulder.ibm.com/pspfixpk.nsf.

No FixPaks are required for OS/2 Warp Server for e-business and
WorkSpace On-Demand 2.0.

  1.3.1 OS/2 Warp 4
  ----------------------------------------------------------------

  FixPak 5 or higher is required.

  1.3.2 OS/2 Warp Server
  ----------------------------------------------------------------

  The following information applies to all versions of OS/2 Warp
  Server, except OS/2 Warp Server for e-business.

  FixPak 32 or higher is required.

  To determine if additional updates are necessary for your
  system, type SYSLEVEL at an OS/2 command prompt. SYSLEVEL
  displays a list of the software currently installed on your
  system, the version number of the software, and the Corrective
  Service Diskette (CSD) levels of the software.

  o If you have IBM TCP/IP Version 2.0 (see the SYSLEVEL.TCP entry
    in the SYSLEVEL output) and do not have CSD level UN64092 or
    higher installed, install CSD files level UN64092 or higher
    (depending on which CSD level is available in the IBM FixPak
    Database).

  o If you have IBM OS/2 LAN Adapter and Protocol Support (see the
    SYSLEVEL.TRP file in the SYSLEVEL output) and do not have CSD
    level WR08210 or higher installed, install CSD files level
    WR08210 or higher (depending on which CSD level is available
    in the IBM FixPak Database).

  1.3.3 DBCS versions of OS/2 Warp and OS/2 Warp Server
  ----------------------------------------------------------------

  The following DBCS versions of OS/2 Warp Version 4 require
  FixPak FX00505 or higher:

  o OS/2 Warp 4 Japanese version (without VoiceType(R))

  o OS/2 Warp 4 Korean version

  o OS/2 Warp 4 Traditional Chinese version

  o OS/2 Warp 4 Simplified Chinese (GB) version

  o OS/2 Warp 4 Simplified Chinese (GBK) version

  All DBCS versions of OS/2 Warp Server except OS/2 Warp Server
  for e-business require FixPak WX03006 or higher.

  1.3.4 PS/55 Display Adapter II (Japanese and Korean only)
  ----------------------------------------------------------------

  If you are using PS/55 Display Adapter II, apply program
  temporary fix (PTF) JR12322 before starting Netscape
  Communicator 4.61.


2.0 INSTALLATION AND CONFIGURATION INSTRUCTIONS
__________________________________________________________________

The following sections describe how to install and configure
Netscape Communicator 4.61. For information on CID installations,
see section 4.0 CID Installation Information.


2.1 Using Netscape Communicator 4.61 with previous versions
------------------------------------------------------------------

Netscape Navigator 2.02 for OS/2 Users:

  o To make it easier to distinguish between Netscape
    Communicator 4.61 and Netscape Navigator 2.02 for OS/2 files,
    install Netscape Communicator 4.61 in a different directory
    than Netscape Navigator 2.02 for OS/2.

  o If Netscape Navigator 2.02 for OS/2 is installed, the
    following three options appear when you create a user
    profile after installing Netscape Communicator 4.61:

    - Move previous files:
      Click if you want your mail and news user profile from
      Netscape Navigator 2.02 shared with Netscape Communicator
      4.61. If you select this option, any mail or postings you
      receive in Netscape Communicator 4.61, you can also see in
      Netscape Navigator 2.02.

    - Copy previous files:
      Click if you want your mail and news user profile from
      Netscape Navigator 2.02 copied to the Netscape Communicator
      4.61 folder. If you select this option, the mail and postings
      you receive in Netscape Communicator 4.61 are separated from
      the mail and postings you see in Netscape Navigator 2.02.

    - Start as a new user:
      Click if you want to ignore your Netscape Navigator 2.02
      mail and news user profile and start Netscape Communicator
      4.61 as if Netscape Navigator 2.02 does not exist on the
      operating system.


Netscape Communicator 4.04 Users:

You should consider the following if you are installing Netscape
Communicator 4.61 and want to keep your copy of Netscape
Communicator 4.04:

  o Netscape Communicator 4.61 installs a utility, ns404.exe,
    into the directory where Netscape Communicator 4.04 is
    installed. This utility enables both versions to exist on
    the same operating system.

  o If Netscape Communicator 4.04 is installed in the NETSCAPE
    directory, Netscape Communicator 4.61 will, by default,
    overwrite your installation of Netscape Communicator 4.04.

    For both versions of Netscape Communicator to exist
    simultaneously, install Netscape Communicator 4.61 into a
    different directory than Netscape Communicator 4.04.

  o If Netscape Communicator 4.61 is installed into a different
    directory than Netscape Communicator 4.04, either version
    can be used, but both cannot be run at the same time.

  o To run Netscape Communicator 4.04 from the command line
    after Netscape Communicator 4.61 has been installed, type:

      cd \comm404\program
      ns404 netscape.exe -l en_US

    Note: You must use this command if you have ever installed
          Netscape Communicator 4.61, even if it has since been
          uninstalled.

  o If you launch Netscape Communicator 4.61 from an icon
    while Netscape Communicator 4.04 is running, another
    session of Netscape Communicator 4.04 is launched. Also,
    you might receive network-related error messages. This
    also applies in reverse if you launch Netscape
    Communicator 4.04 while Netscape Communicator 4.61 is
    running.

  o If you want to have both Netscape Communicator 4.04 and
    Netscape Communicator 4.61 installed, installing Netscape
    Communicator 4.04 before installing Netscape Communicator
    4.61 is recommended. The Netscape Communicator 4.61
    installation program installs ns404.exe in the Netscape
    Communicator 4.04 installation directory and updates the
    Netscape Communicator 4.04 workplace shell desktop objects.

    However, if you do install Netscape Communicator 4.04 after
    installing Netscape Communicator 4.61, follow these steps
    to avoid unexpected results:

      1. Copy the ns404.exe file from the \PROGRAM subdirectory,
         where Netscape Communicator 4.61 is installed, to the
         \PROGRAM subdirectory, where Netscape Communicator
         4.04 is installed. Type the following command from a
         command line:

         copy x:\comm461\PROGRAM\NS404.EXE x:\comm404\PROGRAM\NS404.EXE

         where x:\comm461 is the directory where you installed
         Netscape Communicator 4.61 and x:\comm404 is the directory
         where you installed Netscape Communicator 4.04.

      2. Insert NS404.EXE as the first parameter of the following
         workplace shell objects for any Netscape Communicator
         4.04 desktop objects to launch NS404.EXE rather than
         NETSCAPE.EXE.

           o Netscape Communicator

           o Netscape Navigator

           o Netscape Composer

           o Netscape Messenger

           o Netscape Collabra

           o Netscape User Profile

         For example, edit the Netscape Navigator desktop object
         as follows (the language used in this example is
         "en_US"):

         Path and file name:
         c:\comm404\program\ns404.exe

         Parameters:
         netscape.exe -browser -l en_US


2.2 Installing Netscape Communicator 4.61
------------------------------------------------------------------

After you download Netscape Communicator 4.61, use one of the
following methods to extract the installation files:

Note: To install Netscape Communicator 4.61 as a client network
      application in a WorkSpace On-Demand environment, see
      section 3.0 WorkSpace On-Demand. To install Netscape
      Communicator 4.61 as an application on a WorkSpace On-Demand
      server, use the following general instructions.

To extract the Netscape Communicator 4.61 installation files
using the graphical user interface (GUI):

  1. Open the folder where you downloaded the comm461.exe or
     comm46xr.exe file.

  2. Double-click comm461.exe or comm46xr.exe to unpack the
     files for installing Netscape Communicator 4.61.

  3. Double-click install.exe to start the installation.


To extract the Netscape Communicator 4.61 installation files
using the command line:

  1. From a command line, change to the directory where you
     downloaded the comm461.exe or comm46xr.exe file.

  2. Type comm461 or comm46xr to unpack the files for
     installing Netscape Communicator 4.61.

  3. Type INSTALL to start the installation.


To install Netscape Communicator 4.61:

  1. Click Continue if you agree to the license agreement.

  2. Click OK.

  3. Click Netscape Communicator 4.61 for OS/2 Warp.

  4. If you want to install Netscape Communicator 4.61 into any
     directory other than the NETSCAPE directory or Netscape
     Communicator 4.04 is installed in the NETSCAPE directory
     and you do not want to overwrite it, change the
     destination directory.

  5. Click Install.

  6. If you are installing on an OS/2 Warp 4 system, click Yes
     if want the Netscape Navigator component of Netscape
     Communicator 4.61 to be the default program to open
     the URL objects on your Desktop.

     Note: Any URL objects that are set to open with a specific
           browser are not affected.

  7. Click Yes if you want to convert the IBM WebExplorer(R)
     QuickList entries to Netscape Navigator Bookmark entries.
     A WEBEXQL.HTM file is created in the

       x:\netscape\PROGRAM\LANG\language\DEFAULTS directory

     where x:\netscape is the installation drive and directory for
     Netscape Communicator 4.61, and language is the language of the
     version installed. (For example, EN_US.)

     Whenever user profiles are created, this file is copied into
     the new profile. From the Edit Bookmarks window, you can then
     make the migrated bookmark entries part of the default
     bookmark file by clicking File-->Import, and then selecting
     WEBEXQL.HTM. Or, you can make WEBEXQL.HTM the default bookmark
     file by clicking File-->Open, and then selecting WEBEXQL.HTM.
     See the online helps for more information on the Edit Bookmarks
     window.

  8. Click Yes if you want to be able to open an HTML file by
     selecting Open As, and then selecting Netscape Navigator from
     the file object's pop-up menu.

  9. Click Yes if you want to read the READ.ME file. This file
     contains information about known limitations of Netscape
     Communicator 4.61.

 10. Shut down and restart your operating system.

The installation program creates a shadow of the Netscape
Communicator 4.61 icon and a Netscape Communicator 4.61 folder on your
desktop. This folder includes the Netscape Communicator 4.61 objects,
README files, and an installation utility, which can be used
to delete, update, and reinstall Netscape Communicator 4.61.

Notes:

  o If you get a network or TCP error and you are using Netscape
    Communicator 4.61 behind a firewall, you need to set up a socks
    server or proxy gateway. See the online helps for more
    information.

  o If you are going to install any package from Software Choice
    that uses Feature Install, be sure you have version 1.2.3
    or higher of Feature Install from the Software Choice Web
    site at:

    http://service.boulder.ibm.com/asd-bin/doc/

2.3 Uninstalling Netscape Communicator 4.61
------------------------------------------------------------------

To uninstall Netscape Communicator 4.61:

  1. Double-click the Netscape Communicator Installation Utility
     located in the Netscape Communicator 4.61 folder or the
     Netscape Communicator 4.61 - WorkSpace On-Demand folder.

     Note: To view a list of all currently installed versions of
           Netscape Communicator 4.61 and the OS/2 Plug-in Pack,
           click View --> Installed Products.

  2. Click the version of Netscape Communicator that you want to
     uninstall.

  3. From the Action menu, click Delete.

  4. Click the version of Netscape Communicator that you want to
     uninstall, and then click Delete.

  5. Shut down and restart your system.

     Note: You do not have to restart if you are uninstalling
           Netscape Communicator on WorkSpace On-Demand 2.0
           clients.


3.0 WORKSPACE ON-DEMAND INSTALLATION AND CONFIGURATION
    INSTRUCTIONS
__________________________________________________________________

If you are installing and using Netscape Communicator 4.61 on
WorkSpace On-Demand 2.0, read all of the following sections
carefully before beginning an installation.

3.1 Installing as a Client Network Application
------------------------------------------------------------------

Note: To install Netscape Communicator 4.61 as an application on a
      WorkSpace On-Demand server, see section 2.1 Installing
      Netscape Communicator 4.61.

This installation can be done only by someone with System
Administrator authority.

ATTENTION:

  o If a drive letter other than Z: is used for the clients,
    modify the NS46COMM.PKG file. Search for Z: and replace with
    the correct drive letter. Z: is specified as the drive letter
    in approximately lines 2690, 2879, 2882, 2885, and 2888. Line
    numbers might be different on some editors.

  o After installation, run the GETRPL utility to set the access
    rights for the new subdirectory if either of the following
    is true:

    - Netscape Communicator 4.61 is the first version of Netscape
      Communicator to be installed

    - Netscape Communicator 4.61 is installed in a different
      subdirectory than a previous version of Netscape
      Communicator

    You must have system administrator authority to run this
    utility.

To install Netscape Communicator 4.61 as a client network
application in a WorkSpace On-Demand environment:

  1. Log on as a system administrator.

     Note: If you are not logged on as a system administrator, the
           installation fails. The following error message is
           displayed or written to the log file:

           EPFIE187: A product-specific installation error
           occurred while executing the 'EXEC' exit routine.

           The return code is 0x0002.

  2. From an OS/2 prompt, change to the directory where you
     downloaded the comm461.exe or comm46xr.exe file.

  3. Type comm461 or comm46xr to run the executable file that
     unpacks the files for installing Netscape Communicator 4.61.

  4. To start the installation program, type:

     INSTNSWS

     Note: All parameters that are valid for the INSTALL command
           are valid for the INSTNSWS command.

  5. Follow the online instructions.

     ATTENTION: If you accept the default directory, NETSCAPE,
                the installation of Netscape Communicator 4.61
                overwrites any previous installation of Netscape
                Communicator 4.04 existing in that directory.

                To install to a directory other than NETSCAPE,
                modify the APPPOST.FIT file. See Section 3.2
                Configuring as a Client Network Application for
                instructions on modifying this file.

                To avoid modifying the client FIT files, install
                to the NETSCAPE directory or to a subdirectory
                of the NETSCAPE directory. For example, install
                to the NETSCAPE\COMM461 directory.

The installation program creates a Netscape Communicator 4.61
- WorkSpace On-Demand folder on your desktop. This contains the
README files and an installation utility, which can be used to
delete, update, and reinstall Netscape Communicator 4.61.

Note: If WorkSpace On-Demand was installed in a directory other
      than x:\IBMLAN\RPL\BB20.cc (where x: is the drive and cc
      is the country code), then type the correct installation
      directory in place of the defaults on the main installation
      window.

3.2 Configuring as a Client Network Application
------------------------------------------------------------------

This configuration can be done only by someone with System
Administrator authority.

To configure Netscape Communicator 4.61 as a Client Network
Application on WorkSpace On-Demand, you must perform two tasks
after installation before a client can use the program:

  o If you installed Netscape Communicator 4.61 in a directory other
    than NETSCAPE, modify the APPPOST.FIT file to reflect the
    new location. The default location is similar to
    ?:\NETSCAPE\... For example, if you installed Netscape
    Communicator 4.61 in the \IBMLAN\RPL\BB20.US\NETSCAPE\NET461
    directory, you would change the location from ?:\NETSCAPE\...
    to ?:\NETSCAPE\NET461.

    If you are using the Netscape Communicator Wrapper Utility
    (NSWS.EXE or NSWSR.EXE), modify the \NETSCAPE\ directory
    name on the FILE= line in the NSWS.DSF file.

  o Copy the NSCP.INI file, created during the installation of
    Netscape Communicator 4.61, to each defined client's workarea
    based upon the specification in the FIT file.  There are
    three methods that can be used to accomplish this:

    1. Manually create the directory within the client's
       workarea that will contain the NSCP.INI file, and then
       copy the NSCP.INI file to this directory:

       a. From an OS/2 command prompt, change to the
          x:\IBMLAN\DCDB\USERS\user directory.

       b. Type MD COMM461 to make a directory named COMM461
          within the user's directory.

       c. Copy the NSCP.INI file located in the Netscape
          Communicator 4.61 PROGRAM directory of the WorkSpace
          On-Demand RPL directory, x:\IBMLAN\RPL\BB20.cc\
          NETSCAPE\PROGRAM (where x: is the drive, cc is
          the country code, and NETSCAPE is the directory
          where Netscape Communicator 4.61 is installed),
          into the directory created in step b.

          Note: The above steps need to be performed for each
                user/client that uses Netscape Communicator 4.61.

    -- OR --

    2. To update the public applications without preserving your
       Netscape Communicator 4.04 user preferences if you
       installed Netscape Communicator 4.61 in a different
       directory than Netscape Communicator 4.04:

       Note: The following steps need to be performed for
             each public application definition associated
             with Netscape Communicator 4.61.

       a. Open the settings notebook for the public
          application definition.

       b. Click the "Invocation" tab.

       c. Change NETSCAPE.EXE to NSWS.EXE.

       d. Close the settings notebook.

    -- OR --

    3. To update the public applications and preserve your
       Netscape Communicator 4.04 user preferences if you
       installed Netscape Communicator 4.61 in the same
       directory as Netscape Communicator 4.04:

       a. In the APPPOST.FIT file, replace COMM461 with
          COMM404 or the subdirectory name used for
          Netscape Communicator 4.04 if it was changed
          from the default.

       Note: The following steps need to be performed for
             each public application definition associated
             with Netscape Communicator 4.61.

       b. Open the settings notebook for the public
          application definition.

       c. Click the "Invocation" tab.

       d. Change NETSCAPE.EXE to NSWSR.EXE.

       e. Close the settings notebook.

3.3  Netscape Communicator Wrapper Utility for WorkSpace On-Demand
------------------------------------------------------------------

The Netscape Communicator Wrapper Utility makes the manual
operation of copying the NSCP.INI file into each client's
workarea easy. It reads an input file that contains
specifications on the files to be copied and the directories to be
created, and then executes the commands specified.

The input file's name and location are created from the
executable's name and location by replacing the executable's file
extension with "DSF." So, if the utility is named NSWS.EXE and,
the client locates the file in the Z:\NETSCAPE\PROGRAM directory,
then the input file used is Z:\NETSCAPE\PROGRAM\NSWS.DSF.

The input file consists of keywords and keyword values that
describe the steps needed to copy the files for the application.

The input file has a line limit of 256 bytes and supports the
following keywords:

EXE  = {program}
where {program} is the program to be executed (via
DosExecPgm). Do not specify the EXE keyword more than
once. The value of the last occurrence is used.

FILE = {target file} {source file}
where {target file} is the file that needs to be created
and {source file} is the "template" file to be copied

DIR  = {target dir}
where {target dir} is the directory that needs to be
created in order for the file to be copied successfully

You need a DIR entry for every subdirectory under the
<USER> specification in the file's FIT entry.

For example, if the FIT entry is

?:\OS2\NSCP.INI
\\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\BROWSERS\COMM461\NSCP.INI

You would need the following DIR entries after the
FILE = \OS2\NSCP.INI NSCP.INI entry:

DIR = NSCPDIR1
DIR = NSCPDIR2

You also need corresponding entries in the FIT file to create these
directories. Using the above example, the corresponding FIT entries
would be:

?:\NSCPDIR1
\\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\BROWSERS

?:\NSCPDIR2
\\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\BROWSERS\COMM461

Netscape Communicator 4.61 requires that the NSCP.INI file exist in the
x:\OS2 directory (where x: is the boot drive). Since this file is
written to as well as read from, each client is required to have one.
The Netscape Communicator Wrapper Utility input file supplied
requires no modification of FIT entries.

3.4  Installing with Netscape Communicator 4.04 on WorkSpace
     On-Demand
------------------------------------------------------------------

To have both Netscape Communicator 4.61 and Netscape Communicator
4.04 installed on clients, do the following. Either version can
be used, but both cannot be running at the same time.

This procedure assumes that Netscape Communicator 4.04 is
installed and operating in the bb20.us\NETSCAPE directory with
user information in the USERS\<client name>\COMM404 directory.

  1. Install Netscape Communicator 4.61 in a subdirectory of
     \NETSCAPE, such as \NETSCAPE\NET461.

  2. In the APPPOST.FIT file in the \NETSCAPE\NET461\PROGRAM
     directory, change the five  ?:\NETSCAPE... entries
     to  ?:\NETSCAPE\NET461...

  3. In the NSWS.DSF file in the \NETSCAPE\NET461\PROGRAM
     directory, change FILE = \NETSCAPE\PROGRAM\ to
     FILE = \NETSCAPE\NET461\PROGRAM.

  4. Modify the Netscape Communicator 4.61 apps as in Section 3.2,
     step 2. Use only NSWS.EXE - do not use NSWSR.EXE.

  5. Copy ns404.exe from the \NETSCAPE\NET461\PROGRAM directory to
     the \NETSCAPE\PROGRAM directory and update the
     Netscape Communicator 4.04 applications as described in
     Section 2.1.

  5. Run GETRPL and reboot the clients.

  6. Add new apps to users.


The user information is not shared between Netscape Communicator
4.04 and Netscape Communicator 4.61 in this environment.

If you launch Netscape Communicator 4.61 from an icon while
Netscape Communicator 4.04 is running, another session of
Netscape Communicator 4.04 is launched. Also, you might receive
network-related error messages. These error messages do not
indicate a problem. If you click OK, you can continue to use the
new Netscape Communicator 4.04 window. This also applies in
reverse if you launch Netscape Communicator 4.04 while Netscape
Communicator 4.61 is running.



3.5  WorkSpace On-Demand System Administrator Notes
------------------------------------------------------------------

Netscape Communicator 4.61 is supported as a client network application
in a WorkSpace On-Demand environment.

  o Netscape Communicator 4.61 creates the following six network
    applications during installation.

    - Netscape Communicator

    - Netscape Navigator

    - Netscape Messenger

    - Netscape Composer

    - Netscape Profile Manager

  o To assign a Netscape Communicator 4.61 network application to a
    client, you must be logged on as SysAdmin.

  o If the following IDs are defined when you attempt to install
    Netscape Communicator 4.61, the install fails:

    - NS46COMM

    - NS46NAV

    - NS46COMP

    - NS46MSGR

    - NS46PROF

    This occurs only when attempting to install as a new application. It
    does not effect an update of a current installation.

  o For information on CID keywords for installing on WorkSpace
    On-Demand, see section 4.0 CID Installation.

4.0 CID INSTALLATION INFORMATION
__________________________________________________________________

CID installation is accomplished by using response files to install
Netscape Communicator 4.61 in a CID environment.

A response file is a flat ASCII file that consists of a series of
lines separated by newline sequences (0x0A, 0x0D, or a combination
of these two sequences).

Each line in a response file has a maximum line length of 255
bytes.

A response file has two kinds of lines:

  o Comment lines contain only white space characters or have
    either an asterisk (*) or a semicolon (;) as the first nonwhite
    space character on the line.

  o Response lines are used by Software Installer to determine
    the options and configurations to install on the target
    system.

Response lines have the following syntax:

keyword = value

  o Keywords cannot contain imbedded spaces.

  o Keywords are not case-sensitive.

You can group keywords together in value lists using the following
syntax:

    keyword = (
               keyword1 = value
               keyword2 = value
               .
               .
               keywordn = value
              )


Keyword-value pairs used in a response file can be in any order.
However, only one pair is allowed per line.

If you use any keyword names other than the supported keywords,
they are treated as installation variables. For example,
MONITOR = VGA creates a installation variable with the name of
MONITOR and a value of VGA.

Note: Do not use quotes around the component name, even when the
name is more than one word with blanks between words.

4.1 Sample Installation Response Files
------------------------------------------------------------------

The following command is an example of the command needed to start
a CID installation of Netscape Communicator 4.61:

INSTALL /X /A:I /NMSG /O:DRIVE /R:responsefile /L2:outputfile

The following is an example of a response file used to install
the US English version Netscape Communicator 4.61 for
OS/2 Warp in the C:\NETSCAPE directory:

     COMP             = Netscape Communicator 4.61 for OS/2
     FILE             = C:\NETSCAPE
     CFGUPDATE        = AUTO
     DELETEBACKUP     = NO
     OVERWRITE        = YES
     SAVEBACKUP       = NO
     NSCONVERTBROWSER = YES
     NSCONVERTQL      = YES
     NSASSOCIATEHTML  = YES


The following is an example of a response file used to install
the US English version of Netscape Communicator 4.61 for OS/2 Warp
in a WorkSpace On-Demand environment residing on the C drive:

     COMP             = Netscape Communicator 4.61 for OS/2
     FILE             = C:\IBMLAN\RPL\BB20.US\NETSCAPE
     AUX1             = C:\IBMLAN\RPL\BB20.US
     CFGUPDATE        = AUTO
     DELETEBACKUP     = NO
     OVERWRITE        = YES
     SAVEBACKUP       = NO

4.2 Netscape Communicator 4.61 keywords
------------------------------------------------------------------

Note: The following keywords are not used when installing Netscape
      Communicator 4.61 on a WorkSpace On-Demand client.

The following response file keywords are available to allow you to
install Netscape Communicator 4.61 in a CID environment. The possible
values for each keyword are YES (perform the operation) or NO (do
not perform the operation):

NSCONVERTBROWSER (required)

  Changes the browser settings so that the Netscape Navigator
  component of Netscape Communicator 4.61 is set as the default browser
  for all URL objects (OS/2 Warp 4 only).

NSCONVERTQL (required)

  Converts the WebExplorer QuickList to Netscape Communicator 4.61
  bookmarks.

NSASSOCIATEHTML (required)

  Associates the Netscape Navigator component of Netscape Communicator 4.61
  with HTML files (files with an extension of .htm and .html and
  files of type HTML and text/html). You can then open an HTML file
  within the Netscape Navigator component of Netscape Communicator 4.61
  by selecting Open As then Netscape Navigator from the file
  object's pop-up menu. Right-click the object to display the
  pop-up menu.

Notes:

  o The existing installation is overwritten if you specify the drive
    and directory of an existing Netscape Communicator or Netscape
    Navigator installation (including an installation for another
    operating system) in the response file.

  o The value given in the COMP keyword in the response file
    must exactly match the string specified by the NAME
    keyword of the COMPONENT entry (see about line 422 in the
    NS46COMM.PKG file).

  o For more information on the install.exe command line
    parameters, enter VIEW EPFIHELP in either the installation
    or the target directory.

4.3 Software Installer keywords
------------------------------------------------------------------

Software Installer supports the following keywords:

AUXn (conditionally required)

  Specifies the new default path for the auxiliary directory,
  where n is any number between 1 and 18. (There are 18
  possible auxiliary directories: AUX1, AUX2,...AUX18.) This
  keyword is used only for installation processing.

  This AUXn value is used in place of the AUXn keyword of the PATH
  entry of the package file. This keyword is required if you have
  specified an AUXn keyword in the PATH entry.

CFGUPDATE (required)

  Specifies whether the CONFIG.SYS file is automatically updated.
  Valid values for this keyword are:

     AUTO      Automatically updates CONFIG.SYS

     MANUAL    Does not update CONFIG.SYS

COMP

  Specifies the unique name of a component of the product for which
  passed information applies. There can be a maximum of 100
  components. The COMP value must match the NAME keyword of the
  COMPONENT entry in the package file.

Note: Do not use quotation marks around the component name, even
      when the name is more than one word with blanks between words.

COPY

  Specifies the source and target files for a copy process. The
  format of this keyword is:

    COPY = source_filespec target_filespec

  If the target_filespec already exists, it is overwritten. If
  either file specification is not valid, the copy is not made.

DELETEBACKUP (required)

  Specifies whether to delete only the backup versions of the
  product or to delete the entire product. Valid values for this
  keyword are YES and NO. It is required because an existing
  dialog requests this information in the attended mode.

  If an unattended deletion is attempted and the DELETEBACKUP is not
  present in the response file, the deletion fails with an
  EPFIE212 error.

FILE (conditionally required)

  Provides the new default path for the file directory. This
  keyword is used only for installation processing.

  This FILE value is used in place of the FILE keyword of the PATH
  entry in the package file. This keyword is required if you have
  specified a FILE keyword in the PATH entry.

INCLUDE

  Specifies which general response files to include with a
  specific response file. The format of this keyword is:

    INCLUDE = filespec

  Where filespec is the general response file to be included. If
  the file specification contains any global characters (* or ?),
  the first file found that matches the specification is included.
  If the specification is not valid, no general response file is
  included.

   Note: You cannot have more than five levels of included
         response files.

  The following search order is used to find the general response
  files specified.

  1. The fully qualified file specification, if specified with
     filespec.

  2. The current directory.

  3. The file name together with the /G: invocation parameter.

  4. Each directory in the PATH environment variable.

  5. Each directory in the DPATH environment variable.

OVERWRITE (required)

  Specifies whether to automatically overwrite files during
  installation. Valid values for this keyword are YES and NO.
  This keyword is required for unattended processing.

SAVEBACKUP (required)

  Specifies whether to save a backup version of the product when
  it is updated. Valid values for this keyword are YES and NO. It
  is required for unattended processing because an existing dialog
  requests this information in the attended mode.

USEREXIT

  Specifies the name of an exit that you want started. The format
  of this keyword is:

    USEREXIT = filespec

  Where filespec is the name of a user exit. If the file
  specification contains any global characters (* or ?), the first
  executable file found that matches the specification is started.
  If the specification is not valid, Software Installer displays an
  error message.

  The following search order is used to find the specified user
  exit.

  1. The fully qualified file specification, if specified with
     filespec.

  2. The current directory.

  3. Each directory in the PATH environment variable.

  4. Each directory in the DPATH environment variable.

  If the exit does not already exist on the system, you must pack
  the exit in the INSTALL.IN_ file.

WORK (conditionally required)

  Provides the new default path for the data directory.

  This WORK value is used in place of the WORK keyword of the PATH
  entry in the package file. This keyword is required if you have
  specified a WORK keyword in the PATH entry.

5.0 NOTICES
__________________________________________________________________

This information was developed for products and services offered
in the U.S.A. IBM may not offer the products, services, or
features discussed in this document in other 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 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-1758
U.S.A.

For license inquiries regarding double-byte (DBCS) information,
contact the IBM Intellectual Property Department in your country
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 where such provisions are inconsistent with
local law:

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
KIND. IBM AND NETSCAPE DISCLAIMS ALL WARRANTIES, WHETHER
EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS
DOCUMENT. BY FURNISHING THIS DOCUMENT, NETSCAPE
COMMUNICATIONS GRANTS NO LICENSES TO ANY PATENTS OR
COPYRIGHTS.

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 information. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this
information 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
which has been exchanged, should contact:

IBM Corporation
Department LZKS
11400 Burnet Road
Austin, TX 78758
U.S.A.

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

5.1 Trademarks
------------------------------------------------------------------

The following terms are registered trademarks of the IBM
Corporation in the United States or other countries or both:

  o IBM

  o OS/2

  o WebExplorer

  o VoiceType

The following terms are trademarks of other companies:

Netscape, Netscape Navigator, and the Netscape N logo are
registered trademarks of Netscape Communications Corporation in
the United States and other countries. Netscape Collabra,
Netscape Composer, Netscape Messenger, and Netscape Communicator
are also trademarks of Netscape Communications Corporation, which
may be registered in other countries.

Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Sun Microsystems, Inc. in the US and
other countries.

Pentium is a registered trademark of Intel Corporation in the US
and other countries.

(C) Copyright IBM Corporation and Netscape Communications
Corporation 1995, 1999. All rights reserved.

