@database "MRBackup"

Copyright (c) 1992 MRsoftware, Portsmouth, RI

@master "MRBackup:Help/MRBackup.guide"
@Remark $VER: MRBackup 1.14 (03.31.93)
@Remark AmigaGuide database for MRBackup Professional

@node main "MRBackup Professional"

Welcome to MRBackup Professional!

    @{" Introduction " Link "Introduction" }
        @{" Installation " Link "Installation" }
        @{" Operation    " Link "Operation" }

    @{" Backups   " Link "MRBackup:Help/MRB_Backups.guide/main" }
    @{" Restores  " Link "MRBackup:Help/MRB_Restores.guide/main" }
    @{" Utilities " Link "MRBackup:Help/MRB_Utilities.guide/main" }

    @{" User Interface  " Link "MRBackup:Help/MRB_Interface.guide/main" }
    @{" ARexx Interface " Link "MRBackup:Help/MRB_ARexx.guide/main" }

    @{" Data Compression " 
        Link "MRBackup:Help/MRB_Compression.guide/main" }
    @{" Filter Files "
        Link "MRBackup:Help/MRB_Filters.guide/main" }
    @{" MRBackup SCSI Tape Support " 
        Link "MRBackup:Help/MRB_SCSITape.guide/main" }

    @{" Tips ", Link "MRBackup:Help/MRBackup_Tips.guide/main" }

    @{" Technical Support " Link "Technical Support" }

    @{ "About the Author  " Link "About the Author" }

@endnode main

@node "Introduction"
MRBackup is a hard disk backup program for the Commodore Amiga family of
computers.  It provides a wide range of services to support Amiga file
management and backup/restore of files to/from hard disk.  Files can be
backed up to:

·   Floppy disk, in AmigaDOS format

·   Floppy disk, in a special "fast" format

·   Any sequential file or device (local or networked) in "fast" format

·   SCSI streaming tape

A save-set catalog file is created for each save-set, allowing quick
retrieval of individual files when necessary.  Should the catalog file
become damaged or lost, MRBackup can recreate it by scanning the save-set.

MRBackup is designed to behave well in your Amiga's multi-tasking
environment.  It does not "take over the machine" and will allow you to use
your Amiga for other chores while backups are being performed.  MRBackup is
controlled by a flexible set of user-configurable parameters and offers a
wide range of backup and restore options.  Its Intuition-based user
interface is designed for a pleasing appearance and ease of operation.
MRBackup uses the Amiga's speech capabilities to provide an effective means
for presenting prompts, error conditions and requests for floppy disk
insertions, etc.  MRBackup provides optional data compression which will
reduce the number of diskettes required for a backup.

Requirements
·   any Amiga system with at least 1 MB memory and WorkBench 1.3 or higher

·   the Amiga Resource Project (ARP) library (arp.library), V39.1 or higher
    (supplied with MRBackup)

·   at least 1 floppy disk drive or SCSI streaming tape drive (Archive Viper,
    Wangtek 50XX, TEAC 36XX, Sony DAT, etc.  )

MRBackup will work with any hard drive supported by the AmigaDOS operating
system.

@endnode


@node "Installation" "Installation Instructions"
As always, prior to installing any new software, make a working copy of the
original diskette.  Use the working copy, not the original diskette, for
the installation process.  The new installation procedure for MRBackup
Professional will copy all files to a disk partition or a directory within
a partition (recommended).  MRBackup's support files have been grouped
according to category into several subdirectories which will be created
within the partition or directory which you specify for installation.  You
may wish to make backup copies of any ".init" or filter files which you
created for use with previous versions of MRBackup Professional.  They are
still upward compatible with this release of the software.

Insert the MRBackup Professional working copy disk into an available floppy
drive and double-click on its disk icon.  Find the icon labeled
"Install-MRBackup" and double-click it.  This will run a script which will
install MRBackup Professional.

IMPORTANT NOTE:  this version of the software requires the definition of an
AmigaDOS logical name, MRBackup:.  This name is equated to the name of the
partition or directory where MRBackup Professional is installed and must be
created/assigned prior to installation.  Example:

   MAKEDIR DH0:MRBackup
   ASSIGN MRBackup: DH0:MRBackup

