home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / mdfbu31.zip / mdfbu.doc next >
Text File  |  1994-02-21  |  12KB  |  302 lines
  1.                         
  2. Welcome to Multi Drive File Backup Utility (MDFBU) version 3.1: an OS/2 2.x
  3. shareware/freeware program which allows users to backup specific files with 
  4. great ease.  The complete MDFBU utility is contained in four files:
  5. this doc file (mdfbu.doc), the executable (mdfbu.exe), the VX-Rexx 
  6. runtime library file (vrobj.dll), and the icon (mdfbu.ico)
  7.  
  8. Note: we used a famous software company's method of version numbering.  That is
  9. why this first release is version 3.1
  10.  
  11. Please feel free to e-mail the authors with comments, suggestions, praise, or 
  12. ideas.  No flames please :)
  13.  
  14.  
  15. Why Backup?
  16. ===========
  17.  
  18.       We've all been unfortuneate at one time or another and either deleted a
  19. file we still needed or overwrote one file with another.  MDFBU allows users a 
  20. method of backing up their important files.  Now, programmers can easily back
  21. up all of their *.c or *.cpp files on one or more hard drives.  Word processors
  22. files can easily be backed up if you keep the same extention name.
  23.  
  24.  
  25. Features
  26. ========
  27.  
  28. 1.  Full HPFS and FAT drives supported
  29.  
  30. 2.  Works on Stacker (tm) drives
  31.  
  32. 3.  Backup to floppy drive(s) or hard drive(s)
  33.  
  34. 4.  Allows compression and archive files to be created
  35.  
  36. 5.  Works with OS/2 2.x or above
  37.  
  38. 6.  Full mouse pointer help.  Just move the mouse to any part of the program
  39. screen and help is given at the bottom of the prpgram
  40.  
  41. 7.  Copy or move files
  42.  
  43. 8.  Easy to use
  44.  
  45. 9.  Full PM program
  46.  
  47. 10.  Full mouse and keyboard support
  48.  
  49. 11.  Its FREE!
  50.  
  51.  
  52. Installation
  53. ============
  54.  
  55. Method 1
  56. --------
  57.  
  58. 1.  Copy mdfbu.exe, mdfbu.ico, and mdfbu.doc (this file) to your hard drive. 
  59. The file "vrobj.dll" must be copied to a directory which is listed in your 
  60. libpath statement in your config.sys (A good place to put this file is in 
  61. c:\os2\lib, where in this case OS/2 is installed on drive c:)
  62.  
  63. 2.  Open the templates folder from your desktop and using the right mouse button
  64. drag a program template onto your desktop.  When the program template opens up 
  65. for user input (on the program page) enter the path and file name in the 
  66. appropriate location.  ex:  c:\utils\mdfbu.exe
  67.  
  68. 3.  The working directory should be set to the location of the exe file.  Using 
  69. the same example as above, c:\utils
  70.  
  71. 4.  Go to the general page and change the program name from "program" to "MDFBU"
  72.  
  73. 5.  Close the object by double clicking the left mouse button on the top left 
  74. hand corner of the object
  75.  
  76. 6.  Add a line to your config.sys file like
  77. set MDFBU_INI=drive:\path\MDFBU.INI
  78. where drive:\path is the drive and directory the program is installed in
  79.  
  80. 7.  Shutdown and reboot OS/2 to allow changes in your config.sys to take effect
  81.  
  82. 8.  Double click on the mdfbu icon to start the program
  83.  
  84. Method 2
  85. --------
  86.  
  87. 1.  Copy mdfbu.exe and mdfbu.doc to a directory on your hard drive.  Copy 
  88. vrobj.dll into a directory listed your libpath statement in your config.sys 
  89. example: c:\os2\lib if OS/2 is installed on drive c:)
  90.  
  91. 2.  Change to the directory where mdfbu.exe resides on your hard drive
  92.  
  93. 3.  Enter "set MDFBU_INI=drive:\path\MDFBU.INI" (without the quotes) where 
  94. drive:\path is the drive and path you want the settings to be saved to if you 
  95. desire
  96.  
  97. 4.  Enter the command "start mdfbu.exe" (minus the quotes) to start the program
  98.  
  99.  
  100. Program Options
  101. ===============
  102.  
  103. Settings
  104. --------
  105.  
  106. Drive Settings: this selection allows you to chose the drives MDFBU is to search
  107. for programs to backup.  You can keep this box open at all times by pressing the
  108. "switch" button once your selections are made, or close the box by pressing the 
  109. "hide" button.  MDFBU automatically searches your hard drive to see what drives 
  110. you have.
  111.  
  112. Environment Settings: this is where all user-definable settings are set. 
  113. Options to be defined are: The path and name of the MDFBU settings data file, 
  114. the path and name of the log file stem name, the path of the ZIP temporary 
  115. diectory (see note on this at bottom of doc file), command shell to be used for 
  116. copying, moving, and archiving, and the drive and path of this help file.
  117.  
  118. Compression Program: for the time being you have no choice on the archive 
  119. program to be used (zip.exe).  Later versions may allow zoo or tar/compress.
  120. Note: you must have the shareware/freeware program zip.exe in a directory listed
  121. in your path to use the compression option.
  122.  
  123. Editor Program: choice of the enhanced editor (epm.exe) or OS/2 system editor
  124. (e.exe) for the program to be envoked when double clicking on a found file.
  125.  
  126. Save Current Settings: save these settings for future runs.  Note that you must 
  127. set the variable mdfbu_ini in your config.sys to match the MDFBU settings data 
  128. file
  129.  
  130. Product Info
  131. ------------
  132. Program Info: propaganda
  133.  
  134. Author Info: how to contact the authors via e-mail
  135.  
  136. Execute
  137. -------
  138. Run: begin execution.  Same as double clicking on the background to begin
  139.  
  140. Stop: stop the program
  141.  
  142. Help: read this file
  143.  
  144. PM Screen
  145. ---------
  146. Search Pattern:  enter the file name pattern you would like to seach for.  For 
  147. example, *.sam for Ami Pro files, etc.  See the end of the docs for a list of 
  148. possible file extensions
  149.  
  150. Target Directory: the drive and directory to back up programs into.  To backup 
  151. onto floppy, enter a:\ or b:\ as the target.  Or enter c:\backup to backup to 
  152. yur hard drive
  153.  
  154. Compress into:  enter a name to archive the files into.  This option is only 
  155. available if COPY or MOVE has been selected (not LIST).  Unless you are running 
  156. this program on HPFS, do not include the extension (like .zip).  The archiver
  157. will do this for you.
  158.  
  159. List files:  select this to list the files matching the search pattern on the 
  160. selected drives
  161.  
  162. Copy files: select this to copy all files matching the seach pattern to the 
  163. target directory
  164.  
  165. Move files: same as copy files only the found files are deleted after copying
  166.  
  167. Files processed: list of files found, copied, or moved.  After the list or copy 
  168. is over, double clicking on a file with the left mouse button will load the 
  169. program into the editor selected from the settings menu.
  170.  
  171. Information line:  a one line message display for information (like Done, 
  172. working, etc)
  173.  
  174. Help Bar: the last line on the PM screen is the help screen.  Move the mouse 
  175. over the screen and read the help as the pointer travels over an option.
  176.  
  177. Background: double click the left mouse button on the yellow background begins 
  178. the backup proceedure.
  179.  
  180. Options
  181. =======
  182.  
  183.       MDFBU allows the user to list, copy, or move files from one or more hard
  184. drives to a disk drive or directory.  LIST allows you to obtain a summary of the 
  185. files that MDFBU found and is able to backup for you.  COPY copies these files 
  186. to your specified path, while MOVE copies the files and then deletes the 
  187. originals.  Both the COPY and MOVE funtions also allows the user to archive the 
  188. found files in ZIP format if the program zip.exe is in your path (type in "path" 
  189. without the quotes at a command prompt to check if the directory contining 
  190. zip.exe is defined in your path environmental variable) 
  191.  
  192. Example
  193. ========
  194.  
  195.        To backup all C source code on your 'D' drive to a floppy disk in the
  196. 'A' drive check off the box denoting source drive 'D' from the drives 
  197. selection box from the settings option. In the input field select *.c to search
  198. for all C code (which have the extension .c or possibly .cpp for C++) Select
  199. 'a:\' as the destination drive and path, and select 'copy files' as the program
  200. option.  Once this is done, double click on the yellow background to begin! You
  201. may want to select 'list files' before copying them to verify the selection of
  202. files, but this is not necessary.  Also, to archive the files, once the copy or
  203. move selection has been entered, an option to compress the files appears.
  204. Select this and a name for the archive if you'd like to store all of your files
  205. in one compressed file.
  206.  
  207. Use with tape backup programs
  208. =============================
  209.  
  210.       MDFBU is also useful for those with tape drives.  Instead of trying to 
  211. find all of your programs to archive to tape with your tape backup software, use
  212. MDFBU to make an archvie file on your hard drive and then use the tape software
  213. to back up one zipped file to tape.
  214.  
  215.  
  216. Recommended Usage
  217. =================
  218.  
  219.       In order to be sure of backing up your files with regularity, use the 
  220. alarms program that came with OS/2 2.x to launch MDFBU every week or so.  Use 
  221. the "execute comment as a command at alarm time" as a way of running the 
  222. program.  You will still need to tell the program to start, but as long as the 
  223. program settings have been saved and your config.sys has the ini file set, then 
  224. you will be set up for timely backups.
  225. (make sure alarms is shadowed into your startup folder.  See the OS/2 FAQ on 
  226. how to start the alarms feature minimized, or just mail one of the authors)
  227.  
  228.  
  229. Known "Undocumentated Features"
  230. ===============================
  231.  
  232. 1. If you are running 4OS2 (tm) as your command shell and have a 4start.cmd 
  233. file, a VX-Rexx console may pop up with your 4start.cmd commands upon a copy,
  234. move, list, or zip.  This is due to the way VX-Rexx handles OS/2 commands.  A
  235. solution is to set the "Command Shell" variable in the environment settings to
  236. x:\os2\cmd.exe where x: is the drive OS/2 is installed on.  The VX-Rexx console 
  237. is annoying but in no way impedes upon the ability of MDFBU to perform its job.
  238.  
  239. 2. The executable file must remain named mdfbu.exe  Sorry, no name changes 
  240. permitted.
  241.  
  242. 3.  Files in the target directory are ignored when searching for files to move 
  243. and/or copy.
  244.  
  245. 4.  In the version of zip.exe I have, the option to have the temporary files 
  246. stored on a different directory does not seem to work.  Later versions of zip 
  247. may solve this problem.
  248.  
  249. 5.  Does not work with Xfeel, Feelx, or other programs which change OS/2's 
  250. focus.  Sorry.
  251.  
  252.  
  253. Disclaimer
  254. ==========
  255.  
  256.       Use this program at you own risk.  If anything goes wrong, tough.  I have 
  257. used this program for a few weeks now and the only way for it to mess anything 
  258. up is if the user messes up.  The features in which the program will modify 
  259. existing files is by deleting files during the "move" feature, which
  260. copies and DELETES the files you told the program to work upon.  Use this
  261. feature with discresion.  It is always best to use the list feature first to see
  262. which files will be moved.
  263.  
  264. All programs mentioned in the docs are trade marks of their respective companies
  265. and in no way reflect anyones opinons or signify recommedations or acceptance. 
  266. You get the picture.
  267.  
  268. Void where prohibited by law.  Your milage may vary.  Dealers may sell for less. 
  269. Use at your own risk.  Operators are standing by.  The cheque is in the mail. 
  270.  
  271.  
  272. Sample Extensions 
  273. =================
  274.  
  275.       Included for your backup pleasure is a list of possible file extensions 
  276. that you may need to back up with regularity.
  277.  
  278. *.for Fortran source code
  279. *.f Fortran source code 
  280. *.c C source code 
  281. *.cpp C++ source code 
  282. *.obj object code 
  283. *.sam Ami Pro document 
  284. *.txt text file 
  285. *.ini program initialization file (warning! these files may be locked and
  286.   hence unaccessable to MDBFU) 
  287. *.doc program documentation 
  288. *.ps postscript file
  289. *.fgr FGraph file 
  290. *.grf Grapher or Axum graph file 
  291. *.dat data file 
  292. *.zip zipped archive file 
  293. *.zoo zooed archive file 
  294. *.arj arjed archvie file 
  295.  
  296.  
  297. This doc was written in epm under OS/2 2.1 by Kevin Linfield 
  298. (linfield@bach.utias.utoronto.ca) on or about 94 02 09.  Any errors in this file
  299. are not errors because I ment to do it.  Who reads docs anyways?  What are you, 
  300. a wimp?  Run the program and get on with it.
  301. 
  302.