IBM Presents OS/2 Software Hits 1995/OS-2_SW_HITS_2ND_EDITION_1995.ISO/i17/warpbdsk.1dk/README.INF

OS/2 Help File | 1994-11-09 | 27KB | 875 lines

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

Corrective Service Facility (CSF) is a utility program that you can use to
apply service updates to the OS/2* operating system and to OS/2-based
subsystems and applications. You can use CSF to apply either a full service
package (ServicePak) or a fix service package (FixPak).

A ServicePak contains all code fixes that have been developed since the last
product release.  Applying a ServicePak updates the corrective service level
(current CSD level) of the product.  (You can display the current CSD level by
entering the SYSLEVEL command from an OS/2 command prompt.)

A FixPak replaces or updates a subset of product files.  Applying a FixPak
updates the fix level of the product but does not affect the current CSD level.
(You can view the fix level of the product in the service log, described in
Viewing the Service Log.)

CSF simplifies the process of applying service to a product because CSF:

o Lets you apply service to either a single system or to multiple systems in a
  LAN environment

o Prevents you from applying service that is inappropriate for your system

o Allows you to "back out" of the service you applied, which restores your
  system to a previous level

o Allows you to "commit" to the level of service you applied, which frees disk
  space on your system used by CSF

o Creates a service log that tracks all service applied to a product

o Handles unexpected conditions while continuing to apply service

The sections that follow define CSF terms and explain the CSF process.  The
steps to use CSF are described in Using CSF.


ΓòÉΓòÉΓòÉ 1.1. Applying Service in Single System and LAN Environments ΓòÉΓòÉΓòÉ

CSF provides an interface for applying service to a single system and an
interface for applying service in a LAN environment:

The SERVICE facility is a graphical interface for updating a single system
without restarting the system. SERVICE prompts you to enter information in
service windows and enables you to choose the products you want to update with
service or restore to an earlier level.

The FSERVICE facility is a command-oriented interface.  You can use FSERVICE in
a minimal OS/2 environment, such as when you start CSF from diskette, and in
attended or unattended configuration, installation, and distribution (CID)
environments and NetView* Distribution Manager/2 (NetView DM/2) environments,
in which service is applied to multiple remote systems attached to a local area
network (LAN).  You submit your service request to FSERVICE using command line
parameters and a response file in which you code your service request using
FSERVICE keywords and parameters.


ΓòÉΓòÉΓòÉ 1.2. Ensuring That Service is Appropriate ΓòÉΓòÉΓòÉ

Whether you use SERVICE or FSERVICE, CSF ensures that the country code,
version, release level, and current CSD level of your product are compatible
with the service updates, and will not proceed with service if there is a
mismatch.  Information about the level of the products on your system is
contained in the SYSLEVEL.xxx file on the OS2 directory of the boot drive.


ΓòÉΓòÉΓòÉ 1.3. Restoring a Product to a Previous Level ΓòÉΓòÉΓòÉ

Occasionally, even a service package that is compatible with a product can
cause problems when it interacts with the other products on your system.  CSF
enables you to remove a service package and restore your product to its
previous level without requiring you to reinstall the product. Removing a
service package is called "backing out" of a ServicePak or a FixPak.

CSF enables you to restore a product in either of two ways:

o You can remove all service applied to the product since it was installed or
  last committed, which restores the product to its base level.  (Committing a
  Product with Service Applied explains what it means to "commit" a product.)
o You can remove the most recent service package applied to the product, which
  restores the product to its previous fix level.


ΓòÉΓòÉΓòÉ 1.3.1. Restoring a Product to Its Base Level ΓòÉΓòÉΓòÉ

Depending on the product you are servicing, CSF might save a copy of your
product files before applying service to the product. This copy of your "base"
(installed or committed) level files is called an archive.  You can use an
archive to restore your product to its base level at any time during service.

In general, an archive is required by products that take considerable time and
multiple diskettes to install, and not required by products that can be
reinstalled easily with few diskettes.  When a product requires an archive,
neither the SERVICE nor FSERVICE facilities will apply service to it until you
specify a location for the archive. When a product does not require an archive,
the SERVICE facility will not allow you to specify an archive location.  The
FSERVICE facility will return the error message "Archiving is disabled for the
product" and provide the path to the SYSLEVEL file for the product.

