═══ 1. Installation and Maintenance Utility ═══

Use the Installation and Maintenance Utility window to install, update, 
restore, or delete a product. 

Select Open catalog from the File pull-down to obtain a list of products you 
can work with on a particular system.  After you have obtained a list, select a 
product from the list, and you can do one of the following: 

   o  Install 
   o  Update 
   o  Restore 
   o  Delete 


═══ 1.1. File ═══

Select the File menu to: 

   o  Open or refresh a product list 
   o  Exit the installation and maintenance utility 


═══ 1.1.1. Open catalog ═══

Select Open catalog from the File menu to open a catalog of installable 
products. You must open a product list before you can install or update a 
product. 

When you select Open catalog you are given a choice of opening a catalog from a 
host operating system or from a drive. 


═══ 1.1.2. Open host catalog ═══

Select Host to open a product list from an MVS, VM or VSE system. 

When you select Host, a window prompts you for: 

   o  A host session 
   o  The host operating system that you want to query the catalog from 
   o  The name of the catalog file that you want to download from the host 


═══ 1.1.3. Open drive catalog ═══

Select Drive to open a catalog of installable products from a diskette drive, a 
CD ROM drive, a LAN drive, or an AS/400 PC support folder. 

When you select Drive, a window prompts you for: 

   o  The drive you want to install a product from 
   o  The directory and file name of the catalog that you want to open 


═══ 1.1.4. Exit ═══

Select Exit from the File menu to exit the installation and maintenance 
utility. 


═══ 1.2. Details ═══

Select the Details menu to see: 

   o  A description of the selected product 
   o  The status and service level of the selected product on the workstation 
   o  The disk space required to install the selected product. 


═══ 1.2.1. Product description ═══

Select Product description from the Details menu to see general information 
about the selected product. 

Selecting this choice queries the source for a product description and displays 
the description in a window. 


═══ 1.2.2. Product status ═══

Select Product status from the Details menu to see the following information 
about the selected product: 

   o  Product name 
   o  Product number 
   o  Version, release, and modification currently installed on the workstation 
   o  Feature currently installed on the workstation 
   o  Components, if any, installed on the workstation 
   o  Service levels installed on the workstation 
   o  Drive and directories that the product is installed in 

 The product status choice can be selected only if the selected product is 
 installed. 


═══ 1.2.3. Disk space ═══

Select Disk space from the Details menu to see: 

   o  Amount of space required to install the selected product 
   o  Total amount of disk space available on your workstation drives 
   o  If installation is possible on a selected workstation drive 

 Note:   If you are planning to update a product, the product may require less 
         disk space than indicated because some files may overwrite existing 
         versions. 


═══ 1.3. Action ═══

Select the Action menu to: 

   o  Install the selected product 
   o  Update the selected product to a new service level 
   o  Restore a previously saved service level of the selected product 
   o  Delete the selected product from the workstation 


═══ 1.3.1. Install ═══

Select Install from the Action menu to install the selected product. 

When you select Install, the following occurs: 

   1. A confirmation window displays information about the product you selected 
      to install. 

   2. Another window is displayed requesting the names of the directories you 
      want to install the product in and the components you want to install (if 
      the product contains components). 

   3. A progress window is displayed and the product is installed in the 
      specified directories. 

   4. The Update and Delete pull-down choices for the selected product are made 
      available. 

 The Install choice is available if any components of the selected product are 
 not yet installed. 


═══ 1.3.2. Update ═══

Select Update from the Action menu to update an installed product to a more 
recent service level. 

When you select Update: 

   1. A confirmation window displays information about the product you selected 
      to update. 

   2. A progress window is displayed and the product is updated in the 
      directories that you specified during the initial installation. 

   3. The Restore pull-down choice becomes available for the updated product if 
      a backup was saved. 

 The Update choice is available only for products that have been installed or 
 that have at least one component installed. 


═══ 1.3.3. Restore ═══

Select Restore from the Action menu to restore the selected product to the 
previous service level. 

When you select Restore: 

   1. A confirmation window displays information about the product you selected 
      to restore. 

   2. A progress window appears and files from the previous service level 
      replace the files in the currently installed service level. 

   3. The Restore pull-down choice for the selected product is made 
      unavailable. 

 The Restore choice is only available if the selected product has been 
 installed and updated with the Save a backup version option selected. 


═══ 1.3.4. Delete ═══

Select Delete from the Action menu to delete the selected product from the 
workstation. If the product contains components, specific components can be 
selected for deletion. 

This action also allows any backup versions to be deleted without deleting the 
current version. 

When you select Delete: 

   1. A confirmation window displays information about the product you selected 
      to delete. If the product contains components, the components that you 
      want to delete can be selected. 

   2. A progress window appears and all files that are associated with the 
      selected product (or components of the product) are deleted. If you 
      select the Delete only the backup versions check box, only the backup 
      version of the product is deleted. 

   3. The Update, Delete, and Restore pull-down choices for the selected 
      product are made unavailable if the entire product has been deleted. 

   4. The Install pull-down choice for the selected product is made available. 

 The Delete choice is available when any component of the selected product is 
 installed. 


═══ 1.4. View ═══

Select the View menu to change the list of products displayed in the main 
window list.  You can: 

   o  Display a list of all the products that are in the catalog that is 
      currently open 

   o  Display a list of products that have at least one component installed 

   o  Display a list of only the installed products that have been updated 

   o  Display the product list in the order that it appears in the catalog file 

   o  Sort the product list in ascending alphabetical order (A to Z) 

   o  Sort the product list in descending alphabetical order (Z to A) 


═══ 1.4.1. Current catalog ═══

Select Current catalog from the View menu to look at all the products that are 
in the catalog that is currently opened. Products in this catalog that are 
already installed or updated are displayed in this list.  Products that are 
installed or updated that are not in the current catalog are not displayed in 
this list. 


═══ 1.4.2. Installed products ═══

Select Installed products from the View menu to look at the products that have 
at least one component installed. All installed products are displayed in this 
list regardless of which source or operating system they were installed from. 
Once installed, a product appears in the Installed products view even if the 
product is no longer listed in the currently opened catalog. This allows it to 
be deleted or restored (if a backup was saved on Update). 


═══ 1.4.3. Updated products ═══

Select Updated products from the View menu to look at only the products that 
have at least one component installed and updated. All installed products that 
have been updated are displayed in this list, regardless of which source or 
operating system they were installed from. 


═══ 1.4.4. Catalog order ═══

Select Catalog order from the View menu to display the products in the product 
list in the same order that they appear in the catalog file. 

If the list is in the Installed products or Updated products view, then 
products not in the currently open catalog will be displayed first in the list 
followed by the products that are in the catalog in the order that they occur. 


═══ 1.4.5. Ascending order ═══

Select Ascending order from the View menu to display the product list in 
ascending alphabetical order (A to Z). 


═══ 1.4.6. Descending order ═══

Select Descending order from the View menu to display the product list in 
descending alphabetical order (Z to A). 


═══ 1.5. Help ═══

Select this action to get to the following help: 

 Help for help 
   Gets help on using the online help facility 
 General help 
   Gets help on application windows 
 Keys help 
   Gets help on valid keys 
 Help index 
   Displays an index of help topics 


═══ 1.5.1. Using help ═══

Select this pull-down choice to see a description of the types of help provided 
for this application and to learn how to get help. 


═══ 1.5.2. General help ═══

Select this pull-down choice to get an overview of the current window. 


═══ 1.5.3. Keys help ═══

Select this pull-down choice to get help for the key definitions. 


═══ 1.5.4. Help index ═══

Select this pull-down choice to use the help index.  You can use the index in 
two ways: 

   o  To select a topic from a list of all help topics 
   o  To search for a topic by selecting Search from the Services menu 


═══ 1.5.5. Keys help ═══

Select this pull-down choice to get help for the key definitions. 

Select a topic to get keys help on: 

   o  Help keys 
   o  System keys 
   o  Window keys 
   o  Editing keys 
   o  Application keys 


═══ 1.5.6. Help keys ═══

These are the help window key definitions: 

 F1 
   Gets help 
 F2 
   Gets general help (from within any help window) 
 F9 
   Goes to a list of keys (from within any help window) 
 F11 or Shift+F1 
   Goes to the help index (from within any help window) 
 Esc 
   Displays the previous window 
 Shift+F10 
   Gets using help 
 Alt+F6 
   Switches from help to the application window and back 
 Alt+F4 
   Exits help 


═══ 1.5.7. System keys ═══

These are the system key definitions: 

 F1 
   Gets help 
 F3 
   Closes a program window 
 F10 
   Goes to or from the menu bar 
 Arrow keys 
   Move among the choices on the menu bar and pull-down menus 
 End 
   Goes to the last choice in a pull-down menu 
 Esc 
   Cancels a pull-down menu or the system menu 
 Home 
   Goes to the first choice in a pull-down menu 
 PgUp 
   Scrolls the contents of the window up one screen 
 PgDn 
   Scrolls the contents of the window down one screen 
 Underlined letter (mnemonic) 
   Calls the associated action 
 Alt 
   Goes to or from the menu bar 
 Alt+Esc 
   Switches to the next program, including full-screen programs 
 Alt+Tab 
   Switches to the next program that runs in a window 
 Alt+F4 
   Closes the window 
 Alt+F5 
   Restores the window 
 Alt+F6 
   Changes the active window in an application 
 Alt+F7 
   Moves the window 
 Alt+F8 
   Sizes the window 
 Alt+F9 
   Minimizes the window 
 Alt+F10 
   Maximizes the window 
 Ctrl+Esc 
   Switches to the task list 
 Ctrl+F6 
   Changes the active secondary window in an application 
 Shift+Esc or Alt+Spacebar 
   Goes to or from the system menu 
 Shift+Esc or Alt 
   Goes to or from the system menu of a text window 


═══ 1.5.8. Window keys ═══

These are the window key definitions: 

 Enter 
   Completes the action in the window 
 Esc 
   Cancels the window 
 Spacebar 
   Sets a check box on or off or performs the task associated with the selected 
   push button 
 Tab 
   Moves to the next entry field, selection field, or hypertext phrase 


═══ 1.5.9. Editing keys ═══

These are the editing key definitions: 

 Backspace (left arrow delete) 
   Deletes the character to the left of the cursor 
 Del or Delete 
   Deletes the character to the right of the cursor 
 End or Ctrl+Right arrow key 
   Moves to the end of a field 
 Home or Ctrl+Left arrow key 
   Moves to the beginning of a field 
 Ctrl+Ins 
   Copies the selected text to the clipboard 
 Shift+Print Screen 
   Prints the information currently displayed 


═══ 1.5.10. Application keys ═══

