OS/2 Shareware BBS: 11 Util/11-Util.zip/easyfix.zip/SERVICE.HLP

OS/2 Help File | 1995-05-02 | 21KB | 617 lines

ΓòÉΓòÉΓòÉ 1. Corrective Service Facility ΓòÉΓòÉΓòÉ

OS/2 Corrective Service Facility (CSF) is a utility program that applies
corrections (service) to the OS/2 operating system and other OS/2 products.
CSF updates the files of the products you select with the corresponding product
files on a corrective service diskette (CSD) package or in a fix package.

The main window contains a list of products found on the system that are
eligible for service.  All eligible products are initially selected and are
highlighted in the list.  If you do not want to apply service to one or more
products listed, select those products that you do not want to service.  The
products you select will no longer be highlighted and service will not be
applied to them.

When only the products to which you are applying service are highlighted,
select Service to start the service process.  To change to a list of product
archives, backups, or a list uncommitted products, select Change Product List.


ΓòÉΓòÉΓòÉ 2. Archive ΓòÉΓòÉΓòÉ

An archive is a copy of your product files as they existed before you applied
service to the product.  With an archive you can restore a product to its
earlier state at any time during service by using the Backed Up Products window
or the Archived Products window.

Corrective Service Facility (CSF) saves an archive of your product files when
you:

   o  Apply service to your product for the first time
   o  Apply service to your product for the first time after committing the
      product with a service package applied.

 CSF saves only one archive per product, at the time when service is first
 applied to the product.  You can save copies of later product levels by
 creating a backup of your product files each time you apply a new fix package.


ΓòÉΓòÉΓòÉ 3. Backup ΓòÉΓòÉΓòÉ

A backup is a copy of product files to which service has been applied at least
once.  You request a backup by specifying a path in the Backup field of the
Service window.  Corrective Service Facility saves a copy of your current
product files before applying the next level of service to the product.  The
backup enables you to restore your product to its state before the most recent
level of service was applied.

Creating a backup is optional, but be aware that if you do not create a backup
when you apply service, you cannot use an older backup to restore your product.
You cannot restore your product across multiple service levels.  However, you
can always restore your product to the archive level.

You can have only one backup of a product at a time.  If a backup already
exists when you request a backup, the older backup is deleted. You cannot
create a backup before an archive has been saved.


ΓòÉΓòÉΓòÉ 4. Uncommitted Product ΓòÉΓòÉΓòÉ

A product is uncommitted when it can be restored to its level before the latest
service was applied by using an archive or a backup.  Committing a product when
a service package has been applied to it removes the reference to the archive
and frees the disk space used by the backup, if one exists.  Committing a
product when a fix package has been applied to it frees the disk space used by
the backup, if one exists, but does not affect the archive.

             Γöé            Γöé
             ΓöéFix package ΓöéService
             Γöé            Γöépackage
 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
 Archive     Γöéunaffected  Γöéreference
             Γöé            Γöéremoved
 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
 Backup      Γöédeleted     Γöédeleted
             Γöé            Γöé

You can commit a product when you are satisfied with it by using the Commit
Service window.


ΓòÉΓòÉΓòÉ 5. Serviceable Products ΓòÉΓòÉΓòÉ

A product is eligible for service (serviceable) when:

   o  The product is installed on your system

   o  The product updates are present in the fix package or service package

   o  The SYSLEVEL of the product on your system is compatible with the
      SYSLEVEL of the product on the fix package or service package


ΓòÉΓòÉΓòÉ 6. Application in Use ΓòÉΓòÉΓòÉ

Corrective Service Facility has encountered a file that is in use and cannot be
updated.  This error was probably caused by opening a file or starting a
program after the service process has begun.

Close the indicated file or program and restart Service.  You can close the
file or program from another OS/2 window, or by using the Window List on the
Desktop.  To display the Window List, press Ctrl+Esc, or press both mouse
buttons simultaneously.

If you are unable to close the application, shut down your system.  Place the
first Corrective Service Diskette in Drive A and restart your system using
Ctrl+Alt+Del.


