Table of Contents for Help

The following is list of the panels and menu choices provided by the installation and maintenance utility.  You can see more information about each topic by clicking on the topic.

Error messages

Installation and Maintenance

File

View

Details

Action

Help

Open drive catalog

Drive

Catalog filename

Description

Search

Open

Search

Catalog filename

Drive

File

Directory

OK

Description

Product Status

Cancel

Product status

Directories installed in

Service level

Currently installed components

Disk space

Available space

Cancel

Install

Update CONFIG.SYS/AUTOEXEC.BAT

Overwrite files

OK

Install-File Errors

Retry

Print

Install-directories

Install-directories(initial installation)

Install-directories(subsequent installations)

Descriptions

Select all

Deselect all

Directory

Disk Space

Install

Component

Update

Save a backup version

Update

Restore

Restore

Delete

Components

Delete only the backup versions

Delete (push button)

Service level

Service level list

Print

Cancel

Insert disk

Drive

Continue

Progress (Install or Update)

Stop

Progress (Restore or Delete)

Stop


Installation and Maintenance Utility

The installation and maintenance utility installs, updates, restores, or deletes programmable workstation products.

1.  Select Open catalog from the File pull-down menu to obtain a catalog of installable products (list of products) on a particular system.

2.  Select a product from the list to do one of the following:

•  Install the product

•  Update the to a new service level

•  Restore a previously saved service level of the product

•  Delete the product from the workstation


File

Select the File menu bar choice to:

•  Open or refresh a catalog of installable products (product list)

•  Exit the installation and maintenance utility


opening a catalog;Open catalog;product list
Open catalog

Select Open catalog from the File pull-down menu to open a catalog of installable products.

You must open a product list before you can install or update a product.


Exit

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


Details

Select the Details menu bar choice to see:

•  A description of the selected product

•  The status and service level of the selected product on the workstation

•  The disk space required to install the selected product


Product description

Select Product description from the Details pull-down 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.


Product status

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

•  Product name

•  Product number

•  Version, release, and modification currently installed on the workstation

•  Feature currently installed on the workstation

•  Components, if any, installed on the workstation

•  Service levels installed on the workstation

•  Drive and directories that the product is installed in

Each of the entries in the Directories installed in box is horizonally scrollable using the mouse or keyboard.

The Directories installed in box is vertically scrollable using the mouse or the keyboard.

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


Disk space

Select Disk space from the Details pull-down menu to see:

•  Amount of space required to install the selected product

•  Total amount of disk space available on your workstation drives

•  If installation is possible on a selected workstation drive

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.

CAUTION:  If you are connected to a LAN that has a drive for removable media such as CD-ROM or optical disk, make sure there is a disk in that drive before choosing the Disk space button.  Otherwise, unpredictable results will occur.

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.


Action

Select the Action menu bar choice to:

•  Install the selected product

•  Update the selected product to a new service level

•  Restore a previously saved service level of the selected product

•  Delete the selected product from the workstation


Install

Select Install from the Action pull-down menu to install the selected product.

When you select Install:

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

2.  The Install -directories window requests 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 displays the progress of the installation.

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.  The Install choice is not available if all of the components of a product are installed.


Update

Select Update from the Action pull-down 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.


Restore

Select Restore from the Action pull-down 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 window displays the progress of replacing the files from the previous service level to the current 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.


Delete

Select Delete from the Action pull-down menu to delete the selected product from the workstation.

If the product contains components, specific components can be selected for deletion.

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

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 will be 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.


View

Select the View menu bar choice to change the list of products displayed in the main window list.

You can:

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

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

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


Current catalog

Select Current catalog from the View pull-down 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.

Installed or updated products that are not in the current catalog are not displayed in this list.


Installed products

Select Installed products from the View pull-down menu to look at the products that have at least one component installed.

All installed products are displayed in this list regardless of where 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).


Updated products

Select Updated products from the View pull-down 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 where they were installed from.


Help

Select this action to get to the following help:

•  Contents

•  Search for Help On...

•  Keys Help