These are the application keys definition: 

 F1 
   Gets help 
 F3 
   Ends the installation 
 Ctrl+D 
   Displays a description of the selected product 
 Ctrl+H 
   Opens a product catalog from a host 
 Ctrl+I 
   Installs the selected product 
 Ctrl+K 
   Displays the disk space required by the selected product 
 Ctrl+O 
   Opens a product catalog from a drive 
 Ctrl+R 
   Restores a previous service level of the selected product 
 Ctrl+S 
   Displays the workstation status of the selected product 
 Ctrl+U 
   Updates the selected product 
 Delete 
   Deletes the selected product 


═══ 1.5.11. Text selection keys ═══

These are the text selection key definitions: 

 Shift+arrow 
   Selects text or extends a selection in the direction of the arrow 
 Shift+Home 
   Selects text or extends a selection to the beginning of the current line 
 Shift+End 
   Selects text or extends a selection to the end of the current line 
 Shift+Ctrl+Right 
   Selects text or extends a selection to the beginning of the next word 
 Shift+Ctrl+Left 
   Selects text or extends a selection to the beginning of the previous word 


═══ 1.6. Help ═══

Select this push button to display the help information about the field the 
cursor is in. 


═══ 2. Cancel ═══

Select this push button to exit the window without committing any changes. 

If the operation is in progress and you select Cancel, the operation 
immediately stops and the window closes. 


═══ 3. Open host catalog ═══

Use the Open host catalog window to query a list of available products from an 
MVS, VM or VSE system. 

To open a product list: 

   1. Select the ID of the host session you want to communicate with in the 
      Host session list box. 

   2. Select the Host operating system radio button that corresponds to the 
      operating system that is running on the host. 

   3. Type the name of the catalog file to be opened in the Filename 
      combination box.  If the catalog file you want to open has been 
      previously opened, you can select it from the combination box drop-down 
      list. 

   4. Select the Open push button to begin the open process.  The catalog file 
      is queried from the host. If the open is successful, this window goes 
      away and the opened product list is displayed in the main window. 


═══ 3.1. Host session ═══

Use the Host session list in the Open host catalog window to select the 
Communications Manager host session identifier that you want to use for 
downloading (for example, A, B, or C). The first item in the list box is the 
default. 


═══ 3.2. Host operating system ═══

Select the MVS, VM, or VSE radio button in the Open host catalog window that 
corresponds to the operating system that is running on the host system you 
specified in the Host session list box. MVS is the default. 


═══ 3.3. Catalog filename ═══

Use the Filename field to enter a catalog file name or select the catalog file 
name from the drop-down list of the catalog that you want to open.  Only 
previously opened catalog files appear in the drop-down list. 

When a catalog file name is selected from the drop-down list, the static field 
above the combination box is updated to display a brief description of the 
catalog file. 

The catalog file name entered in this field must be a valid MVS, VM, or VSE 
filename, depending on which host operating system radio button is selected. 

   o  Sample MVS catalog file names: 

           PROJ.GROUP.TYPE(CATALOG) 
           EPF.V1R2M0.SEPFBENU(EPFICAT) 

   o  Sample VM catalog file names: 

           CATALOG ICF A 
           EPFICAT ENUEPF12 * 

   o  Sample VSE catalog file names: 

           LIBRARY.SUBLIBRARY.MEMBER NAME.MEMBER TYPE 
           EPF.VIR2M0.SEPFBENU.CATALOG 


═══ 3.4. Description ═══

Select the Description push button in the Open host catalog window to display a 
brief description of the catalog file that currently appears in the Filename 
field. The description is queried from the host session you selected in the 
Host session list box. 


═══ 3.5. Open ═══

Select the Open push button in the Open host catalog window to open the product 
catalog from the Host session you specified. Ensure that: 

   1. You are logged onto the host session selected in the Host session list 
      box and that the host session is ready to accept input. 
   2. The Host operating system radio button corresponds to the operating 
      system that is running on the host session you specified. 

 After you select this push button, the catalog file is downloaded from the 
 host session you specified, the catalog file is parsed, and the product list 
 is built and displayed. 


═══ 4. Open drive catalog ═══

Use the Open drive catalog window to query a list of available products from a 
diskette drive, a CD ROM drive, a LAN drive, or an AS/400 PC support folder. 

To open a product list: 

   1. Select the drive that contains the catalog file you want to open from the 
      Drive combination box. The Filename combination box is updated with a 
      list of all previously opened catalog files that exist on the drive. 

   2. Type the name of the catalog file to be opened in the Filename 
      combination box.  If the catalog file you want to open has been 
      previously opened and still exists, you can select it from the 
      combination box drop-down list. 

   3. Select the Open push button to begin the open process.  The catalog file 
      is queried from the drive. If the open is successful, this window goes 
      away and the opened product list is displayed in the main window. 


═══ 4.1. Drive ═══

Select the drive that contains the catalog file. 

The combination box displays all drives that are connected to the workstation. 


═══ 4.2. Catalog filename ═══

Type a catalog file name in the Filename field or select the catalog file name 
from the drop-down list of the catalog that you want to open.  Only previously 
opened catalog files that still exist on the selected drive appear in the 
drop-down list. 

When you select a catalog file name from the drop-down list, the static field 
above the combination box is updated to display a brief description of the 
catalog file, if one exists. 

The catalog file name you enter in this field must be a valid OS/2*  file name 
without a drive specification. 

Sample catalog file names: 

      \packages\epficat.icf 
      \catalog.icf 


═══ 4.3. Description ═══

Select the Description push button in the Open drive catalog window to display 
a brief description of the catalog file that currently appears in the Filename 
field. The description is queried from the drive selected in the Drive list 
box. 


═══ 4.4. Search ═══

Select the Search push button in the Open drive catalog window to search the 
selected drive for a list of catalog files. 


═══ 4.5. Open ═══

Select the Open push button in the Open drive catalog window to open the 
product catalog from the Drive you specified. 

After you select this push button, the catalog file is read from the selected 
drive and processed.  Then the product list is built and displayed. 


═══ 5. Product status ═══

Use the Product status window to see information about a product that is 
currently installed on the workstation.  The following information is 
displayed: 

 Product name 
   The name of the selected product that is currently installed on the 
   workstation 
 Product number 
   The official product number assigned to the selected product 
 Version 
   The version, release, and modification number of the selected product 
 Feature 
   The feature number of the selected product 
 Directories installed in 
   The directories where the product is installed 

 The service level of the product can be determined by selecting the Service 
 level push button.  The Service level window is then displayed. 


═══ 5.1. Cancel ═══

Select the Cancel push button in the Product status window to close the window 
and return to the main window. 


═══ 6. Disk space ═══

Use the Disk space window to check the disk space needed to install the 
selected product. 

This window also allows you to check the amount of space available on any of 
the workstation hard disks, and it reports whether installation is possible on 
the specified drive. 

To see whether you can install a product on a hard disk: 

   1. Select the hard disk in the Drive list box 
   2. Read the message next to the Drive list box to determine if you have 
      enough available space to install the product on the selected hard disk 

 Note:   Updating the product may require less disk space than indicated if the 
         installation and maintenance utility overwrites some existing files 
         during the update. So, even though the window may show there is not 
         enough workstation disk space to install the selected product, you can 
         still attempt to update the product. 

 The fields in the Disk space window are: 

 Product name 
   The name of the selected product 
 Bytes needed 
   The amount of space needed to install the selected product 
 Bytes available 
   The amount of space available on the workstation drive specified 
 Installation possible 
   A message indicating that you can install the selected product on the drive 
   specified 
 Installation not possible 
   A message indicating that you cannot install the selected product on the 
   drive specified 


═══ 6.1. Available space ═══

Use the Available space list box in the Disk space window to look at the amount 
of unused space on each workstation hard disk. Use this list to determine which 
drive you want to install the product on. 

When you select a drive, the status message next to the list box is updated. 
This message indicates whether there is enough disk space available on the 
selected drive to allow you to install the product. 


═══ 6.2. Cancel ═══

Select the Cancel push button in the Disk space window to close the Disk space 
window. 


═══ 6.3. Change directories ═══

Select this check box to change all drive letters for the directories on the 
Install-directories window to the drive letter you selected in the available 
space list box. 


═══ 6.4. OK ═══

Select the OK push button to return to the Install-directories window with the 
action indicated by the Change directories to selected drive checkbox. 

Before selecting OK: 

   1. Select a drive with enough space for the components you are installing. 

   2. Select the Change directories to selected drive checkbox to update the 
      directories fields in the Install-directories window. 


═══ 7. Install ═══

Use the Install window to see the following information about the product that 
you selected to install: 

 Product name 
   The name of the product 
 Product number 
   The official product number assigned to the product 
 Version 
   The version, release, and modification number of the product 
 Feature 
   The feature number of the product 

 This window also allows you to set options to have your CONFIG.SYS file 
 automatically updated, if needed, by the product, and to indicate whether 
 files should automatically be overwritten without prompting if files currently 
 exist with the same names as the product files. 

 Select OK to install the product or select Cancel to exit the window and 
 return to the main menu. 


═══ 7.1. Update CONFIG.SYS ═══

Select the Update CONFIG.SYS check box to have the needed variables added to or 
modified in your CONFIG.SYS file to include the directories that the product is 
installed in. 

Note:   A backup of your original CONFIG.SYS file is saved in CONFIG.BAK in the 
        drive and path of the CONFIG.SYS being modified. 

 If you do not select this choice, you must manually update your CONFIG.SYS 
 file. Refer to the product's installation instructions for additional 
 information on how to update your CONFIG.SYS file. 


═══ 7.2. Overwrite files ═══

Select the Overwrite files check box in the Install window to automatically 
replace all workstation files that have the same name and location as product 
files being installed. 

If you do not check this choice, the installation and maintenance utility 
prompts you before overwriting an existing workstation file. 


═══ 7.3. OK ═══

Select the OK push button in the Install window to install the selected 
product. 

When you select OK, the Installation and Maintenance Utility does the 
following: 

   1. Transfers and parses the package file for the product, which provides 
      information to the installation and maintenance utility about how to 
      install the product. 

   2. Prompts you for the directories where you want to place the product 
      files. 


═══ 8. Install-File Errors ═══

Use the Install-File Errors window to see the errors found in the transferred 
catalog or package file. 

System administrators: 

   1. Switch to the source location. 
   2. Edit the catalog or package file to correct the errors. 
   3. Select Retry. 

 Users: 

 Print the errors by selecting the Print push button, and then contact your 
 system administrator or product distributor. 


═══ 8.1. Retry ═══

Select the Retry push button in the Install-File Errors window to transfer and 
parse the catalog or package file again. 

Select Retry after you edit the catalog or package file at the source to ensure 
that your changes have corrected the problem. 


═══ 8.2. Print ═══

Select the Print push button in the File Errors window to print the displayed 
parse errors on the workstation printer. 

Make sure that the workstation printer is on. 