ΓòÉΓòÉΓòÉ 7. Updating Files ΓòÉΓòÉΓòÉ

The Updating Files window shows the path of the file being processed and the
approximate percentage of the service that is complete.

When you are applying service to the product, the Updating Files window
displays the percentage of files to which service has been applied.

When you are backing out of a service package or fix package change, the
Updating Files window displays the percentage of files that have been restored
to either the archive level or the backup level.


ΓòÉΓòÉΓòÉ 8. Insert Diskette ΓòÉΓòÉΓòÉ

Insert the indicated diskette into the requested diskette drive.  Then, press
Enter or select OK to continue.  If there is no diskette in the requested drive
or the wrong diskette is in the requested drive when you select OK, a warning
beep will sound and you will not be able to continue until the correct diskette
is inserted.


ΓòÉΓòÉΓòÉ 9. Service Permission ΓòÉΓòÉΓòÉ

A read-only, hidden, or system file has been encountered that should be
serviced.

If you do not apply service to this file, your system will not be at the proper
corrective service level.  Down-level files can cause system problems and might
prevent your system from restarting.


ΓòÉΓòÉΓòÉ 10. Service Permission Verification ΓòÉΓòÉΓòÉ

Select OK to prevent the indicated file from being serviced.  You should select
OK only if there is a known reason not to service the file.

Select Cancel to service the indicated file.


ΓòÉΓòÉΓòÉ 11. Newer File Service Permission ΓòÉΓòÉΓòÉ

The file indicated for service has a more recent date than the file on the
corrective service diskettes.

Select OK to service the file.

Select Cancel only if there is a known reason for not applying service to the
file.

If you select Cancel, this file will not be at the same corrective service
level as the other files for this product. Down-level files can cause system
problems and prevent your system from restarting.


ΓòÉΓòÉΓòÉ 12. Corrective Service Facility Logfile ΓòÉΓòÉΓòÉ

The logfile is a cumulative service history.  You may browse the file.  The
logfile contains information about the products that are being updated.  The
end of the file contains the most recent actions and might contain error
messages.

Select Cancel to return to the error window.


ΓòÉΓòÉΓòÉ 13. Corrective Service Facility Error ΓòÉΓòÉΓòÉ

An error has occurred that prevents the Corrective Service Facility from
continuing.

Select Display Logfile to view the service history.

Depending on the error, an Exit button might be displayed.  If this button is
displayed, you can use it to exit the service process.


ΓòÉΓòÉΓòÉ 14. Corrective Service Facility Error ΓòÉΓòÉΓòÉ

An error has occurred that prevents the Corrective Service Facility from
continuing.

Correct the problem and select Retry.

Depending on the error, an Exit button might be displayed.  If this button is
displayed, you can use it to exit the service process.


ΓòÉΓòÉΓòÉ 15. Corrective Service Facility Error ΓòÉΓòÉΓòÉ

An error has occurred that prevents the Corrective Service Facility from
continuing.

Correct the problem and select Retry, or select Cancel to end the indicated
operation.

Depending on the error, an Exit button might be displayed.  If this button is
displayed, you can use it to exit the service process.


ΓòÉΓòÉΓòÉ 16. Corrective Service Facility Error ΓòÉΓòÉΓòÉ

Select Yes if you wish to perform the specified operation.  Otherwise, select
No.


ΓòÉΓòÉΓòÉ 17. Wait ΓòÉΓòÉΓòÉ

The Wait window is displayed while lengthy operations are being performed.  The
window will be removed when the operation is complete.


ΓòÉΓòÉΓòÉ 18. Access Control List Protected File ΓòÉΓòÉΓòÉ

The Corrective Service program has encountered an Access Control List
(ACL)-protected file that cannot be updated.

Exit the Corrective Service Facility, and contact your LAN administrator for
more information.  The Corrective Service Facility cannot update your system
until the ACL-protected file has been released.


ΓòÉΓòÉΓòÉ 19. Checksum Error Window ΓòÉΓòÉΓòÉ