When an archive is required, CSF copies the product files that are at the base
level and are to be updated by a service package.  CSF saves these copies in
the archive before applying service. The first time you apply a service package
to a base-level product, all files to be updated by the service package are
copied into the archive. Each time you apply a subsequent service package to
the product, CSF copies into the archive only the product files that were not
serviced previously (the product files that are still at the base level.) If
service has been applied to the file before, the file is not copied into the
archive. In this way, CSF saves a copy of your base-level product that you can
restore even after you have applied multiple service packages.

For example, FixPak 1 updates product files A, B, and C, and FixPak 2 updates
product files C and D.  The product to which they are being applied is at the
base level. Before applying FixPak 1, CSF copies files A, B, and C to the
archive location you provide.  When you later apply FixPak 2, CSF copies file D
into the archive, because file D is still at base level.  File C was updated by
FixPak 1 and is no longer at base level, so CSF does not copy it into the
archive.

When a product requires an archive, you must specify an archive location when
you:

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

You can save an archive on diskette or on a local or remote hard disk.  You
should provide 5 to 10 megabytes of disk space for a product archive. After an
archive has been created for a product, CSF uses that archive until you:

o Redirect CSF to an archive at another location (described in Redirecting CSF
  to a Different Archive.)

o Commit the product with a ServicePak applied to it

CSF saves only one archive per product.  It adds to the archive each time a
service package updates a base-level file. You can save copies of product files
with service applied by creating a backup of your product files each time you
apply a new service package.


ΓòÉΓòÉΓòÉ 1.3.2. Restoring a Product to a Previous Fix Level ΓòÉΓòÉΓòÉ

A backup is a copy of product files to which service has been applied at least
once.  At your request, CSF 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 level of service before the most recent service was
applied.

You request a backup by specifying a path and directory in which CSF is to
create the backup.  The directory can be located on either a local drive or
diskette but cannot be on a network drive.  If both the archive and the backup
are located on diskette, they must be on separate diskettes.

Creating a backup is optional.  However, if you do not create a backup when you
apply service, the only way to back out of the current service package is to
restore the product to the archive level.  You cannot use a backup created when
you applied an earlier service package to back out of the current service
package.  If a product has one or more FixPaks applied to it, it is a good idea
to create a backup before applying a new FixPak.  The backup enables you to
restore the product with any previously-applied service intact.

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.


ΓòÉΓòÉΓòÉ 1.3.3. Redirecting CSF to a Different Archive ΓòÉΓòÉΓòÉ

At some time after CSF has created an archive, you might want to move the
archive to another location, such as a drive with more free disk space, or a
LAN server where multiple systems with identical product levels can share the
archive.  After you (or your LAN administrator) have copied the archive to the
new location, you can redirect CSF to use the new archive location.  (The
archive files must be present at the new archive location before you redirect
CSF, and the system level and files of the archive in the new location must
match those of the archive in the old location.)  Redirecting CSF changes the
reference to the archive location but does not copy the files.

After you ensure that the archive files exist in the new location, you can use
the Redirect window of the SERVICE facility or the REDIRECT keyword of the
FSERVICE facility to redirect CSF to the new archive location.


ΓòÉΓòÉΓòÉ 1.4. Committing a Product with Service Applied ΓòÉΓòÉΓòÉ

After you apply service to a product, you will probably spend some time testing
it to see how the service affects your system.  When you are satisfied with a
service package, you no longer need the ability to restore your previous level
system.  At this point, you can commit the product with the service installed.

Committing the product with a FixPak applied frees the disk space used by your
backup files.  Committing a product with a ServicePak applied frees the disk
space used by the backup files and also removes the reference to the archive.
To free the disk space used by the archive, you must manually delete the
archive files.  CSF does not delete archive files because they can be used by
multiple systems or products.

After a product is committed, you cannot restore the product to an earlier fix
level.  When you commit a product with a ServicePak applied, you cannot restore
the product to an earlier fix level or to the archive level.