═══ 9. Install-directories ═══

Use the Install-directories window to specify the directories you want to 
install the product in. 

You can change the file directories to customize where the files are 
transferred to on your workstation.  Remember that the hard disks you specified 
in the directories must have enough space available to store the transferred 
files. 

After you specify the directories, select the Install push button to start the 
installation. 

You can determine the amount of disk space a product requires and the amount of 
disk space available for all your hard drives by selecting the Disk space push 
button. 


═══ 9.1. Install-directories ═══

Use the Install-directories window to specify the directories you want to 
install the product in. 

You can change the directories to customize where the files are transferred to 
on your workstation.  Remember that the hard disks specified in the directories 
must have enough space available to store the transferred files. 

Use the list box to select the components of the product you want to install. 
You must select at least one component to continue. 

After selecting the components, you can install them by selecting the Install 
push button.  You can also see how much disk space is required to install the 
selected components by selecting the Disk space push button. 


═══ 9.2. Install-directories ═══

One or more of the product's components have already been installed in the 
specified directories.  Use this window to install additional components of a 
product in these same directories. 

Use the list box to select the additional components of the product you want to 
install.  You must select at least one component to continue. 

Select the Install push button to install the selected components. To see how 
much disk space is required to install the selected components, select the Disk 
space push button. 


═══ 9.3. Directory ═══

Use the directory fields in the Install-directories window to enter the 
directories where you want the product files installed. 

The maximum directory length is 128 characters. 

   o  Valid sample directories: 

           C:\IBMRM 
           D:\ 
           D:\TOOLS\KEDIT 

   o  Sample directories that are not valid: 

           \IBMRM 
           C:\TOOLONGPATH 
           C:\IBMRM\ 


═══ 9.4. Disk Space ═══

Select the Disk space push button in the Install-directories window to see the 
amount of disk space required to install the product and the amount of free 
space available on each workstation hard disk. 


═══ 9.5. Install ═══

Select the Install push button in the Install-directories window to begin 
installing the product in the specified directories. 


═══ 9.6. Component ═══

Use the Component list box in the Install-directories window to look at a list 
of the installable components for the selected product if your product has 
components. 

Select the components you want to install.  Next, select the Install push 
button to begin installation or select the Disk space push button to see how 
much workstation disk space the selected components require. 


═══ 10. Update ═══

Use the Update window to see the following information about the product that 
you selected to update: 

 Product name 
   The name of the product 
 Product number 
   The official product number assigned to the product 
 Version 
   The version, release, and modification number of the product 
 Feature 
   The feature number of the product 

 Select Update CONFIG.SYS to automatically update your CONFIG.SYS file. 

 Select Save a backup version to save backup copies of files that have changed 
 into a backup directory.  This option enables the Restore action so that the 
 current service level can be restored at a later date. You can execute a 
 restore if the new service level for the product results in some undesired 
 behavior. Do not select this option if disk space is not available to store 
 the backup files. 

 Note:   The backup version of the product files can be deleted later by using 
         the Delete choice on the Action pull-down. 

 Select Update to update the product or select Cancel to exit the window.  If 
 the product has components, the update affects all installed components for 
 which an update exists.  You can look at a list of the installed components in 
 the Product status window. 


═══ 10.1. Save a backup version ═══

Select the Save a backup version check box in the Update window to save a 
backup version of any files that are replaced during the update. 

Selecting this option enables you to restore the current version of the product 
after the update is done. Do not select this option if disk space is not 
available to store these backup files. 

Note:   If this option is selected, the saved backup can be deleted at a later 
        date by using the Delete only the backup versions option on the Delete 
        window. 


═══ 10.2. Update ═══

Select the Update push button in the Update window to update the selected 
product. 

When you select Update, the installation and maintenance utility does the 
following: 

   1. Transfers and parses the package file for the product 
   2. Begins to update the product by replacing the product files with the 
      newer level files 


═══ 10.3. Progress (Install or Update) ═══

Use the Progress window to look at the progress of files being transferred 
during an install or update. This window contains: 

 Title line 
   The product name and component of the product being installed or updated 
 Progress box 
   Information on the progress of the installation or update 
 Status 
   The current status of the installation or update.  The possible values for 
   this field are: 
        Processing 
          The installation and maintenance utility is performing a task that 
          may take an extended period of time 
        Error occurred 
          An error occurred.  Press the Stop push button to cancel the 
          installation or update 
        Transferring 
          The program is transferring files 
        Unpacking 
          Files are being decompressed 
        Deleting files 
          Files are being deleted after you selected Stop during the 
          installation or update 
        Restoring files 
          Files are being restored to the previous service level after you 
          selected Stop 


 Elapsed time 
   The time that has elapsed since the file transfer began 
 Thermometer 
   A graphic representation of the number of files already transferred 
 Files box 
   Information about the file that is currently being transferred 
 Source 
   The name of the file at the source 
 Target 
   The name of the target file on the workstation 


═══ 10.4. Stop ═══

Select the Stop push button on the Progress window to stop the install or 
update. 


═══ 11. Restore ═══

Use the Restore window to see the following information about the product that 
you selected to restore to the previous service level: 

 Product name 
   The name of the product 
 Product number 
   The official product number assigned to the product 
 Version 
   The version, release, and modification number of the product 
 Feature 
   The feature number of the product 

 Restore removes the last service level applied and returns the product to its 
 previous level.  If the product has components, Restore removes the last 
 service level from those components that have backups and returns them to 
 their previous levels.  Any component without a backup is left at its current 
 level. 

 You can look at the applied service levels for this product or its components 
 by selecting the Service level push button on the Product status window. 

 Select Restore to restore the product to the previous service level, or select 
 Cancel to exit the window. 


═══ 11.1. Restore ═══

Select the Restore push button in the Restore window to restore the product to 
the previous service level. 

When you select Restore, the installation and maintenance utility copies the 
back up files of the previous service level over the current service level 
files. 

Warning:   Selecting Restore overwrites the current service level. 


═══ 12. Delete ═══

Use the Delete window to see the following information about the product that 
you selected to delete: 

 Product name 
   The name of the product 
 Product number 
   The official product number assigned to the product 
 Version 
   The version, release, and modification number of the product 
 Feature 
   The feature number of the product 

 Select the Delete push button to delete the product and any backup versions of 
 the product. 

 If you select the Delete only the backup versions check box, only the backup 
 version of the product will be deleted.  The current version will not be 
 deleted in this case. 


═══ 12.1. Delete ═══

Select the Delete push button in the Delete window to delete the selected 
product or components. 

Warning:   Selecting Delete destroys both the current and any saved backup 
levels of the selected product unless you also select the Delete only the 
backup versions check box. 


═══ 13. Description ═══

Use this window to look at a description of a catalog file or a product. You 
can vertically scroll the window by using the scroll bar or the arrow keys. 
You can also size the window, in which case the text within the window is 
automatically reflowed to the new window size. 


═══ 13.1. Directories installed in ═══

This section of the window lists the directories that the product was installed 
in.  You cannot edit the fields, but you can scroll them so that paths that are 
too long to be displayed in the available space can be seen. 


═══ 13.2. Service level ═══

This push button displays the Service level window so you can determine the 
service level of the product. 


═══ 13.3. Service level ═══

This push button displays the Service level window so you can determine the 
service level of the selected component. 

This push button is disabled until a component is selected in the Currently 
installed list box. 


═══ 13.4. Currently installed components ═══

This list box contains the components that have been installed for the 
specified product.  Select a component in the list and then select the Service 
level push button if you want to see the current service level of a component. 


═══ 14. Product status ═══

Use the Product status window to look at information about a product that is 
currently installed on the workstation.  The following information is 
displayed: 

 Product name 
   The name of the selected product that is currently installed on the 
   workstation 
 Product number 
   The official product number assigned to the selected product 
 Version 
   The version, release, and modification number of the selected product 
 Feature 
   The feature number of the selected product 
 Components currently installed 
   The names of the components that have already been installed on the 
   workstation for the product 
 Directories installed in 
   The directories where the product was installed 

 You can determine the service level of any component by selecting the 
 component in the Currently installed list box and then selecting the Service 
 level push button.  The Service level window is then displayed. 


═══ 14.1. Service level ═══

This window displays a list of the service levels that have been applied to the 
indicated product or component, along with the date each one was applied (by 
the Update action) and the location that it was applied from. 

The displayed information can be printed by selecting the Print push button. 


═══ 14.2. Service level list ═══

This is a list of service levels that have been applied to the indicated 
product or component.  The list also contains the date that each level was 
applied (by the Update action) and the origin of each service level update. 

The origins that can be displayed are: 

 MVS    The service level was applied from an MVS host system. 

 VM     The service level was applied from a VM host system. 

 VSE    The service level was applied from a VSE host system. 

 Drive  The service level was applied from a diskette drive, a CD ROM drive, 
        LAN drive, or AS/400 PC support folder. 


═══ 14.3. Print ═══

Prints a record of the service level information currently displayed on the 
Service level window. 


═══ 14.4. Cancel ═══

Select the Cancel push button to close the Service level window and return to 
the Product status window. 


═══ 15. Search ═══

Use the Search window to search the system for catalog files. 

To search for catalog files: 

   1. Select the drive that you want to search from the Drive combination box. 
      When you select a drive, the Directories and File list boxes are updated 
      to reflect the directories and file names on the selected drive. 

   2. If you want to specify a file qualification to search for, enter a file 
      name in the Catalog filename entry field that contains wildcard 
      characters. The default qualification is *.ICF. 

   3. Begin searching by selecting the directory that you want to search in the 
      Directories list box. Selecting the directory causes the File list box to 
      be updated with a list of files from the directory that matches the 
      specified file qualification. 

      Continue selecting directories until you find the catalog file you want 
      in the File list box. 

   4. Select the desired catalog file from the File list box. 

   5. Select OK. The catalog file name you selected is placed in the Open drive 
      catalog window. 


═══ 15.1. Catalog filename ═══

Use this entry field to enter the name of the catalog file you want to open. 
You can use wildcard characters in the catalog file name. 

You can also specify a catalog file name by selecting an item in the File list 
box. 


═══ 15.2. Drive ═══

This combination box specifies the drive that is to be searched. If you select 
a new drive from the list of drives, the Directories and File list boxes are 
updated to reflect the directories and files that exist on the selected drive. 


═══ 15.3. File ═══

This list box contains a list of the files that exist on the drive and 
directory you are searching. The file names contained in this list box match 
the wildcard specification that appears in the Catalog filename entry field. 
You can specify the catalog file you want to open by selecting an item in this 
list. 

You can scroll the File list box horizontally and vertically. 


═══ 15.4. Directory ═══

This list box contains a list of the directories on the drive you want to 
search. You can scroll the Directory list box horizontally and vertically. 

