Dec 302017
 
OS/2 Protected Mode Backup/Restore Programs - with file compression - runs with multiple threads.
File OBKUP320.ZIP from The Programmer’s Corner in
Category OS/2 Files
OS/2 Protected Mode Backup/Restore Programs – with file compression – runs with multiple threads.
File Name File Size Zip Size Zip Type
BACKALL.CMD 19 19 stored
BACKINC.CMD 30 30 stored
OBACKDIR.EXE 17889 10536 deflated
OBACKUP.EXE 60225 19690 deflated
OBACKUP.TXT 50630 12969 deflated
ORESTORE.EXE 45729 14454 deflated
OSHOWDIR.EXE 18753 10918 deflated

Download File OBKUP320.ZIP Here

Contents of the OBACKUP.TXT file






















OBACKUP, ORESTORE and OBACKDIR

OS/2 Compressing Backup and Restore utilities

$Revision: 1.4 $

Copyright (c) 1989-1991 by Trumphurst Ltd.

















Trumphurst Ltd.
The Willows
St. Martins Moor
Oswestry
Shropshire
SY10 7BH
England

Tel: (+44) 0691-670318
Fax: (+44) 0691-670316
Mail: [email protected]
nikki%[email protected]


________________________________________________________________________________
File obackup.doc Page 1
WARNING - This software is supplied without warranty of any kind. No
guarantee of reliable performance can be given. The suppliers
liability for any failure is limited to the cost of the OBACKUP
program. Users should satisfy themselves that the software performs
satisfactorily before relying on it in any way. As an absolute
minimum, perform a full verification of your first few backups using
ORESTORE /V.

Demonstration copies of this software are distributed free of charge
via computer bulletin boards. These demonstration copies will run
for a limited time only. Full versions of the software are available
from the supplier and from distributors. For details of how to obtain
a full version, see below.

OBACKUP and ORESTORE were written to provide a means of backing up data
from hard disks to floppies which would run as a protected mode
application under OS/2. In order to save media costs, the programs
compress the data as it is backed up. The algorithm used is dynamic
Lempel-Ziv compression, which normally gives compression ratios of between
40% and 60%. To increase the speed of backup, the compression algorithm
can be changed to a simple non-repeat packing method, or turned off
altogether, using a command-line switch.

OBACKUP makes full use of OS/2 threads, thus enabling it to read data from
the hard disk, compress previously read data, and write previously
compressed data to floppy at the same time. The read and compression
threads still run while the user is changing floppies.

OBACKDIR produces a listing of all the files in a backup set.

Obtaining support and licenced copies of OBACKUP

European online support for these programs is provided via CIX, the
Compulink Information Exchange. Details of CIX membership may be
obtained by telephoning the United Kingdom number 01-390-8446.

Trumphurst Ltd. can be reached via email on CIX as "nikki", or via
unix mail (internet) "[email protected]".

Trumphurst Ltd.
The Willows
St. Martins Moor
Oswestry
Shropshire
SY10 7BH
England
Tel : 0691-670318.
Fax : 0691-670316
The country code for the U.K. is 44.









________________________________________________________________________________
File obackup.doc Page 2
The Australian distributor is
Critical Software Designs
5 Magnolia St.
Daisy Hill
Queensland 4127
Australia
Tel : (07) 208 9224
Fax/BBS : (07) 808 8998
The country code for Australia is 61.

Prices

U.K. U.S. Australia
Single copy of OBACKUP.. 40.00 $60.00 $70.00
First update............ 5.00 $ 7.50 $ 8.50
Subsequent updates...... Half the full price in force at the time.

Bulk supply discounts for multiple copies serialised with the same
name and address :
10-19 copies............ 20% discount
20-49 copies............ 30% discount
30-99 copies............ 40% discount
100 or more copies...... 50% discount

Unlimited site licences and educational bulk discounts available on
request.

The reasons to back up data

Hardware failure - your hard disk can fail completely at any time !

Software failure - any program might contain a bug (defect) which could
corrupt data used by that program. Restoring a backup may allow you
to recover from such errors without re-keying all your data.

Human error - It is regrettably easy to accidentally delete files, or to
key in incorrect data.

Viruses - viruses and trojan programs may corrupt any data or programs on
your hard disk. While this event is extremely unlikely, the insurance
of sound backups could enable you to recover from the situation
painlessly.

Archival of data - Keeping some of your old backups can enable you to
restore historical data for analysis.

Normal backup proceedures

