home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / qf121.zip / read.me < prev   
Text File  |  1999-11-10  |  5KB  |  121 lines
  1.     ╔═════════════════════════════════════════════════════════╗
  2.     ║                                                         ║
  3.     ║                       QUICKFIX 1.2                      ║
  4.     ║                                                         ║
  5.     ║ A utility for rapid, safe application of OS/2 fixpacks. ║
  6.     ║                                                         ║
  7.     ║                        Jon Saxton                       ║
  8.     ║                         10-11-99                        ║
  9.     ║                                                         ║
  10.     ╚═════════════════════════════════════════════════════════╝
  11.  
  12. Enclosed is a REXX script to make the application of OS/2 fixpacks easy.
  13. Yes, this is yet another quick fix tool and the obvious question is "Why?".
  14.  
  15. The critical issue is safety.
  16.  
  17. The main difference between this utility and most others in the genre is that
  18. QuickFix uses an image unpacking tool which performs CRC validation of the
  19. diskette images before applying what could otherwise be junk to your finely-
  20. tuned and previously functional OS/2 system.  To me that seems a worthwhile
  21. contribution.
  22.  
  23. QuickFix was derived from an earlier REXX program, DISKFP, by Trevor Hemsley
  24. and full credit is due to Trevor for the concept.  It was Trevor who alerted
  25. me to the danger of tools such as DIUNPACK which do no validation of the
  26. diskette image and to the damage that a bad download could cause.
  27.  
  28. Meanwhile I had tried a diskette image extractor written by Alan Arnett and
  29. one of the items on Alan's list of planned features was CRC checking.  I
  30. harassed Alan a little and in July this year he released a version of his
  31. program with that feature implemented.
  32.  
  33. I have modified Trevor's program to use Alan's program as well as making a
  34. large number of usability enhancements.  With Trevor's concurrence, this
  35. program is being released under a new name.
  36.  
  37. Purely as a courtesy I have included Alan's DSKXTRCT.EXE in this submission
  38. but it is not my intention to post QuickFix updates just to include later
  39. versions of Alan's program.  At the time of writing DSKXTR12.ZIP on Hobbes is
  40. Alan's official release and you should get subsequent versions of Alan's
  41. program from his submissions.
  42.  
  43. Thanks to Peter Flass and Albert Crosby for their REXX code which I have
  44. embedded in this program.
  45.  
  46. ----------------------------------------------------------------------------
  47.  
  48. Steps for applying an OS/2 fixpack.
  49.  
  50. Preparation
  51. -----------
  52.  
  53. 1.  Download all the diskette images (XR?M???.?DK for OS/2 4.0 or XR?W???.?DK
  54.     for OS/2 3.0) along with the latest release of the fix tools (FIXT140.EXE
  55.     or CS?140.DSK or CS?140.EXE at the time of writing).  All of these files
  56.     should be in a single directory somewhere on your hard drive.  This is
  57.     the source directory.
  58.  
  59. 2.  Have QF.CMD and DSKXTRCT.EXE available somewhere on your PATH.  They
  60.     do not have to be in the same directory as the fixpack.
  61.  
  62. 3.  If necessary, clean up your system.  If you've applied an earlier
  63.     fixpack then it may be necessary to commit the fixpack and/or remove
  64.     the old log files.  Within limits, this program can do it for you.
  65.  
  66. 4.  Run QF specifying the source directory (where the disk images are).  If
  67.     you are running the program from the source directory then a dot will
  68.     suffice.
  69.  
  70. 5.  Answer the prompts.  In the absence of any error QF will unpack the
  71.     fixpack images into some directory on your hard drive (the patch directory)
  72.     and build a pair of command files or let you run the GUI fix tool.
  73.  
  74. Application
  75. -----------
  76.  
  77. If you didn't run the GUI fix tool in step 5, then ...
  78.  
  79. 6.  Either boot from a maintenance partition if you have one, or boot to
  80.     a full-screen text-mode session (using Alt-F1 when the white rectangle
  81.     appears on the top left corner of the screen during the boot process).
  82.     Go to the patch directory (where QF put the patch files) and run APPLY.
  83.  
  84. -----------------------------------------------------------------------------
  85.  
  86. Steps for backing out of an OS/2 fixpack
  87.  
  88. 1.  Same as step 6 above except run BACKOUT instead of APPLY.
  89.  
  90.     (Note that this isn't available if you chose to use the GUI fix tool.
  91.      In that case you'll have to run SERVICE yourself.)
  92.  
  93. -----------------------------------------------------------------------------
  94.  
  95. Release history:
  96.  
  97. 1.0    Only worked on OS/2 4.0
  98.  
  99. 1.1    Works on OS/2 3.0 and 4.0
  100.     Much-improved user interface.
  101.  
  102. 1.2    Allow interactive application via SERVICE.
  103.  
  104. -----------------------------------------------------------------------------
  105.  
  106. Planned enhancements:
  107.  
  108. 1.3    Prepare command files for GUI application.
  109.  
  110. 1.4    Handle BACKUP level.
  111.  
  112. 1.5    Multiple ARCHIVE/BACKUP levels?
  113.  
  114. -----------------------------------------------------------------------------
  115.  
  116. Please report any bugs to
  117.  
  118.     Jon Saxton <triton@attglobal.net>
  119.  
  120. or, better still, fix them and send me the modified program.  ;-)
  121.