home *** CD-ROM | disk | FTP | other *** search
Wrap
Text File | 1999-07-14 | 38.3 KB | 1,074 lines
Netscape Communicator 4.61 for OS/2(R) Warp (Beta version) 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 refers to Netscape Communicator 4.61 for OS/2 Warp. CONTENTS __________________________________________________________________ 1.0 Hardware and Software Requirements 2.0 Installation and Configuration Instructions 3.0 WorkSpace On-Demand 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. If you plan to install and use Java(R) with Netscape Communicator, you might need to consider additional hardware and software requirements. See the minimum hardware and software requirements for the version of Java you have or plan to have installed. 1.1 Minimum hardware requirements ------------------------------------------------------------------ To install and use Netscape Communicator, 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 17 MB free hard disk space and 20 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. 1.3.1 OS/2 Warp 4 ---------------------------------------------------------------- FixPak 5 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 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 FX00002 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 require FixPak WX03006 or higher. 1.3.4 DBCS 16-bit Printer Drivers ---------------------------------------------------------------- If you are using the following or any other 16-bit printer drivers on DBCS versions of OS/2 Warp 4, download and apply program temporary fix (PTF) JR12305. EPSON.DRV PSCRIPT.DRV PMLIPS3.DRV IBM5584.DRV IBMPG55P.DRV IBMPS55P.DRV ESCPAGE.DRV DESKJET.DRV IBMPGNET.DRV HPDJPM.DRV LASERJET.DRV Note: JR12305 is not required for any version of OS/2 Warp Server. To download the PTF, go to o Japanese version: http://www.ibm.co.jp/aspc/fixpak.html o Korean version: http://www.ibm.co.kr/ibm/product/sw_biz/down/os2.html o Traditional Chinese version: Contact PSS Taiwan for the PTF o Simplified Chinese version: No PTF required 1.3.5 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. To download the PTF, go to o Japanese version: http://www.ibm.co.jp/aspc/fixpak.html o Korean version: http://www.ibm.co.kr/ibm/product/sw_biz/down/os2.html 2.0 INSTALLATION AND CONFIGURATION INSTRUCTIONS __________________________________________________________________ The following sections describe how to install and configure Netscape Communicator. For information on CID installations, see section 4.0 CID Installation Information. Note to Netscape Navigator 2.02 for OS/2 Users: To make it easier to distinguish between Netscape Communicator and Netscape Navigator 2.02 for OS/2 files, install Netscape Communicator in a different directory than Netscape Navigator 2.02 for OS/2. 2.1 Netscape Communicator 4.61 for OS/2 Warp and Netscape Communicator 4.04 for OS/2 Warp ------------------------------------------------------------------ Installing Netscape Communicator 4.61 for OS/2 Warp will, by default, overwrite your installation of Netscape Communicator 4.04 for OS/2 Warp. For both versions of Netscape Communicator to exist simultaneously, install Netscape Communicator into a different directory than Netscape Communicator 4.04 for OS/2 Warp. - 4.61 is installed into a different directory than where 4.04 is currently installed. In this case, either 4.04 or 4.61 can be used, but both cannot be run concurrently. It is strongly recommended that 4.04 be installed prior to 4.61. The 4.61 installation program will update the 4.04 workplace shell desktop objects and install ns404.exe in the 4.04 installation directory. If 4.04 is installed after 4.61, the ns404.exe must be manually copied from the \PROGRAM subdirectory where 4.61 is installed into the \PROGRAM subdirectory where 4.04 is installed. Additionally, the workplace shell objects for any 4.04 desktop objects must be modified to launch NS404.EXE rather than NETSCAPE.EXE. NETSCAPE.EXE will then have to be inserted as the first parameter. For example, if 4.04 is installed in c:\ns404, and 4.61 is installed in c:\ns461, do the following: copy c:\ns461\program\ns404.exe c:\ns404\program\ns404.exe Then, edit the following workplace shell desktop objects in your Netscape Communicator 4.04: - Netscape Communicator - Netscape Navigator - Netscape Composer - Netscape Messenger - Netscape Collabra - Netscape User Profile For example, edit the Netscape Navigator as follows (language used in this example is "en_US:"): Path and file name: c:\ns404\program\ns404.exe Parameters: netscape.exe -browser -l en_US To run 4.04 from the command line once 4.61 has been installed: cd \ns404\program ns404 netscape.exe -l en_US 2.1 Installing Netscape Communicator ------------------------------------------------------------------ After you download Netscape Communicator, use one of the following methods to install the feature: Note: To install Netscape Communicator as a client network application in a WorkSpace On-Demand environment, see section 3.0 WorkSpace On-Demand. To install Netscape Communicator as an application on a WorkSpace On-Demand server, use the following general instructions. To start the installation of Netscape Communicator using the graphical user interface (GUI): 1. Open the folder where you downloaded the os2en46.exe or os2en46n.exe file. 2. Double-click os2en46.exe or os2en46n.exe to unpack the files for installing Netscape Communicator. 3. Double-click install.exe to start the installation. To start the installation of Netscape Communicator from the command line: 1. From a command line, change to the directory where you downloaded the os2en46.exe or os2en46n.exe file. 2. Type os2en46 or os2en46n to unpack the files for installing Netscape Communicator. 3. Type INSTALL to start the installation. To install Netscape Communicator: 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 do not want Netscape Communicator 4.61 for OS/2 Warp to be installed over Netscape Communicator 4.04 for OS/2 Warp, 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 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, 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 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 on known limitations of Netscape Communicator. 10. Shut down and restart your operating system. The installation program creates a shadow of the Netscape Communicator icon and a Netscape Communicator 4.61 folder on your desktop. This folder includes the Netscape Communicator objects, README files, and an installation utility, which can be used to delete, update, and reinstall Netscape Communicator. Notes: o If you get a network or TCP error and you are using Netscape Communicator behind a firewall, you need to setup 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.2 Uninstalling Netscape Communicator ------------------------------------------------------------------ To uninstall Netscape Communicator: 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 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. 2.3 Migrating a user profile from Netscape Navigator 2.02 for OS/2 ------------------------------------------------------------------ If Netscape Navigator 2.02 for OS/2 is installed, the following three options appear when you create a user profile: o Move previous files: Click if you want your mail and news user profile from Netscape Navigator 2.02 shared with Netscape Communicator. If you select this option, any mail or postings you receive in Netscape Communicator, you can also see in Netscape Navigator 2.02. o Copy previous files: Click if you want your mail and news user profile from Netscape Navigator 2.02 copied to the Netscape Communicator folder. If you select this option, the mail and postings you receive in Netscape Communicator is separated from the mail and postings you see in Netscape Navigator 2.02. o 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 as if Netscape Navigator 2.02 does not exist on the system. 3.0 WORKSPACE ON-DEMAND __________________________________________________________________ If you are installing and using Netscape Communicator on WorkSpace On-Demand 2.0, read the following sections carefully. 3.1 Installing as a Client Network Application ------------------------------------------------------------------ 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 2034, 2190, 2193, 2196, and 2199. Line numbers might be different on some editors. o If Netscape Communicator 4.61 is the first version of Netscape Communicator to be installed or it is installed in a different subdirectory than a previous version, after installation run the GETRPL utility to set the access rights for the new subdirectory. You must have system administrator authority to run this utility. To install Netscape Communicator 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 and 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 os2en46.exe or os2en46n.exe file. 3. Type os2en46 or os2en46n to run the executable file that unpacks the files for installing Netscape Communicator. 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: Because you must accept the default directory, NETSCAPE, the installation of Netscape Communicator 4.61 for OS/2 Warp overwrites any installation of Netscape Communicator 4.04 for OS/2 Warp. 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. Notes: o 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. o To install Netscape Communicator as an application on a WorkSpace On-Demand server, see section 2.1 Installing Netscape Communicator. 3.2 Configuring as a Client Network Application ------------------------------------------------------------------ This configuration can be done only by someone with System Administrator authority. To configure Netscape Communicator as a Client Network Application on WorkSpace On-Demand, you must perform two tasks after installing Netscape Communicator and before a client can use Netscape Communicator: o If you change the subdirectory in which Netscape Communicator resides after installation, modify the APPPOST.FIT file to reflect the new location. The default location is \IBMLAN\DCDB\USERS\<client name>\COMM461. o Copy the NSCP.INI file, created during the installation of Netscape Communicator, to each defined client's workarea based upon the specification in the FIT file. There are two 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 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 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. -- OR -- 2. Update the public applications that were defined during the installation to invoke the Netscape Communicator Wrapper Utility (NSWS.EXE): a. Open the "settings" for the public application definition. b. Click on the "Invocation" tab. c. Change the command from NETSCAPE.EXE to NSWS.EXE Note: If you are experiencing difficulties with this utility, you can create and view a log file by adding >file.log, where file.log is the name of the log file, to the end of the NSWS.EXE command. After the utility has executed, type e file.log, where file.log is the name of the log file, to view the log file. d. Close the "settings" notebook. Note: The above steps need to be performed for each public application definition associated with Netscape Communicator. 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 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 WorkSpace On-Demand System Administrator Notes ------------------------------------------------------------------ Netscape Communicator is supported as a client network application in a WorkSpace On-Demand environment. o Netscape Communicator 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 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, 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 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 response file installation of Netscape Communicator: 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 Communicator keywords ------------------------------------------------------------------ Note: The following keywords are not used when installing Netscape Communicator on a WorkSpace On-Demand client. The following response file keywords are available to allow you to install Netscape Communicator 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 is set as the default browser for all URL objects (OS/2 Warp 4 only). NSCONVERTQL (required) Converts the WebExplorer QuickList to Netscape Communicator bookmarks. NSASSOCIATEHTML (required) Associates the Netscape Navigator component of Netscape Communicator 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 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 If, in the response file, you specify the drive and directory of an existing Netscape Communicator or Navigator installation (including an installation for another operating system), the existing installation is overwritten. 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 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.