•  How to Use Help


Keys Help

Select the type of keys help you need from the following:

Window keys

Editing keys

Application keys

Text selection keys


Window keys

These are the window keys 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


Editing keys

These are the editing keys 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


Application keys

These are the application keys definitions:

F1

Gets help

F3

Ends installation

Ctrl+D

Displays a description of the selected product

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


Text selection keys

These are the text selection keys 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

Shift+Ctrl+Home

Selects text or extends a selection to the beginning of the file

Shift+Ctrl+End

Selects text or extends a selection to the end of the file


Open drive catalog

Use the Open drive catalog window to query a list of available products from a diskette drive, a CD ROM drive, or a LAN drive.

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


Drive

Select the drive that contains the catalog file.

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


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 DOS file name without a drive specification.

Sample catalog file names:

\packages\epficat.icf

\catalog.icf


Description

Select Description 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 catalog file selected in the Filename field.


Search

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


Open

Select Open 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.


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

Product number

The 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 Directories installed in box is vertically scrollable using the mouse or keyboard.

Select Service level to display the product's service level.


Cancel

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


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 fixed disks, and it reports whether installation is possible on the specified drive.

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

1.  Select the fixed 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 fixed 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.

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.

The fields in the Disk space window are:

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


Available space

Use the Available space list box in the Disk space window to look at the amount of unused space on each workstation fixed disk.  Use this information 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.

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.


Cancel

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


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

Update CONFIG.SYS/AUTOEXEC.BAT

You can set options to have your AUTOEXEC.BAT file automatically updated.

If you choose this option, a backup of your original AUTOEXEC.BAT is saved in C:\AUTOEXEC.BAK where C is the drive that WINDOWS is installed on.

If you choose not to have it automatically updated, a sample AUTOEXEC.ADD file will be placed in the same directory as your AUTOEXEC.BAT file. In this case, you must manually update your CONFIG.SYS and AUTOEXEC.BAT files.

This installation will NOT make any changes to your CONFIG.SYS.

Overwrite files

This option controls whether you are prompted before files with the same name and location are overwritten.  If you do not check this box, a confirmation message will display before writing over each existing file.

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


Update CONFIG.SYS/AUTOEXEC.BAT

Select the Update CONFIG.SYS/AUTOEXEC.BAT check box to allow the installation and maintenance utility to update or modify your CONFIG.SYS and AUTOEXEC.BAT files.

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

Note:  A backup of your original CONFIG.SYS file is saved in C:\CONFIG.BAK where C is the drive that WINDOWS is installed on.  A backup of your original AUTOEXEC.BAT is saved in C:\AUTOEXEC.BAK where C is the drive that WINDOWS is installed on.


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 select this choice, the installation and maintenance utility prompts you before writing over an existing workstation file.


OK

Select OK 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.


Install File Errors
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 Print.  Then contact your system administrator or product distributor.


Retry

Select Retry 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.


Print

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

Make sure that the workstation printer is connected and turned on.


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 specify where the files are transferred to on your workstation.

You can scroll the directories using either the mouse or keyboard.

Remember that the fixed disks specified in the directories must have space available to store the transferred files.  You can determine the amount of disk space a product requires and the amount of disk space available for all your fixed disks by selecting Disk space.

CAUTION:  If you are connected to a LAN that has a drive for removable media such as CD-ROM or optical disk, make sure there is a disk in that drive before choosing the Disk space button.  Otherwise, unpredictable results will occur.

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.

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


Install-directories

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

You can change the directories to specify where the files are transferred to on your workstation.

You can scroll the directories using either the mouse or keyboard.

Remember that the fixed disks specified in the directories must have space available to store the transferred files.  You can see how much disk space is required to install the selected components by selecting Disk space.

CAUTION:  If you are connected to a LAN that has a drive for removable media such as CD-ROM or optical disk, make sure there is a disk in that drive before choosing the Disk space button.  Otherwise, unpredictable results will occur.

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.

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


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.

You can scroll the directories using either the mouse or keyboard.

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.

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

