home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac_os2 / oback209.zip / OBACKUP.TXT < prev    next >
Text File  |  1994-08-22  |  69KB  |  1,801 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                      OBACKUP, ORESTORE and OBACKDIR
  22.  
  23.               OS/2 Compressing Backup and Restore utilities
  24.  
  25.                              $Revision: 2.9 $
  26.  
  27.                  Copyright (c) 1989-1993 by Trumphurst Ltd.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.           Trumphurst Ltd.
  46.           The Willows
  47.           St. Martins Moor
  48.           Oswestry
  49.           Shropshire
  50.           SY10 7BH
  51.           England
  52.  
  53.           Tel: (+44) 0691-670318
  54.           Fax: (+44) 0691-670316
  55.           Mail: obackup@trmphrst.demon.co.uk
  56.                 nikki@trmphrst.demon.co.uk
  57.  
  58.  
  59. ________________________________________________________________________________
  60. File obackup.doc                                                       Page   1
  61. WARNING - This software is supplied without warranty of any kind. No
  62. guarantee of reliable performance can be given. The suppliers
  63. liability for any failure is limited to the cost of the OBACKUP
  64. program. Users should satisfy themselves that the software performs
  65. satisfactorily before relying on it in any way. As an absolute
  66. minimum, perform a full verification of your first few backups using
  67. ORESTORE /V. 
  68.  
  69. Demonstration copies of this software are distributed free of charge via
  70. computer bulletin boards. These demonstration copies will run for a
  71. limited time only. Full versions of the software are available from the
  72. supplier and from distributors. For details of how to obtain a full
  73. version, see below. The primary ftp site for demonstration versions is
  74. ftp.demon.co.uk in directory /pub/trumphurst/obackup.
  75.  
  76. OBACKUP and ORESTORE were written to provide a means of backing up data 
  77. from hard disks to floppies which would run as a protected mode
  78. application under OS/2. In order to save media costs, the programs
  79. compress the data as it is backed up. The algorithm used is dynamic
  80. Lempel-Ziv compression, which normally gives compression ratios of
  81. between 30% and 60%. To increase the speed of backup, the compression
  82. algorithm can be changed to a simple non-repeat packing method, or turned
  83. off altogether, using a command-line switch. 
  84.  
  85. OBACKUP makes full use of OS/2 threads, thus enabling it to read data from
  86. the hard disk, compress previously read data, and write previously 
  87. compressed data to floppy at the same time. The read and compression 
  88. threads still run while the user is changing floppies.
  89.  
  90. OBACKDIR produces a listing of all the files in a backup set.
  91.  
  92. OBACKUP currently only produces backups on disk. I would be interested 
  93. in enhancing it to cope with tape drives. If you have a tape drive that is
  94. supported by OS/2, please let me know.
  95.  
  96. Installation
  97.  
  98. Simply copy all the files on to a directory on your path. If you decide 
  99. to move or rename OBACKUP.EXE, make sure you move or rename OBACKUP.REG 
  100. with it. OBACKUP will not run without OBACKUP.REG in the same 
  101. sub directory, with the same name as the executable file.
  102.  
  103. Upgrading from a version of OBACKUP prior to 2.0
  104.  
  105. Users of earlier versions of OBACKUP should note that the current 
  106. version is NOT backward compatible with 1.4. Neither program will 
  107. restore backups made with the other. You should therefore make sure you 
  108. keep a copy of the old version (under a different name, or in a different 
  109. directory) so that you can still restore your old backups.
  110.  
  111. Please note that the way command line and response file arguments are 
  112. processed has changed slightly - all switch arguments must be separate 
  113. from file/directory arguments, and they apply only to files processed
  114. after they have been encountered.
  115.  
  116.  
  117.  
  118.  
  119. ________________________________________________________________________________
  120. File obackup.doc                                                       Page   2
  121. Obtaining support and licensed copies of OBACKUP
  122.  
  123. World-wide on-line support for these programs is provided via the Internet.
  124. Queries about and orders for OBACKUP may be sent via Internet mail 
  125. to obackup@trmphrst.demon.co.uk.
  126.  
  127. Trumphurst Ltd.
  128. The Willows
  129. St. Martins Moor
  130. Oswestry
  131. Shropshire
  132. SY10 7BH
  133. England
  134. Tel : 0691-670318.              (country code 44)
  135. Fax : 0691-670316
  136.  
  137. The Australian distributor is 
  138. Critical Software Designs
  139. 5 Magnolia St.
  140. Daisy Hill
  141. Queensland 4127
  142. Australia
  143. Tel : (07) 208 9224             (country code 61)
  144. Fax/BBS - Ph: (07) 808 8998 (24 hrs)   Fidonet: 3:640/208
  145.  
  146. Prices
  147.                         U.K.            U.S.            Australia
  148. Single copy of OBACKUP  £50.00          $75.00          $125.00
  149. Minor update            £ 5.00          $10.00          $ 12.00
  150. Major update            Half the full price in force at the time.
  151. Updates from 1.4        £ 5.00          $ 7.50          $ 8.50
  152. Password decoding       £10.00          $15.00
  153.  
  154. Unlimited site licences and educational bulk discounts available on request. 
  155. Bulk discounts for multiple copies serialised with the same name and address :
  156. 10-19 copies............ 20% discount
  157. 20-49 copies............ 30% discount
  158. 30-99 copies............ 40% discount
  159. 100 or more copies...... 50% discount
  160.  
  161. Postage and packing charges
  162. U.K..................... Free
  163. Europe.................. £2.50
  164. U.S..................... $10.00
  165. Australia............... Free
  166.  
  167. *** residents in EEC member states must add 17.5% VAT to the total bill ***
  168.  
  169. We accept Visa, Master and American Express cards at the UK address - if
  170. US customers using a credit card to order, you will be charged the U.K.
  171. price, which will save a few dollars. When sending credit card details,
  172. please remember to include the expiry date of your card. 
  173.  
  174. Alternatively, checks are accepted in any of the above currencies. Checks 
  175. in other currencies (translated from the U.K. price at the current
  176. sterling exchange rate) should have 10% added to cover currency exchange 
  177. commission.
  178.  
  179. ________________________________________________________________________________
  180. File obackup.doc                                                       Page   3
  181. Updates
  182. A minor update is where the major version number (to the left of the
  183. decimal point) does not change. For example 2.3 to 2.9. Please note that
  184. your OBACKUP.REG file will work for all OBACKUP versions with the same 
  185. major version number. If you have Internet or Compuserve access, you can 
  186. just download minor upgrades for free. The charges only apply when I have 
  187. to post you a new disk.
  188.  
  189. A major update is where the major version number (to the left of the
  190. decimal point) changes. For example 2.9 to 3.0. 
  191.  
  192. Discounts
  193. If you already have the demonstration version, you are happy to do 
  194. without the laser printed manual (which contains exactly the same text as 
  195. OBACKUP.TXT), you have the UUDECODE program, and a Usenet mail address 
  196. which will accept uuencoded files, I can e-mail you an OBACKUP.REG file
  197. which will turn your demonstration program into a fully registered 
  198. version. There are no post & packing charges for this service (obviously),
  199. and there is an additional 10% discount. If you have a credit card, the 
  200. whole operation can be done via email. (I still need your postal address, 
  201. as it is encoded into OBACKUP.REG.) 
  202.  
  203. The reasons to back up data
  204.  
  205. Hardware failure - your hard disk can fail completely at any time !
  206.  
  207. Software failure - any program might contain a bug (defect) which could
  208.     corrupt data used by that program. Restoring a backup may allow you
  209.     to recover from such errors without re-keying all your data. 
  210.  
  211. Human error - It is regrettably easy to delete files accidentally, or to 
  212.     key in incorrect data.
  213.  
  214. Viruses - viruses and trojan programs may corrupt any data or programs on 
  215.     your hard disk. While this event is extremely unlikely, the insurance 
  216.     of sound backups could enable you to recover from the situation 
  217.     painlessly.
  218.  
  219. Archival of data - Keeping some of your old backups can enable you to 
  220.     restore historical data for analysis.
  221.  
  222. Normal backup procedures
  223.  
  224. Normal backup procedure is to backup ALL the files on your hard disk at 
  225. regular intervals. In between these full backups, you should run an
  226. incremental backup to record files which have changed since the last full
  227. backup. You should keep more than one set of backup disks, so that if a
  228. backup set is corrupted for any reason, you can go to an earlier backup. 
  229.  
  230. Deciding on the interval between backups
  231.  
  232. You should certainly aim to be able to recover your data in the event of
  233. a hard disk failure without undue expense in re-keying data. Most users 
  234. should do an incremental backup at least once every day. Normally, a full 
  235. backup is taken whenever the number of disks holding the incremental 
  236. backups approaches the number needed to hold a full backup.
  237.  
  238.  
  239. ________________________________________________________________________________
  240. File obackup.doc                                                       Page   4
  241. Deciding how many backup sets to keep
  242.  
  243. In addition to any requirement for historical data, you should also take 
  244. account of any periodic checks and reports run on your data. You should 
  245. always aim to be able to restore your data to the state it was in just 
  246. after the last periodic check. If your current report shows that your data
  247. is corrupt or incorrect in some way, you will then be able to go back to a
  248. situation in which you know the data is correct.
  249.  
  250. As an absolute minimum, you should keep 3 backup sets (the Grandfather, 
  251. Father, Son system). Many users will require much more than this. For a
  252. typical accounting application, for instance, you should keep 5 daily
  253. incremental backups (one for each working day), 4 or 5 full weekly
  254. backups (one for each week in the accounting period), and 3 full period
  255. backups. If you have a requirement for historical data, you might also
  256. keep 12 or 13 period sets, and 3 or more yearly sets. 
  257.  
  258. How to take a backups
  259.  
  260. For a full backup of drive C:, from the OS/2 command prompt type ...
  261.  
  262. OBACKUP /S/R C:\
  263.  
  264. If you have more than one hard disk (e.g. C: and D:) you might type ...
  265.  
  266. OBACKUP /S/R C:\ D:\
  267.  
  268. To take an incremental backup, change the above to ...
  269.  
  270. OBACKUP /I/S/R C:\
  271. or
  272. OBACKUP /I/S/R C:\ D:\
  273.  
  274. OBACKUP creates a backup directory (called OBACKUP.DIR), listing all 
  275. the files backed up. This file is used by OSHOWDIR when listing 
  276. backup set contents. You should delete this file (first copying it 
  277. off to floppy using COPY if required) when you start a new backup
  278. set. You can also recreate this file by running OBACKDIR on the 
  279. backup set.
  280.  
  281. OBACKUP also creates a backup log (called OBACKUP.LOG), listing any 
  282. errors that occurred during backup, and the final backup statistics.
  283. This can be useful for checking back to see exactly what errors occurred.
  284. Details of each backup are appended to this file, so you should delete
  285. this file as soon as it is no longer required, otherwise it will continue 
  286. to grow each time you do a backup.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299. ________________________________________________________________________________
  300. File obackup.doc                                                       Page   5
  301. How to restore backups
  302.  
  303. To check that your backup can be restored correctly, from the OS/2 command
  304. prompt type ...
  305.  
  306. ORESTORE /V
  307.  
  308. To restore a complete backup, type ...
  309.  
  310. ORESTORE /W
  311.  
  312. ORESTORE also creates a restore log (called ORESTORE.LOG), listing any 
  313. errors that occurred during restore. This can be useful for checking back
  314. to see exactly what errors occurred. Details of each restore are appended
  315. to this file, so you should delete this file as soon as it is no longer
  316. required, otherwise it will continue to grow each time you do a restore.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359. ________________________________________________________________________________
  360. File obackup.doc                                                       Page   6
  361. OBACKUP in detail
  362.  
  363. Invoke OBACKUP from the OS/2 command interpreter (or a .CMD file) as
  364. follows ... 
  365.  
  366. OBACKUP [<disk>:] [/Bnnn] [/Fname] [/Oname] [/Wprog] [/Ypass]
  367.         [/+-ACDEGHIKLMNPQRSTUVX] <pathnames>
  368.  
  369.     Normally, OBACKUP writes data to drive A:. If you include the
  370.     optional disk: parameter (e.g. B:), the data is written to the
  371.     specified drive. 
  372.  
  373.     SWITCHES - indicate switches by preceeding them with either / or +.
  374.     To turn a switch OFF, precede it with '-' instead. Switches must 
  375.     appear BEFORE the pathname arguments to which they apply.
  376.  
  377.     The E, H, I, S, T, U and X switches may be switched on for some files, 
  378.     and switched off for others. All the other switches must apply to the 
  379.     whole backup.
  380.  
  381.     /Bnnn = Use nnn 8k buffers (min 8, max 500, default 120)
  382.          This changes the amount of memory OBACKUP uses. If you
  383.     find that OS/2 is having to page memory to disk while OBACKUP
  384.     is running, you may wish to set this to a smaller number than the
  385.     default 120. 
  386.  
  387.     /Fname = File name to use instead of OBACKDAT
  388.          This changes the file name OBACKUP uses for non-raw 
  389.     backups. The default file name is OBACKDAT.nnn. The name may be up to 
  390.     8 characters. If the name is less than 8 characters, it is padded with
  391.     underscore (_) characters.
  392.  
  393.     /Oname = Other prompt to use instead of "disk"
  394.          If are setting up OBACKUP for use from a batch file, with a 
  395.     removable device which is not a floppy disk, you can use this switch
  396.     to change the "Insert disk <nnn> in drive" prompt to use the correct 
  397.     name for the media.
  398.  
  399.     /Wprog = Run prog.cmd to format disks if necessary
  400.          This option tells OBACKUP to run an OS/2 CMD (batch) file if the 
  401.     destination disk is not readable. This option is not used if you are 
  402.     backing up in /Raw mode - Raw mode has its own formatting routine, 
  403.     which can format the disk and write data to it at the same time.
  404.          Note that OBACKUP will still be reading and buffering data, and 
  405.     writing output to the screen while the format program is running. It 
  406.     is therefore ESSENTIAL that the CMD file does not require any 
  407.     input, or produce any output. To assist in this, OBACKUP redirects the
  408.     standard output and standard error of the CMD file to the NUL device. 
  409.     However, the OS/2 HELP facility circumvents this - HELP should be 
  410.     turned OFF before running OBACKUP with this option.
  411.          An example CMD file to format the disk in drive A: is provided in
  412.     the OBACKUP distribution - it reads "FORMAT A:/ONCE/V:OBACKUP" - the 
  413.     /ONCE option prevents FORMAT from prompting you to place the disk in 
  414.     the drive, and the /V:OBACKUP switch prevents format from prompting 
  415.     you to enter a volume label.
  416.  
  417.  
  418.  
  419. ________________________________________________________________________________
  420. File obackup.doc                                                       Page   7
  421.     /Ypass = Set password which must be provided to restore
  422.          This option password protects the backup. The same password must 
  423.     be supplied to restore it. The maximum length of password is 8 
  424.     characters.
  425.          Note that, although the password is encrypted in the backup file,
  426.     the encryption is not secure against someone who has access to the
  427.     source code (or to an inventive hacker with a copy of the OBACKUP
  428.     program). 
  429.          Should you lose your password, registered users may send a backup
  430.     disk to Trumphurst Ltd. at the address above, together with a fee of 
  431.     £10.00 (or $15.00) plus postage, packing and tax. The disk will be 
  432.     returned together with a note of the password.
  433.  
  434.     /A = Add this data to the end of a previous backup.
  435.          Normally, OBACKUP creates a new backup set each time it is
  436.     run. Setting this switch causes OBACKUP to add the new data to
  437.     the end of another backup set. You should have the last disk from the
  438.     backup set ready to put in the drive. 
  439.  
  440.     /C = no Checking if backup disk belongs to same backup set
  441.          Normally OBACKUP will not write backup data to a disk that
  442.     belongs to the current backup set. This prevents you accidentally
  443.     over-writing a previous disk by mistake. If you are using
  444.     OBACKUP to transfer a file system from one machine to another,
  445.     this switch allows you to do it using only one (or two) floppies. If
  446.     you use this switch, please be careful not to overwrite the disk
  447.     already in the drive by mistake ! 
  448.  
  449.     /D = Delete existing OBACKUP files on floppy disk first
  450.          Normally, OBACKUP assumes the floppy disk to be a blank,
  451.     formatted disk. If any existing OBACKUP files are found on the
  452.     disk, you will be asked if you wish to delete the old OBACKUP
  453.     files. The /D switch automatically deletes such files without asking.
  454.  
  455.     NOTE: Unless OBACKUP is run in /R(aw) mode, OBACKUP never
  456.     deletes other files on the floppy disk - if you wish to do this, you
  457.     should start another OS/2 session, and delete the files from there.
  458.     You need to do this before OBACKUP starts writing to the disk. 
  459.  
  460.     /E = include Empty files and sub directories in the backup
  461.  
  462.     /G = Go - do not prompt for first disk
  463.          Causes OBACKUP to try to access the first disk immediately
  464.     on program startup, without prompting the user.
  465.  
  466.     /H = include Hidden and system files
  467.          If this switch is set, OBACKUP includes hidden and system
  468.     files (such as IBMBIO.COM and IBMDOS.COM) in the backup process.
  469.     OBACKUP never includes files which are currently in use by
  470.     another OS/2 process. 
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479. ________________________________________________________________________________
  480. File obackup.doc                                                       Page   8
  481.     /I = Incremental backup.
  482.          If this switch is set, OBACKUP skips all files which don't
  483.     have their archive bit set. OBACKUP normally resets the archive
  484.     bit on each file as it is backed up (see /T switch). Other backup
  485.     programs, including OS/2 BACKUP and XCOPY also reset this bit. The
  486.     archive bit is automatically set by OS/2 whenever a file is altered.
  487.     This switch therefore enables you to backup only files which have
  488.     changed since your last backup. You can use the OS/2 utility ATTRIB
  489.     to find out whether a file has the archive bit set. An A attribute
  490.     indicates that a file has been altered since your last backup. 
  491.  
  492.     /K = Kill all existing files on the destination disk
  493.          During a non-raw backup, OBACKUP normally leaves all 
  494.     existing files unchanged (other than deleting existing backup files if
  495.     specified). This switch causes OBACKUP to delete all existing 
  496.     files on the disk. USE THIS SWITCH WITH CAUTION - ALL EXISTING FILES 
  497.     WILL BE ERASED. Please note, in order to prevent accidental deletion 
  498.     of all files on your hard disk, this switch is disabled if the 
  499.     destination drive is not a removable disk.
  500.  
  501.     /L = don't Log backup
  502.          Normally, OBACKUP logs all backup activity to the file
  503.     OBACKUP.DIR, for later viewing with OSHOWDIR. The /L switch
  504.     disables this feature. 
  505.  
  506.     /M = Monochrome screen - screens are shown in black and white.
  507.  
  508.     /N = do Not compress files
  509.          Normally, OBACKUP uses dynamic Lempel-Ziv compression on
  510.     large files, to reduce the number of disks taken for a backup.
  511.     Including the /N switch speeds up the backup process by disabling
  512.     this feature. Files are copied unchanged, except for OBACKUP
  513.     control information, which is added to each block of data. 
  514.  
  515.     /P = Pack files (non-repeat compression)
  516.          Normally, OBACKUP uses dynamic Lempel-Ziv compression on
  517.     large files, to reduce the number of disks taken for a backup.
  518.     Including the /P switch speeds up the backup process by disabling
  519.     this feature. Files are still compressed slightly, using a faster,
  520.     non-repeat packing algorithm. 
  521.  
  522.     /Q = Quiet - do not print backup statistics on exit.
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539. ________________________________________________________________________________
  540. File obackup.doc                                                       Page   9
  541.     /R = Raw device output
  542.          Normally OBACKUP uses floppy disks formatted for use by
  543.     OS/2. This means that part of the available space on the disk is used
  544.     for OS/2 directories, boot sectors, FAT's etc. Also, if you try to
  545.     backup onto an unformatted disk, OBACKUP is unable to write to
  546.     that disk. Using the /R switch causes OBACKUP to use the whole
  547.     area of the disk for data. If OBACKUP is not able to write to
  548.     the disk, it attempts to format it. OBACKUP does not write to
  549.     non-removable disks in Raw mode, or to disks with a track size
  550.     greater than 32768 bytes. 
  551.  
  552.     NOTE: OBACKUP always attempts to use the default format
  553.     for the drive. This usually means the highest density format, so you
  554.     must use suitable disks. 
  555.  
  556.     /S = include files from Sub-directories
  557.          This switch causes OBACKUP to search all sub-directories
  558.     of the directories specified in <pathnames> for files to back up. 
  559.  
  560.     /T = Test mode.
  561.          This switch stops OBACKUP from resetting the archive bit
  562.     on files as they are backed up (see /I switch). 
  563.  
  564.     /U = include files in use by other programs
  565.          Normally OBACKUP backs up all the files it can open for 
  566.     reading, even if some other program may be writing to them at the
  567.     time. If another program changes a file while it is actually being 
  568.     backed up, the backup could contain a partially changed file, which 
  569.     may cause problems if the file is restored. Including -U (or /-U) 
  570.     turns this option off, so that such files are not backed up at all.
  571.  
  572.     /V = Verify data written to floppy
  573.          Including this switch causes OBACKUP to re-read each block
  574.     of data immediately after writing it to the floppy. If any errors are
  575.     encountered when the data is re-read, OBACKUP re-write s the
  576.     data on the next disk. This switch slows down the backup process
  577.     considerably. 
  578.  
  579.     /X = eXtended attributes.
  580.          By default, OBACKUP saves OS/2 extended attribute data
  581.     in the backup. By including /-X, you can turn this facility off.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599. ________________________________________________________________________________
  600. File obackup.doc                                                       Page  10
  601.     <pathnames> may either be directory names, ambiguous file names (as
  602.     used in the DIR command) or full file names. As many pathnames as
  603.     will fit on the command line may be included. If the pathname is a
  604.     file name, that file is backed up. If the pathname is an ambiguous
  605.     file name, all files matching that name are backed up. If the
  606.     pathname is a directory name, all files on that directory are backed
  607.     up. To specify a pathname containing spaces or the characters /, + or -,
  608.     enclose the whole pathname in double quotes ("). To include the double
  609.     quote mark itself, precede it with a backslash (\).
  610.  
  611.     If a supplied pathname is an absolute pathname (i.e it starts from
  612.     the root directory - e.g. \MYDIR\MYFILE) the full pathname is
  613.     recorded in the backup, and ORESTORE will restore the file to
  614.     the same place. If the pathname contains a disk drive, the file will
  615.     also be restored to the same drive. (Note - ORESTORE has
  616.     options to over-ride this if necessary.) If the pathname is relative
  617.     to the current directory (e.g. MYDIR\MYFILE), it will be restored
  618.     relative to the current directory when ORESTORE is run. It is
  619.     therefore suggested that you always specify full pathnames including
  620.     drive letters when making backups. 
  621.  
  622. The E, H, I, S, T, U and X switches may be turned on (e.g. with +H) or
  623. off (e.g. -H) at any place in the command line. These switches take
  624. effect for subsequent pathnames (until turned off/on again). 
  625.  
  626. Entering OBACKUP /HELP shows a brief summary of the above information.
  627.  
  628. Examples
  629.  
  630. OBACKUP B: *
  631.     Back up all files on the current directory to drive B:
  632.  
  633. OBACKUP /S C:\
  634.     Back up all files on all directories on drive C: to drive A:.
  635.  
  636. OBACKUP /N/V/S \
  637.     Back up all files on all directories on the current drive to drive A:.
  638. Do not compress, but verify data written to floppy after each write. 
  639.  
  640. OBACKUP B:/D/H/S/R C:\MYDIR
  641.     Back up all files (including hidden and system files) on directory 
  642. C:\MYDIR and all its sub directories to drive B:. Use raw device mode, 
  643. so that OBACKUP can format the disks as it goes.
  644.  
  645. OBACKUP +S C:\ -S D:\ D:\MYDIR\*.C
  646.     Back up all files on all directories on drive C:, all files on the 
  647. root directory on drive D:, and all files with extension .C on directory 
  648. D:\MYDIR, to drive A:.
  649.  
  650. OBACKUP /I/S C:\
  651.     Back up all files on drive C: which have changed since the last
  652. backup. 
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659. ________________________________________________________________________________
  660. File obackup.doc                                                       Page  11
  661. Command files
  662.  
  663. You can create OBACKUP command files for regular partial backups.
  664. An OBACKUP command file consists of an ordinary ASCII file (created
  665. with your favourite editor or word processor in non-document mode). Each
  666. line of the file contains an OBACKUP command. Only the first line
  667. may contain a destination disk letter, or any of the switches D, N, P, R,
  668. T or V. You must not place more than 1 command or pathname per line.
  669.  
  670. Lines may contain comments, which are started with a semicolon. A comment
  671. may not appear on the same line as a pathname (otherwise it would be 
  672. difficult to parse pathnames containing spaces or semicolons).
  673.  
  674. To use a command file with OBACKUP, type
  675.  
  676. OBACKUP @filename
  677.  
  678. where filename is the name of your command file.
  679.  
  680. Example command file
  681.  
  682. ;Backup to floppy disk A:
  683. A:
  684. /D              ;Delete any existing backups
  685. ;Backup everything on drive C:
  686. +S              ;Subsequent lines should include sub directories
  687. C:\
  688. ;Backup root directory only of drive D:
  689. -S              ;Subsequent lines should NOT include sub directories
  690. D:\
  691. ;Backup MYDIR directory on drive D:
  692. D:\MYDIR
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719. ________________________________________________________________________________
  720. File obackup.doc                                                       Page  12
  721. Prompts and status information while the program is running
  722.  
  723. The OBACKUP screen is divided into four areas. The top area (in
  724. reverse video) shows program information, error messages, prompts to the
  725. user, and user responses. The other areas show lists of filenames as they
  726. are processed by each thread. The screen looks like this ... 
  727.  
  728. ╔══════════════════════════════════════════════════════════════════════════════╗
  729. ║OBACKUP OS/2 backup utility V2.9 Serial: 12345 Copyright(c)1991-93 Nikki Locke║
  730. ║OBACKUP disk no 002 - Dated 10/Nov/1993 10:00:00 <error messages here>        ║
  731. ║<prompts here>                                                      <debug no>║
  732. ╠═Files═╦═Bytes in══╦═Bytes out═╦══Time═══╦User time╦═Input══╦══Comp══╦═Output═╣
  733. ║     3 ║      2345 ║         0 ║    0:12 ║    0:04 ║   70%  ║   80%  ║   50%  ║
  734. ╠═══════╩═══════════╩════════Writing to output══════╩════════╩════════╩════════╣
  735. ║                                                                              ║
  736. ║                                                                              ║
  737. ║                                                                              ║
  738. ║                                                                              ║
  739. ║C:\OS2INIT.CMD                                                                ║
  740. ╠═══════════════════════════════Compressing════════════════════════════════════╣
  741. ║                                                                              ║
  742. ║                                                                              ║
  743. ║                                                                              ║
  744. ║C:\OS2INIT.CMD                                            <Compression method>║
  745. ║C:\CONFIG.SYS                                             <Compression method>║
  746. ╠════════════════════════════Reading from input════════════════════════════════╣
  747. ║                                                                              ║
  748. ║                                                                              ║
  749. ║C:\OS2INIT.CMD                                                                ║
  750. ║C:\CONFIG.SYS                                                    <file errors>║
  751. ║C:\FORMATS.TBL                                                   <file errors>║
  752. ╚══════════════════════════════════════════════════════════════════════════════╝
  753.  
  754. Files     : Number of files processed by the "Reading from input" thread.
  755. Bytes in  : Number of bytes read by the "Reading from input" thread.
  756. Bytes out : Number of bytes written by the "Writing to output" thread.
  757. Time      : Elapsed time (mins:secs)
  758. User Time : Time spent waiting for disk changes
  759. Input     : Percentage efficiency of the "Reading from input" thread.
  760. Comp      : Percentage efficiency of the "Compressing" thread.
  761. Output    : Percentage efficiency of the "Writing to output" thread.
  762.  
  763. These percentage efficiencies reach 100% when the thread is waiting for
  764. another thread to finish. They reach 0% when both the other threads are
  765. waiting for the indicated thread. 
  766.  
  767. Debug no  : If there is a problem with the program hanging, or not 
  768. responding to keyboard input, please make a note of this number and the 
  769. version number of the program when reporting the problem to your 
  770. supplier.
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779. ________________________________________________________________________________
  780. File obackup.doc                                                       Page  13
  781. Program return codes
  782.  
  783. OBACKUP, like all OS/2 programs, returns an "errorlevel" number to
  784. the operating system. The numbers are ...
  785.  
  786. 0       Backup successful
  787. 1       One or more Extended Attributes were not backup successfully
  788. 2       One or more files were not backup successfully
  789. 3       Invalid or out of date OBACKUP.REG file
  790.  
  791. Prompts
  792.  
  793. "Insert disk 002 in drive A: and press Return"
  794. Insert a blank floppy disk in the indicated drive, and press Return. If
  795. you are using Raw device mode, OBACKUP will format the disk if
  796. necessary. Otherwise, the disk must be ready formatted. If you wish, you
  797. may format the disk (in another OS/2 session) before pressing Return.
  798.  
  799. "Insert disk 002 in drive A: and press Return or D to delete old backups"
  800. The disk you have just inserted contains data from a previous backup.
  801. Either replace the disk with another, or press D to delete these old
  802. backups. 
  803.  
  804. "Insert disk 002 in drive A: and press Return or D to delete existing files"
  805. The disk you have just inserted has insufficient free space for the backup 
  806. file. Either replace the disk with another, or press D to delete all 
  807. existing data from the disk to free up space.
  808.  
  809. "Insert disk 002 in drive A: and press Return (DISCARD THIS FLOPPY)"
  810. A disk write or verify error (see error message on line 3) occurred while
  811. attempting to write the first block of data onto this disk. Remove the
  812. disk from the drive, discard it, and replace with another disk. No data
  813. will be lost. 
  814.  
  815. "Insert disk 002 in drive A: and press Return (KEEP THIS FLOPPY)"
  816. A disk write or verify error (see error message on line 3) occurred while
  817. attempting to write a block of data onto this disk. Remove the disk from
  818. the drive, including it in the backup set, and insert the next disk. No
  819. data will be lost. 
  820.  
  821. Once OBACKUP has started writing to the disk, a line of dots will appear 
  822. on the prompt line, and will disappear gradually as each block of data is 
  823. written. This enables you to monitor the process, and be ready to change 
  824. the disk as the last dots go.
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839. ________________________________________________________________________________
  840. File obackup.doc                                                       Page  14
  841. Error messages on line 3
  842.  
  843. "Active backup disk"
  844. The disk you have placed in the floppy drive already contains data from 
  845. this backup.
  846.  
  847. "Not last disk"
  848. You have specified the /A switch to add data to a previous backup, and
  849. the disk in the drive is not the last disk of a previous backup.
  850.  
  851. "Obackup 1.4 disk"
  852. You have specified the /A switch to add data to a previous backup, and
  853. the disk in the drive was backed up with an earlier version of OBACKUP.
  854. Version 2.0 is not compatible with earlier versions - you can only append 
  855. to old backups using the old program.
  856.  
  857. "Disk verify error"
  858. An error occurred while verifying that the data read back from the floppy
  859. disk was the same as the data written. This block of data will be re-
  860. written on the next backup disk.
  861.  
  862. "Disk write error"
  863. An error occurred while writing data to the floppy disk. This block of
  864. data will be re-written on the next backup disk. 
  865.  
  866. "Error opening archive file"
  867. OBACKUP could not create the backup file. This disk will not be used in 
  868. the backup.
  869.  
  870. "Error reading floppy disk"
  871. OBACKUP could not read any data from the floppy disk. This disk will not 
  872. be used in the backup.
  873.  
  874. "Formatting while copying"
  875. OBACKUP (in Raw mode) is formatting the disk while copying data to it.
  876.  
  877. "Cannot format track"
  878. OBACKUP could not format the floppy disk. This disk will not be used in 
  879. the backup.
  880.  
  881. "Not enough space on disk"
  882. There is not enough free space on the disk. Either open another OS/2 
  883. session to delete existing files on the disk (or run CHKDSK if there 
  884. aren't any), or use another disk.
  885.  
  886. "Old backup disk"
  887. The disk currently in the drive contains data from a previous backup. The 
  888. disk number and backup date are also displayed on line 3.
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899. ________________________________________________________________________________
  900. File obackup.doc                                                       Page  15
  901. Compression methods
  902.  
  903. "Copying"
  904. A section of file has been copied unchanged.
  905.  
  906. "Packing"
  907. A section of file has been non-repeat packed.
  908.  
  909. "Compressing"
  910. A section of file has been Lempel-Ziv compressed.
  911.  
  912. Different sections of the same file may use different compression methods,
  913. depending on which method gives the best compression. The compression 
  914. method shown against a file name is the one used on the latest block of 
  915. data from the file.
  916.  
  917. "Empty file"
  918. "Empty dir"
  919. Indicates an empty file or directory being backed up with the /E switch.
  920.  
  921. File errors
  922.  
  923. "File in use"
  924. Indicates that another process may be writing to the file. The file is
  925. still backed up, but the date may not be sensible if the other process
  926. changes the file while OBACKUP is reading it.
  927.  
  928. "Cannot open"
  929. OBACKUP can not open the file for reading, probably because another OS/2
  930. process is using the file. The file is not included in the backup set.
  931.  
  932. "Empty file"
  933. The file contains no data. Such empty files are only backed up if the /E 
  934. switch is specified.
  935.  
  936. "Cannot read EAs"
  937. OBACKUP could not read the Extended Attributes for the file. No 
  938. Extended Attribute information is backed up for this file.
  939.  
  940. "Read error"
  941. An error occurred while OBACKUP was reading the file. Only data read 
  942. before the error is backed up.
  943.  
  944. "Directory depth too great - ignoring sub directories"
  945. OBACKUP can only handle pathnames of a limited length. The directory which 
  946. is about to be backed up has a path name which would cause this length to
  947. be exceeded. The only way to backup files from this directory is to make 
  948. it (or its parent) the current directory, and backup from there.
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959. ________________________________________________________________________________
  960. File obackup.doc                                                       Page  16
  961. Fatal errors
  962.  
  963. Any of the following errors causes OBACKUP to terminate immediately.
  964.  
  965. "Cannot handle media this size"
  966. OBACKUP cannot handle disks with a track size of greater than 32768 bytes 
  967. in Raw mode. Do not use the /R switch when backing up to this drive.
  968.  
  969. "Non-removable media"
  970. OBACKUP will not write to fixed disks in Raw mode. Do not use the /R
  971. switch when backing up to this drive. 
  972.  
  973. "Error opening command file"
  974. A command file was specified using @<filename>. The file could not be 
  975. opened. Check the file name is correct.
  976.  
  977. "Invalid Bytes Per Sector"
  978. OBACKUP can only cope with disks of 128, 256, 512 or 1024 bytes per 
  979. sector in raw mode. Do not use the /R switch when backing up to this
  980. drive. 
  981.  
  982. Internal errors
  983.  
  984. "Can't determine drive type" *** 
  985. "Can't read BPB" *** 
  986. "Can't set BPB" ***
  987. "Creating archive bit setting thread" *** 
  988. "Creating compress thread" *** 
  989. "Creating timer thread" *** 
  990. "Creating write thread" *** 
  991. "DosQueryFileInfo error" *** 
  992. "Error allocating Extended Attribute buffer" ***
  993. "Error allocating queue" *** 
  994. "Error allocating second Extended Attribute buffer" ***
  995. "Error allocating verify buffer" *** 
  996. "Error allocating write buffer" *** 
  997. "Error reading invalid queue" *** 
  998. "Error writing buffer queue" *** 
  999. "Error writing completed queue" *** 
  1000. "Error writing compress queue" *** 
  1001. "Error writing floppy queue" *** 
  1002. "Error writing invalid queue" *** 
  1003. "Error writing unknown queue" *** 
  1004. "Invalid bpb" ***
  1005. "Too many queues" *** 
  1006.  
  1007. Errors marked *** are internal OBACKUP errors. All internal
  1008. errors which cannot be explained by either another OS/2 process
  1009. accessing a file, by a bad sector on the floppy disk, or by another
  1010. hardware failure, should be reported to your supplier, as they
  1011. indicate a probable program bug. If you report an internal error,
  1012. please note down the program version number, and the debug number
  1013. (from line 4). 
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019. ________________________________________________________________________________
  1020. File obackup.doc                                                       Page  17
  1021. ORESTORE in detail
  1022.  
  1023. ORESTORE is invoked from the OS/2 command interpreter (or a .CMD file) as 
  1024. follows ...
  1025.  
  1026. ORESTORE [<disk>:] [/Fname] [/Oname] [/Ypass]
  1027.          [/+-ACDGIMQRSTVWX] [<files to restore>]
  1028.  
  1029.     Normally, ORESTORE reads data from drive A:. Including the optional 
  1030.     disk: parameter (e.g. B:) causes the data to be read from the 
  1031.     specified drive.
  1032.  
  1033.     /Fname = File name to use instead of OBACKDAT
  1034.          This changes the file name ORESTORE expects for non-raw 
  1035.     backups. The default file name is OBACKDAT.nnn. The name may be up to 
  1036.     8 characters. If the name is less than 8 characters, it is padded with
  1037.     underscore (_) characters.
  1038.  
  1039.     /Oname = Other prompt to use instead of "disk"
  1040.          If are setting up ORESTORE for use from a batch file, with a 
  1041.     removable device which is not a floppy disk, you can use this switch
  1042.     to change the "Insert disk <nnn> in drive" prompt to use the correct 
  1043.     name for the media.
  1044.  
  1045.     /Ypass = Password to restore protected backup
  1046.          This option enables you to restore password protected backups.
  1047.     The same password must be supplied as was used to back up. The
  1048.     maximum length of password is 8 characters. 
  1049.          Note that, although the password is encrypted in the backup file,
  1050.     the encryption is not secure against someone who has access to the
  1051.     source code (or to an inventive hacker with a copy of the OBACKUP
  1052.     program). 
  1053.          Should you lose your password, registered users may send a backup
  1054.     disk to Trumphurst Ltd. at the address above, together with a fee of 
  1055.     £10.00 (or $15.00) plus postage, packing and tax. The disk will be 
  1056.     returned together with a note of the password.
  1057.  
  1058.     /A = restore All files to sub directories of current directory
  1059.          If the backed up file name contains a disk drive letter, and/or
  1060.     it is an absolute path name (starting from root - e.g. \MYDIR\MYFILE)
  1061.     the /A switch overrides this, and restores the files to paths
  1062.     relative to the current disk and directory. In the example, if the
  1063.     current directory was C:\TOPDIR, the file would be restored as C:
  1064.     \TOPDIR\MYDIR\MYFILE. 
  1065.  
  1066.     /C = restore all files to Current directory
  1067.          The /C switch removes all drive letters and path details from the
  1068.     file name before restoring it. This means that all the files from the
  1069.     backup are restored to the current directory. If there are two files
  1070.     with the same name (backed up from different directories), the second
  1071.     file is not restored (subject to /Q and /W switches). 
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079. ________________________________________________________________________________
  1080. File obackup.doc                                                       Page  18
  1081.     /D = Don't test disks to see if OBACKUP /R(aw) was used
  1082.          Normally ORESTORE tests each disk to see whether it was written 
  1083.     by OBACKUP in /R(aw) mode. This switch disables this test. You need to
  1084.     use it if the backup was to a non-removable device, or one where the 
  1085.     track size is greater than 32768 bytes.
  1086.  
  1087.     /G = Go - do not prompt for first disk
  1088.          Causes ORESTORE to try to access the first disk immediately
  1089.     on program startup, without prompting the user.
  1090.  
  1091.     /I = Interactive mode - query each file before restoring/verifying
  1092.           Normally ORESTORE restores or verifies all the files in a
  1093.     backup set. The /I switch causes ORESTORE to ask you whether to
  1094.     backup, verify or ignore each file in turn. Note that this switch also
  1095.     takes other behaviour into account, so existing files will be ignored 
  1096.     without prompting unless the /W or /Q switches are also on.
  1097.  
  1098.     /M = Monochrome screen - screens are shown in black and white.
  1099.  
  1100.     /Q = Query mode - ask before overwriting existing files
  1101.          Normally ORESTORE does not overwrite existing files. The /Q switch
  1102.     causes ORESTORE to ask you whether to overwrite any existing file
  1103.     each time one is found. 
  1104.  
  1105.     /T = set file Times to time restored
  1106.          Normally ORESTORE sets each restored file's time and date to its
  1107.     original time and date before it was backed up. This switch turns off
  1108.     this feature.
  1109.  
  1110.     /R = assume Raw mode was used for backup
  1111.          Normally ORESTORE tests each disk to see whether it was written 
  1112.     by OBACKUP in /R(aw) or non raw mode. This switch saves the time 
  1113.     taken by this test.
  1114.  
  1115.     /S = Silent - do not print restore error statistics on exit.
  1116.  
  1117.     /V = Verify backup without restoring files
  1118.          This switch enables you to check that every file in the backup 
  1119.     set is restorable.
  1120.  
  1121.     /W = overWrite existing files without asking
  1122.          Normally ORESTORE does not overwrite existing files. The /W switch
  1123.     causes ORESTORE to overwrite existing files without asking.
  1124.  
  1125.     /X = Ignore eXtended attributes.
  1126.          This switch prevents ORESTORE from updating or checking the 
  1127.     Extended Attributes of the files being restored.
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139. ________________________________________________________________________________
  1140. File obackup.doc                                                       Page  19
  1141. <files to restore>
  1142.     If you enter one or more file names or path names, only files 
  1143. satisfying at least one of the names are restored. If you enter only a
  1144. file name (without disk letter or directory specifiers), all files on all 
  1145. directories which match the name are restored. If you enter a path 
  1146. name (with disk letter or directory specifier), only files fully matching 
  1147. the path name are restored. File and path names may be ambiguous.
  1148.  
  1149. Name matching follows OS/2 conventions, rather than DOS ones - to restore 
  1150. all files, use "*", not "*.*".
  1151.  
  1152. Entering ORESTORE /HELP shows a brief summary of the above information.
  1153.  
  1154. Examples
  1155.  
  1156. ORESTORE B:
  1157.     Restores files from drive B:
  1158.  
  1159. ORESTORE /V/I
  1160.     Asks you whether to verify each individual file in the backup set. 
  1161.  
  1162. ORESTORE /W *.C \INCLUDE\*
  1163.     Restores all files with extension .C in all directories, and all
  1164. files on the \INCLUDE directory, overwriting any existing files with the
  1165. same names.
  1166.  
  1167. To use a command file with ORESTORE, type
  1168.  
  1169. ORESTORE @filename
  1170.  
  1171. where filename is the name of your command file.
  1172.  
  1173. Example command file
  1174.  
  1175. ;Restore from floppy disk A:
  1176. A:
  1177. ;Restore only files beginning with G
  1178. G*
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199. ________________________________________________________________________________
  1200. File obackup.doc                                                       Page  20
  1201. Prompts and status information while the program is running
  1202.  
  1203. The ORESTORE screen is divided into two areas. The top area (in reverse 
  1204. video) shows program information, error messages, prompts to the user,
  1205. and user responses. The other area shows the names of files as they are 
  1206. restored. The screen looks like this ...
  1207.  
  1208. ╔══════════════════════════════════════════════════════════════════════════════╗
  1209. ║ORESTORE OS/2 restore utility V2.9 Copyright(c)1991-93 Nikki Locke            ║
  1210. ║OBACKUP disk no 002 - Dated 10/Nov/1993 10:00:00 <error messages here>        ║
  1211. ║<prompts here>                                                      <debug no>║
  1212. ╠═Disks══╦══Files══╦═Bytes in══╦═Bytes out═╦═══Block═══╦════CRC════╦══Verify═══╣
  1213. ║      0 ║       0 ║         0 ║         0 ║         0 ║         0 ║         0 ║
  1214. ╠════════╩═════════╩═══════════╩═File names╩═══════════╩═══════════╩═══════════╣
  1215. ║                                                                              ║
  1216. ║                                                                              ║
  1217. ║                                                                              ║
  1218. ║                                                                              ║
  1219. ║                                                                              ║
  1220. ║                                                                              ║
  1221. ║                                                                              ║
  1222. ║                                                                              ║
  1223. ║                                                                              ║
  1224. ║                                                                              ║
  1225. ║                                                                              ║
  1226. ║                                                                              ║
  1227. ║                                                                              ║
  1228. ║                                                                              ║
  1229. ║                                                                              ║
  1230. ║                                                                              ║
  1231. ║                                                                              ║
  1232. ║(D:\MYDIR\) MYFILE                                               <file errors>║
  1233. ║MYFILE.DAT                                                       <file errors>║
  1234. ╚══════════════════════════════════════════════════════════════════════════════╝
  1235.  
  1236. Disks     : Number of disks processed so far
  1237. Files     : Number of files restored/verified
  1238. Bytes in  : Number of bytes read from floppy disk
  1239. Bytes out : Number of bytes written/verified to hard disk
  1240. Block     : Number of block errors
  1241. CRC       : Number of file CRC errors
  1242. Verify    : Number of file verify/open errors
  1243.  
  1244. Debug no  : If there is a problem with the program hanging, or not 
  1245. responding to keyboard input, please make a note of this number and the 
  1246. version number of the program when reporting the problem to your 
  1247. supplier.
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259. ________________________________________________________________________________
  1260. File obackup.doc                                                       Page  21
  1261. Program return codes
  1262.  
  1263. ORESTIRE, like all OS/2 programs, returns an "errorlevel" number to
  1264. the operating system. The numbers are ...
  1265.  
  1266. 0       Restore successful
  1267. 1       One or more Extended Attributes were not restored successfully
  1268. 2       One or more files were not restored successfully
  1269. 3       User requested a program abort after a read or CRC error
  1270.  
  1271. Prompts
  1272.  
  1273. "Insert disk 002 in drive A: and press Return "
  1274. Place the next disk in the backup set in the floppy drive, and press 
  1275. Return.
  1276.  
  1277. "Insert disk 002 in drive A: and press Return or R to restart from this disk"
  1278. The disk in the drive is not the next disk in the backup sequence. Either
  1279. place the correct disk in the drive, and press Return, or press R to
  1280. continue restoring data from the first file found on this disk. If you
  1281. press R, any file which has been partially restored from the previous
  1282. disk is not restored correctly. 
  1283.  
  1284. "Obackup 1.4 disk - insert new disk and press Return"
  1285. The disk in the drive is from a backup made with a version of OBACKUP
  1286. prior to 2.0. To restore data from this backup, you must use ORESTORE 
  1287. version 1.4.
  1288.  
  1289. "Verify this file (y/n)"
  1290. "Verify this directory exists (y/n)"
  1291. When the /I and /V switches are in use, this prompt is shown for each
  1292. file found in the backup set. Press Y to verify this file, or N to skip
  1293. to the next file in the set. 
  1294.  
  1295. "Restore this file (y, n or v to verify only)"
  1296. "Restore this directory (y, n or v to verify only)"
  1297. When the /I switch is in use, this prompt is shown for each file found in
  1298. the backup set. Press Y to restore this file, V to verify this file is
  1299. the same on the hard disk is it is in the backup, or N to skip to the
  1300. next file in the set. 
  1301.  
  1302. "File exists - overwrite (y/n)"
  1303. When the /Q switch is in use, this prompt is shown for each file in the
  1304. backup set which already exists on the hard disk. Press Y to overwrite
  1305. the existing file with the backup copy, or N to skip to the next file in
  1306. the set. 
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319. ________________________________________________________________________________
  1320. File obackup.doc                                                       Page  22
  1321. Error messages on line 4
  1322.  
  1323. "Decompression error - Abort, Skip to next file, Next floppy" ***
  1324. An unexpected error has occurred while trying to decompress a block of 
  1325. data. Press A to abort the program, S to restart from the next file in the
  1326. backup set, or N to restart from the first file on the next floppy. The 
  1327. current file is not restored correctly.
  1328.  
  1329. "Floppy CRC error - Abort, Retry, Ignore, Skip file, Next floppy" ***
  1330. The CRC check on the validity of a data block read from the floppy has 
  1331. failed. Press A to abort the program, R to re-read the data, I to ignore 
  1332. the error (this may give rise to further errors later), S to restart from
  1333. the next file in the backup set, or N to restart from the first file on
  1334. the next floppy. If you press S or N, the current file is not restored
  1335. correctly. 
  1336.  
  1337. "Floppy read error - Abort, Retry, Skip file, Next floppy"
  1338. A read error occurred while trying to read a data block from the floppy
  1339. has failed. Press A to abort the program, R to re-read the data, S to
  1340. restart from the next file in the backup set, or N to restart from the
  1341. first file on the next floppy. If you press S or N, the current file will
  1342. not have been restored correctly. 
  1343.  
  1344. "Invalid data block - Abort, Skip to next file, Next floppy" ***
  1345. A data block contained an invalid header. Press A to abort the program, S
  1346. to restart from the next file in the backup set, or N to restart from the
  1347. first file on the next floppy. The current file is not restored correctly.
  1348.  
  1349. "Invalid data CRC - Abort, Ignore, Skip to next file, Next floppy" ***
  1350. The CRC check on the validity of a data block has failed. Press A to
  1351. abort the program, I to ignore the error (this may give rise to further
  1352. errors later), S to restart from the next file in the backup set, or N to
  1353. restart from the first file on the next floppy. If you press S or N, the
  1354. current file is not restored correctly.
  1355.  
  1356. Error messages on line 3
  1357.  
  1358. "Not an OBACKUP disk"
  1359. The disk in the drive was not written by OBACKUP.
  1360.  
  1361. "Obackup 1.4 disk"
  1362. The disk in the drive was backed up with an earlier version of OBACKUP.
  1363. Version 2.0 is not compatible with earlier versions - you can only restore
  1364. to old backups using the old program.
  1365.  
  1366. "Error opening archive file"
  1367. ORESTORE could not open the archive file. Probably the drive is in use by 
  1368. another OS/2 process.
  1369.  
  1370. "Disk out of sequence"
  1371. The disk in the drive is not the next disk in sequence.
  1372.  
  1373. "Wrong OBACKUP set"
  1374. The disk in the drive is from a different OBACKUP set.
  1375.  
  1376.  
  1377.  
  1378.  
  1379. ________________________________________________________________________________
  1380. File obackup.doc                                                       Page  23
  1381. File errors and messages
  1382.  
  1383. "Verified OK"
  1384. The file on the hard disk is the same as the one in the backup.
  1385.  
  1386. "Restored OK"
  1387. The file was restored correctly.
  1388.  
  1389. "Skipped"
  1390. The file is not being restored, either because it does not match the file
  1391. name list provided when ORESTORE was invoked, or because you asked to
  1392. skip it in interactive mode. 
  1393.  
  1394. "EA write error"
  1395. An error occurred when trying to update the Extended Attributes of the file. 
  1396. The file on the hard disk was deleted.
  1397.  
  1398. "Write error"
  1399. A write error occurred when trying to write data to the file. The file on 
  1400. the hard disk was deleted.
  1401.  
  1402. "Verify error"
  1403. The file on the hard disk does not match the file in the backup set.
  1404.  
  1405. "EA Verify err"
  1406. The Extended Attributes of file on the hard disk do not match those of the 
  1407. file in the backup set.
  1408.  
  1409. "Read EA error"
  1410. "Read error"
  1411. A read error occurred when trying to verify the file.
  1412.  
  1413. "CRC error"
  1414. The stored CRC of the backed up file did not match the CRC calculated from
  1415. the data written to the file. This usually means that part of the data was
  1416. skipped due to an earlier error. The file is not deleted, but probably
  1417. contains incorrect data. 
  1418.  
  1419. "Not created"
  1420. ORESTORE was unable to create the file. The file is probably in use by 
  1421. another OS/2 process.
  1422.  
  1423. "Disk full"
  1424. There is insufficient space on the disk to restore the file. This file is
  1425. not restored.
  1426.  
  1427. "File exists"
  1428. The file already exists on the hard disk and the /W switch is not in 
  1429. operation.
  1430.  
  1431. "Invalid path"
  1432. ORESTORE was unable to create the directories necessary to restore the 
  1433. file. Perhaps one of the directory names in the path is already in use as 
  1434. a file.
  1435.  
  1436.  
  1437.  
  1438.  
  1439. ________________________________________________________________________________
  1440. File obackup.doc                                                       Page  24
  1441. "Not found"
  1442. ORESTORE tried to open the file on the hard disk for verification, and
  1443. the file could not be opened. 
  1444.  
  1445. Fatal errors
  1446.  
  1447. Any of the following errors will cause ORESTORE to terminate immediately.
  1448.  
  1449. "Decompression error - Aborted"
  1450. "Floppy disk read - Aborted"
  1451. "Invalid data block - Aborted"
  1452. The stated error occurred, and Abort was selected at the error prompt.
  1453.  
  1454. "Too many arguments"
  1455. ORESTORE can only accept up to 31 <files to restore> arguments.
  1456.  
  1457. Internal errors
  1458.  
  1459. "Can't read BPB" ***
  1460. "Error allocating Extended Attribute buffer" ***
  1461. "Error allocating second Extended Attribute buffer" ***
  1462. "Error allocating verify buffer" ***
  1463. "Error allocating decompress buffer" ***
  1464. "Error allocating write buffer ***"
  1465. "Error allocating read buffer" ***
  1466. These are internal ORESTORE errors.
  1467.  
  1468. Errors marked *** which cannot be explained by either another OS/2
  1469. process accessing a file, by a bad sector on the floppy disk, or by
  1470. another hardware failure, should be reported to your supplier, as
  1471. they indicate a probable program bug. 
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499. ________________________________________________________________________________
  1500. File obackup.doc                                                       Page  25
  1501. OSHOWDIR in detail
  1502.  
  1503. OSHOWDIR allows you to review backup logs created with OBACKUP and 
  1504. OBACKDIR. It is intended to upgrade it to become the user interface to 
  1505. ORESTORE, so you can pick which files to restore. Please feel free to 
  1506. comment on the user interface.
  1507.  
  1508. When OSHOWDIR is invoked, it reads in the OBACKUP.DIR file, and displays 
  1509. the first screen full of files, which looks like this ...
  1510.  
  1511. Disk Date         Time          Size Name                                     ═╗
  1512. ║    15/Aug/1989  14:04:04           New Backup                                ║
  1513. ║001 15/Aug/1989  14:04:04     12345 OBACKUP.TST                               ║
  1514. ║001 15/Aug/1989  14:04:04      2486 TESTFILE.001                              ║
  1515. ║001 15/Aug/1989  14:04:04      1234 TESTFILE.002                              ║
  1516. ║001 15/Aug/1989  14:04:04     56342 TESTFILE.003                              ║
  1517. ║002 15/Aug/1989  14:04:04     12345 TESTFILE.004                              ║
  1518. ║                                                                              ║
  1519. ║  ..... etc .....                                                             ║
  1520. ║                                                                              ║
  1521. ║                                                                              ║
  1522. ║                                                                              ║
  1523. ║                                                                              ║
  1524. ║                                                                              ║
  1525. ║                                                                              ║
  1526. ║                                                                              ║
  1527. ║                                                                              ║
  1528. ║                                                                              ║
  1529. ║                                                                              ║
  1530. ║                                                                              ║
  1531. ║                                                                              ║
  1532. ║                                                                              ║
  1533. ║                                                                              ║
  1534. ║                                                                              ║
  1535. ║                                                                              ║
  1536. ║                                                                              ║
  1537. ║                                                                              ║
  1538. ╚══════════════════════════════════════════════════════════════════════════════╝
  1539. 1HELP  2Dir->3<-Dir4FIND 5Find->6<-Find7Disk->8<-Disk9Set->10<-Set11     12
  1540.  
  1541. Use cursor Up, Down, PgUp, PgDn, Home, End, to move about the list. 
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559. ________________________________________________________________________________
  1560. File obackup.doc                                                       Page  26
  1561. The function keys are used as follows
  1562.  
  1563. F1       Help
  1564. F2       Moves to start of next sub-directory
  1565. F3       Moves to start of previous sub-directory
  1566. F4 or F  Finds (part of) a filename. You will be prompted for a string to
  1567.          search for. Enter the string (or Esc to abandon). When you have
  1568.          entered the string, the cursor will move to the next filename 
  1569.          containing that string.
  1570. F5 or N  Finds the Next occurrence of a file name containing the string
  1571. F6 or P  Finds the Previous occurrence of a file name containing the string
  1572. F7       Moves to start of next backup disk
  1573. F8       Moves to start of previous backup disk
  1574. F9       Moves to start of next backup set
  1575. F10      Moves to start of previous backup set
  1576.  
  1577. OBACKDIR in detail
  1578.  
  1579. OBACKDIR extracts a list of all files found in a backup set. The list is 
  1580. written to the standard output, so may be redirected to a file (OBACKDIR
  1581. >filename). OBACKDIR also adds the list to OBACKUP.DIR for later 
  1582. viewing with OSHOWDIR.
  1583.  
  1584. The only switches available for OBACKDIR are ...
  1585.  
  1586.     /D = Don't test disks to see if OBACKUP /R(aw) was used
  1587.          Normally OBACKDIR tests each disk to see whether it was
  1588.     written by OBACKUP in /R(aw) mode. This switch disables this
  1589.     test. You need to use it if the backup was to a non-removable device,
  1590.     or one where the track size is greater than 32768 bytes. 
  1591.  
  1592.     /L = Don't Log backup
  1593.          Normally, OBACKDIR adds the directories of all disks to
  1594.     the file to OBACKUP.DIR, for later viewing with OSHOWDIR. The
  1595.     /L switch disables this feature. 
  1596.  
  1597. Version history
  1598.  
  1599. 2.9     Improved error detection and recovery for /W switch
  1600.         Detect write-protected disks, and report them as such
  1601.  
  1602. 2.8     Added /Wformatprogram to run cmd file if disk not readable
  1603.         Fixed problem where attribute bit was not always reset correctly
  1604.  
  1605. 2.7     Fixed problem with expiry date code in OBACKUP
  1606.         OBACKUP no longer uses all available space on large drives
  1607.         Usage messages now sent to stdout, so it can be redirected or piped
  1608.  
  1609. 2.6     /F option didn't detect old backups with the same name
  1610.         /K option added
  1611.         /Ypass option added
  1612.         New return code (3) added to ORESTORE if CRC or Read error, or 
  1613.         incorrect password.
  1614.  
  1615. 2.5     Added /O, /F and /G options.
  1616.         Improved recognition of non-raw backups in ORESTORE
  1617.         Added explanation of /S and /Q switches to help text
  1618.  
  1619. ________________________________________________________________________________
  1620. File obackup.doc                                                       Page  27
  1621. 2.4     Corrected pattern matching in ORESTORE.
  1622.         Turned off cursor while OBACKUP & ORESTORE running
  1623.         Added /Q switch to OBACKUP and /S to ORESTORE
  1624.         Allowed command files in ORESTORE.
  1625.         Changed layout of error messages ready for language translation.
  1626.         Added OS/2 error codes to more error messages in log files.
  1627.         Fixed bug where ORESTORE /V did not give an error if file on disk
  1628.          was longer than the backup (but otherwise identical).
  1629.         Fixed bug where program tried to backup directory EA's.
  1630.         Fixed bug where EA data sometimes didn't verify correctly, even if
  1631.          it was actually correct.
  1632.         Fixed bug with large command files.
  1633.         Left 4096 bytes unallocated on initial creation of OBACKDAT files
  1634.          to prevent disk full errors when writing to fixed disks.
  1635.  
  1636. 2.3     Fixed bug where ORESTORE failed to recognise 2nd and subsequent
  1637.         disks properly in non-raw backups.
  1638.         Fixed bug where ORESTORE didn't always close the archive file.
  1639.  
  1640. 2.2     Fixed bug where OBACKUP failed to recognise disks when appending
  1641.         Fixed bug where OBACKDIR failed to recognise non-raw disks
  1642.         Fixed bug where OBACKUP marked appended archives incorrectly
  1643.         Fixed bug where times were shown incorrectly
  1644.  
  1645. 2.1     Fixed minor time expiry problem with demonstration version.
  1646.  
  1647. 2.0     Introduced support for HPFS long file names and Extended Attributes.
  1648.         Fixed bug where ORESTORE sometimes failed to recognise backup disks.
  1649.         Improved compression - 16-bit compression is now used instead of 12.
  1650.         Added backup and restore error log files.
  1651.  
  1652. 1.4     Fixed bug where ORESTORE failed to detect that a file existed, so
  1653.         default mode and /Q mode didn't work correctly.
  1654.  
  1655. 1.3     Documentation changed to booklet form.
  1656.         RCS Revision numbers included.
  1657.  
  1658. 1.25    Released first full version, with owner name stamping.
  1659.  
  1660. 1.24    Changed expiry date on OBACKUP
  1661.  
  1662. 1.23    OSHOWDIR enhanced to allow more than 32k of backup directory
  1663.         Fixed other minor bugs in OSHOWDIR
  1664.         Disabled checking for non-raw backup disks if backing up in raw mode.
  1665.         (This occasionally used to hang OS/2 !)
  1666.  
  1667. 1.20    Added backup log and /L option to disable it.
  1668.         Added new program OSHOWDIR to view backup logs.
  1669.         Split distribution into two archives for easier download.
  1670.  
  1671. 1.07    Changed /I mode not to prompt if file wouldn't be restored because 
  1672.         it already exists.
  1673.         Changed expiry date on OBACKUP
  1674.  
  1675. 1.06    Fixed bug in OBACKUP which left the drive locked when changing disks
  1676.         Fixed bug in ORESTORE which wouldn't recognise some disks
  1677.         Added debug code number on OBACKUP screen to help trace faults
  1678.  
  1679. ________________________________________________________________________________
  1680. File obackup.doc                                                       Page  28
  1681. 1.04    Fixed bug that prevented ORESTORE from reading some raw backup disks
  1682.         Added dots to show progress as OBACKUP writes disks
  1683.         Added /C switch to OBACKUP to allow re-use of disks from same set
  1684.         Fixed bug that stopped OBACKUP reading old non-raw backup disks
  1685.         Made any invalid key pop OBACKUP into the background (not just Q)
  1686.         Added /E switch to OBACKUP to back up empty files and directories
  1687.         Added /T switch to ORESTORE to set all files to restore date & time
  1688.  
  1689. 1.03    Introduced ability to add to an existing backup
  1690.         Introduced ability to pop up over other sessions when changing disks
  1691.         Added OBACKDIR program.
  1692.  
  1693. 1.02    ORESTORE would only restore raw device backups (fixed).
  1694.         Improved speed of skipping files in /I mode.
  1695.         Added "Out of space" error.
  1696.         Added overwrite protection, /W and /Q switches to ORESTORE.
  1697.         Added <files to restore>
  1698.         Added /A and /C switches to ORESTORE.
  1699.         Restored files now have same date and time as original files 
  1700.         before backup.
  1701.  
  1702. 1.01    Fixed bug which always caused verify to fail.
  1703.         Included Copyright message in OBACKUP.
  1704.         Added support for raw device output (/R option).
  1705.  
  1706. 1.00    First release.
  1707.  
  1708. Other programs available from Trumphurst
  1709.  
  1710. REDIRECT        DOS printer and device redirection. Capture printer or 
  1711.                 device (including stderr) output to disk. CUA compliant,
  1712.                 mouse-driven, friendly user interface. DOS only.
  1713.  
  1714. PAGE            User-configurable ASCII document formatter. As well as
  1715.                 tidying up program listings and long documents, this
  1716.                 program will also enable you to save paper by printing in
  1717.                 reduced size fonts, with multiple pages on each sheet of
  1718.                 paper. It will also print documents in booklet form -
  1719.                 this manual was produced using PAGE. Available for DOS,
  1720.                 OS/2 and UNIX.
  1721.  
  1722. ZED             The programmers editor, as bundled with the original
  1723.                 Zortech C compiler. This updated version includes full C
  1724.                 source code. It is available for DOS, OS/2 and UNIX. 
  1725.  
  1726. C++tmUIT        Text mode user interface toolkit library for C++. 
  1727.                 Provides an easy-to-program, CUA compliant, user interface 
  1728.                 for C++ programmers. Works in DOS text mode. Full source 
  1729.                 code supplied. UNIX version in the pipeline.
  1730.  
  1731. UnixMenu        Simple front end menu system to hide UNIX from end users.
  1732.                 Comes with full C source and/or an SCO UNIX executable.
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739. ________________________________________________________________________________
  1740. File obackup.doc                                                       Page  29
  1741. DosAudit        Tracing/debugging program for DOS executables. DosAudit 
  1742.                 is a TSR which logs all file OPEN, CREATE, CLOSE, READ,
  1743.                 WRITE, EXECUTE DELETE and RENAME calls in a running 
  1744.                 program. This log can be viewed, and turned on or off, in
  1745.                 a pop-up window, and comments can be added to the log 
  1746.                 while the audited program is running. A post-processor can
  1747.                 selectively place events from the log file from straight
  1748.                 text into a comma- delimited file for importing into most
  1749.                 spreadsheets and databases for subsequent processing. 
  1750.  
  1751. Cppnews         A DOS text mode Usenet news/mail off-line reader. Ideal 
  1752.                 for users connected to the Internet via modem - cut
  1753.                 down on on-line charges by reading messages and composing 
  1754.                 replies off-line. Works with UUPC or KA9Q as the actual 
  1755.                 transfer agent.
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799. ________________________________________________________________________________
  1800. File obackup.doc                                                       Page  30
  1801.