home *** CD-ROM | disk | FTP | other *** search
/ IBM Presents OS/2 Software Hits 1995 / OS-2_SW_HITS_2ND_EDITION_1995.ISO / i17 / warpbdsk.1dk / README.CSF < prev    next >
Text File  |  1994-11-09  |  49KB  |  1,419 lines
  1.                                            Page 1
  2.  
  3.  
  4.           USING THE CORRECTIVE SERVICE FACILITY
  5.  
  6.  
  7.   CONTENTS
  8.   ________
  9.  
  10.  
  11.   CORRECTIVE SERVICE FACILITY OVERVIEW   . . . . . .  1
  12.   Applying Service in Single System and LAN
  13.    Environments  . . . . . . . . . . . . . . . . . .  3
  14.   Ensuring That Service is Appropriate   . . . . . .  4
  15.   Restoring a Product to a Previous Level  . . . . .  4
  16.     Restoring a Product to Its Base Level  . . . . .  5
  17.     Restoring a Product to a Previous Fix Level  . .  8
  18.     Redirecting CSF to a Different Archive   . . . .  9
  19.   Committing a Product with Service Applied  . . .   10
  20.   Viewing the Service Log  . . . . . . . . . . . .   11
  21.   Handling Unexpected Conditions   . . . . . . . .   14
  22.  
  23.   USING CSF  . . . . . . . . . . . . . . . . . . .   16
  24.   Using the SERVICE Facility   . . . . . . . . . .   16
  25.     Applying Service   . . . . . . . . . . . . . .   17
  26.     Changing the Product List  . . . . . . . . . .   19
  27.     Redirecting CSF to Another Archive   . . . . .   20
  28.     Backing Out of a Service Package   . . . . . .   21
  29.     Committing a Product   . . . . . . . . . . . .   22
  30.   Using the FSERVICE Response File   . . . . . . .   23
  31.     Applying Service to Multiple Systems   . . . .   25
  32.     Response File Syntax   . . . . . . . . . . . .   25
  33.  
  34.  
  35.     General Tags   . . . . . . . . . . . . . . . .   26
  36.     Keyword Tags   . . . . . . . . . . . . . . . .   32
  37.     Applying Service   . . . . . . . . . . . . . .   36
  38.     Redirecting CSF to Another Archive   . . . . .   37
  39.     Backing Out of a Service Package   . . . . . .   38
  40.     Committing a Product   . . . . . . . . . . . .   38
  41.     FSERVICE Command   . . . . . . . . . . . . . .   39
  42.  
  43.   NOTICES  . . . . . . . . . . . . . . . . . . . .   43
  44.   Trademarks   . . . . . . . . . . . . . . . . . .   44
  45.  
  46.  
  47.                                            Page 1
  48.  
  49.  
  50.   CORRECTIVE SERVICE FACILITY OVERVIEW
  51.   ____________________________________
  52.  
  53.  
  54.   Corrective Service Facility (CSF) is a utility
  55.   program that you can use to apply service updates to
  56.   the OS/2* operating system and to OS/2-based
  57.   subsystems and applications.  You can use CSF to
  58.   apply either a full service package (ServicePak) or a
  59.   fix service package (FixPak).
  60.  
  61.   A ServicePak contains all code fixes that have been
  62.   developed since the last product release.  Applying a
  63.   ServicePak updates the corrective service level
  64.   (current CSD level) of the product.  (You can display
  65.   the current CSD level by entering the SYSLEVEL
  66.   command from an OS/2 command prompt.)
  67.  
  68.   A FixPak replaces or updates a subset of product
  69.   files.  Applying a FixPak updates the fix level of
  70.   the product but does not affect the current CSD
  71.   level.  (You can view the fix level of the product in
  72.   the service log, described in "Viewing the Service
  73.   Log" on page 11.)
  74.  
  75.  
  76.                                            Page 2
  77.  
  78.  
  79.   CSF simplifies the process of applying service to a
  80.   product because CSF:
  81.  
  82.   o   Lets you apply service to either a single system
  83.       or to multiple systems in a LAN environment
  84.  
  85.   o   Prevents you from applying service that is
  86.       inappropriate for your system
  87.  
  88.   o   Allows you to "back out" of the service you
  89.       applied, which restores your system to a previous
  90.       level
  91.  
  92.   o   Allows you to "commit" to the level of service
  93.       you applied, which frees disk space on your
  94.       system used by CSF
  95.  
  96.   o   Creates a service log that tracks all service
  97.       applied to a product
  98.  
  99.   o   Handles unexpected conditions while continuing to
  100.       apply service
  101.  
  102.   The sections that follow define CSF terms and explain
  103.   the CSF process.  The steps to use CSF are described
  104.   in "Using CSF" on page 16.
  105.  
  106.  
  107.                                            Page 3
  108.  
  109.  
  110.   APPLYING SERVICE IN SINGLE SYSTEM AND LAN
  111.   _________________________________________
  112.   ENVIRONMENTS
  113.   ____________
  114.  
  115.   CSF provides an interface for applying service to a
  116.   single system and an interface for applying service
  117.   in a LAN environment:
  118.  
  119.   The SERVICE facility is a graphical interface for
  120.   updating a single system without restarting the
  121.   system.  SERVICE prompts you to enter information in
  122.   service windows and enables you to choose the
  123.   products you want to update with service or restore
  124.   to an earlier level.
  125.  
  126.   The FSERVICE facility is a command-oriented
  127.   interface.  You can use FSERVICE in a minimal OS/2
  128.   environment, such as when you start CSF from
  129.   diskette, and in attended or unattended
  130.   configuration, installation, and distribution (CID)
  131.   environments and NetView* Distribution Manager/2
  132.   (NetView DM/2) environments, in which service is
  133.   applied to multiple remote systems attached to a
  134.   local area network (LAN).  You submit your service
  135.   request to FSERVICE using command line parameters and
  136.   a response file in which you code your service
  137.   request using FSERVICE keywords and parameters.
  138.  
  139.  
  140.                                            Page 4
  141.  
  142.  
  143.   ENSURING THAT SERVICE IS APPROPRIATE
  144.   ____________________________________
  145.  
  146.   Whether you use SERVICE or FSERVICE, CSF ensures that
  147.   the country code, version, release level, and current
  148.   CSD level of your product are compatible with the
  149.   service updates, and will not proceed with service if
  150.   there is a mismatch.  Information about the level of
  151.   the products on your system is contained in the
  152.   SYSLEVEL.xxx file on the OS2 directory of the boot
  153.   drive.
  154.  
  155.  
  156.   RESTORING A PRODUCT TO A PREVIOUS LEVEL
  157.   _______________________________________
  158.  
  159.   Occasionally, even a service package that is
  160.   compatible with a product can cause problems when it
  161.   interacts with the other products on your system.
  162.   CSF enables you to remove a service package and
  163.   restore your product to its previous level without
  164.   requiring you to reinstall the product.  Removing a
  165.   service package is called "backing out" of a
  166.   ServicePak or a FixPak.
  167.  
  168.   CSF enables you to restore a product in either of two
  169.   ways:
  170.  
  171.   o   You can remove all service applied to the product
  172.       since it was installed or last committed, which
  173.  
  174.  
  175.                                            Page 5
  176.  
  177.  
  178.       restores the product to its base level.
  179.       ("Committing a Product with Service Applied" on
  180.       page 10  explains what it means to "commit" a
  181.       product.)
  182.   o   You can remove the most recent service package
  183.       applied to the product, which restores the
  184.       product to its previous fix level.
  185.  
  186.  
  187.   RESTORING A PRODUCT TO ITS BASE LEVEL
  188.  
  189.   Depending on the product you are servicing, CSF might
  190.   save a copy of your product files before applying
  191.   service to the product.  This copy of your "base"
  192.   (installed or committed) level files is called an
  193.   archive.  You can use an archive to restore your
  194.   product to its base level at any time during service.
  195.  
  196.   In general, an archive is required by products that
  197.   take considerable time and multiple diskettes to
  198.   install, and not required by products that can be
  199.   reinstalled easily with few diskettes.  When a
  200.   product requires an archive, neither the SERVICE nor
  201.   FSERVICE facilities will apply service to it until
  202.   you specify a location for the archive.  When a
  203.   product does not require an archive, the SERVICE
  204.   facility will not allow you to specify an archive
  205.   location.  The FSERVICE facility will return the
  206.  
  207.  
  208.                                            Page 6
  209.  
  210.  
  211.   error message "Archiving is disabled for the product"
  212.   and provide the path to the SYSLEVEL file for the
  213.   product.
  214.  
  215.   When an archive is required, CSF copies the product
  216.   files that are at the base level and are to be
  217.   updated by a service package.  CSF saves these copies
  218.   in the archive before applying service.  The first
  219.   time you apply a service package to a base-level
  220.   product, all files to be updated by the service
  221.   package are copied into the archive.  Each time you
  222.   apply a subsequent service package to the product,
  223.   CSF copies into the archive only the product files
  224.   that were not serviced previously (the product files
  225.   that are still at the base level.)  If service has
  226.   been applied to the file before, the file is not
  227.   copied into the archive.  In this way, CSF saves a
  228.   copy of your base-level product that you can restore
  229.   even after you have applied multiple service
  230.   packages.
  231.  
  232.   For example, FixPak 1 updates product files A, B, and
  233.   C, and FixPak 2 updates product files C and D.  The
  234.   product to which they are being applied is at the
  235.   base level.  Before applying FixPak 1, CSF copies
  236.   files A, B, and C to the archive location you
  237.   provide.  When you later apply FixPak 2, CSF copies
  238.   file D into the archive, because file D is still at
  239.  
  240.  
  241.                                            Page 7
  242.  
  243.  
  244.   base level.  File C was updated by FixPak 1 and is no
  245.   longer at base level, so CSF does not copy it into
  246.   the archive.
  247.  
  248.   When a product requires an archive, you must specify
  249.   an archive location when you:
  250.  
  251.   o   Apply service to a product for the first time
  252.   o   Apply service to your product for the first time
  253.       after committing the product with a service
  254.       package applied
  255.  
  256.   You can save an archive on diskette or on a local or
  257.   remote hard disk.  You should provide 5 to 10
  258.   megabytes of disk space for a product archive.  After
  259.   an archive has been created for a product, CSF uses
  260.   that archive until you:
  261.  
  262.   o   Redirect CSF to an archive at another location
  263.       (described in "Redirecting CSF to a Different
  264.       Archive" on page 9)
  265.  
  266.   o   Commit the product with a ServicePak applied to
  267.       it
  268.  
  269.   CSF saves only one archive per product.  It adds to
  270.   the archive each time a service package updates a
  271.   base-level file.  You can save copies of product
  272.  
  273.  
  274.                                            Page 8
  275.  
  276.  
  277.   files with service applied by creating a backup of
  278.   your product files each time you apply a new service
  279.   package.
  280.  
  281.  
  282.   RESTORING A PRODUCT TO A PREVIOUS FIX LEVEL
  283.  
  284.   A backup is a copy of product files to which service
  285.   has been applied at least once.  At your request, CSF
  286.   saves a copy of your current product files before
  287.   applying the next level of service to the product.
  288.   The backup enables you to restore your product to its
  289.   level of service before the most recent service was
  290.   applied.
  291.  
  292.   You request a backup by specifying a path and
  293.   directory in which CSF is to create the backup.  The
  294.   directory can be located on either a local drive or
  295.   diskette but cannot be on a network drive.  If both
  296.   the archive and the backup are located on diskette,
  297.   they must be on separate diskettes.
  298.  
  299.   Creating a backup is optional.  However, if you do
  300.   not create a backup when you apply service, the only
  301.   way to back out of the current service package is to
  302.   restore the product to the archive level.  You cannot
  303.   use a backup created when you applied an earlier
  304.   service package to back out of the current service
  305.  
  306.  
  307.                                            Page 9
  308.  
  309.  
  310.   package.  If a product has one or more FixPaks
  311.   applied to it, it is a good idea to create a backup
  312.   before applying a new FixPak.  The backup enables you
  313.   to restore the product with any previously-applied
  314.   service intact.
  315.  
  316.   You can have only one backup of a product at a time.
  317.   If a backup already exists when you request a backup,
  318.   the older backup is deleted.  You cannot create a
  319.   backup before an archive has been saved.
  320.  
  321.  
  322.   REDIRECTING CSF TO A DIFFERENT ARCHIVE
  323.  
  324.   At some time after CSF has created an archive, you
  325.   might want to move the archive to another location,
  326.   such as a drive with more free disk space, or a LAN
  327.   server where multiple systems with identical product
  328.   levels can share the archive.  After you (or your LAN
  329.   administrator) have copied the archive to the new
  330.   location, you can redirect CSF to use the new archive
  331.   location.  (The archive files must be present at the
  332.   new archive location before you redirect CSF, and the
  333.   system level and files of the archive in the new
  334.   location must match those of the archive in the old
  335.   location.)  Redirecting CSF changes the reference to
  336.   the archive location but does not copy the files.
  337.  
  338.  
  339.                                           Page 10
  340.  
  341.  
  342.   After you ensure that the archive files exist in the
  343.   new location, you can use the Redirect window of the
  344.   SERVICE facility or the REDIRECT keyword of the
  345.   FSERVICE facility to redirect CSF to the new archive
  346.   location.
  347.  
  348.  
  349.   COMMITTING A PRODUCT WITH SERVICE APPLIED
  350.   _________________________________________
  351.  
  352.   After you apply service to a product, you will
  353.   probably spend some time testing it to see how the
  354.   service affects your system.  When you are satisfied
  355.   with a service package, you no longer need the
  356.   ability to restore your previous level system.  At
  357.   this point, you can commit the product with the
  358.   service installed.
  359.  
  360.   Committing the product with a FixPak applied frees
  361.   the disk space used by your backup files.  Committing
  362.   a product with a ServicePak applied frees the disk
  363.   space used by the backup files and also removes the
  364.   reference to the archive.  To free the disk space
  365.   used by the archive, you must manually delete the
  366.   archive files.  CSF does not delete archive files
  367.   because they can be used by multiple systems or
  368.   products.
  369.  
  370.  
  371.                                           Page 11
  372.  
  373.  
  374.   After a product is committed, you cannot restore the
  375.   product to an earlier fix level.  When you commit a
  376.   product with a ServicePak applied, you cannot restore
  377.   the product to an earlier fix level or to the archive
  378.   level.
  379.  
  380.   After applying a ServicePak to a product, you must
  381.   commit the product before you can apply additional
  382.   service to it.  The SERVICE facility identifies the
  383.   products that must be committed before you can apply
  384.   additional service.  It also enables you to commit
  385.   those products from a single window.  Committing a
  386.   product before applying additional service makes it
  387.   easier to identify which service package to back out
  388.   of, should a fix be incompatible with your system.
  389.  
  390.  
  391.   VIEWING THE SERVICE LOG
  392.   _______________________
  393.  
  394.   CSF creates a service log in which it tracks all
  395.   service applied to a product.  The service log is
  396.   named SERVICE.LOG, and is located by default on the
  397.   OS2\INSTALL directory of the boot drive.  (The
  398.   FSERVICE utility enables you to specify a different
  399.   location for the service log.)
  400.  
  401.   The service log contains the following information:
  402.  
  403.  
  404.                                           Page 12
  405.  
  406.  
  407.   o   The name and level of the product that was
  408.       updated.
  409.  
  410.   o   The specific identity and level of the FixPak
  411.       that was installed.
  412.  
  413.   o   The date and time the FixPak was installed.
  414.  
  415.   o   The type of CSF operation (for example, the
  416.       application of a FixPak or a back out to a
  417.       previous service level).
  418.  
  419.   o   The new files that have been copied to the disk.
  420.       Copy operations are logged with lines that are
  421.       labelled "Copying" and include the full path name
  422.       of the file on the disk.
  423.  
  424.   o   The existing files that have been updated on the
  425.       disk.  Updates are considered to be either full
  426.       file replacements or file patches.  Update
  427.       operations are logged with lines that are
  428.       labelled "Updating" and that include the full
  429.       path name of the target file on the disk.
  430.  
  431.   o   The files that have been copied to an archive.
  432.       Archive operations are logged with lines that are
  433.       labelled "Archiving" and that include the full
  434.       path name of the file in the archive path.
  435.  
  436.  
  437.                                           Page 13
  438.  
  439.  
  440.   o   The files that have been copied to the backup.
  441.       Backup operations are logged with lines that are
  442.       labelled "Backing up" and include the full path
  443.       name of the file in the backup path.
  444.  
  445.   CSF also creates and maintains the following files
  446.   for its own use.  DO NOT MODIFY THE FOLLOWING FILES:
  447.  
  448.       ARCHIVE_.xxx
  449.       FIXSTART
  450.       All files in the IBMCSFLK directory
  451.       IBMCSFLK.DLL
  452.       IBMCSFLK.EXE
  453.       IBMCSFLK.LST
  454.       IBMCSFLK.LOG
  455.       IBMCSFLK.MGT
  456.       IBMCSFLK.SYS
  457.       LOGF0000.xxx
  458.       LOGSTART.xxx
  459.  
  460.  
  461.                                           Page 14
  462.  
  463.  
  464.   HANDLING UNEXPECTED CONDITIONS
  465.   ______________________________
  466.  
  467.   CSF handles unexpected conditions, such as locked
  468.   files and service interruptions.  When CSF encounters
  469.   a locked file that is to be updated or replaced, it
  470.   postpones the processing of that file until the next
  471.   time you restart the system, and it continues
  472.   applying service.  To process the locked files, you
  473.   must restart the system before you can apply another
  474.   service package to it; however, you can delay
  475.   restarting until a convenient time, such as the end
  476.   of the work day.
  477.  
  478.   If you are using the SERVICE facility and CSF finds
  479.   that there is not enough free disk space on your
  480.   system to process locked files, you will be prompted
  481.   to use the FSERVICE facility.  The response file
  482.   CSF_SEL.000 (on the root directory of the first boot
  483.   drive) contains the tags generated by your input to
  484.   the SERVICE facility up until CSF attempted to
  485.   process the locked files.  Complete the response file
  486.   using the syntax described in "Using the FSERVICE
  487.   Response File" on page 23 and  restart CSF from
  488.   diskette.
  489.  
  490.   If a service interruption such as a power outage or a
  491.   cable disconnection occurs while you are using
  492.   SERVICE or FSERVICE in an attended CID environment,
  493.  
  494.  
  495.                                           Page 15
  496.  
  497.  
  498.   you can allow CSF to continue to apply service or
  499.   discontinue applying service temporarily.  When you
  500.   resume the service, CSF begins at the point when the
  501.   interruption occurred and continues to apply service.
  502.  
  503.   If you are using FSERVICE in an unattended CID or
  504.   NetView DM/2 environment when a service interruption
  505.   occurs, CSF returns an error to the host and you
  506.   cannot apply subsequent service packages until you
  507.   successfully reapply the interrupted service package.
  508.   A message in the log file indicates that recovery is
  509.   pending for a particular service package.
  510.  
  511.   NOTE:  If a service interruption occurs, it is a good
  512.   idea to issue the OS/2 command CHKDSK with the /F
  513.   parameter before resuming service.  CHKDSK analyzes
  514.   files and cleans up file fragments that might result
  515.   from a service interruption.  See "OS/2 Command
  516.   Reference" for information about the CHKDSK command.
  517.  
  518.  
  519.                                           Page 16
  520.  
  521.  
  522.   USING CSF
  523.   _________
  524.  
  525.  
  526.   Your interface to CSF depends on the environment in
  527.   which your system is running.  You use the graphical
  528.   SERVICE facility to update a single running system or
  529.   the command-oriented FSERVICE response file to update
  530.   multiple systems in a LAN environment.
  531.  
  532.  
  533.   USING THE SERVICE FACILITY
  534.   __________________________
  535.  
  536.   The SERVICE facility is a graphical interface that
  537.   uses service windows to prompt you for input when
  538.   applying service to one or more products on your
  539.   system.  Follow the steps below to start CSF and use
  540.   the SERVICE facility.
  541.  
  542.  
  543.   1.  Open an OS/2 window.
  544.  
  545.   2.  Insert "CSF Diskette 1" into drive A
  546.  
  547.   3.  Change the directory to drive A.
  548.  
  549.  
  550.                                           Page 17
  551.  
  552.  
  553.   4.  Type SERVICE at the command prompt, and press
  554.       Enter.
  555.  
  556.   5.  In the OS/2 Corrective Service Facility window,
  557.       select OK to display the Serviceable Products
  558.       window.
  559.  
  560.  
  561.   APPLYING SERVICE
  562.  
  563.   The Serviceable Products window displays the products
  564.   on your system to which service can be applied.  The
  565.   serviceable products displayed in the Products field:
  566.  
  567.  
  568.   o   Are installed on your system
  569.   o   Have updates in the FixPak or ServicePak that you
  570.       are applying
  571.   o   Have SYSLEVEL files that are compatible with the
  572.       SYSLEVEL files of the service you are applying.
  573.  
  574.  
  575.   All serviceable products are initially selected and
  576.   highlighted in the Products field.  If you do not
  577.   want to apply service to one or more products listed,
  578.   deselect those products that you do not want to
  579.   service.  The products that you deselect will no
  580.  
  581.  
  582.                                           Page 18
  583.  
  584.  
  585.   longer be highlighted and service will not be applied
  586.   to them.
  587.  
  588.   If this is the first time that service is being
  589.   applied to a selected product, you must specify in
  590.   the Archive field the path and directory for the
  591.   archive of the product.  If an archive already exists
  592.   for the product, you cannot modify the path that
  593.   appears in the Archive field.  See "Restoring a
  594.   Product to Its Base Level" on page 5 for more
  595.   information on archives and archive paths.
  596.  
  597.   If service has been applied previously to a selected
  598.   product, you can optionally specify in the Backup
  599.   field the path and directory for a backup of the
  600.   product.  If an archive has not yet been saved for
  601.   the product, you will not be able to modify the
  602.   Backup field.  See "Restoring a Product to a Previous
  603.   Fix Level" on page 8 for more information on backups
  604.   and backup paths.
  605.  
  606.   When only the products to which you are applying
  607.   service are highlighted, select Service to apply
  608.   service to the products.  To display a list of
  609.   products that have archives, backups, or a list of
  610.   products that can be committed, select Change Product
  611.   List.
  612.  
  613.  
  614.                                           Page 19
  615.  
  616.  
  617.   CHANGING THE PRODUCT LIST
  618.  
  619.   The Change Product List push button displays a window
  620.   in which you can select one of the four product lists
  621.   that CSF maintains.  The type of product list that
  622.   you select determines the actions you can perform on
  623.   the selected products.   If you select a product list
  624.   that does not exist, such as when no products on the
  625.   system have backups, CSF issues a message.
  626.  
  627.   CSF maintains the following product lists:
  628.  
  629.   Serviceable Products
  630.             A list of products on your system to which
  631.             you can apply service.  When you select
  632.             SERVICEABLE PRODUCTS, you can use the
  633.             window that is displayed to apply service
  634.             to the selected products.
  635.  
  636.   Archived Products
  637.             A list of products on your system that have
  638.             archives.  When you select ARCHIVED
  639.             PRODUCTS, you can use the window that is
  640.             displayed to restore the selected products
  641.             to the archive level or to redirect CSF to
  642.             a different archive location.
  643.  
  644.  
  645.                                           Page 20
  646.  
  647.  
  648.   Backed Up Products
  649.             A list of products on your system that have
  650.             backups.  When you select BACKED UP
  651.             PRODUCTS, you can use the window that is
  652.             displayed to restore the selected products
  653.             to the backup level.
  654.  
  655.   Uncommitted Products
  656.             A list of products on your system that can
  657.             be committed.  When you select UNCOMMITTED
  658.             PRODUCTS, you can use the window that is
  659.             displayed to commit the selected products.
  660.  
  661.  
  662.   REDIRECTING CSF TO ANOTHER ARCHIVE
  663.  
  664.   Use this window to direct CSF to an archive in a
  665.   location that is different from the one specified in
  666.   the SOURCE DIRECTORY field.
  667.  
  668.   To display the Redirect Service window:
  669.  
  670.   1.  Select the CHANGE PRODUCT LIST push button.
  671.   2.  Select the ARCHIVED PRODUCTS radio button.
  672.   3.  In the Archived Products window, all products are
  673.       initially selected.  Deselect the products with
  674.       archives that are to remain unchanged, and then
  675.       select the REDIRECT pushbutton.
  676.  
  677.  
  678.                                           Page 21
  679.  
  680.  
  681.   When the Redirect Service window is displayed, you
  682.   can view the list of products that have archives (in
  683.   the PRODUCT field) and the location of the archives
  684.   (in the SOURCE DIRECTORY field).
  685.  
  686.   Enter the new archive path in the TARGET DIRECTORY
  687.   field.  The archive path can be on a diskette, on a
  688.   local drive, or a network drive, and the archive
  689.   files must be in place in the new location before you
  690.   select OK.
  691.  
  692.  
  693.   BACKING OUT OF A SERVICE PACKAGE
  694.  
  695.   Use the Back Out Service window to restore a product
  696.   to its archive level or backup level.
  697.  
  698.   To display the Back Out Service window:
  699.  
  700.   1.  Select the CHANGE PRODUCT LIST push button.
  701.  
  702.   2.  Do one of the following:
  703.  
  704.       o   To restore a product to its archive level,
  705.           select the ARCHIVED PRODUCTS radio button.
  706.           In the Archived Products window, all products
  707.           are initially selected.  Deselect the
  708.           products that are not to be restored to the
  709.  
  710.  
  711.                                           Page 22
  712.  
  713.  
  714.           archive level, and then select the BACK OUT
  715.           push button.
  716.  
  717.       o   To restore a product to its backup level,
  718.           select the BACKED UP PRODUCTS radio button.
  719.           In the Backed Up Products window,  all
  720.           products are initially selected.  Deselect
  721.           the products that are not to be restored to
  722.           the backup level, and then select the BACK
  723.           OUT push button.
  724.  
  725.   When the Back Out Service window is displayed, you
  726.   can view the selected products (in the PRODUCTS
  727.   field) and the level to which they will be backed out
  728.   (in the TARGET LEVEL field).  Select OK to restore
  729.   the product to the target level.
  730.  
  731.  
  732.   COMMITTING A PRODUCT
  733.  
  734.   Use this window to commit a product with either a
  735.   FixPak or a ServicePak applied.
  736.  
  737.   Committing a product with a FixPak applied frees the
  738.   disk space used by the backup for that product and
  739.   removes the ability to restore the product to the
  740.   backup level.  You can still restore the product to
  741.   the archive level.
  742.  
  743.  
  744.                                           Page 23
  745.  
  746.  
  747.   Committing a product with a ServicePak applied frees
  748.   the disk space used by the backup for that product
  749.   and removes the reference to the archive.  You cannot
  750.   restore the product to either the backup or archive
  751.   level.
  752.  
  753.   To display the Commit Service window:
  754.  
  755.   1.  Select the CHANGE PRODUCT LIST push button.
  756.   2.  Select the UNCOMMITTED PRODUCTS radio button.
  757.   3.  In the Uncommitted Products window, all products
  758.       are initially selected.  Deselect the products
  759.       you do not want to commit, and then select the
  760.       COMMIT push button.
  761.  
  762.   When the Commit Service window is displayed, you can
  763.   view the product list, archive level, and back up
  764.   level, and select OK to commit the products.
  765.  
  766.  
  767.   USING THE FSERVICE RESPONSE FILE
  768.   ________________________________
  769.  
  770.   This section provides a detailed look at the tags and
  771.   syntax used in the FSERVICE response file.
  772.   High-level examples follow the syntax descriptions.
  773.   It also describes the FSERVICE command and
  774.   parameters.
  775.  
  776.  
  777.                                           Page 24
  778.  
  779.  
  780.   Code your service request in the response file before
  781.   starting the FSERVICE facility.  Sample response
  782.   files are included on:
  783.  
  784.       "CSF Diskette 2" if you have 3.5-inch diskettes
  785.       "CSF Diskette 3" if you have 5.25-inch diskettes
  786.  
  787.   You can edit the sample file and customize the tags
  788.   for your request.  If you want to create a new
  789.   response file, open a file named RESPONSE.FIL and
  790.   code your FSERVICE request in it.  Specify the
  791.   location of the new response file in the CONFIG.SYS
  792.   file or on the command line when you invoke FSERVICE.
  793.   (See "FSERVICE Command" on page 39 for information
  794.   about the FSERVICE command and parameters, and the
  795.   location of the CONFIG.SYS file.)
  796.  
  797.   Follow the steps below to start the FSERVICE
  798.   facility.
  799.  
  800.  
  801.   1.  Open an OS/2 window.
  802.   2.  Insert "CSF Diskette 1" into drive A.
  803.   3.  Change the directory to drive A.
  804.   4.  Type FSERVICE at the command prompt, and press
  805.       Enter.
  806.   5.  Follow the instructions on your screen.
  807.  
  808.  
  809.                                           Page 25
  810.  
  811.  
  812.   APPLYING SERVICE TO MULTIPLE SYSTEMS
  813.  
  814.   The method of submitting your response file to CSF
  815.   and applying service to multiple systems varies by
  816.   the type of environment and how it has been set up.
  817.   Review the documentation for your client-server
  818.   environment before attempting to apply service in a
  819.   LAN environment, and refer to the information in
  820.   README.CID on the OS/2 Warp installation diskettes as
  821.   well as the information in this document.
  822.  
  823.  
  824.   RESPONSE FILE SYNTAX
  825.  
  826.   You use two kinds of tags to code CSF requests in
  827.   your response file.  "General" tags specify how CSF
  828.   is to process all the service requests in the
  829.   response file.  "Keyword" tags indicate the actions
  830.   that CSF is to take and the products against which
  831.   CSF is to take them.
  832.  
  833.   The following sections describe the general and
  834.   keyword tags.
  835.  
  836.  
  837.                                           Page 26
  838.  
  839.  
  840.   GENERAL TAGS
  841.  
  842.   General tags indicate how CSF is to process the
  843.   service requests in a response file.  There are four
  844.   general tags.  The general tags describe:
  845.  
  846.   o   The location of an alternate log file to contain
  847.       the service history
  848.   o   Whether CSF is to issue or bypass certain
  849.       verification messages
  850.   o   The location of the service package or the source
  851.       path
  852.   o   The location of the archive or backup
  853.  
  854.   The following summary describes the optional and
  855.   required general tags, and with which keyword tags
  856.   they are coded.
  857.  
  858.   GENERAL TAG   KEYWORD REQUIREMENTS
  859.  
  860.   :LOGFILE      Optional - can be coded with any
  861.                 keyword
  862.  
  863.   :FLAGS        Optional - if coded, must be coded with
  864.                 :SERVICE
  865.  
  866.  
  867.                                           Page 27
  868.  
  869.  
  870.   :SOURCE       Optional - if coded, must be coded with
  871.                 :SERVICE
  872.  
  873.   :TARGET       Required with :BACKOUT
  874.  
  875.   Code any required general tags before their keyword
  876.   tags in the response file.  If a required general tag
  877.   appears after its keyword in a file, FSERVICE will
  878.   fail.  If a general tag that is not required follows
  879.   a keyword tag in the response file, the general tag
  880.   will be ignored.  A general tag is not
  881.   position-dependent with other general tags, but each
  882.   general tag must occur only once in a response file.
  883.  
  884.   :LOGFILE  drive\path\filename
  885.  
  886.             Specifies that a log file other than the
  887.             default log file is to be used.  (The
  888.             default log file is named SERVICE.LOG and
  889.             is located on the directory of the SYSLEVEL
  890.             file for the product.)  Specify the drive,
  891.             directory, and name of the alternate log
  892.             file.  CSF creates the alternate log file
  893.             if it does not exist and appends the
  894.             service history to the log file after it
  895.             has been created.
  896.  
  897.             :LOGFILE is optional.
  898.  
  899.  
  900.                                           Page 28
  901.  
  902.  
  903.   :FLAGS    flag1 | flag2 | flag3
  904.  
  905.             Indicates that CSF is to bypass the
  906.             specified verification messages while
  907.             applying service.  Code :FLAGS only when
  908.             you code the :SERVICE keyword tag.  If you
  909.             specify :FLAGS in a response file that does
  910.             not have the :SERVICE tag, the flags will
  911.             be ignored.
  912.  
  913.             :FLAGS is optional.  When you code :FLAGS,
  914.             you must specify one or more of the
  915.             following flags:
  916.  
  917.             REPLACE_NEWER
  918.                               Specifies that CSF is to
  919.                               replace product files
  920.                               that have more recent
  921.                               dates than the
  922.                               corresponding files on
  923.                               the service package.  If
  924.                               REPLACE_NEWER is not
  925.                               specified, each time CSF
  926.                               finds a file with a more
  927.                               recent date than those in
  928.                               the service package, you
  929.                               must verify that the file
  930.                               can be replaced or cancel
  931.  
  932.  
  933.                                           Page 29
  934.  
  935.  
  936.                               the replacement of the
  937.                               file.
  938.  
  939.                               REPLACE_NEWER is coded in
  940.                               the sample response file
  941.                               on CSF diskette 2.
  942.                               Specify REPLACE_NEWER to
  943.                               avoid multiple
  944.                               verification messages
  945.                               when applying service to
  946.                               multiple products.
  947.  
  948.             REPLACE_PROTECTED
  949.                               Specifies that CSF is to
  950.                               replace files that are
  951.                               read-only, hidden, or
  952.                               system files.  If
  953.                               REPLACE_PROTECTED is not
  954.                               specified, each time CSF
  955.                               finds a protected file,
  956.                               you must verify that the
  957.                               file can be replaced or
  958.                               cancel the replacement of
  959.                               the file.
  960.  
  961.                               REPLACE_PROTECTED is
  962.                               coded in the sample
  963.                               response file on CSF
  964.  
  965.  
  966.                                           Page 30
  967.  
  968.  
  969.                               diskette 2.  Specify
  970.                               REPLACE_PROTECTED to
  971.                               avoid multiple
  972.                               verification messages
  973.                               when applying service to
  974.                               multiple products.
  975.  
  976.             EXIT_WHEN_DONE
  977.                               Tells FSERVICE to stop if
  978.                               any errors are
  979.                               encountered and to report
  980.                               the errors.
  981.  
  982.   :SOURCE   drive\path
  983.  
  984.             Specifies the drive and directory of the
  985.             service package you are applying to a
  986.             product.  :SOURCE is optional.  You can
  987.             specify :SOURCE in a response file that
  988.             contains a :SERVICE tag, or on the command
  989.             line when submitting a response file that
  990.             contains the :SERVICE tag.  If :SOURCE is
  991.             omitted when :SERVICE is specified, the
  992.             default source drive is drive A.  If
  993.             :SOURCE is coded in a response file that
  994.             does not contain the :SERVICE tag, it is
  995.             ignored.
  996.  
  997.  
  998.                                           Page 31
  999.  
  1000.  
  1001.   :TARGET   ARCHIVE | BACKUP
  1002.  
  1003.             Specifies that a product is to be backed
  1004.             out of a service package and restored to
  1005.             either the backup or archive level.  You
  1006.             can specify only one :TARGET keyword per
  1007.             response file.  All back out requests
  1008.             (specified by the :BACKOUT keyword tag) in
  1009.             the response file restore products to the
  1010.             level (either ARCHIVE or BACKUP) specified
  1011.             on :TARGET.  To restore one product to the
  1012.             archive level and another product to the
  1013.             backup level, code the requests in separate
  1014.             response files.
  1015.  
  1016.             :TARGET is required in response files that
  1017.             contain the :BACKOUT keyword.  When you
  1018.             code :TARGET, it must appear in the
  1019.             response file before the :BACKOUT keyword,
  1020.             and it must specify either ARCHIVE or
  1021.             BACKUP.  If :TARGET appears in the response
  1022.             file before the :BACKOUT keyword, FSERVICE
  1023.             will fail.  If :TARGET appears in a
  1024.             response file that does not contain the
  1025.             :BACKOUT tag, it is ignored.
  1026.  
  1027.  
  1028.                                           Page 32
  1029.  
  1030.  
  1031.   *
  1032.  
  1033.             Specifies that a comment follows.
  1034.  
  1035.  
  1036.   KEYWORD TAGS
  1037.  
  1038.   Keyword tags indicate the action to be taken against
  1039.   a specific product.  Because the same product can be
  1040.   installed multiple times or in multiple partitions on
  1041.   a system, all keyword tags include a :SYSLEVEL tag to
  1042.   identify the specific occurrence of the product being
  1043.   updated or restored.
  1044.  
  1045.   You can use a single response file to take action
  1046.   against multiple products or multiple occurrences of
  1047.   the same product.  However, you cannot code
  1048.   conflicting actions for the same product occurrence
  1049.   (represented by the same SYSLEVEL file), such as
  1050.   simultaneously committing a product and restoring it
  1051.   to its backup level.  Similarly, you cannot duplicate
  1052.   requests against the same product occurrence.
  1053.   Conflicting or duplicate requests against a single
  1054.   product occurrence will cause FSERVICE to fail.
  1055.  
  1056.   :SERVICE
  1057.             Specifies that a service package is to be
  1058.             applied to a product.  :SERVICE has two
  1059.  
  1060.  
  1061.                                           Page 33
  1062.  
  1063.  
  1064.             position-dependent parameter tags that must
  1065.             follow it and one optional parameter tag.
  1066.             Each tag must be on a line by itself.  The
  1067.             parameter tags are:
  1068.  
  1069.             :SYSLEVEL drive\path\SYSLEVEL.xxx
  1070.  
  1071.                       Specifies the drive and directory
  1072.                       of the SYSLEVEL file of the
  1073.                       product being serviced.  This tag
  1074.                       must follow the :SERVICE keyword
  1075.                       in the response file.  If you do
  1076.                       not specify a drive, CSF applies
  1077.                       service to all partitions.
  1078.  
  1079.             :ARCHIVE  drive\path
  1080.  
  1081.                       Specifies the drive and directory
  1082.                       of the archive of the product
  1083.                       being serviced.  This tag must
  1084.                       follow the :SERVICE keyword in
  1085.                       the response file if this is the
  1086.                       first time that service is being
  1087.                       applied to the product.  If you
  1088.                       do not specify a drive, CSF will
  1089.                       create an archive on all
  1090.                       partitions to which service is
  1091.                       being applied.
  1092.  
  1093.  
  1094.                                           Page 34
  1095.  
  1096.  
  1097.             :BACKUP   drive\path
  1098.  
  1099.                       Specifies the drive and directory
  1100.                       of the BACKUP of the product
  1101.                       being serviced.  This tag can
  1102.                       optionally follow the :SERVICE
  1103.                       keyword in the response file if
  1104.                       an archive for the product
  1105.                       already exists.  If you do not
  1106.                       specify a drive, CSF will create
  1107.                       a backup on all partitions to
  1108.                       which service is being applied.
  1109.  
  1110.   :BACKOUT
  1111.             Specifies that the product is to be backed
  1112.             out of a FixPak or ServicePak to the level
  1113.             specified on the :TARGET tag.  :BACKOUT has
  1114.             one position-dependent parameter tag, which
  1115.             must follow it on a line by itself.  The
  1116.             parameter tag is:
  1117.  
  1118.             :SYSLEVEL drive\path\SYSLEVEL.xxx
  1119.  
  1120.                       Specifies the drive, directory,
  1121.                       and file name of the SYSLEVEL
  1122.                       file of the product being backed
  1123.                       out of a service package.  This
  1124.  
  1125.  
  1126.                                           Page 35
  1127.  
  1128.  
  1129.                       tag must follow the :BACKOUT
  1130.                       keyword in the response file.
  1131.  
  1132.   :REDIRECT
  1133.             Specifies that CSF is to be redirected to a
  1134.             product archive other than the current
  1135.             product archive.  :REDIRECT has two
  1136.             position-dependent parameter tags that must
  1137.             follow it, each of which must be on a line
  1138.             by itself.  The parameter tags are:
  1139.  
  1140.             :SYSLEVEL drive\path\SYSLEVEL.xxx
  1141.  
  1142.                       Specifies the drive, directory,
  1143.                       and file name of the SYSLEVEL
  1144.                       file of the product associated
  1145.                       with the archive being
  1146.                       redirected.  This tag must follow
  1147.                       the :REDIRECT keyword in the
  1148.                       response file.
  1149.  
  1150.             :ARCHIVE  drive\path
  1151.  
  1152.                       Specifies the drive and directory
  1153.                       of the new archive location.
  1154.                       This tag must follow the
  1155.                       :REDIRECT keyword in the response
  1156.                       file.
  1157.  
  1158.  
  1159.                                           Page 36
  1160.  
  1161.  
  1162.   :COMMIT
  1163.             Specifies that a product is to be committed
  1164.             with either a FixPak or a ServicePak
  1165.             applied to it.  :COMMIT has one
  1166.             position-dependent parameter tag, which
  1167.             must follow it on a line by itself.  The
  1168.             parameter tag is:
  1169.  
  1170.             :SYSLEVEL drive\path\SYSLEVEL.xxx
  1171.  
  1172.                       Specifies the drive, directory,
  1173.                       and file name of the SYSLEVEL
  1174.                       file of the product being
  1175.                       committed.  This tag must follow
  1176.                       the :COMMIT keyword in the
  1177.                       response file.
  1178.  
  1179.  
  1180.   APPLYING SERVICE
  1181.  
  1182.   The following example illustrates the FSERVICE
  1183.   response file syntax for applying service to a
  1184.   product and creating an archive on drive D.  The
  1185.   :SOURCE general tag must appear before the keywords
  1186.   in the response file.  If coded, the :FLAGS general
  1187.   tag must also appear before the keywords in the
  1188.   response file and must specify at least one of the
  1189.   three flags.
  1190.  
  1191.  
  1192.                                           Page 37
  1193.  
  1194.  
  1195.     :SOURCE A:\
  1196.     :FLAGS   REPLACE_NEWER REPLACE_PROTECTED
  1197.     :SERVICE
  1198.     :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  1199.     :ARCHIVE D:\ARCHIVE
  1200.  
  1201.  
  1202.   REDIRECTING CSF TO ANOTHER ARCHIVE
  1203.  
  1204.   The following example illustrates the FSERVICE
  1205.   response file syntax for redirecting CSF to an
  1206.   archive on a LAN.  There are no required general tags
  1207.   and no optional tags.  Both :SYSLEVEL and :ARCHIVE
  1208.   must follow the :REDIRECT tag.
  1209.  
  1210.  
  1211.     :REDIRECT
  1212.     :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  1213.     :ARCHIVE X:\CSD\OS2V3\ARCHIVE
  1214.  
  1215.  
  1216.                                           Page 38
  1217.  
  1218.  
  1219.   BACKING OUT OF A SERVICE PACKAGE
  1220.  
  1221.   The following example illustrates the FSERVICE
  1222.   response file tags for backing out of a fix service
  1223.   package or a ServicePak to the previous fix level.
  1224.   There are no optional tags.  You must specify BACKUP
  1225.   on the TARGET general tag to return to the previous
  1226.   fix level.
  1227.  
  1228.  
  1229.     :TARGET  BACKUP
  1230.     :BACKOUT
  1231.     :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  1232.  
  1233.  
  1234.   COMMITTING A PRODUCT
  1235.  
  1236.   The following example illustrates the FSERVICE
  1237.   response file tags for committing a product to a
  1238.   FixPak or a ServicePak.  There are no required
  1239.   general tags and no optional tags.
  1240.  
  1241.  
  1242.     :COMMIT
  1243.     :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  1244.  
  1245.  
  1246.                                           Page 39
  1247.  
  1248.  
  1249.   FSERVICE COMMAND
  1250.  
  1251.   You can use the FSERVICE command and parameters to
  1252.   provide additional input to FSERVICE about your
  1253.   service request, or to override the information
  1254.   specified in your response file.  The FSERVICE
  1255.   command can be used in two ways:
  1256.  
  1257.   o   When you have a command prompt available, such as
  1258.       when you invoke SEMAINT in a CID environment, you
  1259.       can specify the FSERVICE command at the command
  1260.       prompt.
  1261.  
  1262.   o   You can modify the FSERVICE parameters in the
  1263.       CONFIG.SYS file.
  1264.  
  1265.       The CONFIG.SYS file is on "CSF Diskette 2" if you
  1266.       have 3.5-inch diskettes and "CSF Diskette 3" if
  1267.       you have 5.25-inch diskettes.
  1268.  
  1269.  
  1270.   The parameters that you specify on the command line
  1271.   override the response file tags.  The parameters that
  1272.   you specify in the CONFIG.SYS file override those
  1273.   specified on the command line.
  1274.  
  1275.  
  1276.                                           Page 40
  1277.  
  1278.  
  1279.   ?
  1280.             Displays the FSERVICE command syntax and
  1281.             parameter descriptions on your computer
  1282.             screen.
  1283.  
  1284.   /S:drive\path
  1285.             Specifies the fully-qualified path to the
  1286.             ServicePak images.  The path can specify
  1287.             either a local hard disk or a redirected
  1288.             drive on the code server.  The path depends
  1289.             on the directory structure you have set up.
  1290.             If you use the directory structure
  1291.             recommended in the "LAN Configuration,
  1292.             Installation, and Distribution Utility
  1293.             Guide" and an OS/2 2.0 ServicePak, the path
  1294.             is <drive>\CSD\OS2V20\CSD01.
  1295.  
  1296.             This parameter is required.
  1297.  
  1298.   /T:drive\path
  1299.             Specifies the fully-qualified path to the
  1300.             directory from which the system was
  1301.             started.  If the system was started from a
  1302.             maintenance system on the hard disk, this
  1303.             path matches the /T: parameter specified on
  1304.             the SEMAINT command.  FSERVICE restores the
  1305.             CONFIG.SYS, STARTUP.CMD, and AUTOEXEC.BAT
  1306.  
  1307.  
  1308.                                           Page 41
  1309.  
  1310.  
  1311.             files from backups located in this
  1312.             directory.
  1313.  
  1314.             This parameter is optional.  If you specify
  1315.             /T:drive\path when CSF is started from
  1316.             diskette, CSF does not validate the path
  1317.             specified on this parameter.
  1318.  
  1319.   /R:path\filename.ext
  1320.             Specifies the fully-qualified path to the
  1321.             FSERVICE response file.  If you use the
  1322.             directory structure recommended in the "LAN
  1323.             Configuration, Installation, and
  1324.             Distribution Utility Guide" and an OS/2 2.0
  1325.             ServicePak, the response file is located on
  1326.             <drive>\CSD\OS2V20\CSD01.
  1327.  
  1328.             This parameter is required.
  1329.  
  1330.   /L1:path\filename.ext
  1331.  
  1332.  
  1333.   /L:path\filename.ext
  1334.             Specifies the fully-qualified path to the
  1335.             service log.
  1336.  
  1337.             This parameter is optional.
  1338.  
  1339.  
  1340.                                           Page 42
  1341.  
  1342.  
  1343.   /CID
  1344.             Specifies that FSERVICE is to restore the
  1345.             following files from the backups made by
  1346.             SEMAINT:
  1347.  
  1348.             o   OS2BOOT
  1349.             o   OS2KRNL
  1350.             o   OS2LDR
  1351.             o   OS2DASD.DMD
  1352.             o   OS2SCSI.DMD
  1353.             o   OS2LDR.MSG
  1354.  
  1355.             This parameter is optional.  Specify /CID
  1356.             only when FSERVICE is running under a
  1357.             maintenance system created by SEMAINT.
  1358.  
  1359.   /LARGE
  1360.             Specifies that the service package is on
  1361.             CD-ROM.
  1362.  
  1363.  
  1364.                                           Page 43
  1365.  
  1366.  
  1367.   NOTICES
  1368.   _______
  1369.  
  1370.  
  1371.   References in this publication to IBM products,
  1372.   programs, or services do not imply that IBM intends
  1373.   to make these available in all countries in which IBM
  1374.   operates.  Any reference to an IBM product, program
  1375.   or service is not intended to state or imply that
  1376.   only IBM's product, program, or service may be used.
  1377.   Any functionally equivalent product, program, or
  1378.   service that does not infringe any of IBM's
  1379.   intellectual property rights or other legally
  1380.   protectable rights may be used instead of the IBM
  1381.   product, program, or service.  Evaluation and
  1382.   verification of operation in conjunction with other
  1383.   products, programs, or services, except those
  1384.   expressly designated by IBM, are the user's
  1385.   responsibility.
  1386.  
  1387.   IBM may have patents or pending patent applications
  1388.   covering subject matter in this document.  The
  1389.   furnishing of this document does not give you any
  1390.   license to these patents.  You can send license
  1391.   inquiries, in writing, to the IBM Director of
  1392.  
  1393.  
  1394.                                           Page 44
  1395.  
  1396.  
  1397.   Licensing, IBM Corporation, 500 Columbus Avenue,
  1398.   Thornwood NY 10594, U.S.A.
  1399.  
  1400.   IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR
  1401.   IMPLIED, INCLUDING WITHOUT LIMITATION, WARRANTIES OF
  1402.   FITNESS AND MERCHANTABILITY WITH RESPECT TO THE
  1403.   INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  1404.   DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED
  1405.   PATENTS OR COPYRIGHTS.
  1406.  
  1407.  
  1408.   TRADEMARKS
  1409.   __________
  1410.  
  1411.   The following terms, denoted by an asterisk ((*)) in
  1412.   this publication, are trademarks of the IBM
  1413.   Corporation in the United States or other countries.
  1414.  
  1415.       NetView
  1416.       OS/2
  1417.  
  1418.  
  1419.