The Corrective Service Facility found a file that is not at the expected
corrective service level.  To apply this service package, all files must be at
the prerequisite level.  Ensure that your system is at the prerequisite level
before applying service.

You must replace this file with the original file provided on the installation
diskettes for the product.  Select Exit until you have exited from CSF.
Correct the file before you attempt to start CSF again.


ΓòÉΓòÉΓòÉ 20. Service Window ΓòÉΓòÉΓòÉ

This window displays the list of products that you selected, and allows you to
enter a path for an archive (if none exists) or a backup.

Enter the required information and select OK to perform the service, or Cancel
to return to the previous window.  After you select OK, you can no longer
cancel the service being applied.

For a detailed explanation of each field, select from the list below:

   o  Product field
   o  Archive field
   o  Backup field


ΓòÉΓòÉΓòÉ <hidden> Product Field ΓòÉΓòÉΓòÉ

The Product field lists the name and level of each product you selected, in the
following format:

product name-service level(base level)-SYSLEVEL path

This field is for viewing purposes only.

 product name
           The name of the selected product.

 service level
           The level of service, which reflects the application of one or more
           fix packages since the product was last committed.  If no fix
           package has been applied to the product since the product was last
           committed, this field is omitted.

 base level
           The last committed level of the product.  The base level might be
           the product level as originally installed, or the product level
           committed after a service package was applied. Committing a product
           after a service package has been applied to it always results in a
           new base level.

 SYSLEVEL path
           The path to the product SYSLEVEL file.  This file contains
           information about the product, such as the current version of the
           product and any optional components installed.


ΓòÉΓòÉΓòÉ <hidden> Archive Field ΓòÉΓòÉΓòÉ

Use the Archive field to enter the path and directory of the archive for each
product listed in the Product field.  The directory can be located on a
diskette, a local drive, or a network drive.

The archive path is required if this is the first time that service is being
applied to the product.  If service has been applied to the product previously,
the field will be protected and you will not be able to enter the path.

To change the archive path after it is protected, use either the Redirect
Service window or the REDIRECT command in the FSERVICE response file.


ΓòÉΓòÉΓòÉ <hidden> Backup Field ΓòÉΓòÉΓòÉ

Use the Backup field to enter the path and directory of the backup for each
product listed in the Product field.  The directory can be located on either a
local drive or diskette, but cannot be on a network drive.  The backup path
must be a to a directory that does not exist (the Corrective Service Facility
will create the directory) or to an empty directory.  A backup cannot share an
existing directory.

If both the backup and archive directories are located on a diskette, they must
be on different diskettes.

This field is protected if this is the first time that service is being applied
to the product, and you will not be able to enter the path. If service has been
applied to the product previously, the field is optional.


ΓòÉΓòÉΓòÉ 21. Back Out Service Window ΓòÉΓòÉΓòÉ

Use this window to restore a product to a previous fix-level (backup) or the
last base-level (archive) of the product.

 Products
      This field lists all the selected products that can be restored to a
      previous fix level. This field can only be viewed.

 Target Level
      This field lists the target levels for each product.  The target level is
      the level to which you can restore the product.  The product can be
      restored to either the backup level or the archive level.  This field can
      only be viewed.

 Select OK to perform the back out, or Cancel to return.


ΓòÉΓòÉΓòÉ 22. Commit Service Window ΓòÉΓòÉΓòÉ

Use this window to free the disk space used by the backup directory.  Commit a
product when you are satisfied with the level of service applied to the product
and no longer need the ability to restore the product to its previous level.

Committing a product when a service package has been applied to it removes the
reference to the product's archive and frees the disk space used by the backup,
if one exists.  Committing a product when a fix package has been applied to it
frees the disk space used by the backup, but does not affect the archive.

 Product
      This field lists all the selected products to be committed.  This field
      can only be viewed.

 Archive Level
      This field lists the archive level for each product.  The reference to
      this directory is removed after you commit the product with a service
      package applied, and you will not be able to restore the product to the
      archive level.  The archive is not affected by committing a product with
      a fix package applied.  This field can only be viewed.

 Backup Level
      This field lists the backup level of each product.  The backup for a
      product is deleted after you commit the product with a fix package or a
      service package applied.  This field can only be viewed.

 Select OK to commit the products, or Cancel to return.