Normal backup proceedure is to backup ALL the files on your hard disk at
regular intervals. In between these full backups, you should run an
incremental backup to record files which have changed since the last full
backup. You should keep more than one set of backup disks, so that if a
backup set is corrupted for any reason, you can go to an earlier backup.





________________________________________________________________________________
File obackup.doc Page 3
Deciding on the interval between backups

You should certainly aim to be able to recover your data in the event of
a hard disk failure without undue expense in re-keying data. Most users
should do an incremental backup at least once every day. Normally, a full
backup is taken whenever the number of disks holding the incremental
backups approaches the number needed to hold a full backup.

Deciding how many backup sets to keep

In addition to any requirement for historical data, you should also take
account of any periodic checks and reports run on your data. You should
always aim to be able to restore your data to the state it was in just
after the last periodic check. If your current report shows that your data
is corrupt or incorrect in some way, you will then be able to go back to a
situation in which you know the data is correct.

As an absolute minimum, you should keep 3 backup sets (the Grandfather,
Father, Son system). Many users will require much more than this. For a
typical accounting application, for instance, you should keep 5 daily
incremental backups (one for each working day), 4 or 5 full weekly
backups (one for each week in the accounting period), and 3 full period
backups. If you have a requirement for historical data, you might also
keep 12 or 13 period sets, and 3 or more yearly sets.

How to take a backups

For a full backup of drive C:, from the OS/2 command prompt type ...

OBACKUP /S/R C:\

If you have more than one hard disk (e.g. C: and D:) you might type ...

OBACKUP /S/R C:\ D:\

To take an incremental backup, change the above to ...

OBACKUP /I/S/R C:\
or
OBACKUP /I/S/R C:\ D:\

OBACKUP creates a backup directory (called OBACKUP.DIR), listing all
the files backed up. This file is used by OSHOWDIR when listing
backup set contents. You should delete this file (first copying it
off to floppy using COPY if required) when you start a new backup
set. You can also recreate this file by running OBACKDIR on the
backup set.











________________________________________________________________________________
File obackup.doc Page 4
How to restore backups

To check that your backup can be restored correctly, from the OS/2 command
prompt type ...

ORESTORE /V

To restore a complete backup, type ...

ORESTORE /W
















































________________________________________________________________________________
File obackup.doc Page 5
OBACKUP in detail

Invoke OBACKUP from the OS/2 command interpreter (or a .CMD file) as
follows ...

OBACKUP [:[/Bnnn][/+ACDEHILNPRSTV]] [+-EHIST]

Normally, OBACKUP writes data to drive A:. If you include the
optional disk: parameter (e.g. B:), the data is written to the
specified drive.

SWITCHES - indicate switches by preceeding them with either / or +.

/Bnnn = Use nnn 8k buffers (min 8, max 500, default 120)
This changes the amount of memory OBACKUP uses. If you
find that OS/2 is having to page memory to disk while OBACKUP
is running, you may wish to set this to a smaller number than the
default 120.

/A = Add this data to the end of a previous backup.
Normally, OBACKUP creates a new backup set each time it is
run. Setting this switch causes OBACKUP to add the new data to
the end of another backup set. You should have the last disk from the
backup set ready to put in the drive.

/C = no Checking if backup disk belongs to same backup set
Normally OBACKUP will not write backup data to a disk that
belongs to the current backup set. This prevents you accidentally
over-writing a previous disk by mistake. If you are using
OBACKUP to transfer a file system from one machine to another,
this switch allows you to do it using only one (or two) floppies. If
you use this switch, please be careful not to overwrite the disk
already in the drive by mistake !

/D = Delete existing OBACKUP files on floppy disk first
Normally, OBACKUP assumes the floppy disk to be a blank,
formatted disk. If any existing OBACKUP files are found on the
disk, you will be asked if you wish to delete the old OBACKUP
files. The /D switch automatically deletes such files without asking.


NOTE: Unless OBACKUP is run in /R(aw) mode, OBACKUP never
deletes other files on the floppy disk - if you wish to do this, you
should start another OS/2 session, and delete the files from there.
You need to do this before OBACKUP starts writing to the disk.

/E = include Empty files and subdirectories in the backup.

/H = include Hidden and system files
If this switch is set, OBACKUP includes hidden and system
files (such as IBMBIO.COM and IBMDOS.COM) in the backup process.
OBACKUP never includes files which are currently in use by
another OS/2 process.





