                                                                     backup
Chapter 7 File Management

Because every system has a finite amount of hard disk space, it is important to
be able to archive map data when it is no longer needed  on the system.  The
backup command provides a means for moving all of the files associated with a
map name to a  user-designated offline storage medium.  This command looks for
the storage location identified in the config file.  It is important that both
the source (named or current map) and destination (bkup_path) path names be
correct (see config).  The actual backup command is created from three fields
in the config file: bkup_path, bkup#1 and bkup#2, where # is either the number
1 or 2.  These fields are wrapped around the current map name.  Thus, you may
backup using any of the UNIX/XENIX system commands that you want to use
including backup, tar, or cpio.  The bkup_path field is used when no parameters
are used.  It will precede the name of the current map when making the system
call.  Usage of the backup command is as follows:

backup

    Initiates backup of specified map data.
     
         backup [num] [name]

    Copies the files for the named map name (default is the current map) using
    the command prefix defined by the value of num.  It may have a value of 1
    or 2, and refers to the bkup#1 and bkup#2 parameters in the config file
    (note that num is substituted for the # sign).  By default, the current,
    active map is archived to the device identified by bkup_path using a tar
    format.  The bkup_path element in the config file names the device to which
    the backup is directed. Common device names are:

                             TAPE                     FLOPPY
         For UNIX:      /dev/rmt/c0s0            /dev/rdsk/f0 (or f1)
         For XENIX:     /dev/rct0                /dev/rfd0  (or rfd1)
    ___________________________________________________________________________
    Options/arguments:

         num       Number of backup prefix and suffix to use for creating
                   backup command.  Valid values are 1 or 2.
         name      Map name.  Default is the current map.
    ___________________________________________________________________________
    Example(s):

    To make a copy of the data files associated with the map called cub using
    bkup11 and bkup12 from the config file, (bkup11 = ls and bkup12 is | cpio
    -ocBv -O /dev/rdsk/f0q15d), enter:
     
         backup 1 cub
     
    The result is a system command:
     
         ls /u[sr]/ltp/maps/cub | cpio -ocBv -O /dev/rdsk/f0q15d



    To make a backup copy of the data files associated with the current, active
    map (which, by default, is at the maps_path directory) to the bkup_path
    which is set to /dev/rdsk/f0, enter:
     
         backup
    ___________________________________________________________________________
    See also:

              catalog, config, retrieve, save
    ___________________________________________________________________________