To use this list box, select the directory that you want to search. The files 
in that directory appear in the File list box. Selecting a directory also 
causes the subdirectories in it to be displayed in the Directories list box. 


═══ 15.5. OK ═══

Select this push button to return to the Open drive catalog window. The catalog 
file name you selected is placed in the filename field. 


═══ 16. Insert disk ═══

The Insert disk window is used for products that have more than one 
installation diskette. This window appears on top of the current window 
whenever a new disk needs to be inserted during a drive installation. 


═══ 16.1. Drive ═══

Use this drop-down combination box to specify the drive where you insert the 
requested diskette. The box contains a list of all available drives. The drive 
selected by default is the one currently being used. If you have two diskette 
drives, you can insert two diskettes and use this combination box to switch 
between drives. 


═══ 16.2. Continue ═══

Select this push button to continue with the installation or update. The 
selected drive is checked to ensure it contains the requested disk. If it does 
not, this window is displayed again. 


═══ 16.3. Delete only the backup versions ═══

Select the Delete only the backup versions check box on the Delete window to 
delete only the backup versions of the selected product or components.  The 
files for the current version will not be deleted. 

This check box is disabled if there is no backup version to delete. 


═══ 17. Delete ═══

Use the Delete window to look at the following information about the product 
that you selected to delete: 

 Product name 
   The name of the product 
 Product number 
   The official product number assigned to the product 
 Version 
   The version, release, and modification number of the product 
 Feature 
   The feature number of the product 
 Components 
   The list of installed components for the selected product 

 Use the list to select the components to be deleted, then select the Delete 
 push button to delete the selected components. Any backup versions of the 
 selected components will also be deleted. 

 If you select the Delete only the backup versions check box, only the backup 
 versions of the selected components will be deleted.  The current version will 
 not be deleted in this case. 


═══ 17.1. Components ═══

Use the Component list box in the Delete window to select the installed 
components to be deleted for the selected product. 

Each selected component in the list is deleted, along with any backup versions 
of the components, unless the Delete only the backup versions check box is 
selected.  Select the components in the list, then select the Delete push 
button to begin deleting the components. 


═══ 17.2. Select all ═══

The Select all push button selects all items displayed in the list box. This 
push button is disabled if all the components in the list box are selected. 


═══ 17.3. Deselect all ═══

The Deselect all push button deselects all items displayed and selected in the 
list box. This push button is disabled if none of the components is selected. 


═══ 18. Progress (Restore or Delete) ═══

Use the Progress window to look at the progress of files being restored or 
deleted. This window contains: 

 Title line 
   The product name and component of the product being restored or deleted 
 Progress box 
   Information on the progress of the operation 
 Status 
   The current status of the restore or delete.  The possible values for this 
   field are: 
        Processing 
          The installation and maintenance utility is executing a task that can 
          take an extended period of time 
        Error occurred 
          An error occurred.  Press the Stop push button to cancel the 
          operation 
        Deleting files 
          The program is deleting the product files 
        Restoring files 
          Files are being restored to the previous service level 


 Elapsed time 
   The time that has elapsed since the operation began 
 Thermometer 
   A graphic representation of the number of files already restored or deleted 


═══ 18.1. Descriptions ═══

The Descriptions push button displays a Descriptions window that contains a 
brief description of each selected component in the list box.  If a description 
is not available, the window is displayed with text stating that the 
description is not available to be displayed. 

The Descriptions push button is only available when a component is selected. 


═══ 18.2. Stop ═══

Select the Stop push button on the Progress window to stop the restore or 
delete. 


═══ 19. Error messages ═══


═══ 19.1. Help for EPFIE107 ═══

Explanation 

The installation and maintenance utility cannot find the package file specified 
in the catalog file, or it cannot open the package file after it was 
transferred to the workstation. 

Response 

Users 

Ensure that you have access to the data set (MVS), are linked to the mini disk 
(VM), have the correct diskette inserted, or have accessed the LAN drive that 
contains the product files.  Select Retry to try the transfer again.  If the 
error persists, report the error to your system administrator. 

Select Cancel to remove the message and return to the previous window. 

System administrators 

Check that the package file for this product exists at the source and that the 
Package entry in the catalog file is pointing to the correct package file. 
Correct any errors, and try again. 

Select Cancel to remove the message and return to the previous window. 


═══ 19.2. Help for EPFIE111 ═══

Explanation 

An error occurred while the installation and maintenance utility initialized 
communications with the host. 

Response 

   1. Select Cancel to remove the message and return to the previous window. 

   2. Check that the host session specified in the Open host catalog window is 
      active and ready to accept input. If you are attempting an Install or 
      Update action, open the host catalog again using the Open host catalog 
      choice on the File menu. 

   3. Try the operation again. 


═══ 19.3. Help for EPFIE112 ═══

Explanation 

The installation and maintenance utility cannot transfer the specified file. 
The corresponding workstation file is in use. 

Response 

Do one of the following: 

   o  Close the workstation application that is using the file, and select 
      Retry. 

   o  If the file being transferred is a Workplace Shell* object or class DLL, 
      you must de-register the class and start your workstation again to free 
      the file. 

   o  Select Cancel to cancel the installation or update of this product. 


═══ 19.4. Help for EPFIE113 ═══

Explanation 

The host session specified in the Open host catalog window is not responding to 
the installation and maintenance utility commands. 

Response 

   o  Switch to the host session and verify that the host session is available 
      and ready to accept commands. 

   o  Ensure that you selected the correct host operating system in the Open 
      host catalog window.  You can select one of the following: 

           Cancel  Cancels the entire operation 
           Retry   Issues the RECEIVE commands again 


═══ 19.5. Help for EPFIE114 ═══

Explanation 

The installation and maintenance utility cannot find a specified file at the 
source. 

Response 

Users 

Ensure that the file exists at the source and select Retry or select Cancel. 

If the problem persists, contact your system administrator. 

System administrators 

Ensure that the file exists at the source and that the catalog and package 
files for the product point to the correct files. 


═══ 19.6. Help for EPFIE115 ═══

Explanation 

The installation and maintenance utility cannot find the information necessary 
to delete or restore the selected product. Most likely, the product files were 
deleted without using the Delete or Restore actions of the installation and 
maintenance utility. 

Response 

   1. Select Cancel to cancel the Restore or Delete. 

   2. If the product files are still on your hard drive, you can delete them 
      using the OS/2* DELETE command. To restore the product, copy the files 
      from the backup subdirectory using the OS/2 COPY command. 


═══ 19.7. Help for EPFIE116 ═══

Explanation 

The installation and maintenance utility found errors while attempting to parse 
the backed-up package file. 

A valid package file is required to restore or delete the installed service 
level. 

Response 

   1. Select Cancel to cancel the Delete or Restore. 

   2. To delete the product, manually delete the files using the OS/2* DELETE 
      command.  To restore the product, manually copy the files from the backup 
      subdirectory using the OS/2 COPY command. 


═══ 19.8. Help for EPFIW124 ═══

Explanation 

The installation and maintenance utility cannot find the file specified in the 
package file to be deleted. As a result, it has not been deleted. 

This will not interfere with the installation or update. 

Response 

Select OK to continue the operation. 


═══ 19.9. Help for EPFIQ125 ═══

Explanation 

Due to cancellation or an error, the installation and maintenance utility 
transferred only part of the files necessary to run the product. 

Response 

Select one of the following: 

 Yes 
   Deletes the transferred files.  Select Yes if you do not want to try the 
   installation again. 
 No 
   Leaves the files on the workstation.  The transferred files do not have to 
   be transferred again when installation is restarted. Select No if you want 
   to try the installation again. 

   When you restart the install utility again, it will continue to download the 
   files that were not previously downloaded. 


═══ 19.10. Help for EPFIW127 ═══

Explanation 

The installation and maintenance utility cannot access the file specified 
because it exists on a disk whose format is not readable. 

Response 

   1. Select Cancel to stop the operation. 
   2. Ensure that the specified file is properly formatted. 
   3. Start the operation again. 


═══ 19.11. Help for EPFIW128 ═══

Explanation 

The installation and maintenance utility cannot delete the workstation file 
specified because it is in use. 

Response 

   1. Select Cancel to remove this message. 

   2. Ensure that the product you are attempting to install, update, delete, or 
      restore is not running. If the file being transferred is a Workplace 
      Shell* object or class DLL, you must de-register the class and restart 
      your workstation to free the file. 

   3. Wait until the specified file is free, or end the program that is using 
      the file. 

   4. Start the operation again. 


═══ 19.12. Help for EPFIE129 ═══

Explanation 

There is insufficient space on the hard disk to transfer any more files. 

Response 

   1. Make space on the hard disk by removing unnecessary files. 

   2. Select Update or Install from the Action menu to start the transfer 
      again. 

      If you are attempting an update, you may want to cancel the selection of 
      the Save a backup version check box when you try the update again to save 
      space on the hard disk. 

 or 

   1. Select Cancel to end the install or update. 

   2. Install the product on a different drive, or remove unnecessary files 
      from the current drive. 


═══ 19.13. Help for EPFIE130 ═══

Explanation 

The installation and maintenance utility cannot transfer the specified file 
because the target workstation disk is not readable or is not formatted with 
the correct file system.  This can be caused if a file with a High Performance 
File System (HPFS) name or extension is transferred to a drive formatted with 
the FAT file system. 

Response 

   1. Select the Retry push button. 
   2. Format the hard disk again if the error persists or select a different 
      drive as the target location. 


═══ 19.14. Help for EPFIE131 ═══

Explanation 

Another program is using the specified file.  The installation and maintenance 
utility is unable to overwrite or modify the file. 

Response 

   1. Ensure that the program you are installing or updating is not running. 
   2. End any programs that are accessing the file. If the file being 
      transferred is a Workplace Shell* object or class DLL, you must 
      de-register the class and restart your workstation to free the file. 
   3. Select Retry. 


═══ 19.15. Help for EPFIE132 ═══

Explanation 

The installation and maintenance utility was not able to create the directories 
in the reported path.  A file with the specified name may already exist. 

Response 

   1. Select Cancel to stop the operation. 

   2. Ensure that sufficient disk space is available on the reported hard drive 
      to create the directories. 

   3. Depending on which of the following conditions caused the error, apply 
      the corrective response: 

        o  A directory named EPFICAT.PKG exists as a subdirectory in the 
           <boot_drive>:\OS2\SYSTEM\$EPFINST path or in the 
           <boot_drive>:%EPFINSTDIR% path if the installation variable 
           EPFINSTDIR is set. 

             -  Delete the EPFICAT.PKG from the $EPFINST directory with the 
                OS/2 DEL command. 

             -  Remove the EPFICAT.PKG directory with the OS/2 RD command. 

        o  A file with the same name as one of the directories already exists. 

             -  Ensure that a file with the target directory name does not 
                already exist. 

        o  The EPFINSTDIR environment variable is set to an incorrect directory 
           name. 

             -  Ensure that the directory names are valid for the type of file 
                system on the drive. 

   4. Try the action again. 