It is recommended that you also place the ASSIGN statement in your
startup-sequence (s:StartupII, s:user-startup, etc.) to assure that the
MRBackup:  logical name will always be available whenver you reboot your
system.


The MRBackup: Directory 
This section briefly describes the contents of the MRBackup directory.
None of the subdirectories in this directory are an absolute requirement
but it is strongly suggested that you adopt this configuration.

Files in the MRBackup: Directory
The following files will be found at the top level of the MRBackup:
directory.

Compressor
This program file is MRBackup Professional's data compression "engine".  It
is automatically started by MRBackup Professional when data compression or
decompression is requested.

FormatDisk
This is a shell script file, invoked by MRBackup Professional when a backup
disk is to be formatted (AmigaDOS backup mode).  DO NOT use this script for
general-purpose formatting of disks as it is not intended for that purpose.

MRBackup
This is the MRBackup Professional program file. 

Subdirectories in the MRBackup: Directory
The MRBackup:  directory contains several subdirectories.  These
subdirectories provide a means for grouping files with a similar purpose.

ARexx_Scripts
This directory contains a number of example ARexx scripts for use with
MRBackup Professional.  Use these as a guide for writing your own ARexx
scripts.

Catalogs
Use this directory as a repository for catalog files created by the backup
process.

Docs
This directory contains several small document files providing additional
information and details not available in the user manual.  The file named
Changes in this directory describes last-minute changes that could not be
included in the user manual.

Lists_and_Logs
Use this directory to store listing and log files created by MRBackup
Professional.

Prefs
This directory contains various MRBackup Professional "preferences" files
including the MRBackup.init file and the filter file templates.  You may
also use this directory to save your custom preferences files.

Work
This is the default MRBackup working directory, used to store temporary
files created by MRBackup during backup and restore operations.
@endnode

@node "Operation"
This manual assumes that you already know the basic operating principles of
your Amiga and that you are familiar with its user interface.  If this
manual refers to an Amiga-specific procedure or feature with which you are
not familiar, please refer to your Amiga owner's manual.

MRBackup may be started from the WorkBench by double-clicking its program
icon or from the CLI by typing the appropriate command line.  The startup
procedures for each environment are presented below.

Working Directory
MRBackup requires an area for storing certain temporary information during
the backup process.  This area is called the "working directory".  The
working directory defaults to MRBackup:Work, but you may override this
setting.  The next two sections describe how this is done.

MRBackup may be run from either the Command Line Interface (CLI) or the
WorkBench. 

    @{" CLI Operation " Link "CLI Operation" }

    @{" WorkBench Operation " Link "WorkBench Operation" }

@endnode

@node "CLI Operation"
To start MRBackup from the CLI (Command Line Interface, also called the
"Shell"), you can just type MRBackup at the command prompt.  MRBackup
supports several command-line options which override its default behavior.
These are:  -d <default_directory> This option instructs MRBackup to search
<default_directory>, rather than MRBackup:Prefs, when looking for
preferences files.

-i <init_file>
This option instructs MRBackup to initialize from <init_file>, rather than
MRBackup:Prefs/MRBackup.init or MRBackup.init in the local directory.

-p <default_directory>
This option is essentially the same as the -d option.

-w <work_directory>
This option instructs MRBackup to use <work_directory>, rather than
MRBackup:Work, as the working directory.
@endnode "CLI Operation"

@node "WorkBench Operation"
To start MRBackup from the WorkBench, simply double-click its program icon
or an MRBackup project icon.  MRBackup supports several icon Tool Types
entries which can override its default behavior.  To add or modify the Tool
Types entries, you must use the Info command in the WorkBench menu.  Refer
to your Amiga owner's manual if you are unfamiliar with this procedure.

MRBackup recognizes the following Tool Types entries:

DIR=<default_directory>
PREFS=<default_directory>
These Tool Types are identical and instruct MRBackup to search
<default_directory>when attempting to locate the preferences file.

WINDOW=<console_spec>
This Tool Type entry instructs MRBackup to open its "background" console
window according to <console_spec> which should be a valid CON:  window
specification (e.g.  CON:0/0/640/200/MRBackup ).