After applying a ServicePak to a product, you must commit the product before
you can apply additional service to it.  The SERVICE facility identifies the
products that must be committed before you can apply additional service.  It
also enables you to commit those products from a single window.  Committing a
product before applying additional service makes it easier to identify which
service package to back out of, should a fix be incompatible with your system.


ΓòÉΓòÉΓòÉ 1.5. Viewing the Service Log ΓòÉΓòÉΓòÉ

CSF creates a service log in which it tracks all service applied to a product.
The service log is named SERVICE.LOG, and is located by default on the
OS2\INSTALL directory of the boot drive.  (The FSERVICE utility enables you to
specify a different location for the service log.)

The service log contains the following information:

o The name and level of the product that was updated.

o The specific identity and level of the FixPak that was installed.

o The date and time the FixPak was installed.

o The type of CSF operation (for example, the application of a FixPak or a back
  out to a previous service level).

o The new files that have been copied to the disk.  Copy operations are logged
  with lines that are labelled "Copying" and include the full path name of the
  file on the disk.

o The existing files that have been updated on the disk.  Updates are
  considered to be either full file replacements or file patches.  Update
  operations are logged with lines that are labelled "Updating" and that
  include the full path name of the target file on the disk.

o The files that have been copied to an archive.  Archive operations are logged
  with lines that are labelled "Archiving" and that include the full path name
  of the file in the archive path.

o The files that have been copied to the backup.  Backup operations are logged
  with lines that are labelled "Backing up" and include the full path name of
  the file in the backup path.

CSF also creates and maintains the following files for its own use.  Do not
modify the following files:

ARCHIVE_.xxx
FIXSTART
All files in the IBMCSFLK directory
IBMCSFLK.DLL
IBMCSFLK.EXE
IBMCSFLK.LST
IBMCSFLK.LOG
IBMCSFLK.MGT
IBMCSFLK.SYS
LOGF0000.xxx
LOGSTART.xxx


ΓòÉΓòÉΓòÉ 1.6. Handling Unexpected Conditions ΓòÉΓòÉΓòÉ

CSF handles unexpected conditions, such as locked files and service
interruptions.  When CSF encounters a locked file that is to be updated or
replaced, it postpones the processing of that file until the next time you
restart the system, and it continues applying service.  To process the locked
files, you must restart the system before you can apply another service package
to it; however, you can delay restarting until a convenient time, such as the
end of the work day.

If you are using the SERVICE facility and CSF finds that there is not enough
free disk space on your system to process locked files, you will be prompted to
use the FSERVICE facility.  The response file CSF_SEL.000 (on the root
directory of the first boot drive) contains the tags generated by your input to
the SERVICE facility up until CSF attempted to process the locked files.
Complete the response file using the syntax described in Using the FSERVICE
Response File and restart CSF from diskette.

If a service interruption such as a power outage or a cable disconnection
occurs while you are using SERVICE or FSERVICE in an attended CID environment,
you can allow CSF to continue to apply service or discontinue applying service
temporarily.  When you resume the service, CSF begins at the point when the
interruption occurred and continues to apply service.

If you are using FSERVICE in an unattended CID or NetView DM/2 environment when
a service interruption occurs, CSF returns an error to the host and you cannot
apply subsequent service packages until you successfully reapply the
interrupted service package.  A message in the log file indicates that recovery
is pending for a particular service package.

Note:  If a service interruption occurs, it is a good idea to issue the OS/2
command CHKDSK with the /F parameter before resuming service.  CHKDSK analyzes
files and cleans up file fragments that might result from a service
interruption.  See "OS/2 Command Reference" for information about the CHKDSK
command.


ΓòÉΓòÉΓòÉ 2. Using CSF ΓòÉΓòÉΓòÉ

Your interface to CSF depends on the environment in which your system is
running.  You use the graphical SERVICE facility to update a single running
system or the command-oriented FSERVICE response file to update multiple
systems in a LAN environment.


ΓòÉΓòÉΓòÉ 2.1. Using the SERVICE Facility ΓòÉΓòÉΓòÉ