═══ 19.16. Help for EPFIQ133 ═══

Explanation 

You are attempting to cancel the delete or restore operation in the middle of 
execution.  Doing this would leave the product in an unstable state.  If you 
proceed with the cancellation, do not use the product until you install or 
update it again. 

Response 

Select one of the following: 

 Yes  Cancels the operation 
 No   Continues with the delete or restore in progress 


═══ 19.17. Help for EPFIE134 ═══

Explanation 

The installation and maintenance utility cannot read the specified profile 
file.  Information that is critical for the current operation is stored in this 
file. 

Without this information the operation cannot be performed. 

Response 

   1. Select Cancel to cancel the operation. 

   2. Make sure the specified file is not locked by another process and try the 
      operation again.  If the error persists, delete the profile file, and try 
      the operation again. 


═══ 19.18. Help for EPFIE137 ═══

Explanation 

The installation and maintenance utility cannot copy the specified file to the 
backup directory.  This could be because: 

   o  There is insufficient disk space to back up the specified file 
   o  The specified file already exists and is in use 
   o  The backup directory could not be created 

 Response 

   1. Select Cancel to cancel the operation. 

   2. Ensure that there is sufficient disk space available on the drive 
      containing the backup directory. 

   3. Try the update again. 


═══ 19.19. Help for EPFIW138 ═══

Explanation 

An error occurred while the installation and maintenance utility attempted to 
set the date and time of the transferred file to the date and time specified in 
the package file. 

The date and time do not need to be set for the installation to be successful. 
The date and time of the file has been set to the current system date and time. 

Response 

Select OK to continue. 


═══ 19.20. Help for EPFIQ139 ═══

Explanation 

To transfer the specified file, the installation and maintenance utility needs 
to replace an existing workstation file. To avoid this message for each 
duplicate file, select Yes to all. 

Response 

Select one of the following: 

 Yes 
   Replaces the existing workstation file and continues with the installation 
   or update. 
 No 
   Does not replace the file. The installation or update continues. 
 Yes to all 
   Replaces the existing workstation file and all subsequent duplicate files 
   found on the workstation. This message will not be redisplayed. 

   The installation or update continues. 


═══ 19.21. Help for EPFIE140 ═══

Explanation 

The path you entered is not a valid path name. 

Response 

   1. Select Cancel to return to the Install-directories window. 

   2. Correct the path.  Ensure that: 

        o  The path contains a valid hard drive 
        o  The directory names are all less than or equal to 8 characters 
           (unless the drive is formatted with the HPFS file system) 
        o  The path does not end with a back slash (\) 

   3. Select the Install push button to try again. 


═══ 19.22. Help for EPFIW141 ═══

Explanation 

An error occurred while the installation and maintenance utility attempted to 
set the read-only or hidden attribute of the specified file.  Setting this 
information is not required to successfully install the product. The attribute 
has not been set. 

Response 

Select OK to continue with the operation. 


═══ 19.23. Help for EPFIE142 ═══

Explanation 

An operating system error occurred while installing, updating, or restoring the 
specified files. This could be because: 

   o  Insufficient disk space is available to copy the files. 
   o  One or more of the files being copied already exists and is in use. 

 Response 

   1. Check the amount of disk space on the hard disk that the product is 
      installed on. 

   2. Ensure that the product is not currently running. 

   3. Try the operation again. 


═══ 19.24. Help for EPFIE144 ═══

Explanation 

The installation and maintenance utility cannot load or find the DLL needed to 
continue. 

Response 

   1. Select OK to remove the message. 

   2. Check that the specified DLL is in a directory in the LIBPATH.  If the 
      install transfers the DLL, it may be necessary to add a period and 
      semicolon (.;) to the beginning of the LIBPATH statement in the 
      CONFIG.SYS file (for example, LIBPATH=.;C:\OS2\DLL;). 

   3. Start the workstation again, and then try the installation again. 

      If the DLL is part of the installation and maintenance utility, ensure 
      that it is on the same directory as all the other installation files. 


═══ 19.25. Help for EPFIE145 ═══

Explanation 

The installation and maintenance utility cannot find the function specified in 
an EXIT keyword of a FILE entry within the specified DLL. 

Response 

Users 

This problem is most likely caused by a problem with the product you are 
attempting to install or update.  Contact your system administrator. 

System administrators 

   1. Select OK to remove the message. 
   2. Check the validity of the package file. 
   3. If the error persists, contact the product service representative. 


═══ 19.26. Help for EPFIE147 ═══

Explanation 

The specified path does not contain a valid hard drive. 

Response 

   1. Select Cancel to return to the Install-directories window. 
   2. Add the appropriate drive to the path. 
   3. Select the Install push button to try again. 


═══ 19.27. Help for EPFIE148 ═══

Explanation 

The disk specified in the path does not exist or is not a hard disk. 

Response 

   1. Select Cancel to return to the Install-directories window. 

   2. Change the drive specification of the path. 

   3. Select the Install push button to try again. 


═══ 19.28. Help for EPFIE149 ═══

Explanation 

You cannot use wildcard characters (? and *) in the path specifications for 
this window. 

Response 

   1. Select Cancel to return to the Install-directories window. 

   2. Remove these characters from the path. 

   3. Select Install to try again. 


═══ 19.29. Help for EPFIE150 ═══

Explanation 

The installation and maintenance utility cannot transfer the file specified 
because there are too many files in the directory. 

Response 

   1. Delete unnecessary files from the directory. 
   2. Select Retry. 

 or 

   1. Select Cancel. 
   2. Start again using a new target directory. 


═══ 19.30. Help for EPFIE151 ═══

Explanation 

The installation and maintenance utility detected an error while communicating 
with the host. 

Response 

   1. Check the state of the host session. 
   2. Select Retry. 

 For more information on this error code, refer to the OS/2 User's Guide and 
 look up the corresponding TRANSxxx returncode. 

 If the error persists, contact the product service representative. 


═══ 19.31. Help for EPFIE152 ═══

Explanation 

The host session selected in the Host session list box on the Open host catalog 
window is not valid. 

Response 

   1. Ensure that the specified host session is active. 
   2. Try the operation again. 

 or 

   1. Select Open Catalog-Host from the File menu. 
   2. Open the product catalog again using a different host session. 


═══ 19.32. Help for EPFIE153 ═══

Explanation 

The host session being used for file transfer is already transferring a file or 
is being used by another session. 

Response 

   1. Wait until the host session is no longer busy. 
   2. Select Retry to try the operation again. 


═══ 19.33. Help for EPFIE155 ═══

Explanation 

EHLLAPI reported a system error.  This can be due to a number of communications 
problems, such as the controller is not working or the cable was unplugged. 

Response 

Check your communications setup, and try the install or update again. 

If the error persists, start the system again, and try the install or update 
again. 


═══ 19.34. Help for EPFIE156 ═══

Explanation 

The window the host session runs in is active, but the workstation is not 
connected to the host. 

Response 

   1. Ensure that host communication is established and that the host is ready 
      to accept input. 

   2. Try the operation again. 


═══ 19.35. Help for EPFIE157 ═══

Explanation 

An error occurred while the installation and maintenance utility tried to add 
the specified path to the operating system configuration file (CONFIG.SYS). 

Response 

   1. Select OK to allow the installation or update to continue. 

   2. Add the proper paths to the CONFIG.SYS file.  See the product 
      installation instructions for more information. 

      You can find a backup of the original CONFIG.SYS file in CONFIG.BAK, in 
      the drive and path where the product was installed. 


═══ 19.36. Help for EPFIE158 ═══

Explanation 

An error occurred when the installation and maintenance utility tried to add 
the specified folder to the Workplace Shell.* 

Response 

Select OK to continue transferring the files. 

You can add the group to the Workplace Shell after installation is complete. 


═══ 19.37. Help for EPFIE159 ═══

Explanation 

An error occurred when the installation and maintenance utility tried to add 
the specified program name to the Workplace Shell.* The program name may 
already exist in the designated folder. 

Response 

Select OK to continue adding the remaining files. 

You can add the program to the Workplace Shell after installation is complete. 
Refer to the OS/2* documentation for information on adding programs to the 
Workplace Shell. 


═══ 19.38. Help for EPFIQ160 ═══

Explanation 

The service level of the selected product is the same as the service level of 
the product already installed on your workstation. 

The product has already been updated to the most recent service level. It is 
not necessary to update the product again. 

Response 

Select one of the following: 

 Yes  Continues to update the product 
 No   Cancels the update 


═══ 19.39. Help for EPFIE161 ═══

Explanation 

The operating system of the host session specified in the Open host catalog 
window does not match the operating system you are using. 

Response 

From the Open host catalog window, ensure that the host session and host 
operating system match.  Then try the operation again. 


═══ 19.40. Help for EPFIE162 ═══

Explanation 

You do not have authorization to write to the drive you specified. 

Response 

Change the drive and try again or contact your system administrator for 
authorization. 


═══ 19.41. Help for EPFIE163 ═══

Explanation 

The system requires additional system resources or system memory for this 
installation program. 

Response 

   1. Select Cancel to cancel the entire operation. 

   2. End any unnecessary applications, and exit any unnecessary sessions. 

   3. Try again. 


═══ 19.42. Help for EPFIE165 ═══

Explanation 

The installation and maintenance utility is not able to execute the specified 
program. 

If this executable file is part of the installation product, it must be in the 
same directory as all the other installation and maintenance utility files. 

Response 

   1. Select Cancel to remove the message box and return to the previous 
      window. 

      For more information on the DOS return code reported, refer to the OS/2 
      2.0 Toolkit Control Program Reference. 

   2. Exit the installation program. 

   3. Change to the directory that holds the installation executable files. 

   4. Start the installation program again. 

 or 

   1. Select Cancel to remove the message box and return to the previous 
      window. 

   2. Add the directory containing the installation executable files to the 
      path statement in the CONFIG.SYS file. 

   3. Start the system again. 

   4. Start the installation program again. 


═══ 19.43. Help for EPFIE166 ═══

Explanation 

The catalog file at the source contains too many products.  No more than 80 
product packages are allowed in the catalog file. 

Response 

Users 

   1. Select Cancel to remove the message box. 
   2. Contact your system administrator. 

 System Administrators 

 Do one of the following: 

   o  Edit the catalog file on the host, and delete unnecessary products. 

   o  Split the catalog file into two or more catalog files. 


═══ 19.44. Help for EPFIE167 ═══

Explanation 

