home *** CD-ROM | disk | FTP | other *** search
/ ftp.ib.com / 2003-04-09_ftp.ibm.com-os2.zip / fixtool / english-us / cs_140.txt < prev    next >
Text File  |  1999-02-10  |  34KB  |  822 lines
  1.                 Readme for Corrective Service Facility 2-B
  2.                               Version 1.40
  3.  
  4.                       ****************************
  5.  
  6.  
  7. This readme file describes the features available with Version 1.40 of the
  8. Corrective Service Facility (referred to in this document as the FixTool).
  9. Once you use this version of the FixTool to service a product, you will not
  10. be able to use Version 1.37B or earlier. SYSLEVEL files are modified by
  11. FixTool 1.38 and later, causing FixTool 1.37B or earlier not to find products
  12. to service.
  13.  
  14. This document supplements the information given in the README.INF that
  15. comes with the FixTool.  The README.INF includes more details about the
  16. FixTool process.
  17.  
  18. CONTENTS:
  19.  
  20. Section 1.  How to Tell What FixTool Version You Have
  21. Section 2.  Files Included in the FixTool EXE File
  22. Section 3.  How to Use the FixTool EXE (Zip) File
  23. Section 4.  How to Apply Service
  24. Section 5.  How to Set Up the FixTool for Remote Installation
  25. Section 6.  How to Customize the Response File
  26. Section 7.  How to Turn Off Archiving for a FixPak
  27. Section 8.  Setting Environment Variables
  28. Section 9.  If You Have a Problem
  29. Section 10. Common Error Messages
  30. Section 11. Other Known Problems
  31. Section 12. List of Changes Made for Each Version (1.38 and Later)
  32.  
  33. ================================================
  34.  
  35. Section 1.  How to Tell What FixTool Version You Have
  36.  
  37. You can tell if you have Version 1.40 by running BLDLEVEL on SERVICE.EXE or
  38. FSERVICE.EXE.  You will see one of the following, depending on which version of
  39. BLDLEVEL.EXE you have.
  40.  
  41.   Signature:       @#IBM:F.140#@ OS/2 Corrective Service Facility (C) IBM 1994
  42.   Vendor:          IBM
  43.   Revision:        0.140
  44.   File Version:    0.140
  45.   Description:     OS/2 Corrective Service Facility (C) IBM 1994
  46.  
  47.   Signature:   @#IBM:F.140#@ OS/2 Corrective Service Facility (C) IBM 1994
  48.   Vendor:      IBM
  49.   Revision:    F.140
  50.   Description: OS/2 Corrective Service Facility (C) IBM 1994
  51.  
  52. The new version of the FixTool (Corrective Service Facility) updates the
  53. current CSD field in the SYSLEVEL files of the products it services.  After
  54. applying a FixPak with Version 1.40, you will be able to run SYSLEVEL and
  55. tell what FixPaks you have applied by looking at the current field of the
  56. product's SYSLEVEL file.
  57.  
  58. This version is also compatible with Software Choice features.  If you need to
  59. use Software Choice to install new features for a product, the FixTool will
  60. integrate SYSLEVEL and archive information from the Software Choice install the
  61. next time it services that product.
  62.  
  63.  
  64. Section 2.  Files Included in the FixTool EXE File
  65.  
  66. The following files are included in the FixTool EXE (Zip) file:
  67.  
  68. File            Use
  69. --------------  -----------------------------------------------------------
  70. BUILD.LVL       Contains build information for this FixTool release.
  71. CSFPANS.DLL     Used by FSERVICE
  72. SERVICE.EXE     Executable for applying service through a windowed session
  73. SERVICE.HLP     SERVICE help file
  74. SHPIINST.DLL    FixTool required DLL
  75. UNPACK.EXE      Used to unpack files being serviced
  76. UNPACK2.EXE     Used to unpack files being serviced
  77. VIOCALLS.DLL    FixTool required DLL
  78. FSERVICE.EXE    Executable for applying service through a command line
  79.                 (used with a response file).
  80. IBMCSFLK.DLL    Locked file device driver file
  81. IBMCSFLK.EXE    Locked file device driver file
  82. IBMCSFLK.SYS    Locked file device driver file
  83. IBMCSFLK.MSG    Locked file device driver file
  84. PACK.EXE        Used to pack files being archived or backed up
  85. README.INF      General Installation instructions for the FixTool
  86. RESPONSE.LAN    Response file for servicing network-related products
  87. RESPONSE.WP3    Response file for servicing OS/2 Warp v3 base
  88. RESPONSE.WP4    Response file for servicing OS/2 Warp v4 base
  89. FSERVICE.MSG    FSERVICE message file
  90. FPINST.CMD      Command file for applying service through FSERVICE
  91.                 (uses standard response files for OS/2 Warp 3, OS/2 Warp 4,
  92.                  and network-related FixPaks)
  93. NLS.DLL         FixTool required DLL
  94. MSG.DLL         FixTool required DLL
  95. FILEFIX.DLL     FixTool required DLL
  96. ARCHCTL.CMD     Command file that allows you to turn off archiving for
  97.                 a particular FixPak.
  98. READ.ME         This file
  99.  
  100. Section 3.  How to Use the FixTool EXE (Zip) File
  101.  
  102. First, unzip the FixTool zip file onto a diskette or into a directory.  You can
  103. do this by copying the self-extracting zip file into a new subdirectory and
  104. then use the following commands from an OS/2 command prompt:
  105.  
  106.         <d>:
  107.         cd <directory>
  108.         CSx140 <target>
  109.  
  110. where <d>         is the drive that you've put the FixTool zip file on,
  111.       <directory> is the directory that you've copied the self-extracting
  112.                   zip file to.
  113.       x           Country code, where '_' is the US country code. Other NLV
  114.                   country codes are identical to the Country code used in
  115.                   FixPak's.
  116.       <target>    is the fully qualified path where the file is to be
  117.                   unzipped to.
  118.  
  119. If <target> is not a diskette, you can also copy all the files in <target>
  120. onto a diskette, except for CSx140.EXE if you wish.
  121.  
  122. Next, you need OS/2 boot capability.  For this, you can use any of the
  123. following:
  124.  
  125.    - boot the install diskettes for the product you're servicing
  126.    - create utility diskettes from your system and boot these
  127.    - use a maintenance partition if you have one
  128.    - boot through Alt-F1 and go to the command prompt
  129.    - boot OS/2 as usual and then open an OS/2 session
  130.  
  131.  
  132. Section 4.  How to Apply Service
  133.  
  134. Once you have boot capability (see Section 3) and are at a command prompt,
  135. you can apply service using one of the following methods:
  136.  
  137.         Using FPINST
  138.         Using SERVICE
  139.         Using FSERVICE with a custom RESPONSE.FIL
  140.  
  141. Insert the FixTool diskette you created, or change to the directory that
  142. the FixTool is in, and then use FPINST or FSERVICE as described in
  143. Sections 4.1 and 4.3.  To use SERVICE as described in Section 4.2, you
  144. must have OS/2 running without having booted from diskettes, maintenance
  145. partition, or via Alt-F1.
  146.  
  147. 4.1.  Using FPINST
  148.  
  149. To use FPINST, change to the diskette or directory where you have
  150. FPINST.CMD and the related files, and type
  151.  
  152.       FPINST fixpak_type <boot_drive>
  153.  
  154. where fixpak_type  is WARP3   for OS/2 Warp Version 3.0 FixPak installs,
  155.                       WARP4   for OS/2 Warp Version 4.0 FixPak installs, or
  156.                       NETWORK for LAN or network-related FixPak installs, and
  157.       <boot_drive> is an optional parameter that is only valid when
  158.                       fixpak_type is NETWORK. This is the boot drive of the
  159.                       system.  This restricts the application of FixPaks to
  160.                       specific drives on systems where more than one OS/2
  161.                       system is applied.
  162.  
  163. FPINST uses FSERVICE with a standard response file.  For OS/2 Base FixPaks,
  164. the response file saves an archive copy of the files it services in
  165. <boot_drive>:\ARCHIVE.  For LAN or network-related FixPaks, there is no
  166. archive or backup created.  If you want to keep a backup with
  167. network-related FixPaks, use SERVICE or use FSERVICE with a custom
  168. RESPONSE.FIL.  See Section 6 for more information on customizing a response
  169. file.
  170.  
  171. 4.2.  Using SERVICE
  172.  
  173. To use SERVICE, go to the diskette or directory where you have SERVICE.EXE and
  174. the related files.  Then type
  175.  
  176.         SERVICE
  177.  
  178. The program will prompt you for required inputs.  See README.INF for more
  179. information about these panels.
  180.  
  181. With FixTool Version 1.39 or later, the CSFUTILPATH defaults to the path that
  182. you have executed SERVICE from, so you do not need to set this environment
  183. variable if all the FixTool files are in the same directory with SERVICE.EXE.
  184.  
  185. NOTE:  To use SERVICE, you must have the OS/2 PM Shell running.  You cannot
  186.        run SERVICE if you have booted from install diskettes or if you pressed
  187.        Alt-F1 to get to a command prompt.
  188.  
  189. 4.3.  Using FSERVICE
  190.  
  191. To use FSERVICE from a diskette, copy your customized RESPONSE.FIL to the
  192. diskette with the FixTool files, then go to the diskette and type
  193.  
  194.         FSERVICE /R:RESPONSE.FIL
  195.  
  196. If you have copied the FixTool files into a directory, you need to use the
  197. following command from the directory with FSERVICE.EXE and the related files
  198. (including your custom RESPONSE.FIL):
  199.  
  200.         FSERVICE /R:RESPONSE.FIL /S:<d>:\<directory>
  201.  
  202. where <d> is the drive with the FixTool related files and
  203.       <directory> is the directory structure where you put the FixTool files.
  204.  
  205. There are optional parameters that can be included on the FSERVICE command
  206. line.  See the README.INF file for more details about these parameters.
  207.  
  208. You should use the /B:<drive> parameter with FSERVICE when applying LAN FixPaks
  209. on systems with more than one OS/2 boot partition.  <drive> is the OS/2 boot
  210. partition to be serviced.
  211.  
  212.  
  213. Section 5.  How to Set Up the FixTool for Remote Installation
  214.  
  215. If you want to speed up FixPak installation or setup a FixPak on a LAN drive
  216. for use by others (Redirected Install), follow these steps.
  217.  
  218. Before you begin, I strongly recommend you go install a Virtual Floppy Disk
  219. program like SVDISK (Super Virtual Disk) or VFDISK (Virtual Floppy Disk).  Go
  220. to a Web site and search on "virtual floppy" to locate.
  221.  
  222. In the following examples, d:  is the work drive and j: is the Virtual Floppy
  223. drive.  Replace this with whatever drive letters you need to use. xr_w035 is
  224. the FixPak we are working with.
  225.  
  226. First, setup a directory to hold the FixTool code. For example,
  227. run CS_140.EXE D:\CSF to place the FixTool into the target directory.
  228.  
  229. Next, setup the FixPak directory using the diskette images.
  230.  
  231.         loaddskf xr_w035.1dk j: /f/y/q
  232.         xcopy j: d:\xr_w035\ /h/o/t/s/e/r/v
  233.         loaddskf xr_w035.2dk j: /f/y/q
  234.         xcopy j: d:\xr_w035\ /h/o/t/s/e/r/v
  235.         ...     ...     ...     ...
  236.         repeat for each disk image in the FixPak
  237.  
  238.  
  239. Install the FixPak by running service.exe.
  240.  
  241.         set csfutilpath=d:\csf
  242.         set csfcdromdir=d:\xr_w035
  243.         d:
  244.         cd csf
  245.         service  (or start service)
  246.  
  247. You can also apply service by running fservice.exe with a response file.
  248.  
  249.         d:
  250.         cd csf
  251.         fservice /r:d:\csf\response.wp3 /s:d:\xr_w035
  252.  
  253.         This will apply the FixPak to all serviceable partitions.  If you want
  254.         to make the response file specific to a partition (drive) then you need
  255.         to change the :SYSLEVEL and :ARCHIVE lines in response.wp3:
  256.  
  257.         :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  258.         :ARCHIVE \ARCHIVE
  259.  
  260.         -- to --
  261.  
  262.         :SYSLEVEL x:\OS2\INSTALL\SYSLEVEL.OS2
  263.         :ARCHIVE x:\ARCHIVE
  264.  
  265. where x: is the drive you want serviced.
  266.  
  267.  
  268. Section 6.  How to Customize the Response File
  269.  
  270. There are three standard response files included with the FixTool that can be
  271. modified for your configuration needs.  To modify a response file, copy one of
  272. the standard response files (RESPONSE.WP3, RESPONSE.WP4, or RESPONSE.LAN) to a
  273. file called RESPONSE.FIL.  Modify the RESPONSE.FIL as needed, and then run
  274. FSERVICE /R:RESPONSE.FIL.
  275.  
  276. The following sections show a few of the service actions you can take through
  277. a response file.  For more information about response files, view the README.INF
  278. file that comes with the FixTool.
  279.  
  280. 6.1.  Applying Service to a Product Without an Existing Archive
  281.  
  282. This response file can be used to apply service for the first time using
  283. FSERVICE when there is no existing archive of the product being serviced.  It
  284. will service all partitions and place an archive in each partition.  It does
  285. not take a backup of changed files.
  286.  
  287. In this case, the SERVICE.LOG file will go into the C:\OS2\INSTALL directory.
  288. Files that are read-only, hidden, system, or newer will be replaced
  289. automatically during service.  The FixPak source files are on A:. The FixTool
  290. will service all partitions where \OS2\INSTALL\SYSLEVEL.OS2 and
  291. \MMOS2\INSTALL\SYSLEVEL.MPM are found, and it will save the original files in
  292. an \ARCHIVE directory for each partition serviced.
  293.  
  294. Note that the :LOGFILE tag is optional and may be overridden by using the /L:
  295. parameter on the FSERVICE command line.  The :FLAGS and :SOURCE tags are also
  296. optional, but if used, the :SERVICE tag must be included.  The :SOURCE tag can
  297. be overridden by using the /S:  parameter on the FSERVICE command line.  You
  298. should include a :SERVICE, :SYSLEVEL, and :ARCHIVE tag for each product to be
  299. serviced.  Note that the :SERVICE, :SYSLEVEL, and :ARCHIVE tags must appear in
  300. the order shown in this example.
  301.  
  302. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  303. :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  304. :SOURCE A:\
  305. :SERVICE
  306. :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  307. :ARCHIVE \ARCHIVE
  308. :SERVICE
  309. :SYSLEVEL \MMOS2\INSTALL\SYSLEVEL.MPM
  310. :ARCHIVE \ARCHIVEM
  311.  
  312. For OS/2 Warp 4 systems, the multimedia lines are not needed in the response
  313. file.  So, the last three lines in the previous example should be removed or
  314. commented out of the response file for OS/2 Warp 4.0.
  315.  
  316. 6.2.  Applying Service to a Product With an Existing Archive
  317.  
  318. This response file can be used to apply service using FSERVICE when there is an
  319. existing archive of the product being serviced.  This demonstrates the ability
  320. to take a backup of changed files.
  321.  
  322. Notice that each product serviced must be backed up to a different directory,
  323. so the drive must be explicitly defined in the :SYSLEVEL, :ARCHIVE, and :BACKUP
  324. lines.  Also note the order of the :SERVICE, :SYSLEVEL, :ARCHIVE, and :BACKUP
  325. tags.  These tags must appear in this order.  The :BACKUP tag is optional.
  326.  
  327. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  328. :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  329. :SOURCE A:\
  330. :SERVICE
  331. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  332. :ARCHIVE C:\ARCHIVE
  333. :BACKUP C:\BACKUP
  334. :SERVICE
  335. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  336. :ARCHIVE C:\ARCHIVEM
  337. :BACKUP C:\BACKUPM
  338.  
  339. For OS/2 Warp 4.0, the last four lines are not needed in the response file.
  340.  
  341. 6.3.  Backing Out to the Archive Level of a Product
  342.  
  343. This is a sample response file to be used when backing out to the archive level
  344. of a product.  Note that you can only use one :TARGET tag in the response file.
  345. Also note that the :TARGET tag must appear before a :BACKOUT tag is used.
  346.  
  347. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  348. :TARGET ARCHIVE
  349. :BACKOUT
  350. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  351. :BACKOUT
  352. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  353.  
  354. For OS/2 Warp 4.0, you do not need to include the last two lines of this
  355. example in your response file.
  356.  
  357. 6.4.  Backing Out to the Backup Level of a Product
  358.  
  359. This is a sample response file to be used when backing out to the backup level
  360. of a product.
  361.  
  362. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  363. :TARGET BACKUP
  364. :BACKOUT
  365. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  366. :BACKOUT
  367. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  368.  
  369. For OS/2 Warp 4.0, you do not need to include the last two lines of this
  370. example in your response file.
  371.  
  372. 6.5.  Committing a Product
  373.  
  374. This is a sample response file to be used when committing a product.
  375.  
  376. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  377. :COMMIT
  378. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  379. :COMMIT
  380. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  381.  
  382. For OS/2 Warp 4.0, do not include the last two lines of this example in your
  383. response file.
  384.  
  385. 6.6.  Redirecting an Archive of a Product to Another Existing Archive
  386.  
  387. This is a sample response file to be used when redirecting an archive of a
  388. product to another existing archive location.  One example of this would be for
  389. using a shared network archive.  Note that the archive directory specifies the
  390. location of an existing archive to which the current product is being
  391. redirected.  In this example the arbitrary drive shows S:, which may be a LAN
  392. drive.
  393.  
  394. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  395. :REDIRECT
  396. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  397. :ARCHIVE S:\ARCHIVE
  398. :REDIRECT
  399. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  400. :ARCHIVE S:\ARCHIVEM
  401.  
  402. For OS/2 Warp 4.0, do not include the last three lines of this example in
  403. your response file.
  404.  
  405.  
  406. Section 7.  How to Turn Off Archiving for a FixPak
  407.  
  408. FixTool 1.40 includes a new utility, ARCHCTL.CMD, that allows you to
  409. turn off the archiving feature of a FixPak.  This is especially useful
  410. if you have already tested a FixPak in a controlled environment and are
  411. convinced that there will be no need to backout the FixPak to an original
  412. product level.
  413.  
  414. With archiving turned off, you may include a backup directory and backup
  415. to your previous level if desired.  But you will not be able to back up
  416. more than one level.  For example, if you install OS/2 Base FixPak 8 with
  417. archiving turned off and include a backup directory, then when you install
  418. FixPak 9, the backup directory for FixPak 8 is deleted.
  419.  
  420. If you do not include a backup directory with archiving turned off, there
  421. is no way to back up to a previous level.
  422.  
  423. The syntax for the ARCHCTL utility is as follows:
  424.  
  425.     ARCHCTL ON|OFF fixpak_source
  426.  
  427. where
  428.  
  429.     ON|OFF         indicates the action to perform. ON enables archiving;
  430.                    OFF disables it.
  431.     fixpak_source  is normally the drive with the first FixPak diskette,
  432.                    but it can also be the root of the FixPak when copied
  433.                    to the hard disk (where the \FIX subdirectory is located).
  434.  
  435. The default for OS/2 FixPaks is ON.  The default for LAN FixPaks is OFF.
  436.  
  437. Examples for turning archiving OFF:
  438.   Example 1.
  439.   1. Place first FixPak diskette in A:
  440.   2. Enter ARCHCTL OFF A:
  441.  
  442.   Example 2.
  443.   1. XCOPY all FixPak diskette data to N:\FIXES\FP32
  444.   2. Enter ARCHCTL OFF N:\FIXES\FP32
  445.  
  446. Examples for turning archiving ON:
  447.   Example 3.
  448.   1. Place first FixPak diskette in A:
  449.   2. Enter ARCHCTL ON A:
  450.  
  451.   Example 4.
  452.   1. XCOPY all FixPak diskette data to N:\FIXES\FP32
  453.   2. Enter ARCHCTL ON N:\FIXES\FP32
  454.  
  455.  
  456. Section 8.  Setting Environment Variables
  457.  
  458. There are several SET statements that set environment variables for the
  459. FixTool to use.  See the table below for a list of these variables and
  460. a description of what they do.
  461.  
  462.    Environment Variable              Usage
  463.    -------------------------------   -----------------------------------
  464.    SET CSFUTILPATH=path              Allows you to run SERVICE or
  465.                                      FSERVICE from your hard drive or
  466.                                      from a redirected drive.
  467.  
  468.    SET CSFCDROMDIR=path              Allows you to install a FixPak
  469.                                      from a redirected drive or CD-ROM.
  470.                                      All of the FixPak files should be
  471.                                      in this path.  This path should NOT
  472.                                      be pointing to a floppy (or virtual
  473.                                      floppy) drive.
  474.  
  475.    SET REMOTE_INSTALL_STATE=0|1      If this variable is set to 0, then
  476.                                      upon termination FixTool returns
  477.                                      control to the calling process.
  478.  
  479.    SET CSFDRIVEAPPLY=d               Allows you to restrict service to
  480.                                      products found only on drive d and
  481.                                      on the boot drive.
  482.  
  483.  
  484. Section 9.  If You Have a Problem
  485.  
  486. If the FixPak does not install properly, there are files you can look in
  487. to find out what error occurred.  The SERVICE.LOG file is the first place
  488. to look.  The FixTool puts it in the directory where the SYSLEVEL file
  489. of the product being serviced is located.
  490.  
  491.  
  492. Section 10.  Common Error Messages
  493.  
  494. Here are some common error messages that you may receive when running
  495. SERVICE.
  496.  
  497.     - Error message:
  498.       An error occurred while searching for files to update.
  499.       The reason may be old or corrupt CSF logfiles, CSF_SEL.000
  500.       file, or file system corruption.  See README file for more
  501.       information.
  502.  
  503.       Explanation #1:
  504.       You may get this if you have used the new FixTool (version
  505.       1.38 or later) to install a FixPak, and then try to use an
  506.       old version of the FixTool (version 1.37B or earlier).
  507.  
  508.       Solution #1:
  509.       If you are installing a LAN FixPak, you can delete all the
  510.       LOGF0000.xxx and LOGSTART.xxx files on your system, and
  511.       reapply the FixPak.  If you are installing an OS/2 FixPak,
  512.       you will also need to copy your original SYSLEVEL.OS2 file
  513.       back into the \OS2\INSTALL directory.
  514.  
  515.       Explanation #2:
  516.       You may also get this error if you are trying to service
  517.       a system that has many syslevel files (over about 150)
  518.       on all drives.
  519.  
  520.       Solution #2:
  521.       If your system has a large number of syslevel files, you
  522.       may have to limit the search for products to be serviced
  523.       by using the following set statement before you run SERVICE:
  524.  
  525.       SET CSFDRIVEAPPLY=d
  526.  
  527.       where d is the drive you wish to service.  This statement
  528.       limits the search for serviceable products to one drive at
  529.       a time in addition to the boot drive.  This will get the
  530.       number of files opened down to a workable level.
  531.  
  532.     - Error message:
  533.       No products were found on the target system to service.
  534.  
  535.       Explanation #1:
  536.       Your SYSLEVEL.xxx file does not contain the proper
  537.       prerequisite FixPak number or product information.  In
  538.       order to install a FixPak, the number of the FixPak must
  539.       be higher than the number of the current CSD in the
  540.       SYSLEVEL.xxx file, or the product information must match.
  541.  
  542.       Solution #1:
  543.       Check the prerequisites needed for the FixPak you are
  544.       trying to install.  Some FixPaks have a particular FixPak
  545.       that must be installed prior to installing that FixPak.
  546.       Also, make sure that the FixPak you are trying to install
  547.       is one that may be applied to that product.  If the product
  548.       information is incorrect, you may need to copy the product
  549.       SYSLEVEL.xxx file from the install media.
  550.  
  551.       Explanation #2:
  552.       If you have committed an OS/2 base FixPak with Version 1.38
  553.       or Version 1.39, you may get this message when you try to
  554.       install another FixPak.
  555.  
  556.       Solution #2:
  557.       Copy the product's SYSLEVEL.xxx file from the install media
  558.       or from a backup copy that was made prior to committing the
  559.       FixPak.
  560.  
  561.     - Error message:
  562.       The path <path\filename> does not exist or is invalid.
  563.  
  564.       Explanation:
  565.       FixTool could not unpack the file specified in the message,
  566.       or it could not unpack the file just prior to the file
  567.       specified in the message.
  568.  
  569.       Solution:
  570.       This indicates that the FixPak media is bad.  You should
  571.       download the FixPak again, re-create the FixPak diskettes,
  572.       and then re-install the FixPak.  The FixTool will resume,
  573.       starting at the point where it stopped.
  574.  
  575.       If you get RC=109 in the service.log, the file listed prior
  576.       to the first RC=109 is probably giving an unpack error.  The
  577.       modules that received the 109 error were not updated properly.
  578.       Make sure that you are using the UNPACK2.EXE that comes with
  579.       this version of the FixTool.  You should also download the FixPak
  580.       again and re-create the FixPak diskettes.  Then reinstall the
  581.       FixPak from the new media.  The FixTool will resume, updating
  582.       any files that were not originally updated.  If this does not
  583.       fix the problem, please contact your service representative.
  584.  
  585.     - Error message:
  586.       Error reading file <path>\IBMCSFLK.DLL.
  587.  
  588.       Explanation:
  589.       FixTool could not find the files needed for servicing.
  590.  
  591.       Solution:
  592.       Make sure that you've set the CSFUTILPATH and CSFCDROMDIR
  593.       environment variables if you're running service from a hard
  594.       drive.  The CSFUTILPATH should point to the directory that
  595.       contains the FixTool files (SERVICE.EXE, FSERVICE.EXE, etc.),
  596.       and CSFCDROMDIR should point to the directory that contains
  597.       the FixPak files (with the FIX directory).  Also make sure
  598.       that all the files listed in Section 2 are in your FixTool
  599.       file directory.
  600.  
  601.     - Error message:
  602.       No source drive is available.
  603.  
  604.       Explanation:
  605.       The FixTool first checks for removable drives on the system.
  606.       If there are no removable drives, you will get this error
  607.       message if you have not set the CSFCDROMDIR to point to a valid
  608.       hard drive or LAN drive.
  609.  
  610.       Solution:
  611.       Set the CSFCDROMDIR to point to the drive and directory that
  612.       contain the FixPak files.
  613.  
  614.     - Error message:
  615.       Checksum error in <file>.
  616.  
  617.       Explanation:
  618.       The FixTool checks the checksum of the source media with a
  619.       checksum that was recorded when the FixPak was created.  If
  620.       these values do not match, you will receive this error.
  621.  
  622.       Solution:
  623.       This indicates that the FixPak media is bad.  Download the
  624.       FixPak again and re-create the FixPak diskettes, or get another
  625.       FixPak CD.  Then reinstall the FixPak.  The FixTool will resume,
  626.       starting at the point where it stopped.
  627.  
  628.     - Error message:
  629.       The path SET CSFCDROMDIR=<path\filename> does not exist or is
  630.       invalid.
  631.  
  632.       Explanation:
  633.       FixTool could not find the FIX directory in the path given in
  634.       the SET CSFCDROMDIR statement.
  635.  
  636.       Solution:
  637.       Check to make sure the path given in the SET CSFCDROMDIR statement
  638.       is pointing to the directory that contains the FixPak.  This
  639.       directory should contain all the files and directories included in
  640.       the FixPak.
  641.  
  642.  
  643. Here are some common error messages that you might see when running
  644. FSERVICE.
  645.  
  646.     - Error message:
  647.       CSF257: No product has been selected.
  648.  
  649.       Explanation:
  650.       This error message is reported in several situations.  You may
  651.       not have selected a product to service in the RESPONSE.FIL, or
  652.       FSERVICE may not have found any products to service.  If FSERVICE
  653.       didn't find any products to service, either the product information
  654.       on the system did not match the product information in the FixPak,
  655.       or FSERVICE determined that the FixPak would back-level the system.
  656.  
  657.       Solution:
  658.       Check the prerequisites for the FixPak and make sure that the
  659.       system contains the proper pre-requisites.  Also, be sure that
  660.       the FixPak you are trying to install is being applied to the
  661.       appropriate product.  If the product information is incorrect,
  662.       you may need to copy the product SYSLEVEL.xxx file from the
  663.       install media.
  664.  
  665.     - Error message:
  666.       This portion of service has completed.  Reboot your
  667.       system before applying additional service or using the product
  668.       to process files that were locked during service.
  669.  
  670.       Explanation:
  671.       This appears as a red screen with a title of "Corrective Service
  672.       Facility Fatal Error," but the message may not indicate an error.
  673.       Please view the service.log file by pressing Enter.  This screen
  674.       appears after doing a backout with FSERVICE so that you can check
  675.       the log file to make sure there are no errors before you reboot
  676.       your system.
  677.  
  678.       Solution:
  679.       Make sure that there are no errors logged and then press Ctrl-Break
  680.       to exit service.  If there were no errors in the log file, then
  681.       FSERVICE completed successfully and it's safe to reboot your system.
  682.  
  683.     - Error message:
  684.       Error reading file <path>\IBMCSFLK.DLL.
  685.  
  686.       Explanation:
  687.       FixTool could not find the files needed for servicing.
  688.  
  689.       Solution:
  690.       Make sure that all the files listed in Section 2 are in the
  691.       directory (or on the diskette) with the FixTool files.  Also,
  692.       make sure your /S: parameter path is valid.  It should contain the
  693.       FixPak files with the FIX directory.  Sometimes you may need to
  694.       include the /S: parameter--even if you have set SOURCE properly in
  695.       the response file.
  696.  
  697.  
  698. Section 11.  Other Known Problems
  699.  
  700. The following problems have also been encountered:
  701.  
  702.   - When using SERVICE, one of the panels contains a Reboot button that
  703.     no longer is needed.  This button was used when you wanted to reboot
  704.     from the CSF boot diskettes, but the CSF boot diskettes are no longer
  705.     available.  You should select Continue, or you can select Cancel and
  706.     reboot the system using boot diskettes for that product.
  707.  
  708.   - BOOTOS2 induced problem. BOOTOS2 (corrected in latest version)
  709.     copied the SYSLEVEL.OS2 file from the booted partition which was used
  710.     to create the BOOTOS2 partition to the new partition. This SYSLEVEL.OS2
  711.     file could have had default service directories that included drive
  712.     letters in it.  Since BOOTOS2 copied the file to a different partition,
  713.     the wrong drive letter would be specified for the FixTool to use when
  714.     looking for files to be serviced.  The SYSLEVEL.OS2 normally would have
  715.     default directories in it after one had applied service to a partition,
  716.     or possibly after the system install.  The net result here is that
  717.     if you had a SYSLEVEL.OS2 file with default directories in it, then
  718.     created a BOOTOS2 partition, and later tried to service the BOOTOS2
  719.     partition, the FixTool not only would apply service to the BOOTOS2
  720.     partition, but the default directories in the SYSLEVEL.OS2 file as well
  721.     (the partition where the SYSLEVEL.OS2 came from).
  722.  
  723.     The solution here is to copy the SYSLEVEL.OS2 from your distribution
  724.     diskette or CD into OS2\INSTALL directory of the BOOTOS2 partition before
  725.     applying service to that partition.
  726.  
  727.  
  728. Section 12.  List of Changes Made for Each Version (1.38 and Later)
  729.  
  730. This section gives a description of what changes have been made
  731. for the new versions of the FixTool (Version 1.38 and later).
  732.  
  733. NOTE: FixTool 1.40 and FixTool 1.37B are the only supported FixTools.
  734.       FixTool 1.40 supersedes all FixTools. FixTool 1.37B can
  735.       continue to be used only on FixPaks that it was released with.
  736.       All other FixPaks should use FixTool 1.40.
  737.  
  738. Section 11.1.  Changes Made in Version 1.40
  739.  
  740. Version 1.40 contains all the fixes included in 1.39 as well as the
  741. following additional changes:
  742.  
  743.   - Fixes a commit problem introduced with FixTool 1.38. If you
  744.     committed an OS/2 base FixPak with Version 1.38 or 1.39, you
  745.     cannot install subsequent FixPaks without reverting to a
  746.     SYSLEVEL.OS2 file used prior to the commit (you can use the
  747.     SYSLEVEL.OS2 that was shipped with the product from the product
  748.     diskettes/CD).
  749.  
  750.     After you had done a commit, applied a FP to the committed base,
  751.     and then either restored from the commit Archive or backed out an
  752.     installed FP, the fact that the base was at a specific FixPak
  753.     level was lost. The FixTool will now create in OS2\INSTALL a file
  754.     named FPCOMMIT.OS2 to hold the base committed SYSLEVEL. This will
  755.     be restored to SYSLEVEL.OS2 during either of these 2 restore
  756.     activities. Do not erase this file.
  757.  
  758.   - Eliminates a SYS0039 error when using SERVICE without a diskette
  759.     in the drive when starting the FixTool.
  760.  
  761.   - Allows you to set a new CSFDRIVEAPPLY environment variable prior
  762.     to running SERVICE which will limit the search for products to be
  763.     serviced to the drive given in the set statement and to the boot
  764.     drive.
  765.  
  766.   - Includes an updated FPINST.CMD file that uses the /B: parameter
  767.     for LAN-related FixPak installations.
  768.  
  769.   - Includes an updated UNPACK2.EXE and updated error handling for
  770.     messages coming from UNPACK2.EXE.
  771.  
  772.   - Includes checksum verification on the source media.  This fix
  773.     prevents corrupted source files from being transferred to the
  774.     target system.  You may also notice a slight increase in the
  775.     time it takes to process files to be updated.
  776.  
  777.   - Includes an ARCHCTL utility that allows you to turn off archive
  778.     processing for a particular FixPak.
  779.  
  780.  
  781. Section 11.2.  Changes Made in Version 1.39
  782.  
  783. Version 1.39 contains all the fixes included in 1.38 as well as the
  784. following additional changes:
  785.  
  786.   - Works with OS/2 Warp v3.0 and LAN-related FixPaks.  The backout-
  787.     to-backup process was fixed for LAN-related FixPaks.
  788.  
  789.   - The CSFUTILPATH environment variable does not have to be set to
  790.     be able to run SERVICE from a hard drive.
  791.  
  792.   - Now services systems that do not have a removable media drive.
  793.  
  794.   - Contains an updated response file for Warp 4 systems.
  795.  
  796. Section 11.3. Changes Made in Version 1.38
  797.  
  798. NOTE:  Version 1.38 of the FixTool was for use with OS/2 Warp v4.0 systems
  799. only.
  800.  
  801. The following basic changes were made for Version 1.38:
  802.  
  803.   - Updates the CSD level in the SYSLEVEL.xxx file for all products.
  804.     The CSD level is updated to match the FixPak number.
  805.  
  806.   - Recognizes Software Choice installed features.  When backing out
  807.     a FixPak, you will be given a chance to cancel the backout if a
  808.     Software Choice installed feature will be broken by the FixPak
  809.     backout.
  810.  
  811.   - No longer uses CSF boot diskettes.  The FixTool now comes as a
  812.     self-extracting zip file that can be unzipped to a single diskette.
  813.  
  814.   - Places the locked file device driver statements closer to the
  815.     beginning of the CONFIG.SYS.
  816.  
  817.   - Corrects a problem with the backout-to-backup process when a file
  818.     is serviced in more than one directory.
  819.  
  820.  
  821.  
  822.