________________________________________________________________________________
File obackup.doc Page 6
/I = Incremental backup.
If this switch is set, OBACKUP skips all files which don't
have their archive bit set. OBACKUP normally resets the archive
bit on each file as it is backed up (see /T switch). Other backup
programs, including OS/2 BACKUP and XCOPY also reset this bit. The
archive bit is automatically set by OS/2 whenever a file is altered.
This switch therefore enables you to backup only files which have
changed since your last backup. You can use the OS/2 utility ATTRIB
to find out whether a file has the archive bit set. An A attribute
indicates that a file has been altered since your last backup.

/L = dont Log backup
Normally, OBACKUP logs all backup activity to the file
OBACKUP.DIR, for later viewing with OSHOWDIR. The /L switch
disables this feature.

/N = do Not compress files
Normally, OBACKUP uses dynamic Lempel-Ziv compression on
large files, to reduce the number of disks taken for a backup.
Including the /N switch speeds up the backup process by disabling
this feature. Files are copied unchanged, except for OBACKUP
control information, which is added to each block of data.

/P = Pack files (non-repeat compression)
Normally, OBACKUP uses dynamic Lempel-Ziv compression on
large files, to reduce the number of disks taken for a backup.
Including the /P switch speeds up the backup process by disabling
this feature. Files are still compressed slightly, using a faster,
non-repeat packing algorithm.

/Q = Quiet mode
Whenever OBACKUP needs a new disk, it will pop up over
whatever application you are running. Setting the /Q switch will stop
it doing this. The bell will still ring, but you will have to switch
to the OBACKUP session to change disks.

/R = Raw device output
Normally OBACKUP uses floppy disks formatted for use by
OS/2. This means that part of the available space on the disk is used
for OS/2 directories, boot sectors, FAT's etc. Also, if you try to
backup onto an unformatted disk, OBACKUP is unable to write to
that disk. Using the /R switch causes OBACKUP to use the whole
area of the disk for data. If OBACKUP is not able to write to
the disk, it attempts to format it. OBACKUP does not write to
non-removable disks in Raw mode, or to disks with a track size
greater than 32768 bytes.

NOTE: OBACKUP always attempts to use the default format
for the drive. This usually means the highest density format, so you
must use suitable disks.

/S = include files from Sub-directories
This switch causes OBACKUP to search all sub-directories
of the directories specified in for files to back up.




________________________________________________________________________________
File obackup.doc Page 7
/T = Test mode.
This switch stops OBACKUP from resetting the archive bit
on files as they are backed up (see /I switch).

/V = Verify data written to floppy
Including this switch causes OBACKUP to re-read each block
of data immediately after writing it to the floppy. If any errors are
encountered when the data is re-read, OBACKUP re-write s the
data on the next disk. This switch slows down the backup process
considerably.

may either be directory names, ambiguous file names (as
used in the DIR command) or full file names. As many pathnames as
will fit on the command line may be included. If the pathname is a
file name, that file is backed up. If the pathname is an ambiguous
file name, all files matching that name are backed up. If the
pathname is a directory name, all files on that directory are backed
up.

If a supplied pathname is an absolute pathname (i.e it starts from
the root directory - e.g. \MYDIR\MYFILE) the full pathname is
recorded in the backup, and ORESTORE will restore the file to
the same place. If the pathname contains a disk drive, the file will
also be restored to the same drive. (Note - ORESTORE has
options to over-ride this if necessary). If the pathname is relative
to the current directory (e.g. MYDIR\MYFILE), it will be restored
relative to the current directory when ORESTORE is run. It is
therefore suggested that you always specify full pathnames including
drive letters when making backups.


The E, H, I, S and T switches may be turned on (e.g. with +H) or off (e.g.
-H) at any place in the command line. These switches take effect for the
pathname to which they are attached, and for subsequent pathnames (until
turned off/on again).

Entering OBACKUP /HELP shows a brief summary of the above information.

Examples

OBACKUP B: *.*
Back up all files on the current directory to drive B:

OBACKUP /S C:\
Back up all files on all directories on drive C: to drive A:.

OBACKUP /N/V/S \
Back up all files on all directories on the current drive to drive A:.
Do not compress, but verify data written to floppy after each write.

OBACKUP B:/D/H/S/R C:\MYDIR
Back up all files (including hidden and system files) on directory
C:\MYDIR and all its subdirectories to drive B:. Use raw device mode,
so that OBACKUP can format the disks as it goes.




________________________________________________________________________________
File obackup.doc Page 8
OBACKUP C:\+S D:\-S D:\MYDIR\*.C
Back up all files on all directories on drive C:, all files on the
root directory on drive D:, and all files with extension .C on directory
D:\MYDIR, to drive A:.