The SERVICE facility is a graphical interface that uses service windows to
prompt you for input when applying service to one or more products on your
system.  Follow the steps below to start CSF and use the SERVICE facility.

 1. Open an OS/2 window.

 2. Insert "CSF Diskette 1" into drive A

 3. Change the directory to drive A.

 4. Type SERVICE at the command prompt, and press Enter.

 5. In the OS/2 Corrective Service Facility window, select Ok to display the
    Serviceable Products window.


ΓòÉΓòÉΓòÉ 2.1.1. Applying Service ΓòÉΓòÉΓòÉ

The Serviceable Products window displays the products on your system to which
service can be applied.  The serviceable products displayed in the Products
field:

o Are installed on your system
o Have updates in the FixPak or ServicePak that you are applying
o Have SYSLEVEL files that are compatible with the SYSLEVEL files of the
  service you are applying.

All serviceable products are initially selected and highlighted in the Products
field.  If you do not want to apply service to one or more products listed,
deselect those products that you do not want to service.  The products that you
deselect will no longer be highlighted and service will not be applied to them.

If this is the first time that service is being applied to a selected product,
you must specify in the Archive field the path and directory for the archive of
the product.  If an archive already exists for the product, you cannot modify
the path that appears in the Archive field.  See Restoring a Product to Its
Base Level for more information on archives and archive paths.

If service has been applied previously to a selected product, you can
optionally specify in the Backup field the path and directory for a backup of
the product.  If an archive has not yet been saved for the product, you will
not be able to modify the Backup field.  See Restoring a Product to a Previous
Fix Level for more information on backups and backup paths.

When only the products to which you are applying service are highlighted,
select Service to apply service to the products.  To display a list of products
that have archives, backups, or a list of products that can be committed,
select Change Product List.


ΓòÉΓòÉΓòÉ 2.1.2. Changing the Product List ΓòÉΓòÉΓòÉ

The Change Product List push button displays a window in which you can select
one of the four product lists that CSF maintains.  The type of product list
that you select determines the actions you can perform on the selected
products.  If you select a product list that does not exist, such as when no
products on the system have backups, CSF issues a message.

CSF maintains the following product lists:

Serviceable Products
          A list of products on your system to which you can apply service.
          When you select Serviceable Products, you can use the window that is
          displayed to apply service to the selected products.

Archived Products
          A list of products on your system that have archives.  When you
          select Archived Products, you can use the window that is displayed to
          restore the selected products to the archive level or to redirect CSF
          to a different archive location.

Backed Up Products
          A list of products on your system that have backups.  When you select
          Backed Up Products, you can use the window that is displayed to
          restore the selected products to the backup level.

Uncommitted Products
          A list of products on your system that can be committed.  When you
          select Uncommitted Products, you can use the window that is displayed
          to commit the selected products.


ΓòÉΓòÉΓòÉ 2.1.3. Redirecting CSF to Another Archive ΓòÉΓòÉΓòÉ

Use this window to direct CSF to an archive in a location that is different
from the one specified in the Source directory field.

To display the Redirect Service window:

 1. Select the Change Product List push button.
 2. Select the Archived products radio button.
 3. In the Archived Products window, all products are initially selected.
    Deselect the products with archives that are to remain unchanged, and then
    select the Redirect pushbutton.

When the Redirect Service window is displayed, you can view the list of
products that have archives (in the Product field) and the location of the
archives (in the Source directory field).

Enter the new archive path in the Target directory field.  The archive path can
be on a diskette, on a local drive, or a network drive, and the archive files
must be in place in the new location before you select Ok.


ΓòÉΓòÉΓòÉ 2.1.4. Backing Out of a Service Package ΓòÉΓòÉΓòÉ

Use the Back Out Service window to restore a product to its archive level or
backup level.

To display the Back Out Service window:

 1. Select the Change Product List push button.

 2. Do one of the following:

   o To restore a product to its archive level, select the Archived Products
     radio button.  In the Archived Products window, all products are initially
     selected.  Deselect the products that are not to be restored to the
     archive level, and then select the Back Out push button.

   o To restore a product to its backup level, select the Backed Up Products
     radio button.  In the Backed Up Products window,  all products are
     initially selected.  Deselect the products that are not to be restored to
     the backup level, and then select the Back Out push button.