The installation and maintenance utility cannot find the catalog file at the 
source.  This could be because: 

   o  The specified file does not exist. 

   o  You do not have access to the MVS data sets, the VM mini disks, the LAN 
      drives, or the correct diskettes that contain the catalog file. 

 Response 

 Select Cancel to remove the message box and return to the previous window. 

 Do one of the following: 

   o  Contact your system administrator if the specified file does not exist at 
      the source. 

   o  Access the MVS data sets, the VM mini disks, the LAN drives, or the 
      correct diskettes that contain the catalog. 


═══ 19.45. Help for EPFIE168 ═══

Explanation 

The installation and maintenance utility encountered a syntax error while 
parsing the specified catalog file. 

Response 

Users 

   1. Select Cancel to remove the message box and return to the Open window. 

   2. Ensure that the catalog file name specified on the Open window is a valid 
      catalog file name. 

   3. If the error persists, report the problem to your system administrator. 

 System administrators 

   1. Fix the syntax error in the source copy of the host configuration file. 

   2. Select Cancel to remove the message box and return to the Open window. 

   3. Try Open again. 


═══ 19.46. Help for EPFIF169 ═══

Explanation 

The maximum number of open files allowed by the system has been exceeded. 
Transferring the specified file requires opening a new file. 

Response 

   1. Close any applications that use a large number of files. 

   2. Try the operation again. 

 If the error persists, start the system again and restart the installation 
 program. 


═══ 19.47. Help for EPFIE171 ═══

Explanation 

Too many transmission errors have occurred during the file transfer. 

This situation can be caused by a faulty communication line. 

Response 

Try the operation again.  If the error persists, call a service person to check 
the communications channel. 


═══ 19.48. Help for EPFIE172 ═══

Explanation 

The host is waiting for you to issue a reset.  Communication cannot proceed 
unless you issue a reset or the timeout interval expires. 

Response 

   1. Switch to the host session. 
   2. Issue a reset. 
   3. Try the operation again. 


═══ 19.49. Help for EPFIQ173 ═══

Explanation 

The installation and maintenance utility transferred only part of the files 
specified in the package file that are necessary to update the product.  You 
cannot use the product as it is. 

Response 

Select one of the following: 

 Yes 
   Restores the product to the state it was in before the update began.  Select 
   Yes if you do not plan to try the update again. 
 No 
   Leaves the files as they are.  Select No if you plan to try the update 
   again.  This saves time when you run the installation or update again. 


═══ 19.50. Help for EPFIQ174 ═══

Explanation 

You have requested to exit the installation and maintenance utility. 

Response 

Select one of the following: 

 Yes  Exits the utility 
 No   Returns you to the main window without exiting 


═══ 19.51. Help for EPFIF175 ═══

Explanation 

The installation and maintenance utility failed due to insufficient system 
resources. 

Response 

Close any unnecessary applications, and select Retry. 

Select Cancel if you want to leave the application. 


═══ 19.52. Help for EPFIE176 ═══

Explanation 

The installation and maintenance utility failed to create a Presentation 
Manager* window. This error could be caused by insufficient system resources or 
a lack of available memory. 

Response 

   o  Select Cancel. 
   o  Cancel any unnecessary applications and close any unnecessary sessions. 
   o  Try the operation again. 


═══ 19.53. Help for EPFII177 ═══

Explanation 

The action you requested has completed. You must restart your operating system. 

Response 

Shut down and restart your system. 


═══ 19.54. Help for EPFII178 ═══

Explanation 

The action you requested has stopped. You must restart your operating system 
and retry the requested action. 

Response 

   o  Respond to any other messages from the application. 

   o  Shut down and restart your system. 

   o  Retry the action that stopped. 


═══ 19.55. Help for EPFIE180 ═══

Explanation 

The product description file is not available at the source, or the file name 
specified by the PKGDESCRFILE keyword in the catalog file is incorrect. 

Response 

Users 

Ensure that you have access to the appropriate VM mini disks, MVS data sets, 
LAN drives, or diskettes and select one of the following: 

 Retry 
   Attempts to transfer the product description file again 
 Cancel 
   Removes the message box and returns to the main window 

 System administrators 

 Ensure that the file name specified by the PKGDESCRFILE keyword in the catalog 
 file is correct and that the file exists at the source. 


═══ 19.56. Help for EPFIQ181 ═══

Explanation 

If you have not selected the Save a backup version option, then you cannot 
restore the product to the previous service level after the Update is 
completed.  Also, if you do not select this option, and an unrecoverable error 
occurs during the update, the product will not be restored to a stable service 
level. 

Select the Save a backup version option unless workstation disk space is 
limited.  Using this option guarantees that the product can be restored to a 
stable service level if an error occurs. 

Response 

Select one of the following: 

 Yes 
   Continues with the update without saving a backup version 
 No 
   Removes the message box and returns you to the Update window where you can 
   select the Save a backup version option 


═══ 19.57. Help for EPFIE183 ═══

Explanation 

One or more of the parameters specified is not valid for a user exit. A problem 
occurred when parsing the argument variables. 

Response 

Users 

Tell the system administrator that there is a problem in the package file of 
the selected product. 

System administrators 

Examine the specified exit parameters, and correct any errors in the product's 
package file. 


═══ 19.58. Help for EPFIQ184 ═══

Explanation 

One of the selected components cannot operate correctly unless you also install 
another component. 

Response 

Select one of the following: 

 Yes 
   Installs the component required for correct operation 
 No 
   Removes the message box and returns you to the Install-directories window 


═══ 19.59. Help for EPFIQ185 ═══

Explanation 

The specified drive in the File directory field does not contain enough free 
disk space to hold the product that you are attempting to install. 

Response 

Select one of the following: 

 Yes 
   Ignores the warning and continues with the installation.  This can result in 
   an unsuccessful installation because of the lack of free disk space. 
 No 
   Removes the message box and returns to the Install-directories window. 
   After returning, perform one of the following actions: 
     1. Select a new drive to install the product on by changing the drive 
        specification in the File directory field.  To try to find a disk with 
        enough space, select the Disk space push button. 

     2. If the product contains components, select fewer components and select 
        the Install push button again. 

        Note:   Only the selected components are installed. 


═══ 19.60. Help for EPFIQ186 ═══

Explanation 

You selected to not have the CONFIG.SYS file automatically updated.  If the 
product you are installing or updating requires changes in the CONFIG.SYS file, 
the product will not run correctly after the installation or update is complete 
unless you make the necessary changes and restart your system. 

Response 

Select one of the following: 

 Yes 
   Installs the product without updating the CONFIG.SYS file.  When the product 
   installation or update has successfully completed, you must manually update 
   the CONFIG.SYS file, if this is required by the product, before it can be 
   run. 

   The information that must be added to the CONFIG.SYS will be written to a 
   file named CONFIG.ADD in the same directory as your current CONFIG.SYS. You 
   should replace your current CONFIG.SYS with the CONFIG.ADD file. 
 No 
   Removes the message box and returns to the previous window where you can 
   select the Update CONFIG.SYS option and then restart the installation or 
   update. 


═══ 19.61. Help for EPFIE187 ═══

Explanation 

An error occurred while running a routine provided by the product you are 
installing, updating, or restoring. 

Response 

Record the return code and select Cancel to exit the installation or update. 
Refer to the installation instructions of the product that you are installing 
for more information about the return code. 

If the error persists, contact your system administrator or your product 
service representative. 


═══ 19.62. Help for EPFIE188 ═══

Explanation 

An error occurred while attempting to access the file at the source. One of the 
following conditions can cause this error: 

   o  Another program or user is accessing the file or the data set containing 
      the file. 

   o  The specified file or data set does not exist at the source. 

 Response 

   1. If a host is the source, switch to the host emulator window and check the 
      host screen for any error messages. 

   2. Ensure that the specified file or data set exists. 

   3. Return to the workstation session, and try the operation again by 
      selecting the Retry push button. 

 If the error persists, wait until the host file is not in use, and try the 
 operation again. 


═══ 19.63. Help for EPFIE189 ═══

Explanation 

You did not select Save a backup version and the update failed. Therefore, the 
installation and maintenance utility cannot restore the product to a stable 
service level. 

Response 

Do not attempt to run the product until you successfully restore it to a stable 
state. 

   1. Select Cancel to remove this error message. 

   2. Return to the main window and then try to update the product again. 

   3. If the error persists, delete the product and install it again. 


═══ 19.64. Help for EPFIE190 ═══

Explanation 

The system cannot complete the print operation because of a workstation printer 
error.  This error can be caused by any of the following: 

   o  Insufficient available disk space 
   o  The printer is off line 
   o  The OS/2 * Print Manager is not running 

      Note:   The Print Manager must be active and a workstation printer must 
              be associated with LPT1 in order for the print operation to work. 


 Response 

   1. Select Cancel to remove this error message. 

   2. Ensure that the OS/2 Print Manager is set up properly and is running.  If 
      the Print Manager is not running, start it and try the operation again. 

   3. Check the OS/2 Print Manager for additional information regarding this 
      error. 


═══ 19.65. Help for EPFIE191 ═══

Explanation 

The operation cannot be completed because the specified drive could not be 
accessed. This error could be caused by any of the following: 

   o  The specified drive is a diskette drive and a disk needs to be inserted. 
   o  The drive is disconnected from the machine. 

 Response 

   1. Ensure that a disk is in the specified drive and that the drive is 
      connected. 

   2. Select the Retry push button to try the operation again. 


═══ 19.66. Help for EPFII192 ═══

Explanation 

A drive other than the default drive needs to be accessed.  This requires a 
disk change. 

Response 

Insert the required disk into the drive and select OK. If the required disk is 
already in the drive, simply select OK. 


═══ 19.67. Help for EPFIE193 ═══

Explanation 

The specified file name is not a valid OS/2* file name or it does not exist on 
the source drive.  Wildcard characters are not allowed in installation file 
names. 

Response 

If this error occurred during an open operation: 

   1. Select the Cancel push button on this error message box. 

   2. Ensure that the file name entered in the Filename field of the Open drive 
      catalog or Open host catalog window is valid. 

   3. Try the open operation again. 

 If this error occurred during another operation: 

   1. Reopen the current catalog by selecting Open catalog from the File menu. 

   2. Try the operation again. 

   3. If the error persists, contact your system administrator and report the 
      problem.  There is probably an error in the catalog or package files that 
      the installation and maintenance utility is reading. 

 System administrators 

 This error can occur if you are using a file name that contains a drive 
 specification in the HOSTLOC, PACKAGEFILE, or PKGDESCRFILE keywords in the 
 catalog file or in the FILE-SOURCE or INCLUDE-NAME keywords in the package 
 file. The file names specified in these keywords should NOT contain drive 
 letters.  Examples of valid keywords: 

  packagefile = 'drive: \wsp2\epfipkg.pkg;
                 vm: epfipkg enuepf12 *'
  pkgdescfile = 'drive: \wsp2\epfidesc.dsc;
                 vm: epfidesc enuepf12 *'
  hostloc     = 'drive: \wsp2\; vm: ;'
  source      = 'drive: file.exe; vm: file exebin *'


