home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / csf144.zip / cs_144.txt < prev   
Text File  |  2002-03-23  |  64KB  |  1,430 lines
  1.                 Readme for Corrective Service Facility 2-B
  2.                               Version 1.44
  3.  
  4.                       ****************************
  5.  
  6.   NOTE: Change bars (|) included to the left of the text indicate that this
  7.   line has changed or been added since the last READ.ME update.
  8.  
  9.  
  10. | This readme file describes the features available with Version 1.44 of the
  11.   Corrective Service Facility (referred to in this document as the FixTool).
  12.   Once you use this version of the FixTool to service a product, you will not
  13.   be able to use Version 1.37B or earlier. SYSLEVEL files are modified by
  14.   FixTool 1.38 and later, causing FixTool 1.37B or earlier not to find products
  15.   to service.
  16.  
  17.   This document supplements the information given in the README.INF that
  18.   comes with the FixTool.  The README.INF includes more details about the
  19.   FixTool process.
  20.  
  21.   For more information, the following URL contains a very thorough and useful
  22.   document called OS/2 FixPak Primer.  It was written by Frank McKenney, an
  23.   independent OS/2 consultant.
  24.  
  25.      http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/fp.html
  26.  
  27.  
  28. CONTENTS:
  29.  
  30.   Section 1.  How to Use the FixTool EXE (Zip) File
  31.   Section 2.  Files Included in the FixTool EXE File
  32.   Section 3.  How to Tell What FixTool Version You Have
  33.   Section 4.  Basic Installation for First-Time FixPak Users
  34.   Section 5.  Other Ways to Apply Service
  35. | Section 6.  Information about ARCHIVE, BACKUP, and COMMIT
  36.   Section 7.  How to Set Up the FixTool for Remote Installation
  37.   Section 8.  How to Customize the Response File
  38.   Section 9.  How to Turn Off Archiving for a FixPak
  39.   Section 10. Setting Environment Variables
  40.   Section 11. If You Have a Problem
  41.   Section 12. Common Error Messages
  42.   Section 13. Other Known Problems
  43.   Section 14. List of Changes Made for Each Version (1.38 and Later)
  44.  
  45. ******************************************************************************
  46. Section 1.  How to Use the FixTool EXE (Zip) File
  47.  
  48.   First, unzip the FixTool zip file onto a diskette or into a directory.  You
  49.   can do this by copying the self-extracting zip file into a new subdirectory
  50.   and then use the following commands from an OS/2 command prompt:
  51.  
  52.         <d>:
  53.         cd <directory>
  54. |       CSx144 <target>
  55.  
  56.   where <d>         is the drive that you've put the FixTool zip file on,
  57.         <directory> is the directory that you've copied the self-extracting
  58.                     zip file to.
  59.         x           Country code, where '_' is the US country code. Other NLV
  60.                     country codes are identical to the Country code used in
  61.                     FixPak's.
  62.         <target>    is the fully qualified path where the file is to be
  63.                     unzipped to.
  64.  
  65.   If <target> is not a diskette, you can also copy all the files in <target>
  66. | onto a diskette, except for CSx144.EXE if you wish.
  67.  
  68.   Next, you need OS/2 boot capability.  For this, you can use any of the
  69.   following:
  70.  
  71.    - boot the install diskettes for the product you're servicing
  72.    - create utility diskettes from your system and boot these
  73.    - use a maintenance partition if you have one
  74.    - boot through Alt-F1 and go to the command prompt
  75.    - boot OS/2 as usual and then open an OS/2 session
  76.  
  77.  
  78. ******************************************************************************
  79. Section 2.  Files Included in the FixTool EXE File
  80.  
  81.   The following files are included in the FixTool EXE (Zip) file:
  82.  
  83.   File            Use
  84.   --------------  -----------------------------------------------------------
  85.   BUILD.LVL       Contains build information for this FixTool release.
  86.   CSFPANS.DLL     Used by FSERVICE
  87. | SERVICE.EXE     Executable for applying service through a windowed session
  88.   SERVICE.HLP     SERVICE help file
  89.   SHPIINST.DLL    FixTool required DLL
  90.   UNPACK.EXE      Used to unpack files being serviced
  91.   UNPACK2.EXE     Used to unpack files being serviced
  92.   VIOCALLS.DLL    FixTool required DLL
  93. | FSERVICE.EXE    Executable for applying service through a command line
  94.                   (used with a response file).
  95.   IBMCSFLK.DLL    Locked file device driver file
  96. | IBMCSFLK.EXE    Locked file device driver file
  97.   IBMCSFLK.SYS    Locked file device driver file
  98.   IBMCSFLK.MSG    Locked file device driver file
  99.   PACK.EXE        Used to pack files being archived or backed up
  100.   README.INF      General Installation instructions for the FixTool
  101.   RESPONSE.LAN    Response file for servicing network-related products
  102.   RESPONSE.WP3    Response file for servicing OS/2 Warp v3 base
  103. | RESPONSE.WP4    Response file for servicing OS/2 Warp v4 base,
  104. |                 OS/2 Warp Server for e-business and OS/2 Warp
  105. |                 Convenience Packages
  106.   RESPONSE.BDD    Response file for servicing OS/2 Warp Base Device Drivers
  107.   FSERVICE.MSG    FSERVICE message file
  108.   FPINST.CMD      Command file for applying service through FSERVICE
  109.                   (uses standard response files for OS/2 Warp 3, OS/2 Warp 4,
  110. |                 OS/2 Warp Server for e-business, OS/2 Warp Convenience
  111. |                 Packages, OS/2 Base Device Drivers, and network-related
  112. |                 FixPaks)
  113.   NLS.DLL         FixTool required DLL
  114.   MSG.DLL         FixTool required DLL
  115.   FILEFIX.DLL     FixTool required DLL
  116.   ARCHCTL.CMD     Command file that allows you to turn off archiving for
  117.                   a particular FixPak.
  118. | READ.ME         This file
  119.  
  120.  
  121. ******************************************************************************
  122. Section 3.  How to Tell What FixTool Version You Have
  123.  
  124. | You can tell if you have Version 1.44 by running BLDLEVEL on SERVICE.EXE or
  125.   FSERVICE.EXE.  You will see one of the following, depending on which version
  126.   of BLDLEVEL.EXE you have.
  127.  
  128. | Signature:       @#IBM:F.144#@ OS/2 Corrective Service Facility (C) IBM 1994
  129.   Vendor:          IBM
  130. | Revision:        0.144
  131. | File Version:    0.144
  132.   Description:     OS/2 Corrective Service Facility (C) IBM 1994
  133.  
  134. | Signature:   @#IBM:F.144#@ OS/2 Corrective Service Facility (C) IBM 1994
  135.   Vendor:      IBM
  136. | Revision:    F.144
  137.   Description: OS/2 Corrective Service Facility (C) IBM 1994
  138.  
  139.   The new version of the FixTool (Corrective Service Facility) updates the
  140.   current CSD field in the SYSLEVEL files of the products it services.  After
  141. | applying a FixPak with Version 1.44, you will be able to run SYSLEVEL and
  142.   tell what FixPaks you have applied by looking at the current field of the
  143.   product's SYSLEVEL file.
  144.  
  145.   This version is also compatible with Software Choice features.  If you need to
  146.   use Software Choice to install new features for a product, the FixTool will
  147.   integrate SYSLEVEL and archive information from the Software Choice install
  148.   the next time it services that product.
  149.  
  150. ******************************************************************************
  151. Section 4.  Basic Installation for First-Time FixPak Users
  152.  
  153.   This is a very basic set of instructions to help you install an OS/2 Warp
  154.   FixPak; it contains installation tips from OS/2 support technicians.
  155.  
  156.   This document is designed to help you understand how to prepare your system
  157.   and then install an OS/2 Warp base or Base Device Driver FixPak. It is
  158.   important that you also read the README file supplied with the FixPak you
  159.   are installing.
  160.  
  161.   This document only discusses local FixPak installations from diskettes using
  162. | the Corrective Service Facility (CSF) FixTool 1.44.  For other methods of
  163.   installation see Section 5.
  164.  
  165.   Before you can begin the FixPak installation, either obtain the FixPak
  166.   diskettes from IBM, or download the FixPak and run LOADDSKF.EXE to convert
  167.   the downloaded FixPak images into a usable diskette format.
  168.  
  169.   Note:  LOADDSKF.EXE can be found on the OS/2 Warp installation CD in the
  170.   DISKIMGS directory.
  171.  
  172. 4.1.   Prerequisites:
  173.  
  174.  4.1.1. You must have at least 70 megabytes of free space available on your
  175.         hard drive.  At least 20 MB of the 70 MB must be available on the C:
  176.         drive if installing to another partition.
  177.  
  178.        To determine how much free space is available, open an OS/2 Command
  179.        Prompt window and type CHKDSK; then press Enter.  CHKDSK will search
  180.        the disk and report its findings, including the number of kilobytes
  181.        available for use. This number must exceed 70000 kilobytes.
  182.  
  183.  4.1.2. You must create utility diskettes.
  184.  
  185.        These diskettes will allow you to boot to a command prompt and perform
  186.        various utility maintenance jobs on your computer to prepare it for the
  187.        FixPak install as well as to help recover from some minor problems.
  188.  
  189.        4.1.2.1. How to create utility diskettes:
  190.  
  191.        Note:  Before you begin, you must have three blank diskettes and the
  192.        installation CD for OS/2 Warp 3 or Warp Server, or four blank diskettes
  193. |      and the installation CD for OS/2 Warp 4, Warp Server for e-business, or
  194.        OS/2 Warp Convenience Packages.
  195.  
  196.        a. From the desktop, click on the OS/2 System icon,
  197.        b. Click on the System Setup icon,
  198.        c. Click on the Create Utility Diskettes icon.
  199.        d. Follow the prompts to label, insert and remove the diskettes.
  200.  
  201.  4.1.3. Run CHKDSK.
  202.  
  203.        The computer must be running well before you install a FixPak. If you
  204.        are experiencing any problems with your machine, please contact your
  205.        technical support representative to get the machine fixed. Even if your
  206.        machine is running well, it is a good idea to run CHKDSK; it may find
  207.        and fix some unknown problems.
  208.  
  209.        4.1.3.1  To run CHKDSK:
  210.  
  211.        a. Shut down the computer.
  212.        b. Insert Utility Diskette 1 in drive A: and restart the computer.
  213.        c. Replace the diskettes as prompted, until you reach an A:\ prompt.
  214.        d. Insert the last utility diskette (Utility Diskette 3 for OS/2 Warp 3,
  215. |         Utility Diskette 4 for OS/2 Warp 4 or Warp Server for e-business or
  216. |         CD for OS/2 Warp Convenience Packages).
  217.        e. At the A:\ prompt, type CHKDSK C: /F, then press Enter.
  218.           CHKDSK will search the disk and attempt to fix any problems.
  219.        f. If CHKDSK reports any problems, record the errors, then rerun CHKDSK
  220.           to verify that the problems were actually fixed.
  221.  
  222.  4.1.4. DO NOT USE YOUR SYSTEM
  223.  
  224.        Once you begin a FixPak installation, do not try to use your system for
  225.        any other purpose. Unexpected problems may arise, causing the FixPak
  226.        installation to fail.
  227.  
  228.  4.1.5. Record Your Current Revision Level Number.
  229.  
  230.        Before beginning the FixPak installation, verify the current version and
  231.        revision level of the operating system, as follows:
  232.  
  233.        Open an OS/2 Command Prompt window, and type VER /R, then press Enter.
  234.        Record the information displayed; for example:
  235.  
  236.        The Operating System/2 Version is 4.00
  237.            Revision 9.030
  238.  
  239.        Once you have completed the FixPak installation, you can verify that the
  240.        revision number has been properly updated.
  241.  
  242.  
  243.  4.1.6. UNDERSTAND ALL THE WORDS
  244.  
  245.        If there are any words, phases or instructions in this document that you
  246.        do not understand or if you do not know their meaning, please contact
  247.        your local support representative for an explanation.
  248.  
  249.        Once you have successfully completed all of the above steps, and are
  250.        satisfied that your system is in good working order and ready to begin,
  251.        proceed to the instructions below.  If you have any questions or
  252.        concerns, contact you computer support adminstrator and address them
  253.        before continuing.
  254.  
  255. 4.2.  Basic Installation Instructions
  256.  
  257.        There are several ways to install a FixPak; this section of the readme
  258.        uses the FPINST procedure.
  259.  
  260.        1. Shutdown your computer.
  261.  
  262.        2. Insert Utility Diskette 1 in the diskette drive and restart the
  263.           computer, either by turning on the power, or pressing the
  264.           Ctrl+Alt+Del keys.
  265.  
  266.        3. As prompted, remove and insert utility diskettes until you come to an
  267.           A:\ prompt.
  268.  
  269.        4. Remove the current utility diskette, and insert the last of the
  270.           series (Utility Diskette 3 for OS/2 Warp 3, or Utility Diskette 4
  271. |         for OS/2 Warp 4, Warp Server for e-business or CD for OS/2 Warp
  272. |         Convenience Packages).
  273.  
  274.        5. Type CHKDSK C: /F then press Enter.  This will run the CHKDSK program.
  275.           Review the reported findings. Look for any recognizable problems and
  276.           fix them.
  277.  
  278.           Note: If CHKDSK does detect problems, run the command again, to
  279.           verify that the problems were really fixed. If CHKDSK continues to
  280.           find problems and is unable to fix them, please contact your local
  281.           support representative to resolve the problems before continuing
  282.           with the FixPak installation.
  283.  
  284.        6. As mentioned in Section 2.1 above, CHKDSK also reports the amount of
  285.           free space remaining. If you have at least 70 MB free (70000
  286.           Kilobytes or 70000000 Bytes) then you can proceed with the FixPak
  287.           install. If not, you must delete or move enough files to meet the
  288.           free space requirement before continuing.
  289.  
  290. |      7. Insert the Corrective Service FixTool diskette (CSF FIXT 144).
  291.  
  292.        8. At the command prompt, enter one of the following commands and then
  293.           press Enter.
  294.  
  295.           For an OS/2 Warp 3 or Warp Server Base FixPak:
  296.              FPINST  WARP3
  297.  
  298.           For an OS/2 Warp 4 Base FixPak:
  299.              FPINST  WARP4
  300.  
  301.           For an OS/2 Warp Server for e-business Base FixPak:
  302.              FPINST  WSEB
  303.  
  304. |         For an OS/2 Warp Convenience Packages :
  305. |            FPINST  CONVP
  306.  
  307.           For an OS/2 Base Device Driver FixPak:
  308.              FPINST  BASEDD <source drive>
  309.  
  310.           For an OS/2 LAN or Network related FixPak:
  311.              FPINST  NETWORK <d>
  312.  
  313.        9. The FixPak installation program will perform a variety of functions.
  314.  
  315.           Note: Near the beginning of the FixPak installation, it may appear
  316.           as if nothing is happening. Please be patient.
  317.  
  318.           Note: Base Device Driver fixpacks may require running the following
  319.           command:  \FIX\FIXTOOL.EXT\FIXTPREP.EXE
  320.           which is located on Base Device Driver Diskette 1.  This command
  321.           only needs to be run if this is the first time you are installing
  322.           a Base Device Driver FixPak on an OS/2 Base System.
  323.  
  324.           The only other user action required will be to remove and insert
  325.           diskettes as prompted.
  326.  
  327.           When the installation is complete, you will be informed and prompted
  328.           to restart the computer.  Do this by pressing Ctrl+Alt+Del, or by
  329.           turning the power off and then back on.
  330.  
  331. ******************************************************************************
  332. Section 5.  Other Ways to Apply Service
  333.  
  334.   Once you have boot capability (see Section 1) and are at a command prompt,
  335.   you can apply service using one of the following methods:
  336.  
  337.         Using FPINST
  338.         Using SERVICE
  339.         Using FSERVICE with a custom RESPONSE.FIL
  340.  
  341.   Insert the FixTool diskette you created, or change to the directory that
  342.   the FixTool is in, and then use FPINST or FSERVICE as described in
  343.   Sections 5.1 and 5.3.  To use SERVICE as described in Section 5.2, you
  344.   must have OS/2 running without having booted from diskettes, maintenance
  345.   partition, or via Alt-F1.
  346.  
  347. 5.1.  Using FPINST
  348.  
  349.   To use FPINST, change to the diskette or directory where you have
  350.   FPINST.CMD and the related files, and type
  351.  
  352.       FPINST fixpak_type
  353.  
  354.        where fixpak_type is:
  355.              WARP3       for applying a FixPak to OS/2 Warp Version 3.0.
  356.              WARP4       for applying a FixPak to OS/2 Warp Version 4.0.
  357.              WSEB        for applying a FixPak to OS/2 Warp Server for
  358.                          e-business.
  359. |            CONVP       for applying a FixPak to OS/2 Warp Convenience
  360. |                        Packages.
  361.              BASEDD src  for applying a Base Device Driver FixPak to OS/2
  362.                          Warp Version 3.0, Warp Version 4.0, or Warp Server
  363.                          for e-business, where src is an optional parameter
  364.                          for the location of the Base Device Driver source.
  365.                          A: is the default source location.
  366.              NETWORK d   for applying LAN or other network-related FixPaks,
  367.                          where d is an optional parameter for the OS/2
  368.                          boot drive.  Use it when you have multiple OS/2
  369.                          boot partitions.
  370.  
  371.    Note: Base Device Driver FixPaks may require running the following
  372.          command:  \FIX\FIXTOOL.EXT\FIXTPREP.EXE
  373.          which is located on Base Device Driver Diskette 1.  This command
  374.          only needs to be run if this is the first time you are installing
  375.          a Base Device Driver FixPak on an OS/2 Base System.
  376.  
  377.   FPINST uses FSERVICE with default response files.  These default response
  378.   files do the following:
  379.  
  380.   For OS/2 Base FixPaks, the default response file saves an archive copy of the
  381.   files it services in <boot_drive>:\ARCHIVE.  It does not keep a backup for
  382.   files serviced, other than the archived files.  If this is not the first OS/2
  383.   base FixPak installed and if you want to be able to backout to the previous
  384.   FixPak level, you must modify the default response file.
  385.  
  386.   For OS/2 Base Device Driver FixPaks, the default response file saves an
  387.   archive copy of the files it services in <boot_drive>:\ARCHIVEB.  It does not
  388.   keep a backup for files serviced, other than the archived files.  If this
  389.   is not the first Base Device Driver FixPak installed and if you want to be
  390.   able to backout to the previous FixPak level, you must modify the default
  391.   response file.
  392.  
  393.   Also, the default response file does not automatically replace all files from
  394.   the FixPak.  The FixTool will prompt you to find out whether to replace any
  395.   files on the system that appear to be newer than the files in the FixPak.
  396.   This happens because the REPLACE_NEWER flag is not set in the default
  397. | response file for OS/2 Warp v3, v4, Warp Server for e-business, or Base
  398. | Device Drivers.
  399.  
  400.   For LAN or network-related FixPaks, there will be no archives or backups
  401.   kept by default, and the FixTool will service all partitions that contain
  402.   the product being serviced by that FixPak.  If you wish to restrict the
  403.   drives serviced, you must modify the default response file.
  404.  
  405.   NOTE:  If you need to install a FixPak with different options from the ones
  406.   described above, then you must either modify the default response file or
  407.   use SERVICE instead of FPINST.  See Section 6 for information about how to
  408.   modify a response file.  See the next section for information about SERVICE.
  409.  
  410. 5.2.  Using SERVICE
  411.  
  412.   To use SERVICE, go to the diskette or directory where you have SERVICE.EXE
  413.   and the related files.  Then type
  414.  
  415.         SERVICE
  416.  
  417.   The program will prompt you for required inputs.  See README.INF for more
  418.   information about these panels.
  419.  
  420.   With FixTool Version 1.39 or later, the CSFUTILPATH defaults to the path that
  421.   you have executed SERVICE from, so you do not need to set this environment
  422.   variable if all the FixTool files are in the same directory with SERVICE.EXE.
  423.  
  424.   NOTE:  To use SERVICE, you must have the OS/2 PM Shell running.  You cannot
  425.          run SERVICE if you have booted from install diskettes or if you
  426.          pressed Alt-F1 to get to a command prompt.
  427.  
  428. 5.3.  Using FSERVICE
  429.  
  430.   To use FSERVICE from a diskette, copy your customized RESPONSE.FIL to the
  431.   diskette with the FixTool files, then go to the diskette and type
  432.  
  433.         FSERVICE /R:RESPONSE.FIL
  434.  
  435.   If you have copied the FixTool files into a directory, you need to use the
  436.   following command from the directory with FSERVICE.EXE and the related files
  437.   (including your custom RESPONSE.FIL):
  438.  
  439.         FSERVICE /R:RESPONSE.FIL /S:<d>:\<directory>
  440.  
  441.   where <d> is the drive with the FixTool related files and
  442.         <directory> is the directory structure where you put the FixTool files.
  443.  
  444.   There are optional parameters that can be included on the FSERVICE command
  445.   line.  See the README.INF file for more details about these parameters.
  446.  
  447.   You should use the /B:<drive> parameter with FSERVICE when applying LAN
  448.   FixPaks on systems with more than one OS/2 boot partition.  <drive> is the
  449.   OS/2 boot partition to be serviced.
  450.  
  451.  
  452. ******************************************************************************
  453.  Section 6.  Information about ARCHIVE, BACKUP, and COMMIT
  454.  
  455.   The FixTool gives you the option to save existing files and restore your
  456.   system to a previous state in case the FixPak contains files that are not
  457.   compatible with your system.  You may not need to restore your system, but
  458.   it is recommended that you keep a backup copy of your files in case you
  459.   encounter a problem after installing a FixPak.
  460.  
  461.   Depending on the FixPak type and on the state of the system you are
  462.   servicing, a FixPak allows you to save the following files:
  463.  
  464.   - an archive file only                If this is the first FixPak installed
  465.                                         for this product and if archiving is
  466.                                         enabled for the FixPak
  467.   - an archive file and a backup file   If archiving is enabled and if you
  468.                                         have already installed a FixPak for
  469.                                         this product
  470.   - a backup file only                  If archiving is disabled
  471.  
  472.   An archive file is the initial file that is installed with the product,
  473.   before any FixPaks have been applied.  A backup file is the previous file
  474.   that was on the system before applying the current FixPak.
  475.  
  476.   OS/2 base and Device Driver FixPaks have archiving enabled.  LAN, MPTS, and
  477.   TCP/IP FixPaks have archiving disabled.
  478.  
  479.  6.1.  Keeping an Archive and/or Backup Copy of Files Serviced
  480.  
  481.   6.1.1. ARCHIVE Directory
  482.  
  483.   When using SERVICE to install a FixPak, you will see a panel that
  484.   either allows you to enter the drive and path to the ARCHIVE directory,
  485.   or if you have previously installed a FixPak on this product, the
  486.   ARCHIVE directory will appear greyed out and you can enter a BACKUP
  487.   directory.  (If archiving is disabled for this FixPak, you will not be
  488.   able to enter an ARCHIVE directory but will be able to enter a
  489.   BACKUP directory.)  With FSERVICE, use the response file to specify the
  490.   ARCHIVE directory.  See Section 8 for more information.
  491.  
  492.   Note that you specify the location of the ARCHIVE when you first install
  493.   a FixPak for a product, and this information is retained by the FixTool.
  494.   You will not be able to change it manually.  Do not delete the archive
  495.   directory or any files in it unless you have done a COMMIT for that FixPak.
  496.   (See Section 6.3 for more information about COMMITing a FixPak.)
  497.  
  498.   The FixTool never deletes the ARCHIVE directory, even after a FixPak
  499.   is committed, because the ARCHIVE directory may be shared by more than
  500.   one system.
  501.  
  502.   If you have deleted the ARCHIVE directory and cannot install a FixPak
  503.   because FixTool cannot find the ARCHIVE directory, you should delete the
  504.   LOGF0000.xxx and LOGSTART.xxx files, where xxx is the 3-character
  505.   extension on the product's syslevel file.  For example, LOGF0000.OS2 and
  506.   LOGSTART.OS2 should be deleted for OS/2 base FixPak installation.  These
  507.   files are in the directory with the syslevel.xxx file.
  508.  
  509.   The ARCHIVE directory is very important.  It allows you to restore your
  510.   system to the original installation level (or last committed level).
  511.   Each FixPak that's installed checks the files being replaced.  If a file
  512.   is to be replaced and the original file is not in the ARCHIVE directory,
  513.   FixTool adds the original file to the ARCHIVE directory.
  514.  
  515.   6.1.2. BACKUP Directory
  516.  
  517.   The BACKUP directory is handled very differently from the ARCHIVE directory.
  518.   It holds only the files that were updated by the last FixPak installation
  519.   for that product.  The FixTool deletes the BACKUP directory for that product
  520.   with each new FixPak installation.  Because of this, you can change the
  521.   location of the BACKUP directory with each FixPak if desired.
  522.  
  523.   When you restore your system to its BACKUP level, you are going back to
  524.   the files that were used before the LAST FixPak was applied.
  525.  
  526.   For FixPaks with archiving enabled, you will not be able to specify a
  527.   BACKUP directory for the first FixPak installed because the original files
  528.   go into the ARCHIVE directory instead of the BACKUP directory.  In this
  529.   case, you can only specify an ARCHIVE directory.  The second FixPak
  530.   installed and each FixPak after that will allow you to specify a BACKUP
  531.   directory.  Be aware that the ARCHIVE directory is checked during FixPak
  532.   installation and it's possible that the same file may be in both
  533.   directories.
  534.  
  535.   Warning:  If you re-install the same FixPak two times, the BACKUP
  536.   directory will contain only the files that were updated the second time
  537.   you installed the FixPak.  In many cases, no files will be updated during
  538.   the second installation, and the BACKUP directory will be deleted, leaving
  539.   you no way to restore to BACKUP level.
  540.  
  541.  6.2.  Recovering to a Backup or Archive Level
  542.  
  543.   With the presence of a valid ARCHIVE or BACKUP directory, you have some
  544.   recovery options if needed.  You may either recover the system by using the
  545.   ARCHIVE directory, which will restore the system to the initial install
  546.   state, or by using the BACKUP directory, which will return the system to
  547.   the state before the last FixPak installation for that product.
  548.  
  549.   To recover, you can use either FSERVICE or SERVICE.  For information about
  550.   recovering with FSERVICE, see Section 8.  To use SERVICE, use the Backout
  551.   procedure as follows:
  552.  
  553.   1. Select the "Change product list..." button from the initial panel.
  554.  
  555.   2. Select the "Archived products" radio button to see the list of
  556.      products with a valid ARCHIVE directory.
  557.  
  558.      -OR-
  559.  
  560.      Select the "Backed up products" radio button to see the list of
  561.      products with a valid BACKUP directory.
  562.  
  563.   3. De-select any products that appear on the list that you do not want
  564.      to restore to the archive or backup level.  Then click on the Backout
  565.      button to begin the recovery process.
  566.  
  567.   4. The syslevel files to be recovered will be listed in the Products
  568.      field and the level to which they will be backed out will appear in
  569.      the Target Level field, either ARCHIVE or BACKUP.  Select OK to
  570.      restore to the target level.
  571.  
  572.   Warning:  When backing out LAN FixPaks, be sure to select all the
  573.             syslevels for the components that were originally serviced
  574.             when the FixPak was installed.  For example, Warp Server
  575.             FixPaks include updates for the syslevel.req, syslevel.srv,
  576.             syslevel.mug, and syslevel.upe components.
  577.  
  578.  6.3.  Committing to an Installed FixPak Level
  579.  
  580.   Fixtool also allows you to COMMIT the present system (with FixPaks
  581.   applied) to be your "base" system.  The COMMIT process makes your
  582.   current system appear to be the archive level.
  583.  
  584.   When you COMMIT a product to a FixPak level, FixTool destroys all
  585.   references to your ARCHIVE and/or BACKUP directories.  It does NOT,
  586.   however, delete the ARCHIVE directory because other products may be
  587.   pointing to the same directory for their archives.  If your system
  588.   is not sharing its ARCHIVE directory with any other systems, you can
  589.   delete the ARCHIVE directory.  You will have to use the following
  590.   before deleting the files to take off the read-only attribute:
  591.      attrib -r *.*
  592.  
  593.   The COMMIT process allows you to free up disk space used by the ARCHIVE
  594.   directory, but it also removes the ability to restore the product to
  595.   initial archive level.
  596.  
  597.   You might want to do this if your system is stable and you do not
  598.   want to return to the actual installed version for some reason.
  599.   For example, if you have applied a Year 2000 FixPak and your system is
  600.   stable, you could COMMIT to that FixPak level before applying any
  601.   future FixPaks.  In this way, if you need to backout to archive level,
  602.   you do not have to re-install the Year 2000 FixPak.  Backing out to
  603.   the ARCHIVE directory would actually back out to the stable Year 2000
  604.   FixPak level.
  605.  
  606.   To COMMIT a FixPak with FSERVICE, see Section 8.  To COMMIT to a
  607.   certain FixPak level using SERVICE, do the following:
  608.  
  609.   1. Select the "Change product list..." button from the initial panel.
  610.  
  611.   2. Select the "Uncommitted products" radio button to display a list
  612.      of all products that have a valid ARCHIVE or BACKUP directory
  613.      associated with them.
  614.   3. In the Uncommitted Products window, de-select any products that you
  615.      do not want to commit to their current level, and then click on the
  616.      Commit button.
  617.   4. When the Commit Service window is displayed, you can view the
  618.      product list, archive level, and backup level, and then select OK
  619.      if you are ready to commit the products listed in the window to
  620.      the levels shown.
  621.  
  622.   Since the COMMIT process removes the archive reference to the installed
  623.   system, you may safely delete the ARCHIVE directory if no other machine
  624.   is using it.  If you do not delete it and re-use the same directory name
  625.   for your next FixPak install, name collisions will occur.  The FixTool
  626.   will handle this properly, but it will take more processing time.  Also,
  627.   you will be wasting disk space with the old files still in the ARCHIVE
  628.   directory.
  629.  
  630.  6.4.  Restoring an Individual File from the ARCHIVE or BACKUP Directory
  631.  
  632.   If you should find the need to restore a file to a prior level, you
  633.   can do this manually by locating the old file in either the ARCHIVE or
  634.   BACKUP directory.  The old file name will be the same as the new one
  635.   with an underscore as the last character in the extension or with all
  636.   underscores for the extension if there is no extension on the original
  637.   filename.  If there is already a file with this name in the ARCHIVE or
  638.   BACKUP directory, then FixTool replaces the last character of the name
  639.   with a number, starting with a 1.  For example, PMMERGE.DL_ would be
  640.   changed to PMMERG1.DL_ if there's a name collision.
  641.  
  642.   After locating the file you wish to restore, you can unpack the file
  643.   in either the ARCHIVE or BACKUP directory with the following command:
  644.     UNPACK filename.ex_
  645.  
  646.   This unpacks the file to the same directory.  If the file is not locked,
  647.   you can copy the file to the location desired and reboot.  If it is
  648.   locked, the copy will fail, and you'll need to boot to an alternate
  649.   boot source and then copy the file over and reboot.
  650.  
  651.   This is normally done when you believe that a regression has occurred
  652.   and the older file works better on your system than the one included
  653.   in the FixPak.
  654.  
  655.  
  656. ******************************************************************************
  657. Section 7.  How to Set Up the FixTool for Remote Installation
  658.  
  659.   To speed up FixPak installation or to setup a FixPak on a LAN drive
  660.   for use by others (Redirected Install), follow these steps.
  661.  
  662.   Before you begin, it is recommended that you install a Virtual Floppy Disk
  663.   program such as SVDISK (Super Virtual Disk) or VFDISK (Virtual Floppy Disk).
  664.  
  665.   In the following examples, d: is the working drive and j: is the Virtual
  666.   Floppy drive.  Replace this with the drive letters you use.  Also in these
  667.   examples, XR_W035 is the FixPak name.
  668.  
  669.   First, setup a directory to hold the FixTool code. For example,
  670.   run the following to place the FixTool into the d:\csf directory.
  671.  
  672. |       cs_144.exe d:\csf
  673.  
  674.   Next, setup the FixPak directory using the diskette images.
  675.  
  676.         loaddskf xr_w035.1dk j: /f/y/q
  677.         xcopy j: d:\xr_w035\ /h/o/t/s/e/r/v
  678.         loaddskf xr_w035.2dk j: /f/y/q
  679.         xcopy j: d:\xr_w035\ /h/o/t/s/e/r/v
  680.         ...
  681.         ...
  682.         ...        <repeat for each disk image in the FixPak>
  683.  
  684.   Install the FixPak by running service.exe.
  685.  
  686.         set csfutilpath=d:\csf
  687.         set csfcdromdir=d:\xr_w035
  688.         d:
  689.         cd csf
  690.         service  (or start service)
  691.  
  692.   You can also apply service by running fservice.exe with a response file.
  693.  
  694.         d:
  695.         cd csf
  696.         fservice /r:d:\csf\response.wp3 /s:d:\xr_w035
  697.  
  698.   This will apply the FixPak to all serviceable partitions.  If you want
  699.   to make the response file specific to a partition (drive) then you need
  700.   to change the :SYSLEVEL and :ARCHIVE lines in response.wp3:
  701.  
  702.         :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  703.         :ARCHIVE \ARCHIVE
  704.  
  705.         -- should be changed to --
  706.  
  707.         :SYSLEVEL x:\OS2\INSTALL\SYSLEVEL.OS2
  708.         :ARCHIVE x:\ARCHIVE
  709.  
  710.   where x: is the drive you want serviced.
  711.  
  712.  
  713. ******************************************************************************
  714. Section 8.  How to Customize the Response File
  715.  
  716.   There are three standard response files included with the FixTool that can be
  717.   modified for your configuration needs.  To modify a response file, copy one
  718.   of the standard response files (RESPONSE.WP3, RESPONSE.WP4, or RESPONSE.LAN)
  719.   to a file called RESPONSE.FIL.  Modify the RESPONSE.FIL as needed, and then
  720.   run FSERVICE /R:RESPONSE.FIL.
  721.  
  722.   The following sections show a few of the service actions you can take through
  723.   a response file.  For more information about response files, view the
  724.   README.INF file that comes with the FixTool.
  725.  
  726. 8.1.  Applying Service to a Product Without an Existing Archive
  727.  
  728.   This response file can be used to apply service for the first time using
  729.   FSERVICE when there is no existing archive of the product being serviced.  It
  730.   will service all partitions and place an archive in each partition.  It does
  731.   not take a backup of changed files.
  732.  
  733.   In this case, the SERVICE.LOG file will go into the C:\OS2\INSTALL directory.
  734.   Files that are read-only, hidden, or system files will be replaced
  735.   automatically during service.  The FixPak source files are on A:. The FixTool
  736.   will service all partitions where \OS2\INSTALL\SYSLEVEL.OS2 and
  737.   \MMOS2\INSTALL\SYSLEVEL.MPM are found, and it will save the original files in
  738.   an \ARCHIVE directory for each partition serviced.
  739.  
  740.   Note that the :LOGFILE tag is optional and may be overridden by using the /L:
  741.   parameter on the FSERVICE command line.  The :FLAGS and :SOURCE tags are also
  742.   optional, but if used, the :SERVICE tag must be included.  The :SOURCE tag
  743.   can be overridden by using the /S:  parameter on the FSERVICE command line.
  744.   You should include a :SERVICE, :SYSLEVEL, and :ARCHIVE tag for each product
  745.   to be serviced.  Note that the :SERVICE, :SYSLEVEL, and :ARCHIVE tags must
  746.   appear in the order shown in this example.
  747.  
  748.   The REPLACE_NEWER flag can be added to the :FLAGS line as shown here:
  749.      :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  750.  
  751.   This flag will replace files automatically instead of giving a pop-up
  752.   panel that questions whether you want to replace a file that is newer on
  753.   the system with an older version from the FixPak.
  754.  
  755.   Warning:  Using the REPLACE_NEWER flag may cause files to be back-leveled.
  756.   Be sure that you know it is okay to replace the files that are newer before
  757.   you use this flag.
  758.  
  759.   This flag was included in the previous default response files for OS/2 Warp 3,
  760.   but has been deleted because it allows you to back-level files
  761.   unintentionally.
  762.  
  763.      :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  764.      :FLAGS REPLACE_PROTECTED
  765.      :SOURCE A:\
  766.      :SERVICE
  767.      :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  768.      :ARCHIVE \ARCHIVE
  769.      :SERVICE
  770.      :SYSLEVEL \MMOS2\INSTALL\SYSLEVEL.MPM
  771.      :ARCHIVE \ARCHIVEM
  772.  
  773.   For OS/2 Warp 4 systems, the multimedia lines are not needed in the response
  774.   file.  So, the last three lines in the previous example should be removed or
  775.   commented out of the response file for OS/2 Warp 4.0.
  776.  
  777. 8.2.  Applying Service to a Product With an Existing Archive
  778.  
  779.   This response file can be used to apply service using FSERVICE when there is
  780.   an existing archive of the product being serviced.  This demonstrates the
  781.   ability to take a backup of changed files.
  782.  
  783.   Notice that each product serviced must be backed up to a different directory,
  784.   so the drive must be explicitly defined in the :SYSLEVEL, :ARCHIVE, and
  785.   :BACKUP lines.  Also note the order of the :SERVICE, :SYSLEVEL, :ARCHIVE,
  786.   and :BACKUP tags.  These tags must appear in this order.  The :BACKUP tag is
  787.   optional.
  788.  
  789.   The REPLACE_NEWER flag can be added to the :FLAGS line as shown here:
  790.      :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  791.  
  792.   This flag will replace files automatically instead of giving a pop-up
  793.   panel that questions whether you want to replace a file that is newer on
  794.   the system with an older version from the FixPak.
  795.  
  796.   Warning:  Using the REPLACE_NEWER flag may cause files to be back-leveled.
  797.   Be sure that you know it is okay to replace the files that are newer before
  798.   you use this flag.
  799.  
  800.   This flag was included in the previous default response files for OS/2 Warp 3,
  801.   but has been deleted because it allows you to back-level files
  802.   unintentionally.
  803.  
  804.      :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  805.      :FLAGS REPLACE_PROTECTED
  806.      :SOURCE A:\
  807.      :SERVICE
  808.      :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  809.      :ARCHIVE C:\ARCHIVE
  810.      :BACKUP C:\BACKUP
  811.      :SERVICE
  812.      :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  813.      :ARCHIVE C:\ARCHIVEM
  814.      :BACKUP C:\BACKUPM
  815.  
  816.   For OS/2 Warp 4.0, the last four lines are not needed in the response file.
  817.  
  818. 8.3.  Backing Out to the Archive Level of a Product
  819.  
  820.   This is a sample response file to be used when backing out to the archive
  821.   level of a product.  Note that you can only use one :TARGET tag in the
  822.   response file. Also note that the :TARGET tag must appear before a :BACKOUT
  823.   tag is used.
  824.  
  825.      :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  826.      :SOURCE A:\
  827.      :TARGET ARCHIVE
  828.      :BACKOUT
  829.      :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  830.      :BACKOUT
  831.      :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  832.  
  833.   For OS/2 Warp 4.0, you do not need to include the last two lines of this
  834.   example in your response file.
  835.  
  836. 8.4.  Backing Out to the Backup Level of a Product
  837.  
  838.   This is a sample response file to be used when backing out to the backup
  839.   level of a product.
  840.  
  841.      :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  842.      :SOURCE A:\
  843.      :TARGET BACKUP
  844.      :BACKOUT
  845.      :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  846.      :BACKOUT
  847.      :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  848.  
  849.   For OS/2 Warp 4.0, you do not need to include the last two lines of this
  850.   example in your response file.
  851.  
  852. 8.5.  Committing a Product
  853.  
  854.   This is a sample response file to be used when committing a product.
  855.  
  856.      :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  857.      :SOURCE A:\
  858.      :COMMIT
  859.      :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  860.      :COMMIT
  861.      :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  862.  
  863.   For OS/2 Warp 4.0, do not include the last two lines of this example in your
  864.   response file.
  865.  
  866. 8.6.  Redirecting an Archive of a Product to Another Existing Archive
  867.  
  868.   This is a sample response file to be used when redirecting an archive of a
  869.   product to another existing archive location.  One example of this would be
  870.   for using a shared network archive.  Note that the archive directory
  871.   specifies the location of an existing archive to which the current product is
  872.   being redirected.  In this example the arbitrary drive shows S:, which may be
  873.   a LAN drive.
  874.  
  875.      :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  876.      :SOURCE A:\
  877.      :REDIRECT
  878.      :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  879.      :ARCHIVE S:\ARCHIVE
  880.      :REDIRECT
  881.      :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  882.      :ARCHIVE S:\ARCHIVEM
  883.  
  884.   For OS/2 Warp 4.0, do not include the last three lines of this example in
  885.   your response file.
  886.  
  887.  
  888. ******************************************************************************
  889. Section 9.  How to Turn Off Archiving for a FixPak
  890.  
  891.   With FixTool 1.40 and later, a new utility called ARCHCTL.CMD is included.
  892.   This utility allows you to turn off the archiving feature of a FixPak.  This
  893.   is especially useful if you have already tested a FixPak in a controlled
  894.   environment and are convinced that there will be no need to backout the
  895.   FixPak to an original product level.
  896.  
  897.   With archiving turned off, you may include a backup directory and backup
  898.   to your previous level if desired.  But you will not be able to back up
  899.   more than one level.  For example, if you install OS/2 Base FixPak 8 with
  900.   archiving turned off and include a backup directory, then when you install
  901.   FixPak 9, the backup directory for FixPak 8 is deleted.
  902.  
  903.   If you do not include a backup directory with archiving turned off, there
  904.   is no way to back up to a previous level.
  905.  
  906.   The syntax for the ARCHCTL utility is as follows:
  907.  
  908.     ARCHCTL ON|OFF fixpak_source
  909.  
  910.   where
  911.  
  912.     ON|OFF         indicates the action to perform. ON enables archiving;
  913.                    OFF disables it.
  914.     fixpak_source  is normally the drive with the first FixPak diskette,
  915.                    but it can also be the root of the FixPak when copied
  916.                    to the hard disk (where the \FIX subdirectory is located).
  917.  
  918.   The default for OS/2 FixPaks is ON.  The default for LAN FixPaks is OFF.
  919.  
  920.   Examples for turning archiving OFF:
  921.     Example 1.
  922.     1. Place first FixPak diskette in A:
  923.     2. Enter ARCHCTL OFF A:
  924.  
  925.     Example 2.
  926.     1. XCOPY all FixPak diskette data to N:\FIXES\FP32
  927.     2. Enter ARCHCTL OFF N:\FIXES\FP32
  928.  
  929.   Examples for turning archiving ON:
  930.     Example 3.
  931.     1. Place first FixPak diskette in A:
  932.     2. Enter ARCHCTL ON A:
  933.  
  934.     Example 4.
  935.     1. XCOPY all FixPak diskette data to N:\FIXES\FP32
  936.     2. Enter ARCHCTL ON N:\FIXES\FP32
  937.  
  938.  
  939. ******************************************************************************
  940. Section 10. Setting Environment Variables
  941.  
  942.   There are several SET statements that set environment variables for the
  943.   FixTool to use.  See the table below for a list of these variables and
  944.   a description of what they do.
  945.  
  946.    Environment Variable              Usage
  947.    -------------------------------   -----------------------------------
  948.    SET CSFUTILPATH=path              Allows you to run SERVICE or
  949.                                      FSERVICE from your hard drive or
  950.                                      from a redirected drive.
  951.  
  952.    SET CSFCDROMDIR=path              Allows you to install a FixPak
  953.                                      from a redirected drive or CD-ROM.
  954.                                      All of the FixPak files should be
  955.                                      in this path.  This path should NOT
  956.                                      be pointing to a floppy (or virtual
  957.                                      floppy) drive.
  958.  
  959.    SET REMOTE_INSTALL_STATE=0|1      If this variable is set to 0, then
  960.                                      upon termination FixTool returns
  961.                                      control to the calling process.
  962.  
  963.    SET CSFDRIVEAPPLY=d               Allows you to restrict service to
  964.                                      products found only on drive d and
  965.                                      on the boot drive.
  966.  
  967.    SET CSFTIMESTAMP=1                Adds a timestamp to each line of the
  968.                                      SERVICE.LOG file.
  969.  
  970.    SET CSFSTAGEDRIVE=d               Allows you to determine where the
  971.                                      locked files will be temporarily
  972.                                      stored.  d is the drive on which to
  973.                                      put the locked files.
  974.  
  975.    SET CSFSKIPCRC=1                  Allows you to skip the CRC checking
  976.                                      of the FixPak files.  Be careful to
  977.                                      use this only if necessary.  The CRC
  978.                                      check identifies bad media and prevents
  979.                                      potential problems.
  980.  
  981. ******************************************************************************
  982. Section 11.  If You Have a Problem
  983.  
  984.   If the FixPak does not install properly, there are files you can look in
  985.   to find out what error occurred.  The SERVICE.LOG file is the first place
  986.   to look.  The FixTool puts it in the x:\OS2\INSTALL directory where x: is
  987.   the OS/2 boot drive.
  988.  
  989.   If the FixTool is unable to complete processing successfully, then the next
  990.   time you use the FixTool, it will try to recover, picking up from where it
  991.   stopped previously.  It uses information from C:\FIXSTART to recover.  You
  992.   may also notice a directory $CSFTMP$ on a drive that had the largest amount
  993.   of free space available when the FixTool last started.  It is safe to delete
  994.   this directory and any files in it any time the FixTool is not running. This
  995.   directory is recreated on the drive with the most free space available
  996.   whenever starting the FixTool.  Due to system usage and drive space changes,
  997.   it may not be the same drive each time for this directory.
  998.  
  999. ******************************************************************************
  1000. Section 12.  Common Error Messages
  1001.  
  1002.   Here are some common error messages that you may receive when running
  1003.   SERVICE.
  1004.  
  1005.     - Error message:
  1006.       An error occurred while searching for files to update.
  1007.       The reason may be old or corrupt CSF logfiles, CSF_SEL.000
  1008.       file, or file system corruption.  See README file for more
  1009.       information.
  1010.  
  1011.       Explanation #1:
  1012.       You may get this if you have used the new FixTool (version
  1013.       1.38 or later) to install a FixPak, and then try to use an
  1014.       old version of the FixTool (version 1.37B or earlier).
  1015.  
  1016.       Solution #1:
  1017.       If you are installing a LAN FixPak, you can delete all the
  1018.       LOGF0000.xxx and LOGSTART.xxx files on your system, and
  1019.       reapply the FixPak.  If you are installing an OS/2 FixPak,
  1020.       you will also need to copy your original SYSLEVEL.OS2 file
  1021.       back into the \OS2\INSTALL directory.
  1022.  
  1023.       Explanation #2:
  1024.       You may also get this error if you are trying to service
  1025.       a system that has many syslevel files (over about 150)
  1026.       on all drives.
  1027.  
  1028.       Solution #2:
  1029.       If your system has a large number of syslevel files, you
  1030.       may have to limit the search for products to be serviced
  1031.       by using the following set statement before you run SERVICE:
  1032.  
  1033.       SET CSFDRIVEAPPLY=d
  1034.  
  1035.       where d is the drive you wish to service.  This statement
  1036.       limits the search for serviceable products to one drive at
  1037.       a time in addition to the boot drive.  This will get the
  1038.       number of files opened down to a workable level.
  1039.  
  1040.     - Error message:
  1041.       No products were found on the target system to service.
  1042.  
  1043.       Explanation #1:
  1044.       Your SYSLEVEL.xxx file does not contain the proper
  1045.       prerequisite FixPak number or product information.  In
  1046.       order to install a FixPak, the number of the FixPak must
  1047.       be higher than the number of the current CSD in the
  1048.       SYSLEVEL.xxx file, or the product information must match.
  1049.  
  1050.       Solution #1:
  1051.       Check the prerequisites needed for the FixPak you are
  1052.       trying to install.  Some FixPaks have a particular FixPak
  1053.       that must be installed prior to installing that FixPak.
  1054.       Also, make sure that the FixPak you are trying to install
  1055.       is one that may be applied to that product.  If the product
  1056.       information is incorrect, you may need to copy the product
  1057.       SYSLEVEL.xxx file from the install media.
  1058.  
  1059.       Explanation #2:
  1060.       If you have committed an OS/2 base FixPak with Version 1.38
  1061.       or Version 1.39, you may get this message when you try to
  1062.       install another FixPak.
  1063.  
  1064.       Solution #2:
  1065.       Copy the product's SYSLEVEL.xxx file from the install media
  1066.       or from a backup copy that was made prior to committing the
  1067.       FixPak.
  1068.  
  1069.     - Error message:
  1070.       The path <path\filename> does not exist or is invalid.
  1071.  
  1072.       Explanation:
  1073.       FixTool could not unpack the file specified in the message,
  1074.       or it could not unpack the file just prior to the file
  1075.       specified in the message.
  1076.  
  1077.       Solution:
  1078.       This indicates that the FixPak media is bad.  You should
  1079.       download the FixPak again, re-create the FixPak diskettes,
  1080.       and then re-install the FixPak.  The FixTool will resume,
  1081.       starting at the point where it stopped.
  1082.  
  1083.       If you get RC=109 in the service.log, the file listed prior
  1084.       to the first RC=109 is probably giving an unpack error.  The
  1085.       modules that received the 109 error were not updated properly.
  1086.       Make sure that you are using the UNPACK2.EXE that comes with
  1087.       this version of the FixTool.  You should also download the FixPak
  1088.       again and re-create the FixPak diskettes.  Then reinstall the
  1089.       FixPak from the new media.  The FixTool will resume, updating
  1090.       any files that were not originally updated.  If this does not
  1091.       fix the problem, please contact your service representative.
  1092.  
  1093.     - Error message:
  1094.       Error reading file <path>\IBMCSFLK.DLL.
  1095.  
  1096.       Explanation:
  1097.       FixTool could not find the files needed for servicing.
  1098.  
  1099.       Solution:
  1100.       Make sure that you've set the CSFUTILPATH and CSFCDROMDIR
  1101.       environment variables if you're running service from a hard
  1102.       drive.  The CSFUTILPATH should point to the directory that
  1103.       contains the FixTool files (SERVICE.EXE, FSERVICE.EXE, etc.),
  1104.       and CSFCDROMDIR should point to the directory that contains
  1105.       the FixPak files (with the FIX directory).  Also make sure
  1106.       that all the files listed in Section 2 are in your FixTool
  1107.       file directory.
  1108.  
  1109.     - Error message:
  1110.       No source drive is available.
  1111.  
  1112.       Explanation:
  1113.       The FixTool first checks for removable drives on the system.
  1114.       If there are no removable drives, you will get this error
  1115.       message if you have not set the CSFCDROMDIR to point to a valid
  1116.       hard drive or LAN drive.
  1117.  
  1118.       Solution:
  1119.       Set the CSFCDROMDIR to point to the drive and directory that
  1120.       contain the FixPak files.
  1121.  
  1122.     - Error message:
  1123.       Checksum error in <file>.
  1124.  
  1125.       Explanation:
  1126.       The FixTool checks the checksum of the source media with a
  1127.       checksum that was recorded when the FixPak was created.  If
  1128.       these values do not match, you will receive this error.
  1129.  
  1130.       Solution:
  1131.       This indicates that the FixPak media is bad.  Download the
  1132.       FixPak again and re-create the FixPak diskettes, or get another
  1133.       FixPak CD.  Then reinstall the FixPak.  The FixTool will resume,
  1134.       starting at the point where it stopped.
  1135.  
  1136.     - Error message:
  1137.       The path SET CSFCDROMDIR=<path\filename> does not exist or is
  1138.       invalid.
  1139.  
  1140.       Explanation:
  1141.       FixTool could not find the FIX directory in the path given in
  1142.       the SET CSFCDROMDIR statement.
  1143.  
  1144.       Solution:
  1145.       Check to make sure the path given in the SET CSFCDROMDIR statement
  1146.       is pointing to the directory that contains the FixPak.  This
  1147.       directory should contain all the files and directories included in
  1148.       the FixPak.
  1149.  
  1150.  
  1151.   Here are some common error messages that you might see when running
  1152.   FSERVICE.
  1153.  
  1154.     - Error message:
  1155.       CSF257: No product has been selected.
  1156.  
  1157.       Explanation:
  1158.       This error message is reported in several situations.  You may
  1159.       not have selected a product to service in the RESPONSE.FIL, or
  1160.       FSERVICE may not have found any products to service.  If FSERVICE
  1161.       didn't find any products to service, either the product information
  1162.       on the system did not match the product information in the FixPak,
  1163.       or FSERVICE determined that the FixPak would back-level the system.
  1164.  
  1165.       Solution:
  1166.       Check the prerequisites for the FixPak and make sure that the
  1167.       system contains the proper pre-requisites.  Also, be sure that
  1168.       the FixPak you are trying to install is being applied to the
  1169.       appropriate product.  If the product information is incorrect,
  1170.       you may need to copy the product SYSLEVEL.xxx file from the
  1171.       install media.
  1172.  
  1173.     - Error message:
  1174.       This portion of service has completed.  Reboot your
  1175.       system before applying additional service or using the product
  1176.       to process files that were locked during service.
  1177.  
  1178.       Explanation:
  1179.       This appears as a red screen with a title of "Corrective Service
  1180.       Facility Fatal Error," but the message may not indicate an error.
  1181.       Please view the service.log file by pressing Enter.  This screen
  1182.       appears after doing a backout with FSERVICE so that you can check
  1183.       the log file to make sure there are no errors before you reboot
  1184.       your system.
  1185.  
  1186.       Solution:
  1187.       Make sure that there are no errors logged and then press Ctrl-Break
  1188.       to exit service.  If there were no errors in the log file, then
  1189.       FSERVICE completed successfully and it's safe to reboot your system.
  1190.  
  1191.     - Error message:
  1192.       Error reading file <path>\IBMCSFLK.DLL.
  1193.  
  1194.       Explanation:
  1195.       FixTool could not find the files needed for servicing.
  1196.  
  1197.       Solution:
  1198.       Make sure that all the files listed in Section 2 are in the
  1199.       directory (or on the diskette) with the FixTool files.  Also,
  1200.       make sure your /S: parameter path is valid.  It should contain the
  1201.       FixPak files with the FIX directory.  Sometimes you may need to
  1202.       include the /S: parameter--even if you have set SOURCE properly in
  1203.       the response file.
  1204.  
  1205.  
  1206. ******************************************************************************
  1207. Section 13.  Other Known Problems
  1208.  
  1209.   The following problems have also been encountered:
  1210.  
  1211.   - When using SERVICE, one of the panels contains a Reboot button that
  1212.     no longer is needed.  This button was used when you wanted to reboot
  1213.     from the CSF boot diskettes, but the CSF boot diskettes are no longer
  1214.     available.  You should select Continue, or you can select Cancel and
  1215.     reboot the system using boot diskettes for that product.
  1216.  
  1217.   - BOOTOS2 induced problem. BOOTOS2 (corrected in latest version)
  1218.     copied the SYSLEVEL.OS2 file from the booted partition which was used
  1219.     to create the BOOTOS2 partition to the new partition. This SYSLEVEL.OS2
  1220.     file could have had default service directories that included drive
  1221.     letters in it.  Since BOOTOS2 copied the file to a different partition,
  1222.     the wrong drive letter would be specified for the FixTool to use when
  1223.     looking for files to be serviced.  The SYSLEVEL.OS2 normally would have
  1224.     default directories in it after one had applied service to a partition,
  1225.     or possibly after the system install.  The net result here is that
  1226.     if you had a SYSLEVEL.OS2 file with default directories in it, then
  1227.     created a BOOTOS2 partition, and later tried to service the BOOTOS2
  1228.     partition, the FixTool not only would apply service to the BOOTOS2
  1229.     partition, but the default directories in the SYSLEVEL.OS2 file as well
  1230.     (the partition where the SYSLEVEL.OS2 came from).
  1231.  
  1232.     The solution here is to copy the SYSLEVEL.OS2 from your distribution
  1233.     diskette or CD into OS2\INSTALL directory of the BOOTOS2 partition before
  1234.     applying service to that partition.
  1235.  
  1236.   - A trap can occur if you include an unformatted drive for the archive
  1237.     directory.  This occurs even if you format the drive in a different
  1238.     session before the FixTool processes any files for archiving.  This
  1239.     happens because the FixTool scans for formatted drives at the beginning
  1240.     of the program and creates a list of possible drives, which is not added
  1241.     to during subsequent processing.
  1242.  
  1243.     The solution is to make sure that you have a valid, formatted drive
  1244.     given for the ARCHIVE directory BEFORE the FixTool starts.  If not, you
  1245.     must stop and then restart the FixTool once the drive is valid.
  1246.  
  1247.   - If your drive C: is formatted with FAT32, you may get the following error
  1248.     message:  "An error occurred.  The reason may be old or corrupt CSF
  1249.     logfiles, CSF_SEL.000 file, or file system corruption."  This is a general
  1250.     error message that's returned when an unexpected return code is encountered.
  1251.     The error is sent because the FixTool searches for the FIXSTART file on C:,
  1252.     and therefore needs a C: partition that contains data it can read, such as
  1253.     FAT or HPFS.
  1254.  
  1255.     The solution is to create a dummy C: partition that's formatted FAT or HPFS.
  1256.     Try to boot to that C: partition (which will fail, but allows it to remain
  1257.     the active C: partition).  Then boot OS/2 and install the FixPak.
  1258.     Finally, boot to the other C: partition, which will make it the default C:
  1259.     drive.
  1260.  
  1261.  
  1262. ******************************************************************************
  1263. Section 14.  List of Changes Made for Each Version (1.38 and Later)
  1264.  
  1265.   This section gives a description of what changes have been made
  1266.   for the new versions of the FixTool (Version 1.38 and later).
  1267.  
  1268. | NOTE: FixTool 1.44 and FixTool 1.37B are the only supported FixTools.
  1269. |       FixTool 1.44 supersedes all FixTools. FixTool 1.37B can
  1270.         continue to be used only on FixPaks that it was released with.
  1271. |       All other FixPaks should use FixTool 1.44.
  1272.  
  1273. |  Changes Made in Version 1.43
  1274.  
  1275. |  - Added support for applying OS/2 Warp Convenience Packages using
  1276. |    FPINST.CMD
  1277.  
  1278. |  - Fixed a code problem dealing with systems where FAT32.IFS allowed
  1279. |    access to the C: drive.
  1280.  
  1281. |  - Fixed a problem where the FixTool was reporting insufficient space
  1282. |    on large hard drives with partitions over 4.3 MB's, even if the
  1283. |    the partition had enough space to allow FixPak Install.
  1284.  
  1285. |  - Fixed a problem with DBCS FixPak installation of OS/2 Warp
  1286. |    Convenience Packages.
  1287.  
  1288.    Changes Made in Version 1.43
  1289.  
  1290.    - Added support for applying Warp Server for e-business and Base Device
  1291.      Driver FixPaks using FPINST.CMD
  1292.  
  1293.    - Fixed a code problem dealing with resources inside the FixTool.
  1294.      This resource problem could make the FixTool hang under certain
  1295.      circumstances and make application of a FixPak difficult to
  1296.      complete.
  1297.  
  1298.    - Fixed a problem with DBCS FixPak installations on Warp Server for
  1299.      e-business SMP machines.
  1300.  
  1301.    Changes Made in Version 1.42
  1302.  
  1303.    - Added processing to detect the drive that VoiceType, Security, and
  1304.      OpenDoc are installed on.  These can now be serviced without the
  1305.      USERDIRS.OS2 file.
  1306.  
  1307.    - Changed the way forced locked files are processed.  RIPL tree files
  1308.      will no longer be force locked, and WIN-OS/2 files on a drive other
  1309.      than the boot drive may be force locked.
  1310.  
  1311.    - A config.sys file of 0 bytes will no longer be created on drives
  1312.      being serviced that do not contain a config.sys file.
  1313.  
  1314.    - The base device driver FixPak will be processed as an OS/2 product
  1315.      instead of a LAN product.
  1316.  
  1317.    - ABIOSless machines with RAM-loaded ABIOS will be properly detected.
  1318.  
  1319.    - Added backup/backout response file information to RESPONSE.LAN file.
  1320.  
  1321.    - Modified Fixtool to work with DBCS OS/2 base operating system
  1322.      FixPaks, with a pre-requisite of FX00505 for OS/2 Warp 4 and
  1323.      WX03807 for OS/2 Warp 3.
  1324.  
  1325.    - Can now rejoin large files that have been split across diskettes.
  1326.  
  1327.    - OS2KRNL, OS2LDR, and OS2BOOT files will only be given SYSTEM / HIDDEN
  1328.      attributes in the root directory.  If these files are serviced in other
  1329.      directories, they will not be made into SYSTEM / HIDDEN files.
  1330.  
  1331.  
  1332.   Changes Made in Version 1.41
  1333.  
  1334.    - Added the ability to include a timestamp in the SERVICE.LOG file.
  1335.  
  1336.    - Enhanced the performance when installing from diskettes.
  1337.  
  1338.    - Copy packed files to a temporary directory on the hard drive and then
  1339.      run checksum and unpack against the files on the temporary directory.
  1340.      An additional 1.1 MB is required for this processing.  The drive used for
  1341.      this is the one with the most available space.
  1342.  
  1343.    - Fixed error that occurred when C: is the CD-ROM drive.  CSF_SEL.000 and
  1344.      FIXSTART will be written to the first non-removable, non-network drive
  1345.      on the system.
  1346.  
  1347.    - Changed Backout routine so that any CSBKExxx.EXE exit routines will run
  1348.      last, after the syslevel files are updated and the files are backed out.
  1349.  
  1350.    - Updated FILEFIX.DLL to detect invalid release numbers.  These must be
  1351.      between 1 and 255.  Also, this file was updated to not return a mismatch
  1352.      when the file versions are the same.
  1353.  
  1354.  
  1355.   Changes Made in Version 1.40
  1356.  
  1357.    - Fixes a commit problem introduced with FixTool 1.38. If you
  1358.      committed an OS/2 base FixPak with Version 1.38 or 1.39, you
  1359.      cannot install subsequent FixPaks without reverting to a
  1360.      SYSLEVEL.OS2 file used prior to the commit (you can use the
  1361.      SYSLEVEL.OS2 that was shipped with the product from the product
  1362.      diskettes/CD).
  1363.  
  1364.      After you had done a commit, applied a FP to the committed base,
  1365.      and then either restored from the commit Archive or backed out an
  1366.      installed FP, the fact that the base was at a specific FixPak
  1367.      level was lost. The FixTool will now create in OS2\INSTALL a file
  1368.      named FPCOMMIT.OS2 to hold the base committed SYSLEVEL. This will
  1369.      be restored to SYSLEVEL.OS2 during either of these 2 restore
  1370.      activities. Do not erase this file.
  1371.  
  1372.    - Eliminates a SYS0039 error when using SERVICE without a diskette
  1373.      in the drive when starting the FixTool.
  1374.  
  1375.    - Allows you to set a new CSFDRIVEAPPLY environment variable prior
  1376.      to running SERVICE which will limit the search for products to be
  1377.      serviced to the drive given in the set statement and to the boot
  1378.      drive.
  1379.  
  1380.    - Includes an updated FPINST.CMD file that uses the /B: parameter
  1381.      for LAN-related FixPak installations.
  1382.  
  1383.    - Includes an updated UNPACK2.EXE and updated error handling for
  1384.      messages coming from UNPACK2.EXE.
  1385.  
  1386.    - Includes checksum verification on the source media.  This fix
  1387.      prevents corrupted source files from being transferred to the
  1388.      target system.  You may also notice a slight increase in the
  1389.      time it takes to process files to be updated.
  1390.  
  1391.    - Includes an ARCHCTL utility that allows you to turn off archive
  1392.      processing for a particular FixPak.
  1393.  
  1394.  
  1395.   Changes Made in Version 1.39
  1396.  
  1397.    - Works with OS/2 Warp v3.0 and LAN-related FixPaks.  The backout-
  1398.      to-backup process was fixed for LAN-related FixPaks.
  1399.  
  1400.    - The CSFUTILPATH environment variable does not have to be set to
  1401.      be able to run SERVICE from a hard drive.
  1402.  
  1403.    - Now services systems that do not have a removable media drive.
  1404.  
  1405.    - Contains an updated response file for Warp 4 systems.
  1406.  
  1407.  
  1408.   Changes Made in Version 1.38
  1409.  
  1410.    NOTE:  Version 1.38 of the FixTool was for use with OS/2 Warp v4.0 systems
  1411.    only.
  1412.  
  1413.    - Updates the CSD level in the SYSLEVEL.xxx file for all products.
  1414.      The CSD level is updated to match the FixPak number.
  1415.  
  1416.    - Recognizes Software Choice installed features.  When backing out
  1417.      a FixPak, you will be given a chance to cancel the backout if a
  1418.      Software Choice installed feature will be broken by the FixPak
  1419.      backout.
  1420.  
  1421.    - No longer uses CSF boot diskettes.  The FixTool now comes as a
  1422.      self-extracting zip file that can be unzipped to a single diskette.
  1423.  
  1424.    - Places the locked file device driver statements closer to the
  1425.      beginning of the CONFIG.SYS.
  1426.  
  1427.    - Corrects a problem with the backout-to-backup process when a file
  1428.      is serviced in more than one directory.
  1429.  
  1430.