When the Back Out Service window is displayed, you can view the selected
products (in the Products field) and the level to which they will be backed out
(in the Target Level field).  Select Ok to restore the product to the target
level.


ΓòÉΓòÉΓòÉ 2.1.5. Committing a Product ΓòÉΓòÉΓòÉ

Use this window to commit a product with either a FixPak or a ServicePak
applied.

Committing a product with a FixPak applied frees the disk space used by the
backup for that product and removes the ability to restore the product to the
backup level.  You can still restore the product to the archive level.

Committing a product with a ServicePak applied frees the disk space used by the
backup for that product and removes the reference to the archive.  You cannot
restore the product to either the backup or archive level.

To display the Commit Service window:

 1. Select the Change Product List push button.
 2. Select the Uncommitted Products radio button.
 3. In the Uncommitted Products window, all products are initially selected.
    Deselect the products you do not want to commit, and then select the Commit
    push button.

When the Commit Service window is displayed, you can view the product list,
archive level, and back up level, and select Ok to commit the products.


ΓòÉΓòÉΓòÉ 2.2. Using the FSERVICE Response File ΓòÉΓòÉΓòÉ

This section provides a detailed look at the tags and syntax used in the
FSERVICE response file.  High-level examples follow the syntax descriptions.
It also describes the FSERVICE command and parameters.

Code your service request in the response file before starting the FSERVICE
facility. Sample response files are included on:

"CSF Diskette 2" if you have 3.5-inch diskettes
"CSF Diskette 3" if you have 5.25-inch diskettes
You can edit the sample file and customize the tags for your request.  If you
want to create a new response file, open a file named RESPONSE.FIL and code
your FSERVICE request in it.  Specify the location of the new response file in
the CONFIG.SYS file or on the command line when you invoke FSERVICE.  (See
FSERVICE Command for information about the FSERVICE command and parameters, and
the location of the CONFIG.SYS file.)

Follow the steps below to start the FSERVICE facility.

 1. Open an OS/2 window.
 2. Insert "CSF Diskette 1" into drive A.
 3. Change the directory to drive A.
 4. Type FSERVICE at the command prompt, and press Enter.
 5. Follow the instructions on your screen.


ΓòÉΓòÉΓòÉ 2.2.1. Applying Service to Multiple Systems ΓòÉΓòÉΓòÉ

The method of submitting your response file to CSF and applying service to
multiple systems varies by the type of environment and how it has been set up.
Review the documentation for your client-server environment before attempting
to apply service in a LAN environment, and refer to the information in
README.CID on the OS/2 Warp installation diskettes as well as the information
in this document.


ΓòÉΓòÉΓòÉ 2.2.2. Response File Syntax ΓòÉΓòÉΓòÉ

You use two kinds of tags to code CSF requests in your response file. "General"
tags specify how CSF is to process all the service requests in the response
file.  "Keyword" tags indicate the actions that CSF is to take and the products
against which CSF is to take them.

The following sections describe the general and keyword tags.


ΓòÉΓòÉΓòÉ 2.2.3. General Tags ΓòÉΓòÉΓòÉ

General tags indicate how CSF is to process the service requests in a response
file. There are four general tags.  The general tags describe:

o The location of an alternate log file to contain the service history
o Whether CSF is to issue or bypass certain verification messages
o The location of the service package or the source path
o The location of the archive or backup

The following summary describes the optional and required general tags, and
with which keyword tags they are coded.

General Tag   Keyword Requirements

:LOGFILE      Optional - can be coded with any keyword

:FLAGS        Optional - if coded, must be coded with :SERVICE

:SOURCE       Optional - if coded, must be coded with :SERVICE

:TARGET       Required with :BACKOUT

Code any required general tags before their keyword tags in the response file.
If a required general tag appears after its keyword in a file, FSERVICE will
fail. If a general tag that is not required follows a keyword tag in the
response file, the general tag will be ignored.  A general tag is not
position-dependent with other general tags, but each general tag must occur
only once in a response file.