OBACKUP /I/S C:\
Back up all files on drive C: which have changed since the last
backup.

Command files

You can create OBACKUP command files for regular partial backups.
An OBACKUP command file consists of an ordinary ASCII file (created
with your favourite editor or word processor in non-document mode). Each
line of the file contains an OBACKUP command. Only the first line
may contain a destination disk letter, or any of the switches D, N, P, R,
T or V.

Lines may contain comments, which are started with a semicolon.

To use a command file with obackup, type

OBACKUP @filename

where filename is the name of your command file.

Example command file

A:/D ;Backup to floppy disk A:, delete any existing backups
C:\/S ;Backup everything on drive C:
D:\-S ;Backup root directory only of drive D:
D:\MYDIR ;Backup MYDIR directory on drive D:


























________________________________________________________________________________
File obackup.doc Page 9
Prompts and status information while the program is running

The OBACKUP screen is divided into four areas. The top area (in
reverse video) shows program information, error messages, prompts to the
user, and user responses. The other areas show lists of filenames as they
are processed by each thread. The screen looks like this ...


OBACKUP OS/2 backup utility V1.3 Serial: 12345 Copyright (c) 1991 Nikki Locke
OBACKUP disk no 002 - Dated 10/Mar/1988 10:00:00

FilesBytes inBytes outTimeUser timeInputCompOutput
3 2345 0 0:12 0:04 70% 80% 50%
Writing to output




C:\OS2INIT.CMD
Compressing



C:\OS2INIT.CMD
C:\CONFIG.SYS
Reading from input


C:\OS2INIT.CMD
C:\CONFIG.SYS
C:\FORMATS.TBL


Files : Number of files processed by the "Reading from input" thread.
Bytes in : Number of bytes read by the "Reading from input" thread.
Bytes out : Number of bytes written by the "Writing to output" thread.
Time : Elapsed time (mins:secs)
User Time : Time spent waiting for disk changes
Input : Percentage efficiency of the "Reading from input" thread.
Comp : Percentage efficiency of the "Compressing" thread.
Output : Percentage efficiency of the "Writing to output" thread.

These percentage efficiencies reach 100% when the thread is waiting for
another thread to finish. They reach 0% when both the other threads are
waiting for the indicated thread.

Debug no : If there is a problem with the program hanging, or not
responding to keyboard input, please make a note of this number and the
version number of the program when reporting the problem to your
supplier.








________________________________________________________________________________
File obackup.doc Page 10
Prompts

"Insert disk 002 in drive A: and press Return"
Insert a blank floppy disk in the indicated drive, and press Return. If
you are using Raw device mode, OBACKUP will format the disk if
necessary. Otherwise, the disk must be ready formatted. If you wish, you
may format the disk (in another OS/2 session) before pressing Return.
Unless you used the /Q switch, you need to press any other key to pop
OBACKUP into the background before trying to switch sessions.

"Insert disk 002 in drive A: and press Return or D to delete old backups"
The disk you have just inserted contains data from a previous backup.
Either replace the disk with another, or press D to delete these old
backups.

"Insert disk 002 in drive A: and press Return (DISCARD THIS FLOPPY)"
A disk write or verify error (see error message on line 3) occurred while
attempting to write the first block of data onto this disk. Remove the
disk from the drive, discard it, and replace with another disk. No data
will be lost.

"Insert disk 002 in drive A: and press Return (KEEP THIS FLOPPY)"
A disk write or verify error (see error message on line 3) occurred while
attempting to write a block of data onto this disk. Remove the disk from
the drive, including it in the backup set, and insert the next disk. No
data will be lost.

Once OBACKUP has started writing to the disk, a line of dots will appear
on the prompt line, and will disappear gradually as each block of data is
written. This enables you to monitor the process, and be ready to change
the disk as the last dots go.

Error messages on line 3

"Active backup disk"
The disk you have placed in the floppy drive already contains data from
this backup.

"Not last disk"
You have specified the /A switch to add data to a previous backup, and
the disk in the drive is not the last disk of a previous backup.

"Disk verify error"
An error occurred while verifying that the data read back from the floppy
disk was the same as the data written. This block of data will be re-
written on the next backup disk.

"Disk write error"
An error occurred while writing data to the floppy disk. This block of
data will be re- written on the next backup disk.

"Error opening archive file"
OBACKUP could not create the backup file. This disk will not be used in
the backup.




