home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / os2 / 177bk2.arj / READ.ME < prev    next >
Encoding:
Text File  |  1992-02-06  |  7.6 KB  |  155 lines
  1.                     6H.177 Workplace Shell Backup Utility
  2.  
  3.  
  4. FOREWORD BY THE AUTHOR - 02/06/92
  5.  
  6.  
  7. Thank you for trying 177bkup.  Several changes have been made to the utility
  8. in this maintenance release:
  9.  
  10. - The program was recompiled using the 177 level of the IBM toolkit.
  11. - 177bkup correctly installs itself into the task list.  It may be minimized
  12.   and restored while running.
  13. - The program no longer requires the existence of directory \OS2\OS2.DTP.
  14.   However, If this directory is present, it will be backed up and restored.
  15. - Additional tests for invalid INI files have been introduced.
  16. - The WipeDTP program has been replaced with WipeWPS.  WipeWPS is a 32 bit
  17.   program which correctly deletes all target WPS files and directories.
  18. - WipeWPS requires a user response of 'Y' to execute or 'N' to bypass 
  19.   clearing of the target directory(s).  
  20. - The generated restore command file now uses Copy instead of Xcopy.
  21. - Lines in the Read.me and restore command files are terminated with
  22.   carriage return and line feed.
  23. - The restore process has been tested using MOST to boot 6.167 in order to
  24.   restore a 6.177 partition.  This process is more timely than booting the
  25.   installation diskette, but is limitted to individuals who maintain both
  26.   beta levels on their hard drives.
  27.  
  28. A mysterious performance problem during backup of the OS2.INI file occurs
  29. on my PC and at least one other.  Backup of that file has taken over 15
  30. minutes for me.  If you have that problem as well, please let me know.  I
  31. have included an additional input parameter that you may use at your own
  32. peril.  "NoBackupIni" may be specified to skip the INI file backups.  An
  33. obvious loss of synchronization will occur if you use this parameter.
  34. However, the INI files are much more static in OS 2.0 than they were in
  35. the past and it may be possible for you to use an old INI backup during
  36. restore.  Again, I caution against using this parameter.  The performance
  37. problem will try your patience, but will produce valid data.
  38.  
  39. Finally, I can not promise that it will be possible to produce a version of
  40. this utility that will work with the GA release of OS2 2.0.  Things change
  41. and "stuff" happens.  If one is not produced, it will not be for my lack of
  42. trying.  I can promise that those who register 177bkup will be provided with
  43. free registration for production versions of this utility that may become
  44. available in the future.
  45.  
  46.  
  47. INTRODUCTION
  48.  
  49. Have you ever discovered that whole folders of laboriously entered programs
  50. have vanished from the desktop?  How about dropping the System folder on the
  51. shredder?  Deleted the System Clock?  Lost sleep over the fact that the
  52. printer lives right next to the shredder?
  53.  
  54. If you answered yes to any of the above questions, then this utility is right
  55. on target for you!  177bkup.exe is a 32 bit PM program that will make an image
  56. copy of your workplace shell configuration while you are up and running.  It
  57. creates a CMD file (DtpRest.cmd) that you can use to recover with the image
  58. copy if you need to.
  59.  
  60. NO MORE RE-INSTALLING just to recover from Workplace Shell catastrophes.
  61. To make your life even less complicated, every time you take a backup, a
  62. Read.Me file is placed into your backup directory.  It will explain precisely
  63. how to execute the recovery procedure!
  64.  
  65. Contents of this package are:
  66.  
  67. Read.Me     - You're reading it right now.
  68. 177bkup.exe - The Workplace Shell image copy utility.
  69. WipeWPS.exe - Clears out the desktop directorie(s) before recovery.
  70.  
  71. Installation is pretty darn simple:
  72.  
  73. Step1 - Copy 177bkup.exe to a directory that you use to store programs.
  74.  
  75. Step2 - Copy WipeWPS.exe to one of the boot drive directories named in the
  76.         config.sys that is contained on your SYSTEM DISK 1 OF 14.  They are:
  77.  
  78.             \     (Root)
  79.             \OS2
  80.             \OS2\SYSTEM
  81.             \OS2\INSTALL    <== suggested
  82.  
  83. Step3 - Add a program entry to any of your folders for 177bkup.exe.  As far
  84.         as program settings go, all you really have to specify is path and
  85.         file name for where you placed 177bkup.exe and the name of the
  86.         target directory into which Workplace Shell backup data will be placed.
  87.         Enter the name of the target directory in the Parameters entry field.
  88.         You must specify drive and full path name. (ie. E:\DtpStore)  If this
  89.         directory does not exist, 177bkup.exe will create it when it executes.
  90.  
  91.         TAKE NOTE:  177bkup.exe owns the target directory lock, stock and
  92.                     barrel.  When it starts execution, it erases all files
  93.                     and sub-directories contained within its target directory.
  94.                     So don't specify a directory that holds any files or
  95.                     sub-directories that you wish to keep.
  96.  
  97. Executing the backup is as simple as double clicking the icon! 177bkup.exe
  98. is a well behaved 32 bit PM application.  It does its considerable I/O on a
  99. separate thread so that you can close it, minimize it or do other tasks while
  100. it is running.  After it completes execution, look at the Read.Me file that is
  101. created in the target directory.  This file will tell you exactly what must
  102. be done in the case of a Workplace Shell failure.
  103.  
  104. Miscellaneous Notes:
  105.  
  106. 1) To receive syntax help for 177bkup, execute it with no parameters from
  107.    an OS2 command prompt.
  108.  
  109. 2) Optional Parameters:
  110.  
  111.    PurgePrompt | NoPurgePrompt    -  allows suppression of the confirmation
  112.                                      message box that warns of the erasure
  113.                                      of files and sub-directories of the
  114.                                      backup target.  Default is PurgePrompt.
  115.  
  116.    TestVer2Rev | NoTestVer2Rev    -  allows suppression of the check made for
  117.                                      6H.177 OS2KRNL file size.  Use this if
  118.                                      you have a patched kernel and are sure
  119.                                      that this backup procedure will still
  120.                                      work with your revision.  Default is
  121.                                      TestVer2Rev.
  122.  
  123. 3) Make the target directory be disk resident.  If you write to floppy, the
  124.    backup of the system INI files may not complete in your lifetime.  It
  125.    would be prudent to use a drive other than your 6H.177 boot drive.
  126.  
  127. 4) Many checks are made to insure that you will be notified if valid backups
  128.    are not created.  However, image copies are created and the GIGO (garbage
  129.    in / garbage out) rule applies.  Therefore, make sure that you are running
  130.    cleanly before you write over backup data with a new backup.  Try to use
  131.    a rotating target directory methodology so that you can maintain a valid
  132.    -1 backup should the current backup data prove to be damaged.
  133.  
  134.  
  135. ================== SUPPORT SHAREWARE =====================================
  136.  
  137. I hope you find this utility helpful, but (here comes the disclaimer) I am
  138. in no way responsible for any damages the use of this utility may cause.
  139. You are free to use this utility at your own risk with no obligation to me,
  140. the author, for only a short period of time.
  141.  
  142. This backup utility will allow 15 trial executions.  Then it will "time out."
  143. If 177bkup is helpful to you or your organization, you should register it.
  144. The registration fee for individuals is $15 (US).  The site registration fee
  145. for corporate entities is $150 (US).  Please send registration fees along
  146. with a daytime phone number to:
  147.  
  148. Dave Lester
  149. PO Box 461
  150. New Freedom, PA. 17349 USA
  151.  
  152. Comments, suggestions and bug reports may be submitted through CIS Mail
  153. ID 75600,237.  These will be answered on a "best effort" basis.
  154.  
  155.