:LOGFILE  drive\path\filename

          Specifies that a log file other than the default log file is to be
          used.  (The default log file is named SERVICE.LOG and is located on
          the directory of the SYSLEVEL file for the product.)  Specify the
          drive, directory, and name of the alternate log file.  CSF creates
          the alternate log file if it does not exist and appends the service
          history to the log file after it has been created.

          :LOGFILE is optional.

:FLAGS    flag1 Γöé flag2 Γöé flag3

          Indicates that CSF is to bypass the specified verification messages
          while applying service. Code :FLAGS only when you code the :SERVICE
          keyword tag.  If you specify :FLAGS in a response file that does not
          have the :SERVICE tag, the flags will be ignored.

          :FLAGS is optional.  When you code :FLAGS, you must specify one or
          more of the following flags:

   REPLACE_NEWER
                     Specifies that CSF is to replace product files that have
                     more recent dates than the corresponding files on the
                     service package.  If REPLACE_NEWER is not specified, each
                     time CSF finds a file with a more recent date than those
                     in the service package, you must verify that the file can
                     be replaced or cancel the replacement of the file.

                     REPLACE_NEWER is coded in the sample response file on CSF
                     diskette 2.  Specify REPLACE_NEWER to avoid multiple
                     verification messages when applying service to multiple
                     products.

   REPLACE_PROTECTED
                     Specifies that CSF is to replace files that are read-only,
                     hidden, or system files.  If REPLACE_PROTECTED is not
                     specified, each time CSF finds a protected file, you must
                     verify that the file can be replaced or cancel the
                     replacement of the file.

                     REPLACE_PROTECTED is coded in the sample response file on
                     CSF diskette 2.  Specify REPLACE_PROTECTED to avoid
                     multiple verification messages when applying service to
                     multiple products.

   EXIT_WHEN_DONE
                     Tells FSERVICE to stop if any errors are encountered and
                     to report the errors.

:SOURCE   drive\path

          Specifies the drive and directory of the service package you are
          applying to a product.  :SOURCE is optional.  You can specify :SOURCE
          in a response file that contains a :SERVICE tag, or on the command
          line when submitting a response file that contains the :SERVICE tag.
          If :SOURCE is omitted when :SERVICE is specified, the default source
          drive is drive A.  If :SOURCE is coded in a response file that does
          not contain the :SERVICE tag, it is ignored.

:TARGET   ARCHIVE Γöé BACKUP

          Specifies that a product is to be backed out of a service package and
          restored to either the backup or archive level.  You can specify only
          one :TARGET keyword per response file.  All back out requests
          (specified by the :BACKOUT keyword tag) in the response file restore
          products to the level (either ARCHIVE or BACKUP) specified on
          :TARGET.  To restore one product to the archive level and another
          product to the backup level, code the requests in separate response
          files.

          :TARGET is required in response files that contain the :BACKOUT
          keyword.  When you code :TARGET, it must appear in the response file
          before the :BACKOUT keyword, and it must specify either ARCHIVE or
          BACKUP.  If :TARGET appears in the response file before the :BACKOUT
          keyword, FSERVICE will fail.  If :TARGET appears in a response file
          that does not contain the :BACKOUT tag, it is ignored.

*

          Specifies that a comment follows.


ΓòÉΓòÉΓòÉ 2.2.4. Keyword Tags ΓòÉΓòÉΓòÉ

Keyword tags indicate the action to be taken against a specific product.
Because the same product can be installed multiple times or in multiple
partitions on a system, all keyword tags include a :SYSLEVEL tag to identify
the specific occurrence of the product being updated or restored.

You can use a single response file to take action against multiple products or
multiple occurrences of the same product.  However, you cannot code conflicting
actions for the same product occurrence (represented by the same SYSLEVEL
file), such as simultaneously committing a product and restoring it to its
backup level.  Similarly, you cannot duplicate requests against the same
product occurrence.  Conflicting or duplicate requests against a single product
occurrence will cause FSERVICE to fail.

