home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / autobk2.zip / ReadMe.TXT < prev    next >
Text File  |  1995-12-08  |  9KB  |  185 lines
  1. I originally wrote these REXX programs for my own personal use with 
  2. BackMaster 2.0 on my home OS/2 Warp system, but from what I'd seen in 
  3. the Compuserve OS2BVEN forum I thought others would find them useful
  4. too.  If not as is, they can be easily modified to suit your needs.  I
  5. am releasing these seven programs to the public domain; I only ask that
  6. if you make modifications that you feel will be useful to the public at
  7. large to please send me a copy so that I might implement them in my own
  8. personal copy.  Since this is public domain, I also ask that any
  9. external function calls utilized by these programs also be freely
  10. available to the general public.  It does no good to release some
  11. programs in the public domain if the user has to pay for a particular
  12. component in order for it to run (other than MSR's BackMaster 2.0, of
  13. course!).
  14.  
  15. Three of the programs in this archive require the IBM EWS Visual REXX
  16. extensions.  This is freely available from many sources, including the 
  17. IBM PC BBS, and the OS2USER forum on Compuserve.  It is freeware; IBM 
  18. retains all rights to the program, but it may be distributed and used 
  19. free of charge.  The file name is most typically VREXX2.ZIP.
  20.  
  21. This archive contains ten files:
  22. ReadMe.TXT      This file you're reading now
  23. ReadMe.LWP      This document in IBM Works Word Processor format.
  24. BMMenu.CMD      A program allowing you to select between a full or an
  25.                 incremental backup of all of your partitions, or to 
  26.                 quick erase a number of tapes.
  27. BMLog.CMD       Display the BackMaster Log file.
  28. FullBkup.CMD    Perform a full backup of all of your partitions.
  29. IncrBkup.CMD    Perform an incremental backup of all of your partitions.
  30. ZapTapes.CMD    Perform a Quick Erase of a set number of cartridges
  31. TpFormat.CMD    Format a set number of cartridges.
  32. FileType.CMD    External function to determine a partition file system.
  33. Whats.new       History of changes made to the programs here.
  34.  
  35. BMMenu.CMD
  36. This program allows you to select which type of backup you want to run. 
  37. Currently, it only allows you a choice of a full backup of all of your 
  38. partitions, an incremental backup of all of your partitions, or you can 
  39. quick erase (or format) a number of cartridges in preparation for 
  40. running a backup.  You can easily modify the code if you would like to
  41. add more options.  If you know REXX at all (or you're willing to learn)
  42. the changes required should be obvious.  Experiment!  (just make sure 
  43. you have a copy of the original in case you make a mistake!).  This
  44. program uses IBM's Visual REXX extensions and will not run without them.
  45.  
  46. BMLog.CMD
  47. This quick and dirty little program will display the current BackMaster 
  48. Log file.  As written, it assumes the log file name is BACKMAST.LOG, and
  49. that the BackMaster directory is in your PATH.  It utilizes the OS/2 
  50. Enhanced Editor (EPM.EXE), but you can easily modify the program to use 
  51. the OS/2 System Editor (E.EXE), or any other text display program you'd 
  52. like.
  53.  
  54. FullBkup.CMD
  55. This program will perform an automated full backup of every logical
  56. FAT and HPFS drive on your system.
  57.  
  58. In addition, this program will maintain two copies of your BACKMAST.LOG 
  59. file (if you have one).  Prior to performing it's first backup, it will 
  60. delete the existing BACKMAST.OLD file (if any) and rename the current 
  61. BACKMAST.LOG to BACKMAST.OLD.  This mechanism should prevent one single 
  62. BACKMAST.LOG from growing too large.  This program will create the 
  63. backup with a name of:
  64.  
  65.           FULL: mm/dd/yy
  66.          Where: mm/dd/yy is the date on which the backup was performed.
  67.  
  68. This program will use the FileType() external function call to determine
  69. the logical drive type.
  70.  
  71. IncrBkup.CMD
  72. This program will perform an automated incremental backup of every 
  73. logical FAT and HPFS drive on your system.  Each incremental backup will
  74. be created with a name of:
  75.  
  76.         INCR:  mm/dd/yy
  77.        Where:  mm/dd/yy is the date on which the backup was performed.
  78.  
  79. The name differs from the Full Backup in order to allow the user to 
  80. easily differentiate which type of backup is on the tape if the user 
  81. should scan the tape directory.  This program will use the FileType() 
  82. external function in order to determine the logical drive type.
  83.  
  84. ZapTapes.CMD
  85. This program will allow you to erase a number of cartridges prior to 
  86. performing a full or an incremental backup.  If you select this program 
  87. from the BMMenu.CMD menu, BMMenu will restart and allow you to decide 
  88. which backup you want to perform (it is assumed you wanted to Quick 
  89. Erase the tapes prior to running the backup).  The program will 
  90. calculate how much space is actually used on your system, and give a 
  91. rough estimate of how many tapes you'll need.  If you are using 
  92. tapes that can hold more than 250M of data, edit the program and 
  93. change the value for the "capacity" variable at the beginning of 
  94. the code.  Usually you'll need more than the default, but you are 
  95. allowed to override it in any case.  This program will use the 
  96. FileType() external function so as to not include CD-ROM or VDU drives 
  97. in it's space calculations.  It also requires IBM's Visual REXX
  98. extensions in order to run.
  99.  
  100. TpFormat.CMD
  101. This program was essentially cloned from ZapTapes.CMD (above) so 
  102. everything documented for ZapTapes.CMD also applies to this program. 
  103. The difference is that this program will format the tape, not just 
  104. perform a Quick Erase.  Use this program if you are getting errors while
  105. backing up (typically Error 52).  Formatting a tape will also mark those
  106. blocks identified as being "bad" so that BackMaster won't attempt to use
  107. them.  Be aware that formatting a standard DC2120 cartridge can take up 
  108. to two hours unless you are using a high-speed tape controller.  Higher 
  109. capacity tapes will take even longer.
  110.  
  111. FileType.CMD
  112. I inquired from several places on how I could determine through a REXX 
  113. program what type of file system is being used by a particular 
  114. partition.  I received lots of useful suggestions until I hit upon what 
  115. I feel is the best possible one.  I have a product installed called 
  116. "Performance 2.1 Plus" from Clear And Simple, Inc.  This is a 
  117. performance and tuning tool kit written entirely in OS/2 REXX/2.  One of
  118. the tools, SeeSys.CMD, was correctly identifying each partition on my 
  119. system.  I decided to look at the source to see how it was doing this.
  120. What I found was a very simple technique which I've used to write
  121. FileType.CMD.  Please note that while I duplicated the technique, 
  122. the code used is entirely different!  I did not plagiarize the code! 
  123. "Performance 2.1 Plus" is a terrific product for two reasons: 
  124.  
  125. 1) It provides lots of useful information for tuning an OS/2 2.x system,
  126.    and
  127. 2) It provides some terrific examples of REXX coding for those of you
  128.    interested in furthering your knowledge of this wonderfully flexible
  129.    language.
  130.  
  131. Enough of the plug.  FileType.CMD is an external function that must be
  132. invoked from within other REXX programs in order to perform any useful
  133. function.
  134.  
  135. Example:
  136.         type = FileType(drivespec)
  137.         Where:
  138.                 drivespec is the logical identifier of the drive you are
  139.                         interested in.  It must be an alphabetic 
  140.                         character followed by a colon (or a variable
  141.                         representing this information).  If the 
  142.                         drivespec is incorrectly coded, or represents a
  143.                         drive that does not exist on your system, then 
  144.                         "type" will contain the literal "ERROR". If the 
  145.                         specified drive is not ready or unmounted, then
  146.                         "type" will contain the literal "NOT READY",
  147.                         otherwise it will contain "FAT," "HPFS" or
  148.                         "CD-ROM" (no quotes). The newest revision will
  149.                         also return "VDU" for a DCF/2 container volume.
  150.  
  151. I hope you find these programs useful.  Information on the products and 
  152. vendors named here are:
  153.  
  154. BackMaster 2.0
  155. MSR Development
  156. P.O. Box 632070
  157. Nacogdoches, TX  75963
  158. 409-564-1862 - Voice
  159. 409-560-5868 - FAX
  160. 409-560-5970 - BBS
  161.  
  162. Performance 2.1 Plus
  163. Clear & Simple, Inc.
  164. P.O. Box 130
  165. W. Simsbury, CT  06092
  166. 203-658-1204 - Voice
  167.  
  168. DCF/2
  169. Proportional Software Corporation
  170. 1717 Linden Lake Road
  171. Fort Collins, CO  80524
  172. 303-484-2665 - Voice
  173. 303-484-2670 - FAX
  174.  
  175. OS/2 Warp 3.0
  176. The IBM Corporation
  177. 919-517-0001 - BBS
  178. 800-342-6672 - Voice Sales
  179.  
  180. The author may be contacted at:
  181. Compuserve:  72267,1372
  182. Internet:  72267.1372@compuserve.com
  183.                     -- or --
  184.            jcruz@ibm.net
  185.