CAUTION:  If you are connected to a LAN that has a drive for removable media such as CD-ROM or optical disk, make sure there is a disk in that drive before choosing the Disk space button.  Otherwise, unpredictable results will occur.

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.

Select Install to install the selected components.


Directory

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

You can scroll the directories using either the mouse or keyboard.

The maximum directory length is 128 characters.

•  Valid sample directories:

C:\IBMRM

D:\

D:\TOOLS\KEDIT

•  Sample directories that are not valid:

\IBMRM

C:\TOOLONGPATH

C:\IBMRM\


Disk space

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

CAUTION:  If you are connected to a LAN that has a drive for removable media such as CD-ROM or optical disk, make sure there is a disk in that drive before choosing the Disk space button.  Otherwise, unpredictable results will occur.

Select the Change directories to selected drive check box to change the directories used for installation on the Install-directories window.


Install

Select Install in the Install-directories window to install the product in the specified directories.


Component

The Component list box in the Install-directories window shows you a list of the installable components for the selected product (if your product has components).

Select the components you want to install.  Next, select Install to begin installation.

You can also select Disk space to see how much workstation disk space the selected components require.

CAUTION:  If you are connected to a LAN that has a drive for removable media such as CD-ROM or optical disk, make sure there is a disk in that drive before choosing the Disk space button.  Otherwise, unpredictable results will occur.


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/AUTOEXEC.BAT to automatically update your CONFIG.SYS and AUTOEXEC.BAT files.

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 should restore to a previous service level if a new service level results in undesired behavior.

Note:  Do not select this option if disk space is not available to store the backup files.

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

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.


Save a backup version

Select Save a backup version 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.

Note:  Do not select this option unless disk space is available to store these backup files.

If this option is selected, the saved backup can be deleted by using the Delete only the backup versions option on the Delete window.


Update

Select Update 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 product's package file

2.  Updates the product by replacing the product files with the newer level files


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 a long time.

Error occurred

An error occurred.  Press Stop 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.


Stop

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


Restore

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

Product name

The name of the product

Product number

The 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 Service level on the Product status window.

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


Restore

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

Warning:  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.


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 product number assigned to the product

Version

The version, release, and modification number of the product

Feature

The feature number of the product

Select Delete to delete the product and any backed up versions of the product.

If you select Delete only the backup versions , only the backup version of the product will be deleted.  The current version will not be deleted.


Delete

Select Delete to delete the selected product or components.

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


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.


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.


Service level

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


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 Components list.


Currently installed components

This list contains the components that have been installed for the specified product.

Select a component in the list and then select Service level to see the current service level of a component.


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

Product number

The 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

The names of the product's components that have already been installed on the workstation

Directories installed in

The directories where the product was installed

The scrollable fields can be scrolled using either the mouse or the keyboard.

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


Service level

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

The displayed information can be printed by selecting Print.


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 origin that can be displayed is:

Drive

The service level was applied from a diskette drive, a CD ROM drive, or LAN drive.


Print

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


Cancel

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


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.


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.


Drive

This combination box specifies the drive that is to be searched.

If you select a different drive from the list of drives, then the Directories and File list boxes are updated to reflect the directories and files that exist on the selected drive.


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


Directory

This list box contains a list of the directories on the drive you want to search.

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.

You can scroll the Directory list box vertically.


OK

Select OK to return to the Open drive catalog window.

The catalog file name you selected is placed in the Filename field.


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 diskette needs to be inserted during an installation.


Drive

Use this drop-down combination box to specify the drive where you insert the requested disk.

The box contains a list of all available drives.  The default drive 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.


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.


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.


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

Select the components to be deleted, then select Delete 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.


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 Delete to delete the components.


Select all

Select all causes all items displayed in the list box to be selected.

This push button is disabled if all the components in the list box are selected.


Deselect all

Deselect all causes all items displayed to be deselected in the list box.

This push button is disabled if none of the components is selected.


Progress (Restore or Delete)

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

This window contains:

Title line

The product name and component of the product being restored or deleted.