:SERVICE
          Specifies that a service package is to be applied to a product.
          :SERVICE has two position-dependent parameter tags that must follow
          it and one optional parameter tag.  Each tag must be on a line by
          itself.  The parameter tags are:

   :SYSLEVEL drive\path\SYSLEVEL.xxx

             Specifies the drive and directory of the SYSLEVEL file of the
             product being serviced.  This tag must follow the :SERVICE keyword
             in the response file.  If you do not specify a drive, CSF applies
             service to all partitions.

   :ARCHIVE  drive\path

             Specifies the drive and directory of the archive of the product
             being serviced.  This tag must follow the :SERVICE keyword in the
             response file if this is the first time that service is being
             applied to the product.  If you do not specify a drive, CSF will
             create an archive on all partitions to which service is being
             applied.

   :BACKUP   drive\path

             Specifies the drive and directory of the BACKUP of the product
             being serviced.  This tag can optionally follow the :SERVICE
             keyword in the response file if an archive for the product already
             exists.  If you do not specify a drive, CSF will create a backup
             on all partitions to which service is being applied.

:BACKOUT
          Specifies that the product is to be backed out of a FixPak or
          ServicePak to the level specified on the :TARGET tag.  :BACKOUT has
          one position-dependent parameter tag, which must follow it on a line
          by itself. The parameter tag is:

   :SYSLEVEL drive\path\SYSLEVEL.xxx

             Specifies the drive, directory, and file name of the SYSLEVEL file
             of the product being backed out of a service package.  This tag
             must follow the :BACKOUT keyword in the response file.

:REDIRECT
          Specifies that CSF is to be redirected to a product archive other
          than the current product archive.  :REDIRECT has two
          position-dependent parameter tags that must follow it, each of which
          must be on a line by itself.  The parameter tags are:

   :SYSLEVEL drive\path\SYSLEVEL.xxx

             Specifies the drive, directory, and file name of the SYSLEVEL file
             of the product associated with the archive being redirected.  This
             tag must follow the :REDIRECT keyword in the response file.

   :ARCHIVE  drive\path

             Specifies the drive and directory of the new archive location.
             This tag must follow the :REDIRECT keyword in the response file.

:COMMIT
          Specifies that a product is to be committed with either a FixPak or a
          ServicePak applied to it. :COMMIT has one position-dependent
          parameter tag, which must follow it on a line by itself. The
          parameter tag is:

   :SYSLEVEL drive\path\SYSLEVEL.xxx

             Specifies the drive, directory, and file name of the SYSLEVEL file
             of the product being committed.  This tag must follow the :COMMIT
             keyword in the response file.


ΓòÉΓòÉΓòÉ 2.2.5. Applying Service ΓòÉΓòÉΓòÉ

The following example illustrates the FSERVICE response file syntax for
applying service to a product and creating an archive on drive D.  The :SOURCE
general tag must appear before the keywords in the response file.  If coded,
the :FLAGS general tag must also appear before the keywords in the response
file and must specify at least one of the three flags.


:SOURCE A:\
:FLAGS   REPLACE_NEWER REPLACE_PROTECTED
:SERVICE
:SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
:ARCHIVE D:\ARCHIVE


ΓòÉΓòÉΓòÉ 2.2.6. Redirecting CSF to Another Archive ΓòÉΓòÉΓòÉ

The following example illustrates the FSERVICE response file syntax for
redirecting CSF to an archive on a LAN.  There are no required general tags and
no optional tags.  Both :SYSLEVEL and :ARCHIVE must follow the :REDIRECT tag.


:REDIRECT
:SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
:ARCHIVE X:\CSD\OS2V3\ARCHIVE


ΓòÉΓòÉΓòÉ 2.2.7. Backing Out of a Service Package ΓòÉΓòÉΓòÉ

The following example illustrates the FSERVICE response file tags for backing
out of a fix service package or a ServicePak to the previous fix level.  There
are no optional tags.  You must specify BACKUP on the TARGET general tag to
return to the previous fix level.


:TARGET  BACKUP
:BACKOUT
:SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2


ΓòÉΓòÉΓòÉ 2.2.8. Committing a Product ΓòÉΓòÉΓòÉ