________________________________________________________________________________
File obackup.doc Page 11
"Error reading floppy disk"
OBACKUP could not read any data from the floppy disk. This disk will not
be used in the backup.

"Formatting while copying"
OBACKUP (in Raw mode) is formatting the disk while copying data to it.

"Cannot format track"
OBACKUP could not format the floppy disk. This disk will not be used in
the backup.

"Not enough space on disk"
There is not enough free space on the disk. Either open another OS/2
session to delete existing files on the disk (or run CHKDSK if there
aren't any), or use another disk.

"Old backup disk"
The disk currently in the drive contains data from a previous backup. The
disk number and backup date are also displayed on line 3.

Compression methods

"Copying"
A section of file has been copied unchanged.

"Packing"
A section of file has been non-repeat packed.

"Compressing"
A section of file has been Lempel-Ziv compressed.

Different sections of the same file may use different compression methods,
depending on which method gives the best compression. The compression
method shown against a file name is the one used on the latest block of
data from the file.

"Empty file"
"Empty dir"
Indicates an empty file or directory being backed up with the /E switch.



















________________________________________________________________________________
File obackup.doc Page 12
File errors

"File in use"
OBACKUP can not open the file for reading, probably because another OS/2
process is using the file. The file is not included in the backup set.

"Empty file"
The file contains no data. Such empty files are only backed up if the /E
switch is specified.

"Read error"
An error occurred while OBACKUP was reading the file. Only data read
before the error is backed up.

"Directory depth too great - ignoring subdirectories"
OBACKUP can only handle pathnames of a limited length. The directory which
is about to be backed up has a path name which would cause this length to
be exceeded. The only way to backup files from this directory is to make
it (or its parent) the current directory, and backup from there.

Fatal errors

Any of the following errors causes OBACKUP to terminate immediately.

"Cannot handle media this size"
OBACKUP cannot handle disks with a track size of greater than 32768 bytes
in Raw mode. Do not use the /R switch when backing up to this drive.

"Non-removable media"
OBACKUP will not write to fixed disks in Raw mode. Do not use the /R
switch when backing up to this drive.

"Error opening command file"
A command file was specified using @. The file could not be
opened. Check the file name is correct.

"Invalid Bytes Per Sector"
OBACKUP can only cope with disks with 128, 256, 512 or 1024 bytes per
sector in raw mode. Do not use the /R switch when backing up to this
drive.


















________________________________________________________________________________
File obackup.doc Page 13
Internal errors

"Can't determine drive type" ***
"Can't read BPB" ***
"Creating archive bit setting thread" ***
"Creating compress thread" ***
"Creating timer thread" ***
"Creating write thread" ***
"DosQFileInfo error" ***
"Error allocating queue" ***
"Error allocating verify buffer" ***
"Error allocating write buffer" ***
"Error reading invalid queue" ***
"Error writing buffer queue" ***
"Error writing completed queue" ***
"Error writing compress queue" ***
"Error writing floppy queue" ***
"Error writing invalid queue" ***
"Error writing unknown queue" ***
"Too many queues" ***

Errors marked *** are internal OBACKUP errors. All internal
errors which cannot be explained by either another OS/2 process
accessing a file, by a bad sector on the floppy disk, or by another
hardware failure, should be reported to your supplier, as they
indicate a probable program bug. If you report an internal error,
please note down the program version number, and the debug number
(from line 4).






























________________________________________________________________________________
File obackup.doc Page 14
ORESTORE in detail

ORESTORE is invoked from the OS/2 command interpreter (or a .CMD file) as
follows ...

ORESTORE [:[/ACDIQTVW]] []

Normally, ORESTORE reads data from drive A:. Including the optional
disk: parameter (e.g. B:) causes the data to be read from the
specified drive.

/A = restore All files to subdirectories of current directory
If the backed up file name contains a disk drive letter, and/or
it is an absolute path name (starting from root - e.g. \MYDIR\MYFILE)
the /A switch overrides this, and restores the files to paths
relative to the current disk and directory. In the example, if the
current directory was C:\TOPDIR, the file would be restored as C:
\TOPDIR\MYDIR\MYFILE.

/C = restore all files to Current directory
The /C switch removes all drive letters and path details from the
file name before restoring it. This means that all the files from the
backup are restored to the current directory. If there are two files
with the same name (backed up from different directories), the second
file is not restored (subject to /Q and /W switches).

/D = Don't test disks to see if OBACKUP /R(aw) was used
Normally ORESTORE tests each disk to see whether it was written
by OBACKUP in /R(aw) mode. This switch disables this test. You need to
use it if the backup was to a non-removable device, or one where the
track size is greater than 32768 bytes.

/I = Interactive mode - query each file before restoring/verifying
Normally ORESTORE restores or verifies all the files in a
backup set. The /I switch causes ORESTORE to ask you whether to
backup, verify or ignore each file in turn. Note that this switch also
takes other behaviour into account, so existing files will be ignored
without prompting unless the /W or /Q switches are also on.

/Q = Query mode - ask before overwriting existing files
Normally ORESTORE does not overwrite existing files. The /Q switch
causes ORESTORE to ask you whether to overwrite any existing file
each time one is found.

/T = set file Times to time restored
Normally ORESTORE sets each restored file's time and date to its
original time and date before it was backed up. This switch turns off
this feature.

/V = Verify backup without restoring files
This switch enables you to check that every file in the backup
set is restorable.

/W = overWrite existing files without asking
Normally ORESTORE does not overwrite existing files. The /W switch
causes ORESTORE to overwrite existing files without asking.


________________________________________________________________________________
File obackup.doc Page 15

If you enter one or more file names or path names, only files
satisfying at least one of the names are restored. If you enter only a
file name (without disk letter or directory specifiers), all files on all
directories which match the name are restored. If you enter a path
name (with disk letter or directory specifier), only files fully matching
the path name are restored. File and path names may be ambiguous.

Entering ORESTORE /HELP shows a brief summary of the above information.

Examples

ORESTORE B:
Restores files from drive B:

ORESTORE /V/I
Asks you whether to verify each individual file in the backup set.

ORESTORE /W *.C \INCLUDE\*.*
Restores all files with extension .C in all directories, and all
files on the \INCLUDE directory, overwriting any existing files with the
same names.

Prompts and status information while the program is running

The ORESTORE screen is divided into two areas. The top area (in reverse
video) shows program information, error messages, prompts to the user,
and user responses. The other area shows the names of files as they are
restored. The screen looks like this ...


ORESTORE OS/2 restore utility V1.3 Copyright (c) 1991 Nikki Locke
OBACKUP disk no 002 - Dated 10/Mar/1988 10:00:00

DisksFilesBytes inBytes outBlockCRCVerify
0 0 0 0 0 0 0
File names

















(D:\MYDIR\) MYFILE
MYFILE.DAT


________________________________________________________________________________
File obackup.doc Page 16
Disks : Number of disks processed so far
Files : Number of files restored/verified
Bytes in : Number of bytes read from floppy disk
Bytes out : Number of bytes written/verified to hard disk
Block : Number of block errors
CRC : Number of file CRC errors
Verify : Number of file verify/open errors

Prompts

"Insert disk 002 in drive A: and press Return "
Place the next disk in the backup set in the floppy drive, and press
Return.

"Insert disk 002 in drive A: and press Return or R to restart from this disk"
The disk in the drive is not the next disk in the backup sequence. Either
place the correct disk in the drive, and press Return, or press R to
continue restoring data from the first file found on this disk. If you
press R, any file which has been partially restored from the previous
disk is not restored correctly.

"Verify this file (y/n)"
"Verify this directory exists (y/n)"
When the /I and /V switches are in use, this prompt is shown for each
file found in the backup set. Press Y to verify this file, or N to skip
to the next file in the set.

"Restore this file (y, n or v to verify only)"
"Restore this directory (y, n or v to verify only)"
When the /I switch is in use, this prompt is shown for each file found in
the backup set. Press Y to restore this file, V to verify this file is
the same on the hard disk is it is in the backup, or N to skip to the
next file in the set.

"File exists - overwrite (y/n)"
When the /Q switch is in use, this prompt is shown for each file in the
backup set which already exists on the hard disk. Press Y to overwrite
the existing file with the backup copy, or N to skip to the next file in
the set.



















________________________________________________________________________________
File obackup.doc Page 17
Error messages on line 4

"Decompression error - Abort, Skip to next file, Next floppy" ***
An unexpected error has occurred while trying to decompress a block of
data. Press A to abort the program, S to restart from the next file in the
backup set, or N to restart from the first file on the next floppy. The
current file is not restored correctly.

"Floppy CRC error - Abort, Retry, Ignore, Skip file, Next floppy" ***
The CRC check on the validity of a data block read from the floppy has
failed. Press A to abort the program, R to re-read the data, I to ignore
the error (this may give rise to further errors later), S to restart from
the next file in the backup set, or N to restart from the first file on
the next floppy. If you press S or N, the current file is not restored
correctly.

"Floppy read error - Abort, Retry, Skip file, Next floppy"
A read error occurred while trying to read a data block from the floppy
has failed. Press A to abort the program, R to re-read the data, S to
restart from the next file in the backup set, or N to restart from the
first file on the next floppy. If you press S or N, the current file will
not have been restored correctly.

"Invalid data block - Abort, Skip to next file, Next floppy" ***
A data block contained an invalid header. Press A to abort the program, S
to restart from the next file in the backup set, or N to restart from the
first file on the next floppy. The current file is not restored correctly.

"Invalid data CRC - Abort, Ignore, Skip to next file, Next floppy" ***
The CRC check on the validity of a data block has failed. Press A to
abort the program, I to ignore the error (this may give rise to further
errors later), S to restart from the next file in the backup set, or N to
restart from the first file on the next floppy. If you press S or N, the
current file is not restored correctly.

Error messages on line 3

"Not an OBACKUP disk"
The disk in the drive was not written by OBACKUP.

"Error opening archive file"
ORESTORE could not open the archive file. Probably the drive is in use by
another OS/2 process.

"Disk out of sequence"
The disk in the drive is not the next disk in sequence.

"Wrong OBACKUP set"
The disk in the drive is from a different OBACKUP set.









________________________________________________________________________________
File obackup.doc Page 18
File errors and messages

"Verified OK"
The file on the hard disk is the same as the one in the backup.

"Restored OK"
The file was restored correctly.

"Skipped"
The file is not being restored, either because it does not match the file
name list provided when ORESTORE was invoked, or because you asked to
skip it in interactive mode.

"Write error"
A write error occurred when trying to write data to the file. The file on
the hard disk was deleted.

"Verify error"
The file on the hard disk does not match the file in the backup set.

"Read error"
A read error occurred when trying to verify the file.

"CRC error"
The stored CRC of the backed up file did not match the CRC calculated from
the data written to the file. This usually means that part of the data was
skipped due to an earlier error. The file is not deleted, but probably
contains incorrect data.

"Not created"
ORESTORE was unable to create the file. The file is probably in use by
another OS/2 process.

"Disk full"
There is insufficient space on the disk to restore the file. This file is
not restored.

"File exists"
The file already exists on the hard disk and the /W switch is not in
operation.

"Invalid path"
ORESTORE was unable to create the directories necessary to restore the
file. Perhaps one of the directory names in the path is already in use as
a file.

"Not found"
ORESTORE tried to open the file on the hard disk for verification, and
the file could not be opened.









________________________________________________________________________________
File obackup.doc Page 19
Fatal errors

Any of the following errors will cause ORESTORE to terminate immediately.

"Decompression error - Aborted"
"Floppy disk read - Aborted"
"Invalid data block - Aborted"
The stated error occurred, and Abort was selected at the error prompt.

"Too many arguments"
ORESTORE can only accept up to 31 arguments.

Internal errors

"Can't read BPB" ***
"Error allocating verify buffer" ***
"Error allocating decompress buffer" ***
"Error allocating write buffer ***"
"Error allocating read buffer" ***
These are internal ORESTORE errors.

Errors marked *** which cannot be explained by either another OS/2
process accessing a file, by a bad sector on the floppy disk, or by
another hardware failure, should be reported to your supplier, as
they indicate a probable program bug.

































________________________________________________________________________________
File obackup.doc Page 20
OBACKDIR in detail

OBACKDIR extracts a list of all files found in a backup set. The list is
written to the standard output, so may be redirected to a file (OBACKDIR
>filename). OBACKDIR also adds the list to OBACKUP.DIR for later
viewing with OSHOWDIR.

The only switches available for OBACKDIR are ...

/D = Don't test disks to see if OBACKUP /R(aw) was used
Normally OBACKDIR tests each disk to see whether it was
written by OBACKUP in /R(aw) mode. This switch disables this
test. You need to use it if the backup was to a non-removable device,
or one where the track size is greater than 32768 bytes.

/L = dont Log backup
Normally, OBACKDIR adds the directories of all disks to
the file to OBACKUP.DIR, for later viewing with OSHOWDIR. The
/L switch disables this feature.







































________________________________________________________________________________
File obackup.doc Page 21
OSHOWDIR in detail

OSHOWDIR allows you to review backup logs created with OBACKUP and
OBACKDIR. It is intended to upgrade it to become the user interface to
ORESTORE, so you can pick which files to restore. Please feel free to
comment on the user interface.

When OSHOWDIR is invoked, it reads in the OBACKUP.DIR file, and displays
the first screenfull of files, which looks like this ...

Disk Date Time Size Name
15/Aug/1989 14:04:04 New Backup
001 15/Aug/1989 14:04:04 12345 OBACKUP.TST
001 15/Aug/1989 14:04:04 2486 TESTFILE.001
001 15/Aug/1989 14:04:04 1234 TESTFILE.002
001 15/Aug/1989 14:04:04 56342 TESTFILE.003
002 15/Aug/1989 14:04:04 12345 TESTFILE.004

..... etc .....



















1HELP 2Dir->3<-Dir4FIND 5Find->6<-Find7Disk->8<-Disk9Set->10<-Set11 12

Use cursor Up, Down, PgUp, PgDn, Home, End, to move about the list.

















________________________________________________________________________________
File obackup.doc Page 22
The function keys are used as follows

F1 Help
F2 Moves to start of next sub-directory
F3 Moves to start of previous sub-directory
F4 or F Finds (part of) a filename. You will be prompted for a string to
search for. Enter the string (or Esc to abandon). When you have
entered the string, the cursor will move to the next filename
containing that string.
F5 or N Finds the Next occurrence of a file name containing the string
F6 or P Finds the Previous occurrence of a file name containing the string
F7 Moves to start of next backup disk
F8 Moves to start of previous backup disk
F9 Moves to start of next backup set
F10 Moves to start of previous backup set

Version history

1.4 Fixed bug where ORESTORE failed to detect that a file existed, so
default mode and /Q mode didn't work correctly.

1.3 Documentation changed to booklet form.
RCS Revision numbers included.

1.25 Released first full version, with owner name stamping.

1.24 Changed expiry date on OBACKUP

1.23 OSHOWDIR enhanced to allow more than 32k of backup directory
Fixed other minor bugs in OSHOWDIR
Disabled checking for non-raw backup disks if backing up in raw mode.
(This used to occasionally hang OS/2 !)

1.20 Added backup log and /L option to disable it.
Added new program OSHOWDIR to view backup logs.
Split distribution into two archives for easier download.

1.07 Changed /I mode not to prompt if file wouldn't be restored because
it already exists.
Changed expiry date on OBACKUP

1.06 Fixed bug in OBACKUP which left the drive locked when changing disks
Fixed bug in ORESTORE which wouldn't recognise some disks
Added debug code number on OBACKUP screen to help trace faults

1.04 Fixed bug that prevented ORESTORE from reading some raw backup disks
Added dots to show progress as OBACKUP writes disks
Added /C switch to OBACKUP to allow re-use of disks from same set
Fixed bug that stopped OBACKUP reading old non-raw backup disks
Made any invalid key pop OBACKUP into the background (not just Q)
Added /E switch to OBACKUP to back up empty files and directories
Added /T switch to ORESTORE to set all files to restore date & time

1.03 Introduced ability to add to an existing backup
Introduced ability to pop up over other sessions when changing disks
Added OBACKDIR program.


________________________________________________________________________________
File obackup.doc Page 23
1.02 ORESTORE would only restore raw device backups (fixed).
Improved speed of skipping files in /I mode.
Added "Out of space" error.
Added overwrite protection, /W and /Q switches to ORESTORE.
Added
Added /A and /C switches to ORESTORE.
Restored files now have same date and time as original files
before backup.

1.01 Fixed bug which caused verify to always fail.
Included Copyright message in OBACKUP.
Added support for raw device output (/R option).

1.00 First release.

Other programs available from Trumphurst

REDIRECT DOS printer and device redirection. Capture printer or
device (including stderr) output to disk. CUA compliant,
mouse-driven, friendly user interface. DOS only.

PAGE User-configurable ASCII document formatter. As well as
tidying up program listings and long documents, this
program will also enable you to save paper by printing in
reduced-size fonts, with multiple pages on each sheet of
paper. It will also print documents in booklet form -
this manual was produced using PAGE. Available for DOS,
OS/2 and Unix.

ZED The programmers editor, as bundled with the original
Zortech C compiler. This updated version includes full C
source code. It is available for DOS, OS/2 and Unix.

C++tmUIT Text mode user interface toolkit library for C++.
Provides an easy-to-program, CUA compliant, user interface
for C++ programmers. Works in DOS text mode. Full source
code supplied. Unix version in the pipeline.





















________________________________________________________________________________
File obackup.doc Page 24


 December 30, 2017  Add comments

Leave a Reply