The Developer Connection…ice Driver Kit for OS/2 3/DEV3-D1.ISO/devtools/softinst/install.in_/epfihplb.hlp

OS/2 Help File | 1993-10-15 | 84.1 KB | 3,597 lines

ΓòÉΓòÉΓòÉ 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 Indicator 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 indicator 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. If
wildcard characters are included in the catalog file name specification, select
OK to return to the Open drive catalog window.

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 Indicator 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 indicator 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 workstation target file of the transfer. The
installation and maintenance utility cannot overwrite 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.  This
can be caused by one of the following conditions:

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

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

Response

 1. Select Cancel to stop the operation.

 2. Ensure that a file with the specified directory name does not already
    exist.

 3. Ensure that sufficient disk space is available on the reported hard drive
    to create the directories and that the directory names are valid for the
    type of file system on the drive.

 4. Try the installation or update 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.

Response

Select one of the following:

OK
  Replaces the existing workstation file, and continues with the installation
  or update.
Cancel
  Cancels the entire installation or update.  You can restart the operation and
  select the Overwrite files check box on the Install or Update window to
  enable automatic replacement of existing files, or you can restart and select
  a different target location that doesn't contain existing files with the same
  names as the product files.


ΓòÉΓòÉΓòÉ 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

Select the Retry push button on the error message box to try the operation
again.  If the error persists, follow the appropriate instructions:

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 EPFII201 ΓòÉΓòÉΓòÉ

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.

/F=responsefile
          Specifies the drive, path, and name of the specific response file on
          the workstation that is read for additional information.

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

          The function of /F is the same as /R:. If both are specified, /R:
          takes precedence over /F.

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

          The function of the /R: parameter is the same as the /F parameter. If
          both are specified, /R: takes precedence over /F. If neither /F nor
          /R: is used, no response files are used.

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

          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 /L:, all error messages are logged to
          the error log file specified.  If /L: 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
          interactive 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 EPFII205 ΓòÉΓòÉΓòÉ

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

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 50 component parameters exist within the response file. A maximum of
50 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 EPFII211 ΓòÉΓòÉΓòÉ

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 EPFII212 ΓòÉΓòÉΓòÉ

Explanation

The /x command line option specified that a completely noninteractive
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 EPFII213 ΓòÉΓòÉΓòÉ

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 EPFII214 ΓòÉΓòÉΓòÉ

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 EPFII215 ΓòÉΓòÉΓòÉ

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 EPFII220 ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of