Progress box

Information on the progress of the operation.

Status

The current status of the restore or delete.  The possible values for this field are:

Processing

The installation and maintenance utility is executing a task that can take a long time.

Error occurred

An error occurred.  Select Stop to cancel the operation.

Deleting files

The program is deleting 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.


Descriptions

Descriptions shows a Descriptions window that contains a brief description of each component in the list.

If a description is not available, the window is displayed with text stating that the description is not available.


Stop

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


Error messages

Click on the message identifier in the following list for an explanation of that message.

EPFIE107

EPFIE112

EPFIE114

EPFIE115

EPFIE116

EPFIW124

EPFIQ125

EPFIW127

EPFIW128

EPFIE129

EPFIE130

EPFIE131

EPFIE132

EPFIQ133

EPFIE134

EPF0135

EPF0136

EPFIE137

EPFIW138

EPFIQ139

EPFIE140

EPFIW141

EPFIE142

EPFIE144

EPFIE145

EPFIE147

EPFIE148

EPFIE149

EPFIE150

EPFIE157

EPFIE158

EPFIE159

EPFIQ160

EPFIE162

EPFIF163

EPFIE165

EPFIE166

EPFIE167

EPFIE168

EPFIF169

EPFIE171

EPFIQ173

EPFIQ174

EPFIF175

EPFIE176

EPFIE180

EPFIQ181

EPFIE183

EPFIQ184

EPFIQ185

EPFIQ186

EPFIE187

EPFIE188

EPFIE189

EPFIE190

EPFIE191

EPFII192

EPFIE193

EPFIE195

EPFIE196

EPFIE197

EPFIE198

EPFIE199

EPFIE200

EPFII201

EPFIE202

EPFIE203

EPFIE204

EPFII205

EPFIE206

EPFIE207

EPFIE208

EPFIE210

EPFII211

EPFII212

EPFII213

EPFII214

EPFII215

EPFIQ216

EPFIE219

EPFII220

EPFIE223

EPFIE224

EPFIE225

EPFIE226

EPFIE227

EPFIE232

EPFIE233


Help for EPFIE107

Explanation

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

Response

Users:

Ensure that you 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.


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:

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

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


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.


Help for EPFIE115

Explanation

The installation and maintenance utility cannot find the backup package file that is 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 fixed disk, you can delete them by using the DOS DELETE command.  To restore the product, copy the files from the backup subdirectory using the DOS COPY command.


Help for EPFIE116

Explanation

The installation and maintenance utility found errors while attempting to parse the backup 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, delete the files using the DOS DELETE command.  To restore the product, copy the files from the backup subdirectory using the DOS COPY command.


Help for EPFIW124

Explanation

The installation and maintenance utility cannot find the file specified in the package file to be deleted.

This will not interfere with the installation or update.

Response

Select OK to continue the operation.


Help for EPFIQ125

Explanation

Because of 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 installation utility, it will continue to download the files that were not previously downloaded.


Help for EPFIW127

Explanation

The installation and maintenance utility cannot access the file specified because it exists on a diskette 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.


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.

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

4.  Start the operation again.


Help for EPFIE129

Explanation

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

Response

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

2.  Select Update or Install from the Action pull-down 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 fixed 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.


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 occur when a file with a High Performance File System (HPFS) name or extension is transferred to a drive formatted with the file allocation table (FAT) file system.

Response

1.  Select Retry.

2.Format the fixed disk again if the error persists or select a different drive as the target location.


Help for EPFIE131

Explanation

Another program is using the workstation target file.  The installation and maintenance utility cannot overwrite the file that is in use.

Response

1.  Ensure that the program you are installing or updating is not running.

2.  End any programs that are accessing the target file.

3.  Select Retry.


Help for EPFIE132

Explanation

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

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 fixed disk 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.


Help for EPFIQ133

Explanation

You are attempting to cancel the delete or restore processing 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

Cancel the operation

No

Continue with the delete or restore that is in progress


Help for EPFIE134

Explanation

The installation and maintenance utility cannot read the specified profile file.