WORK=<work_directory>
This Tool Type instructs MRBackup to use <work_directory>, rather than
MRBackup:Work, as the default working directory.

If you really want to get clever, you can make copies of MRBackup's project
icon file (MRBackupDefault.info) and tune the Tool Types entries for each
hard disk partition.  How is this done?  Using the CLI COPY command, make a
copy of MRBackupDefaults.info for each partition.  Example:

   (CD to the directory where MRBackup resides)
   COPY MRBackupDefaults.info MRBackup-DH0.info
   COPY MRBackupDefaults.info MRBackup-DH1.info
   (etc.)

For each icon, make the appropriate changes to  the Tool Types entries.
@endnode "WorkBench Operation"

@node "Technical Support"

If   you   have  a  problem  with  MRBackup,  think  you've  discovered  an
"undocumented  feature"  or just need help, please call!  We'll do our best
to  help  you get the most out of MRBackup Professional.

    MRsoftware
    348 Indian Avenue
    Portsmouth, RI  02871

    (401) 846-7639

    Usenet:     mrr@mrsoft!network23.com

    BIX:        markr, 
                amiga.vendors/mrsoftware

@endnode "Technical Support"

@node "About the Author"

Mark Richard Rinfret
Born:           Exeter, NH  12/27/49
Hair Color:     Brown
Eyes:           Two! (Hazel)
Height:         6' 0"
Weight:         NOYB! :-)
Marital Status: Married


Professional Status

I'm currently a self-employed software consultant with over 18 years of
software design/development and systems administration experience on a wide
variety of military and commercial computer platforms and operating
systems, including:

    Amiga
    AN/UYK-7, AN/UYK-44, AN/UYK-20
    DEC VAX, PDP-15, PDP-8
    Texas Instruments micros and minis
    Macintosh
    PC/Windows
    Sun workstations
    Silicon Graphics workstations


My computer language experience includes:

    C, C++, Ada, Pascal, CMS-2, SPL-I, FORTRAN, BASIC, FORTH, and
    various assembly languages

I've also recently acquired much experience with the Oracle database
manager (V6, VAX) and SQL at both the scripting and API levels.


Amiga!

I bought my first Amiga in 1987 and have been committed to the Amiga ever
since.  I currently own an A2500/030 and an A2000 (my son's machine, also
used for testing). For the curious, my system configuration includes:

    A2500/030, 5MB RAM
    A2091 SCSI Controller
    Quantum LPS-240S (internal)
    Quantum P105S (external)
    Sony SMO-E501 5 1/4" magneto-optical drive (281 MB per side, removable)
    Tandberg 3600 series 150MB tape drive
    SupraFAX modem
    Panasonic KXP-4455 laser printer

I'm currently registered with CATS as a certified developer.  My system is
a registered Usenet node (mrsoft@network23.com) and I am on BIX frequently
as "markr".

My fondest desire is to be able to develop software tools full-time for the
Amiga, though the "real world" often makes demands which pull me in other
directions.


Other Details

I'm married to Penny (a.k.a.  Clotilde), my wife of 18 years (no - that's
not her age, that's how long we've been married!) and I'm a happy (young!)
grandfather of five little Thumpers, an active member of my church (former
parish council chairman, school board vice chairman) and currently the
Deputy Grand Knight of the Middletown, RI Knights of Columbus, Council
#4201.  I love music and can play the saxophone (fairly well), the guitar
(so-so) and can stumble around a keyboard.  I have a somewhat offbeat sense
of humor and love a good chuckle, even at my own expense.


Skills for Hire!

If you represent a software house or organization which could benefit from
my skills, please call or write:

    MRsoftware
    348 Indian Avenue
    Portsmouth, RI  02871
    (401) 846-7639

    Usenet:     mrr@mrsoft.network23.com
    BIX:        markr
                amiga.vendors/mrsoftware

I'm willing to consider firm fixed price or time and materials contracts.
I'll be happy to send you a resume and list of references. Heck - if you
just represent yourself and want to call or write, be my guest! I love
mail.

@endnode "About the Author"