═══ 19.68. Help for EPFIE195 ═══

Explanation 

An error has occurred that affects the data integrity of the file being 
transferred.  The source files may be corrupted.  The installation or update 
cannot complete successfully unless this problem is fixed. 

Response 

   1. Select the Retry push button to retry the file transfer. 

   2. If the error persists, then the source files are most likely in error. 
      Contact your product service representative to obtain a new set of source 
      files. 


═══ 19.69. Help for EPFIE196 ═══

Explanation 

An error occurred while unpacking a compressed file. The installation or update 
cannot complete successfully unless this problem is fixed. 

Response 

   1. Select the Retry push button to retry the unpack operation. 

   2. If the error persists then the product is probably corrupted or in error. 
      Contact your product service representative to obtain a new set of 
      installation files or diskettes. 


═══ 19.70. Help for EPFIE197 ═══

Explanation 

An error occurred while unpacking a compressed file. The installation or update 
cannot complete successfully unless this problem is fixed. 

Response 

   1. Select the Retry push button to retry the unpack operation. 

   2. If the error persists then the product is probably corrupted or in error. 
      Contact your product service representative to obtain a new set of 
      installation files or diskettes. 


═══ 19.71. Help for EPFIE198 ═══

Explanation 

A file needed for the installation or update was not found within the 
appropriate compressed file. This error could be caused by any of the 
following: 

   o  When the compressed file was created, the specified file was not 
      included. 

   o  An error exists within the product's package file. Most likely, the FILE 
      entry that corresponds to the specified file contains a value for the 
      PACKID keyword that does not match the correct PACK file. 

 Response 

 Users: 

 Report the error to your system administrator. 

 Package file builders: 

   1. Examine the FILE entry that corresponds to the specified file and fix any 
      errors that are found. 

   2. If no errors are found in the package file, rebuild the compressed file. 
      Make sure that the specified file is included in the compressed file. 

   3. Try the operation again. 


═══ 19.72. Help for EPFIE199 ═══

Explanation 

An error exists in the product's package file. The FILE entry that corresponds 
to the specified file contains an invalid PACKID. 

Response 

Users: 

Report the error to your system administrator. 

Package file builders: 

   1. Examine the FILE entry that corresponds to the specified file and correct 
      any errors that are found.  Make sure that a PACKFILE entry exists that 
      matches the PACKID specified in the FILE entry. 

   2. Try the operation again. 


═══ 19.73. Help for EPFIE200 ═══

Explanation 

The installation and maintenance utility cannot find a specified PACK file on 
the source system.  This could be because the file is not present on the source 
system or the package file contains an error. 

Response 

Users 

   1. Select one of the following: 

           Cancel  Cancels the file transfer 
           Retry   Issues the transfer commands again 

   2. Contact your system administrator if the problem persists. 

 System administrators 

   1. Check the SOURCE keyword of the PACKFILE entry type that corresponds to 
      the specified file to ensure that the file name is correct. 

   2. If the package file is correct, ensure that the file exists on the source 
      system. 

   3. Try the operation again. 


═══ 19.74. Help for EPFIE201 ═══

Explanation 

The catalog that was opened does not contain any new products.  It contains 
only program fixes for other product(s).  Before these fixes can be applied, 
you must install the product(s). 

Response 

If you want to apply these fixes, you must first install the product(s). If you 
have already installed the product(s), it is possible that the application 
profile file has been corrupted or deleted.  If this is the case, you must 
install the products again.  When doing this installation, specify the same 
directories where the products were originally installed. 


═══ 19.75. Help for EPFIE203 ═══

Explanation 

The command line option you specified is valid, but the value specified (the 
part on the right-hand side of the equal sign) is not valid. 

Response 

Correct the command line option value and try the operation again. 


═══ 19.76. Help for EPFIE204 ═══

Explanation 

An unknown command line option was specified. 

Response 

Enter the correct command line option and try the operation again. 


═══ 19.77. Command line parameters ═══

Use the EPFINSTS command followed by one or more of the following parameters at 
the OS/2 ready prompt. 

If the value of any of the parameters contains spaces, you must use double 
quotes to enclose the value. 