Information that is necessary for current processing is stored in this file.

Without this information the requested process 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.

3.  If the error persists, delete the profile file, and try the operation again.


Help for EPF0135

Explanation

The product you installed might have changed your CONFIG.SYS or AUTOEXEC.BAT files.

Response

1.  Start the installed product.

•  If it does not start or does not run correctly, restart your workstation.

•  If the installed product does not start or run correctly after restarting your system, call your product administrator.

2.  If the product runs without problem, no further action is required.


Help for EPF0136

Explanation

The product you updated might have changed your CONFIG.SYS or AUTOEXEC.BAT files.

Response

1.  Start the updated product.

•  If it does not start or does not run correctly, restart your workstation.

•  If the updateed product does not start or run correctly after restarting your system, call your product administrator.

2.  If the product runs without problem, no further action is required.


Help for EPFIE137

Explanation

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

•  There is insufficient disk space to back up the specified file

•  The specified file already exists and is in use

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


Help for EPFIW138

Explanation

An error occurred when 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 default date and time of the file is the current system date and time.

Response

Select OK to continue.


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:

Yes

Replaces the existing workstation file and continues with the installation or update.

No

Does not replace the existing file.  The installation or update processing will continue.

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 does not contain existing files with the same names as the product files.


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:

•  The path contains a valid fixed disk

•  The directory names are all less than or equal to 8 characters (unless the drive is formatted with the HPFS file system)

•  The path does not end with a back slash (\)

3.  Select Install to try again.


Help for EPFIW141

Explanation

An error occurred when 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 is not set by default.

Response

Select OK to continue with the operation.


Help for EPFIE142

Explanation

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

•  Insufficient disk space is available to copy the files.

•  One or more of the files being copied already exists and is in use.

Response

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

2.  Ensure that the product is not currently running.

3.  Try the operation again.


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 PATH directory.  If the installation and maintenance utility transfers the DLL, it may be necessary to add a period and semicolon (.;) to the beginning of the PATH statement in the AUTOEXEC.BAT file (for example, SET PATH=.;C:\WINDOWS\SYSTEM;).

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 in the same directory as all the other installation files.


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:

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.


Help for EPFIE147

Explanation

The specified path does not contain a valid fixed disk.

Response

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

2.  Add the appropriate drive to the path.

3.  Select Install to try again.


Help for EPFIE148

Explanation

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

Response

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

2.  Change the drive specification of the path.

3.  Select Install to try again.


Help for EPFIE149

Explanation

You cannot use global 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.


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.


Help for EPFIE157

Explanation

An error occurred while the installation and maintenance utility tried to add to the CONFIG.SYS or the AUTOEXEC.BAT file.

The following are possible causes:

•  Your system is out of disk space.

•  CONFIG.SYS or AUTOEXEC.BAT is read-only.

•  A parameter specified in the exit to change the CONFIG.SYS or AUTOEXEC.BAT is greater than 512 bytes.

•  CONFIG.SYS or AUTOEXEC.BAT does not exist.

Response

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

2.  Add the proper statements to the CONFIG.SYS or AUTOEXEC.BAT files.  See the product's installation instructions for more information.

You can find a backup of the original CONFIG.SYS file in C:\CONFIG.BAK, where C is the drive where WINDOWS is installed.

You can find a backup of the original AUTOEXEC.BAT file in C:\AUTOEXEC.BAK, where C is the drive where WINDOWS is installed.


Help for EPFIE158

Explanation

An error occurred when the installation and maintenance utility tried to add the specified program group to the Program Manager.

Response

Select OK to continue transferring the files.

You can add the program group to the Program Manager after installation is complete.


Help for EPFIE159

Explanation

An error occurred when the installation and maintenance utility attempted to add the specified program item to the Program Manager.

The program item may already exist in the designated program group.

Response

Select OK to continue adding the remaining files.

You can add the program item to the program group after installation is complete.

Refer to Windows documentation for information on adding program items to a program group.


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

Yes

Continue to update the product

No

Cancel the update


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.