ΓòÉΓòÉΓòÉ 23. Redirect Service Window ΓòÉΓòÉΓòÉ

Use this window to use an archive on a path other than the path displayed in
the Source Directory field.  You can copy the archive to a new location, such
as a network drive with more storage available. The Redirect Service window
causes Corrective Service Facility to reference the new location; it does not
copy the archive.

To reference a new archive location:

   1. Create a directory on the new archive path.
   2. Use the XCOPY command to copy all of the existing archive files to the
      new directory.
   3. Enter the new path in the Target Directory field.
   4. Select OK to reference the archive in the new location.

 Product
      This field displays the products that you selected from the list of
      products with archives.  You can only view this field.

 Source Directory
      This field lists the archive directories of each selected product.  You
      can only view this field.

 Target Directory
      Use this field to enter the new archive path.  You must enter a new path
      for each product.  The system level and files in the archive at the new
      location must match those of the archive at the old location.

 Select OK to redirect, or Cancel to return.


ΓòÉΓòÉΓòÉ 24. Change Product List Window ΓòÉΓòÉΓòÉ

Select the type of product list that you want to display.  The system will be
searched for products that meet the required criteria.  If a product list does
not exist, it will be grayed, which indicates it is unavailable for viewing.

Select OK to continue, or Cancel to return.

Related information

   o  Archive
   o  Backup
   o  Uncommitted
   o  Serviceable


ΓòÉΓòÉΓòÉ 25. Directories or Products Not Selected ΓòÉΓòÉΓòÉ

You must select at least one product to start service.

If there are no products listed, service cannot be initiated.

Select a product from the Products list in the main window.


ΓòÉΓòÉΓòÉ 26. Service Complete ΓòÉΓòÉΓòÉ

Service completed successfully.

Select OK to end the Corrective Service Facility.


ΓòÉΓòÉΓòÉ 27. No Serviceable Products ΓòÉΓòÉΓòÉ

The products on your system do not match those on the corrective service
diskettes.

Matching products might not be found if the corrective service diskettes are at
a service level lower than the base level of the system.  Use the SYSLEVEL
program to view the information about the products on your system.


ΓòÉΓòÉΓòÉ 28. Exit Corrective Service Facility ΓòÉΓòÉΓòÉ

Select OK to exit from the Corrective Service Facility.


ΓòÉΓòÉΓòÉ 29. Exit Program Failure ΓòÉΓòÉΓòÉ

The specified exit program failed.  The Corrective Service Facility will
continue when you select OK.


ΓòÉΓòÉΓòÉ 30. Key Assignments ΓòÉΓòÉΓòÉ

From the OS/2 Setup and Installation window, you can press F3 to display a
command prompt.

For more information on keys, select Key assignments below.

Related Information:

Key assignments


ΓòÉΓòÉΓòÉ 31. Uncommitted Products ΓòÉΓòÉΓòÉ

A list of products that you can commit is displayed.  Select from this list the
products you want to commit.  You can commit more than one product at a time.

Commit a product when you are satisfied with it at its current level.
Committing a product frees the disk space used by the backup, and removes your
ability to restore the product to the backup level.  If you commit a product
that has a service package applied to it, the reference to the archive is also
deleted, and you cannot restore the product to the archive level.

After selecting the products you want, select Commit to perform the action.

To change to a list of products that are archived, backed up, or eligible for
service, select Change Product List. Select Cancel to return to the previous
window.


ΓòÉΓòÉΓòÉ 32. Archived Products ΓòÉΓòÉΓòÉ