The following example illustrates the FSERVICE response file tags for
committing a product to a FixPak or a ServicePak.  There are no required
general tags and no optional tags.


:COMMIT
:SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2


ΓòÉΓòÉΓòÉ 2.2.9. FSERVICE Command ΓòÉΓòÉΓòÉ

You can use the FSERVICE command and parameters to provide additional input to
FSERVICE about your service request, or to override the information specified
in your response file.  The FSERVICE command can be used in two ways:

o When you have a command prompt available, such as when you invoke SEMAINT in
  a CID environment, you can specify the FSERVICE command at the command
  prompt.

o You can modify the FSERVICE parameters in the CONFIG.SYS file.

  The CONFIG.SYS file is on "CSF Diskette 2" if you have 3.5-inch diskettes and
  "CSF Diskette 3" if you have 5.25-inch diskettes.

The parameters that you specify on the command line override the response file
tags. The parameters that you specify in the CONFIG.SYS file override those
specified on the command line.

?
          Displays the FSERVICE command syntax and parameter descriptions on
          your computer screen.

/S:drive\path
          Specifies the fully-qualified path to the ServicePak images.  The
          path can specify either a local hard disk or a redirected drive on
          the code server.  The path depends on the directory structure you
          have set up.  If you use the directory structure recommended in the
          "LAN Configuration, Installation, and Distribution Utility Guide" and
          an OS/2 2.0 ServicePak, the path is <drive>\CSD\OS2V20\CSD01.

          This parameter is required.

/T:drive\path
          Specifies the fully-qualified path to the directory from which the
          system was started.  If the system was started from a maintenance
          system on the hard disk, this path matches the /T: parameter
          specified on the SEMAINT command.  FSERVICE restores the CONFIG.SYS,
          STARTUP.CMD, and AUTOEXEC.BAT files from backups located in this
          directory.

          This parameter is optional.  If you specify  /T:drive\path when CSF
          is started from diskette, CSF does not validate the path specified on
          this parameter.

/R:path\filename.ext
          Specifies the fully-qualified path to the FSERVICE response file.  If
          you use the directory structure recommended in the "LAN
          Configuration, Installation, and Distribution Utility Guide" and an
          OS/2 2.0 ServicePak, the response file is located on
          <drive>\CSD\OS2V20\CSD01.

          This parameter is required.

/L1:path\filename.ext

/L:path\filename.ext
          Specifies the fully-qualified path to the service log.

          This parameter is optional.

/CID
          Specifies that FSERVICE is to restore the following files from the
          backups made by SEMAINT:

   o OS2BOOT
   o OS2KRNL
   o OS2LDR
   o OS2DASD.DMD
   o OS2SCSI.DMD
   o OS2LDR.MSG

          This parameter is optional.  Specify /CID only when FSERVICE is
          running under a maintenance system created by SEMAINT.

/LARGE
          Specifies that the service package is on CD-ROM.


ΓòÉΓòÉΓòÉ 3. Notices ΓòÉΓòÉΓòÉ

References in this publication to IBM products, programs, or services do not
imply that IBM intends to make these available in all countries in which IBM
operates. Any reference to an IBM product, program or service is not intended
to state or imply that only IBM's product, program, or service may be used. Any
functionally equivalent product, program, or service that does not infringe any
of IBM's intellectual property rights or other legally protectable rights may
be used instead of the IBM product, program, or service. Evaluation and
verification of operation in conjunction with other products, programs, or
services, except those expressly designated by IBM, are the user's
responsibility.

IBM may have patents or pending patent applications covering subject matter in
this document. The furnishing of this document does not give you any license to
these patents. You can send license inquiries, in writing, to the IBM Director
of Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood NY 10594, U.S.A.

IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WITHOUT
LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH RESPECT TO THE
INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO
LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.


ΓòÉΓòÉΓòÉ 3.1. Trademarks ΓòÉΓòÉΓòÉ

The following terms, denoted by an asterisk (*) in this publication, are
trademarks of the IBM Corporation in the United States or other countries.

NetView
OS/2