Help for EPFIF163

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.


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 product being installed, it must be in the same directory as all the other installation and maintenance utility files.

Response

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

2.  Exit the installation program.

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

4.  Start the installation program again.

or

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

2.  Add the directory containing the installation executable files to the path statement in the AUTOEXEC.BAT file.

3.  Start the system again.

4.  Start the installation program again.


Help for EPFIE166

Explanation

The catalog file on 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.

2.  Contact your system administrator.

System Administrators:

Do one of the following:

•  Edit the catalog file to delete unnecessary products.

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


Help for EPFIE167

Explanation

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

•  The specified file does not exist.

•  You do not have access to the diskettes or LAN drive that contain the catalog file.

Response

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

Do one of the following:

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

•  Access the diskettes LAN drives that contain the catalog.


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 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.  Correct the syntax error in the source copy of the configuration file.

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

3.  Try Open again.


Help for EPFIF169

Explanation

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

Response

1.  Close the 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.


Help for EPFIE171

Explanation

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


Help for EPFIQ173

Explanation

The installation and maintenance utility has 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.


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


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.


Help for EPFIE176

Explanation

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

Response

1.  Select Cancel.

2.  Cancel any unnecessary applications and close any unnecessary sessions.

3.  Try the operation again.


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 diskettes or LAN drives 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.


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.

Use 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


Help for EPFIE183

Explanation

One or more of the parameters specified is not valid for a user exit.  A problem occurred when the utility parsed 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.


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.


Help for EPFIQ185

Explanation

The specified drive in the File directory field contains insufficient available disk space for 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 insufficient disk space.

No

Removes the message box and returns to the Install-directories window.

After returning, perform one of the following actions:

•  Select a new drive to install the product on by changing the drive specification in the File directory field.  To find a disk with enough space, select Disk space.

•  If the product contains components, select fewer components and select Install again.

Note:  Only the selected components are installed.


Help for EPFIQ186

Explanation

You specified not to automatically update the CONFIG.SYS and AUTOEXEC.BAT files.

If the product you are installing or updating requires changes in the CONFIG.SYS or AUTOEXEC.BAT files, the product will not run correctly after the installation or update is complete unless you make the necessary changes.

Response

Select one of the following:

Yes

Installs the product without updating the CONFIG.SYS and AUTOEXEC.BAT files.  When the product installation or update has successfully completed, you must manually update the CONFIG.SYS and AUTOEXEC.BAT files, if required by the product, before it can run.  Refer to the product's installation instructions for information on how to update the CONFIG.SYS and AUTOEXEC.BAT files.

No

Removes the message box and returns to the previous window where you can select the Update CONFIG.SYS/AUTOEXEC.BAT option and then restart the installation or update.


Help for EPFIE187

Explanation

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

Response

1.  Record the return code value.  See the following for a list of return code (RC) values and their descriptions.

RC 	Description

    2	File not found

    3	Path not found

    5	Access denied

    6	Invalid handle

    8	Insufficient memory

  32	Sharing violation

  50	Network request not supported

191	Incorrect EXE signature file in a DOS mode program or an improper program

2.  Refer to the installation instructions of the product that you are installing for more information about the return code.

3.  Select Cancel to exit the installation or update.

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


Help for EPFIE188

Explanation

An error occurred while attempting to access the file at the source.

One of the following problems can cause this error:

•  Another program or user is accessing the file.

•  The specified file does not exist.

Response

1.  Ensure that the specified file exists.

2.  Return to the workstation session, and try the operation again by selecting Retry

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


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.


Help for EPFIE190

Explanation

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

•  Insufficient available disk space

•  The printer is off-line

•  The Windows 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 Windows 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 Windows Print Manager for additional information regarding this error.


Help for EPFIE191

Explanation

The operation could not be completed because the specified drive could not be accessed.

This error could be caused by any of the following:

•  The specified drive is a diskette drive and a diskette needs to be inserted.

•  The LAN drive is disconnected from the workstation.

Response

1.  Ensure that a diskette is in the specified drive or that the LAN drive is connected.