A list of products that have archives is displayed.  Select from this list the
products you want to restore to an earlier level (back out) or redirect to an
archive at a different location.

 Back out
      Select Back out to restore the product to an earlier state before service
      was applied.  You can view the product and target level (archive or
      backup) to which the product will be restored.

 Redirect
      Select Redirect to change the archive location.  You can view the product
      and the location of the current archive, and specify the new archive
      location.

 To change to a list of products that have backups, are uncommitted, or are
 eligible for service, select Change Product List. Select Cancel to return to
 the previous window.


ΓòÉΓòÉΓòÉ 33. Backed Up Products ΓòÉΓòÉΓòÉ

A list of products that have a backup is displayed.  Select from this list the
products you want to restore to their backup levels.

 Back out
      Select Back out to view the product and target level to which you would
      back out.

 To change to a list of products that are archived, uncommitted, or eligible
 for service, select Change Product List. Select Cancel to return to the
 previous window.


ΓòÉΓòÉΓòÉ 34. Automatically Commit Products ΓòÉΓòÉΓòÉ

A list of products that are uncommitted is displayed.  You must commit these
products before you can apply service to them. You can only view the product
list.

Select Yes to commit the products and automatically generate a new archive for
them.  Select No to return to the Service window.


ΓòÉΓòÉΓòÉ 35. Select Source Drive ΓòÉΓòÉΓòÉ

Use this window to select the drive from which you will apply service.  Choose
a drive from the list displayed.  The default drive is A.

Select OK to use the selected drive to apply service.  Select Cancel to cancel
service.


ΓòÉΓòÉΓòÉ 36. Service Interruption ΓòÉΓòÉΓòÉ

A service interruption damaged one or more system files.

Select Continue to allow Corrective Service Facility to continue applying
service from the point when the interruption occurred.  Select Exit to exit CSF
at this time.  When you restart the service process at a later time, you will
return to this screen.


ΓòÉΓòÉΓòÉ 37. Locked Files Encountered ΓòÉΓòÉΓòÉ

The Corrective Service Facility (CSF) has determined that the listed files are
locked.  Service can continue; however, you must restart the system before
applying additional service or using the files.

Depending on the error, a Retry button might be displayed.  If this button is
displayed, you can unlock the files by closing the programs, and select Retry
to continue applying service.

Select Continue to allow CSF to process the locked files at a later time.

Select Reboot to exit from CSF and bypass processing the locked files.  You
will be prompted to shut down and restart your system.

Select Cancel to stop applying service.


ΓòÉΓòÉΓòÉ 38. Space Required for Locked Files Processing ΓòÉΓòÉΓòÉ

The Corrective Service Facility (CSF) has determined that the listed files are
locked and sufficient space is not available for CSF to process the files.

Depending on the error, a Retry button might be displayed.  If this button is
displayed, you can either:

   o  Unlock the files by closing the applications, and select Retry to
      continue applying service.

   o  Free the required amount of contiguous disk space on a single drive, and
      select Retry to continue applying service.

 Select Reboot to exit CSF and bypass processing the locked files.  You will be
 prompted to shut down and restart your system.

 Select Cancel to stop applying service.


ΓòÉΓòÉΓòÉ 39. Insufficient Space for Service ΓòÉΓòÉΓòÉ

The Corrective Service Facility (CSF) has determined that the listed files are
locked, and sufficient space is not available on the listed drives for CSF to
process the files.

Depending on the error, a Retry button might be displayed.  If this button is
displayed, you can either:

   o  Unlock the files by closing the applications, and select Retry to
      continue applying service.

   o  Free disk space on the drives indicated, and select Retry to continue
      applying service.

 Select Reboot to exit CSF and bypass processing the locked files.  You will be
 prompted to shut down and restart your system.

 Select Cancel to stop applying service.


ΓòÉΓòÉΓòÉ 40. Unprocessed Files ΓòÉΓòÉΓòÉ

The Corrective Service Facility (CSF) completed successfully, but product files
that were locked during service remain unprocessed. Complete the service for
these files by shutting down the system and restarting it.  You can then apply
additional service or use the product.

Select Display Logfile to display the service history. The logfile contains a
list of files for which service was deferred.

Select Exit to exit CSF.