The parameters can be specified in any order. 

 Parameter Description 

 /A=action 
           Specifies the action to be performed. 

           If this parameter is present with a valid value, the main 
           installation utility window is not displayed.  In this case, windows 
           are displayed directly on the OS/2* Workplace Shell. 

           If you do not use this parameter, the installation and maintenance 
           utility starts normally with all windows displayed. Values can be 
           upper or lower case. Valid values for this parameter are: 

                d         For delete 

                i         For install 

                r         For restore 

                u         For update 

           Use of this parameter requires that the /P parameter also be 
           specified. 

 /C=catfilename 
           Specifies the name and location of the catalog file. 

           If the catalog file is located on a host system, the host session ID 
           must precede the catalog file name. 

           If the catalog file is located on a diskette, LAN, or AS/400 Shared 
           folder, a drive and directory must precede the catalog file name. 

           The following are examples of the /C parameter for each source: 

                Drive 
                     /C=Z:\EPFICAT.CAT 

                MVS 
                     /C=B:EPF.V1R1M0.SEPFBENU(EPFICAT) 

                VM 
                     /C="B:EPFICAT ENUEPF11 *" 

                VSE 
                     /C=B:LIB.SIBLIB.MEMBERNAME.MEMBERTYPE 

           If this parameter is present, the specified catalog file is 
           automatically opened. 

 /G:include path 
           Specifies the drive and path of the general response files that are 
           included by the specific response file. 

           The installation and maintenance utility sets the EPFIGENRESPDIR 
           installation variable to the include path. 

           Example: 

                         /G:L:\XYZ

 /L=xpos,ypos 
           Specifies the initial x and y coordinates of the Installation and 
           Maintenance window on the desktop relative to the lower-left corner 
           of the screen. 

           If this parameter is specified, all previously saved default 
           positions are overridden. 

 /L1:error log 
           Specifies the drive, path, and file name of the destination of the 
           error log file. 

           The installation and maintenance utility sets the EPFIERRORLOG 
           installation variable to the error log. 

           If drive and path are not specified, the drive and path where 
           EPFINSTS.EXE is running is used. If file name is not specified, 
           errors are logged to EPFINSTS.OUT. 

           Example: 

                         /L1:C:\ABC\ERROR.LOG

 /L2:history log 
           Specifies the drive, path, and file name of the destination of the 
           history log file. 

           The installation and maintenance utility sets the EPFIHISTORYLOG 
           installation variable to the history log. 

           If drive and path are not specified, the drive and path where 
           EPFINSTS.EXE is running is used. 

           If this parameter is not specified, no history log is maintained. 

           Example: 

                         /L2:C:\ABC\HISTORY.LOG

 /L3:  /L4:  /L5:log files 
           Each of these parameters can contain a drive, path, and file name of 
           a log file. They are preserved in installation variables EPFIL3LOG, 
           EPFIL4LOG, and EPFIL5LOG for your use. 

 /P=prodname 
           Specifies the name of the product on which the action is performed. 

           If the product name contains spaces, it must be enclosed in double 
           quotes ("). 

           Sample valid product name specifications: 

                /P="Product name with spaces" 
                /P=productname 

 /R:response file 
           Specifies the drive, path, and file name of the specific response 
           file. 

           The installation and maintenance utility sets the EPFIRESPFILE 
           installation variable to the response file. 

           Example: 

                         /R:L:\XYZ\RESPONSE.DAT

 /O=source environment 
           Specifies the source environment (origin) of the installation or 
           update. Valid values for this parameter are: 

             o  DRIVE 
             o  MVS 
             o  VM 
             o  VSE 

           This parameter is ignored for a delete or restore action. 

 /S:source location 
           Specifies the drive and path that contain the source files to be 
           installed. 

           The installation and maintenance utility sets the EPFISOURCEDIR 
           installation variable to the source location. 

           Specifying this parameter sets the /S parameter to DRIVE and 
           overrides the value of the HOSTLOC keyword in the product's catalog 
           file. 

           If this parameter is not specified the value of the HOSTLOC keyword 
           is not overridden. 

           Example: 

                         /S:L:\XYZ

 /T:install target directory 
           Specifies the drive and path of that the product files are installed 
           into. 

           This parameter only affects the value of the FILE directory 
           (directory corresponding to the FILELABEL keyword). 

           The installation and maintenance utility sets the EPFITARGETDIR 
           installation variable to the install target directory. 

           Example: 

                         /T:C:\IBB

 / TU:update target CONFIG.SYS directory 
           Specifies the drive and path of the target CONFIG.SYS to be updated. 

           The installation and maintenance utility sets the EPFITARGETCNF 
           installation variable to the update CONFIG.SYS target directory. 

           If this parameter is not specified the CONFIG.SYS files are updated 
           as specified in the product's package file. 

           Example: 

                         /TU:C:\

 /X 
           Specifies that the action is unattended. 

           When you specify this parameter no progress indication is shown. 

           If information needed for the action to complete is not specified, 
           an error occurs. If you specify /L1:, all error messages are logged 
           to the error log file specified.  If /L1: is not specified, error 
           messages are logged to the EPFINSTS.OUT file. 

           If this parameter is not specified, the user will be prompted for 
           any information that is needed for the action to complete. In this 
           attended mode of operation, progress indication is shown, and error 
           messages are displayed to the user in message boxes. 


═══ 19.78. Response file parameters ═══

In general, the format for parameters within a response file is parameter = 
value. 

Only one parameter can be specified per line and parameters can occur in any 
order. 

The following parameters are valid in an installation response file. 

 Parameter  Description 

 auxn 
            Specifies the new default path for the auxiliary directory where n 
            is any number between 1 and 18. (Thus there are 18 possible 
            auxiliary directories: AUX1, AUX2,...AUX18.) Use this parameter 
            only for an install action. 

 comp 
            Specifies a component within the product for which the operation is 
            to be performed.  Use multiple comp parameters to specify more than 
            one component.  Invalid components are ignored. 

 cfgupdate 
            Specifies whether the CONFIG.SYS file is automatically updated. 
            Valid values for this parameter are AUTO (automatically update 
            CONFIG.SYS) or MANUAL (do not update CONFIG.SYS). This parameter is 
            used only for install or update actions and is ignored if any other 
            action is specified. 

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

                          COPY = from_filespec to_filespec

            Where from_filespec is the source file and to_filespec is the 
            target file.  If the to_filespec already exists, it is overwritten. 
            If either file specification is not valid, the copy is not 
            performed. 

 deletebackup 
            Specifies whether to delete only the backup versions of the product 
            or to delete the entire product. Valid values for this parameter 
            are YES or NO.  This parameter is used only for a delete action and 
            is ignored if any other action is specified. 

 file 
            Specifies the FILE directory that the product is to be installed 
            into.  This parameter is used only for an install action and is 
            ignored if any other action is specified. 

 include 
            Specifies the which general response files to include with a 
            specific response file. The format of this parameter 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 which matches the specification is included.  If 
            the specification is not valid, no general response file is 
            included. 

            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 
            Specifies whether to automatically overwrite files during 
            installation.  Valid values for this parameter are YES or NO. This 
            parameter is used only for an install action and is ignored if any 
            other action is specified. 

 savebackup 
            Specifies whether to save a backup version of the product when it 
            is updated. Valid values for this parameter are YES or NO.  This 
            parameter is used only for an update action and is ignored if any 
            other action is specified. 

 userexit 
            Specifies the name of a user exit that you want started. The format 
            of this parameter is: 

                          USEREXIT = filespec

            Where filespec is the name of a user exit. If the file 
            specification contains any global characters (* or ?), the first 
            executable found which matches the specification is started.  If 
            the specification is not valid, no user exit is started. 

            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 

 work 
            Specifies the WORK directory that will be used during product 
            installation.  This parameter is used only for an install action 
            and is ignored if any other action is specified. 


═══ 19.79. Help for EPFIE205 ═══

Explanation 

The installation that was requested cannot be performed because the specified 
product has already been installed. A product cannot be installed more than 
once on a workstation. 

Response 

To install a new version of the product, you must first delete the current 
version.  Refer to the product's documentation for further information. 

If you are attempting to apply a program fix, use the Update action. 


═══ 19.80. Help for EPFIE206 ═══

Explanation 

An unrecognized parameter was found within the specified response file. 

Response 

Enter the correct response file parameters and try the operation again. 


═══ 19.81. Help for EPFIE207 ═══

Explanation 

The response file parameter specified is valid, but the value specified (on the 
right-hand side of the equal sign) is not valid. 

Response 

Correct the response file parameters and try the operation again. 


═══ 19.82. Help for EPFIE208 ═══

Explanation 

More than 100 component parameters exist within the response file. A maximum of 
100 component parameters are allowed. 

Response 

Remove unneeded component parameters from the response file and try the 
operation again. 


═══ 19.83. Help for EPFIE210 ═══

Explanation 

The requested operation cannot be performed because the product name specified 
is not valid.  The product name specified as the value of the /p parameter must 
exactly match the product name as it appears in the product list.  If the 
product name contains spaces then it must be enclosed within double quotes ("). 

Sample valid product name specifications: 

      /p="Product name with spaces" 
      /p=productname 

 Response 

 Correct the /p parameter and try the operation again. 


═══ 19.84. Help for EPFIE211 ═══

Explanation 

The operation requested from the command line options cannot be performed 
without the /p parameter.  A product name must be specified when performing an 
install, update, restore, or delete. 

Response 

Add a /p parameter to specify a product name and try the operation again. 


═══ 19.85. Help for EPFIE212 ═══

Explanation 

The /x command line option specified that a completely unattended installation 
be performed, but not enough information was specified. In order for the 
operation to complete successfully, all the information needed to complete the 
operation must be specified on the command line or in the response file. 

Response 

   1. Try the command again omitting the /x parameter. This allows the 
      installation and maintenance utility to prompt for the missing 
      information. 

   2. After seeing what information is missing, specify this missing 
      information using command line options and response file parameters. 

   3. Try the command again using the /x parameter. 

   4. If the operation is not successful, repeat this procedure starting from 
      step 1. 


═══ 19.86. Help for EPFIE213 ═══

Explanation 

The update operation requested from the command line options cannot be 
performed because the specified product is not installed. A product cannot be 
updated unless it has been installed. 

Response 

If you want to update the product, you must first install it. Refer to the 
documentation for your product for further information on installation. 


═══ 19.87. Help for EPFIE214 ═══

Explanation 

The delete operation requested from the command line options cannot be 
performed because the specified product is not installed. A product cannot be 
deleted unless it has been installed. 

Response 

If you have installed the product, it is possible that the application profile 
file has been corrupted or deleted.  If this is the case, you must install the 
product again and then delete it.  When doing this second installation, specify 
the same directories where the product was originally installed.  The 
installation will go very quickly since no files will need to be transferred. 


═══ 19.88. Help for EPFIE215 ═══

Explanation 

The restore operation requested from the command line options cannot be 
performed because the specified product has not been installed and updated. A 
product cannot be restored unless it has been installed and then updated at 
least once (with the Save a backup version option selected). 


═══ 19.89. Help for EPFIQ216 ═══

Explanation 

A selected component (or component backup) cannot be deleted because another 
component is dependent upon it. 

Response 

Select one of the following: 

 Yes 
      Deletes the dependent component. 
 No 
      Exits the error message box and returns you to the Delete window.  You 
      can cancel the selection of the specified component and try the deletion 
      again. 


═══ 19.90. Help for EPFIE218 ═══

Explanation 

The requested action requires the HLLAPI interface to Communications Manager, 
but the HLLAPI DLL (ACS3EHAP.DLL) cannot be loaded. 

Response 

   1. Ensure that you have Communications Manager installed, including the 
      HLLAPI programming interfaces. 

   2. If HLLAPI is installed, ensure that the LIBPATH statement in your 
      CONFIG.SYS file is set so that it contains the path where the HLLAPI DLL 
      is located.  If a change is required to the CONFIG.SYS file, you must 
      restart your workstation in order to activate the change. 

   3. Try the operation again. 


═══ 19.91. Help for EPFIE219 ═══

Explanation 

A catalog or package file has been recursively included by another catalog or 
package file, causing an infinite loop. 

The simplest example of this problem is a product that contains two package 
files, A and B.  If package file A includes package file B and package file B 
includes package file A, then an infinite loop results. 

Response 

Remove the INCLUDE entry that is causing this problem from the catalog or 
package file and try the operation again. 


═══ 19.92. Help for EPFIE220 ═══

Explanation 

The /o command line option must be specified if the /c command line option is 
used.  The /o option specifies the source of the open operation (VM, MVS, VSE, 
or Drive) and is required to correctly perform the open operation. 

Response 

Specify the source of the operation by using the /o command line option and 
then try the operation again. 


═══ 19.93. Help for EPFIE223 ═══

Explanation 

Most likely the selected product was installed using a previous version of the 
installation and maintenance utility.  The current version of the installation 
and maintenance utility requires additional information to complete the 
requested operation. 

Response 

To obtain the additional information, open the catalog that the selected 
product is in. After the open is complete, select the product and try the 
operation again. 


═══ 19.94. Help for EPFIE224 ═══

Explanation 

You can only enter a drive letter followed by a colon (for example, C:). 

Response 

   o  Correct the entry. 

   o  Try the operation again. 


═══ 19.95. Help for EPFIE225 ═══

Explanation 

A temporary directory to hold deferred installation files cannot be created. 
This can occur for the following reasons: 

   o  The drive is not recognized. This can be caused if a file with a High 
      Performance File System (HPFS) name or extension is transferred to a 
      drive formatted with the FAT file system. 

   o  Another application is using the drive. 

 Response 

   1. Try one of the following: 

        o  Select a different drive. 

        o  Format the drive. 

        o  Wait until the other application is finished. 

   2. Try the operation again. 


═══ 19.96. Help for EPFIE226 ═══

Explanation 

The deferred installation command file cannot be written to. Another program 
might be using this file, or there is no more disk space on the boot drive. 

Response 

   1. Check the disk space. 
   2. Close any program using the file. 
   3. Try the operation again. 


═══ 19.97. Help for EPFIE227 ═══

Explanation 

The deferred installation preparation failed because CONFIG.SYS is a read-only 
file or there is not enough disk space on the boot drive. 

Response 

   1. Ensure that your CONFIG.SYS is not a read-only file. 
   2. Remove some files from the boot drive. 
   3. Try the operation again. 


═══ 19.98. Help for EPFIE232 ═══

Explanation 

The specified expression is not valid.  This could be for one of the following 
reasons: 

   o  Parentheses are mismatched.  Either a left parenthesis exists without a 
      matching right parenthesis or vice versa. 
   o  The syntax of the expression is not correct.  An operator may be missing 
      an operand, or an operand may exist without an operator. 
   o  Evaluation of the expression causes a division by zero to occur. 

 Response 

   1. Correct the expression within the package file. 
   2. Try the operation again. 


═══ 19.99. Help for EPFIE233 ═══

Explanation 

One of the operators in the specified expression has operands of different 
types.  All operators require that the operands be of the same type. Examples 
of expressions that contain operand type conflicts are: 

 "string" == 123
 "string" / "string"
 ("string" == "string") && "string2"

Response 

   1. Correct the expression within the package file. 
   2. Try the operation again. 


═══ 19.100. Help for EPFIE234 ═══

Explanation 

The CREATEWPSOBJECT installation exit could not create the specified object. 
The object may already exist on the desktop. 

Response 

   1. Specify 'R' for the replace parameter in the package file. 
   2. Verify that the parameters in the setup string are valid for the object 
      class for which you are creating an instance. 
   3. Try the operation again. 


═══ 19.101. Help for EPFIW235 ═══

Explanation 

Without the current level of OS/2 2.0 installed, your product installation may 
cause your workstation to hang. 

Response 

Install the current version of OS/2 (CSD XR06055 or above). 


═══ 19.102. Help for EPFIE236 ═══

Explanation 

The specified drive does not have enough space to save a backup. 

Response 

   1. Make space on the drive. 
   2. Select Retry. 
 or 

 Select Cancel. 


═══ 19.103. Help for EPFIW237 ═══

Explanation 

The value specified for the indicated log parameter cannot be used.  The value 
is invalid if the log file cannot be created on the specified drive and path, 
or if the specified log file cannot be appended to.  Possible causes are: 

   o  The specified drive does not exist 

   o  The specified drive, directory, or file is read-only. 

 Response 

 Do one of the following: 

   o  Select OK to continue without writing to the indicated log 

   o  Select Cancel to cancel the action, then re-invoke using a valid value 
      for the indicated log. 


═══ 19.104. Help for EPFIW238 ═══

Explanation 

The value specified for the indicated log parameter cannot be used but the 
displayed alternate value will be used if you continue.  The provided value is 
invalid if the log file cannot be created on the specified drive and path, or 
if the specified log file cannot be appended to.  Possible causes are: 

   o  The specified drive does not exist 

   o  The specified drive, directory, or file is read-only. 

 Response 

 Do one of the following: 

   o  Select OK to continue processing using the displayed alternate value 

   o  Select Cancel to cancel the action, then re-invoke using a valid value 
      for the indicated log. 


═══ <hidden>  ═══

Trademark of