2.  Select Retry to retry the operation.


Help for EPFII192

Explanation

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

Response

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


Help for EPFIE193

Explanation

The specified file name is not a valid DOS file name or it does not exist on the source drive.

Global characters are not allowed in installation file names.

Response

If this error occurred during an open operation:

1.  Select Cancel on this error message box.

2.  Ensure that the file name entered in the Filename field in the Open drive 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 pull-down 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 may occur if you are using a file name that contains a drive specification in the PACKAGEFILE or PKGDESCRFILE keywords in the catalog file, or in the FILE entry SOURCE keyword or in the INCLUDE entry NAME keyword 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;'

pkgdescfile = 'drive: \wsp2\epfidesc.dsc;'

source = 'drive: file.exe;'


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

Response

1.  Select Retry 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.


Help for EPFIE196

Explanation

An error occurred while unpacking a compressed file.

The installation or update cannot complete successfully unless this problem is corrected.

Response

1.  Select Retry to retry the unpack operation.

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


Help for EPFIE197

Explanation

An error occurred while unpacking a compressed file.

The installation or update cannot complete successfully unless this problem is corrected.

Response

1.  Select Retry to retry the unpack operation.

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


Help for EPFIE198

Explanation

A file needed for the installation or update was not found within the specified compressed file.

This error could be caused by any of the following:

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

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

Response

Users:

Report the error to your system administrator.

Package file builders:

1.  Examine the FILE entry that corresponds to the specified file and correct 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.


Help for EPFIE199

Explanation

An error exists in the product's package file.

The PACKFILE entry that corresponds to the PACKID keyword value was not found.

Response

Users:

Report the error to your system administrator.

Package file builders:

1.  Examine the FILE entry PACKID keyword and the PACKFILE entry ID keyword.  Make sure that these match.

2.  Try the operation again.


Help for EPFIE200

Explanation

The installation and maintenance utility cannot find a specified compressed 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 command 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.


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) to which these fixes apply.

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 repeating this installation, specify the same directories where the products were originally installed.


Help for EPFIE202

Explanation

You can have only one PACKAGE entry for each product in the catalog file.

Response

If you want more than one, use an INCLUDE entry for each catalog file you want to be processed with the master catalog file.


Help for EPFIE203

Explanation

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

Response

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


Help for EPFIE204

Explanation

An unknown command line option was specified.

Response

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


Command line options

The following options are valid on the installation and maintenance utility command line.  The options can be specified in any order.

Option

/s=source

Specifies the source system that the operation is to be performed from.  The valid value for this parameter is Drive.

This option is ignored for a delete or restore operation.

/c=catfilename

Specifies the name and location of the catalog file.  If the catalog file is located on a diskette or LAN, then the catalog file name must be preceded by a drive and directory.

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

The following are examples of /c options for each source:

Drive (diskette)	: /c=a:\diskette.icf

Drive (LAN)	: /c=z:\lancat\epficat.cat

/a=action

Specifies the action to be performed.

If this option is present with a valid value, then the main window will not be displayed.  In this case, windows will be displayed directly on the Windows desktop. Omitting this option causes the installation and maintenance utility to come up as normal.

Use of this option requires that the /p option also be specified.

Valid values for this option are:

    i	(for install)

    u	(for update)

    r	(for restore)

    d	(for delete)

/p=prodname

Specifies the name of the product for which the operation is to be performed. If the product name contains spaces, then it must be enclosed in double quotes (").

Sample valid product name specifications:

/p="Product name with spaces"

/p=productname

/f=responsefile

Specifies the name of the response file to be read for additional information.

/l=xpos,ypos

Specifies the initial x and y positions of the installation and maintenance utility on the desktop.  If this option is specified, all previously saved default positions are overridden.  These coordinates are relative to the lower-left corner of the screen.

/x

Specifies that the operation will be totally noninteractive.  If information needed for the operation to complete is not specified, an error occurs.  When this option is specified, no progress indicator is displayed, and all error messages  are logged to the EPFINSTS.OUT file.

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


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 within an installation response file.

Parameter

comp

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

file

Specifies the value of 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.

work

Specifies the value of 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.

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.

cfgupdate

Specifies whether the CONFIG.SYS and AUTOEXEC.BAT files are automatically updated.

Valid values for this parameter are:

  AUTO.........Automatically update CONFIG.SYS and AUTOEXEC.BAT

  MANUAL   Do not update CONFIG.SYS and AUTOEXEC.BAT

This parameter is used only for install or update actions and is ignored if any other action is specified.

overwrite

Specifies whether to automatically overwrite files during installation.

Valid values for this parameter are:

  YES   Overwrite files with the same name

  NO     Do not overwrite

This parameter is used only for an install action and is ignored if any other action is specified.

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	Delete only the backup versions

  NO	Delete all versions.

This parameter is used only for a delete 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   Save a the current version as a backup

  NO     Do not save a backup version

This parameter is used only for an update action and is ignored if any other action is specified.


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

Response

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

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


Help for EPFIE206

Explanation

An unrecognized parameter was found within the specified response file.

Response

Correct the response file parameters and try the operation again.


Help for EPFIE207

Explanation

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

Response

Correct the response file parameters and try the operation again.


Help for EPFIE208

Explanation

A maximum of 50 component parameters are allowed in the response file.

More than 50 component parameters exist in the response file.

Response

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


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 with double quotes (").

Sample valid product name specifications:

/p="Product name with spaces"

/p=productname

Response

Correct the /p parameter and try the operation again.


Help for EPFII211

Explanation

The operation requested from the command line options cannot be performed without the /p parameter.

A product name is required when performing an install, update, restore, or delete.

Response

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


Help for EPFII212

Explanation

The /x command line option specified that a completely noninteractive installation be performed, but not enough information was 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 the information that 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.


Help for EPFII213

Explanation

The update action requested from the command line options cannot be performed because the specified product is not 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.


Help for EPFII214

Explanation

The delete action requested from the command line options cannot be performed because the specified product is not 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.


Help for EPFII215

Explanation

The restore operation requested from the command line options cannot be performed.

The specified product has not been installed and updated at least once.

The update must have been done with the Save a backup version option selected.


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 to the Delete window.  You can cancel the selection of the specified component and try the deletion again.


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


Help for EPFII220

Explanation

The /s command line option must be specified if the /c command line option is used.

The /s option specifies the source of the open operation (Drive).

Response

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


Help for EPFIE223

Explanation

The selected product was probably installed using a previous version of the installation and maintenance utility.

The current version requires additional information to complete the requested operation.

Response

1.  To obtain the additional information, open the catalog that the selected product is in.

2.  Select the product.

3.  Try the operation again.


Help for EPFIE224

Explanation

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

Response

1.  Correct the entry.

2.  Try the operation again.


Help for EPFIE225

Explanation

A temporary directory to hold deferred installation files cannot be created.

This can occur for the following reasons:

•  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 file allocation table (FAT) file system.

•  Another application is using the drive.

Response

1.  Try one of the following:

•  Select a different drive.

•  Format the drive.

•  Wait until the other application is finished.

2.  Try the operation again.


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 oepration again.


Help for EPFIE227

Explanation

The deferred installation preparation failed because:

•  CONFIG.SYS or AUTOEXEC.BAT is a read-only file

•  There is insufficient space on the boot drive.

Response

1.  Ensure that your CONFIG.SYS or AUTOEXEC.BAT are not read-only files.

2.  Remove some files from the boot drive.

3.  Try the operation again.


Help for EPFIE232

Explanation

The specified expression is not valid.

This could be for one of the following reasons:

•  Parentheses are mismatched.  Either a left parenthesis exists without a matching right parenthesis or vice versa.

•  The syntax of the expression is not correct.  An operator may be missing an operand, or an operand may exist without an operator.

•  Evaluation of the expression causes a division by zero to occur.

Response

1.  Correct the expression in the package file.

2.  Try the operation again.


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.