home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dskutl / ibuv2.arc / IBU.DOC < prev    next >
Text File  |  1988-03-26  |  64KB  |  1,893 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.           INTERACTIVE BACKUP UTILITY V2.00
  19.  
  20.  
  21.  
  22.  
  23.           03-26-1988
  24.  
  25.  
  26.           Mike Hodapp
  27.  
  28.           5609 Apache Road
  29.           Louisville, KY
  30.           40207
  31.  
  32.  
  33.  
  34.                           INTERACTIVE BACKUP UTILITY V2.00
  35.  
  36.           CONTENTS
  37.  
  38.  
  39.             INTERACTIVE BACKUP UTILITY USERS GUIDE ...................... 1
  40.             INTRODUCTION ................................................ 1
  41.               OVERVIEW .................................................. 1
  42.               CAPABILITIES .............................................. 2
  43.               BENEFITS .................................................. 4
  44.               HARDWARE REQUIREMENTS ..................................... 4
  45.               SOFTWARE REQUIREMENTS ..................................... 4
  46.             HOW TO USE THE PROGRAM ...................................... 5
  47.               INVOCATION ................................................ 5
  48.               DRIVE SELECTION ........................................... 6
  49.               CUSTOMIZING THE PROGRAM OPTIONS.  ......................... 7
  50.               FUNCTIONS AVAILABLE WHILE DISPLAYING FILE NAMES .......... 10
  51.               OTHER KEYS SUPPORTED WHILE DISPLAYING FILE NAMES ......... 13
  52.               COLOR ADAPTER CONTROL WHILE DISPLAYING FILE NAMES ........ 15
  53.  
  54.             Appendix A: FILE NAME DISPLAY SCREEN ....................... 17
  55.  
  56.             Appendix B: RESTART DISPLAY SCREEN ......................... 19
  57.  
  58.             Appendix C: MESSAGES ....................................... 20
  59.  
  60.             Appendix D: USER SUPPORTED SOFTWARE CONCEPT ................ 26
  61.               AVAILABILITY ............................................. 26
  62.               COPYING .................................................. 26
  63.               DISCLAIMER ............................................... 26
  64.               PERMISSION TO COPY ....................................... 26
  65.               THE USER-SUPPORTED CONCEPT ............................... 27
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.           Contents                                                       ii
  94.  
  95.  
  96.                           INTERACTIVE BACKUP UTILITY V2.00
  97.  
  98.           INTERACTIVE BACKUP UTILITY USERS GUIDE
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.           INTRODUCTION
  106.  
  107.  
  108.  
  109.  
  110.  
  111.           OVERVIEW
  112.  
  113.  
  114.           The  Interactive  Backup  Utility  provides an  easy  method  for
  115.           backing up new or modified disk and diskette files.  Some of it's
  116.           features include:
  117.  
  118.           *   Operates as a DOS command.
  119.  
  120.           *   Displays the space required  on the target  disk/diskette for
  121.               the backup operation.
  122.  
  123.           *   Displays the amount of free space on both the source  and the
  124.               target disk/diskette.
  125.  
  126.           *   Provides a full screen display of the file names selected for
  127.               backup, and provides for scrolling of the display.
  128.  
  129.           *   Provides 7 sorting sequences for the file display.
  130.  
  131.           *   Allows  files  selected for backup to be marked for exclusion
  132.               from backup.
  133.  
  134.           *   Allows files selected for backup to be marked for deletion.
  135.  
  136.           *   Allows files marked for exclusion or  deletion to be unmarked
  137.               prior to actually being excluded or deleted.
  138.  
  139.           *   Provides a display of the function key definitions; functions
  140.               assigned  to shifted function keys, Ctrl-function  keys,  and
  141.               Alt-function keys are displayed when the shift,  Ctrl  or Alt
  142.               keys are held down.
  143.  
  144.           *   Can  be invoked  once  and used any  number of  times without
  145.               having to be invoked again.
  146.  
  147.           *   Will  copy any valid DOS file including those with the hidden
  148.               file attribute; zero length  files, including  volume  labels
  149.               and sub-directory entries are not copied.
  150.  
  151.           *   Allows  paths to  be specified  for  both  source  and target
  152.               disk/diskettes.
  153.  
  154.  
  155.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          1
  156.  
  157.  
  158.                           INTERACTIVE BACKUP UTILITY V2.00
  159.  
  160.           *   Allows  permanent or temporary  modification  of the function
  161.               key definitions.
  162.  
  163.           *   Allows permanent  or  temporary  modification  of the  colors
  164.               displayed if a color monitor is being used.
  165.  
  166.           *   Allows permanent  and temporary specification of backup based
  167.               on the file's date, the file's archive attribute or both  the
  168.               file's date and archive attribute.
  169.  
  170.           *   Allows  permanent and temporary specification  of the default
  171.               source and target drives.
  172.  
  173.           *   Allows permanent and temporary specification of the amount of
  174.               memory to reserve for DOS's COMMAND.COM.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.           CAPABILITIES
  182.  
  183.  
  184.           This utility is designed to be an extension to DOS and is invoked
  185.           like  any other  DOS command.  As  with  many  of  the  other DOS
  186.           commands,  file specifications and an optional  parameter  may be
  187.           entered on the command line when invoking  the program.  The file
  188.           specifications are used  to qualify the names of the files to  be
  189.           backed up as well as the names of the backup files themselves.
  190.  
  191.           The backup copy of a file may be on  the same disk or diskette as
  192.           the original file if its filename  or extension is different than
  193.           the original file.
  194.  
  195.           The names  of all  files which  are  candidates  for  backup  are
  196.           displayed  for you to examine. A  file  becomes a candidate based
  197.           on:
  198.  
  199.           1.  its directory date and time compared to the date and  time of
  200.               its backup file,
  201.  
  202.           2.  its archive attribute, or
  203.  
  204.           3.  both of the these.
  205.  
  206.           You can customize the program for one of these options.
  207.  
  208.           Files may  be  excluded from the  display and as  candidates  for
  209.           backup  via function  key.  It  is also possible  to delete files
  210.           that have been selected  for backup  by pressing a function  key.
  211.           The exclusion and deletion actions  are  "marked" on  the display
  212.           and do  not actually  take place until  you  press  the "Process"
  213.           function key or the "RUN" function key.  This two step  procedure
  214.           reduces the possibility  of  accidents, especially in the case of
  215.  
  216.  
  217.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          2
  218.  
  219.  
  220.                           INTERACTIVE BACKUP UTILITY V2.00
  221.  
  222.           deletions.
  223.  
  224.           Files  marked  for exclusion or  deletion may also be "Unmarked".
  225.           The unmarking may  be  done  individually  or  all  marks  can be
  226.           "Reset" at the same time.
  227.  
  228.           The display heading reflects the file  specifications  entered at
  229.           invocation or  restart time, the amount of space required for the
  230.           backup,  the  amount of free  space on both  the source  and  the
  231.           target  disk/diskette,  and the  invocation  time  and date.  See
  232.           "Appendix A: FILE NAME DISPLAY SCREEN" on page 17.
  233.  
  234.           The body  of  the display contains a  line for each file selected
  235.           for backup and a second line  for the backup file.  Each of these
  236.           display  lines contains the date and time of the  file as well as
  237.           its size and file attributes.
  238.  
  239.           The last line of the display  shows the function key definitions.
  240.           The  last  line  of the display  will also  be  used  to  display
  241.           messages generated by the utility.
  242.  
  243.           You can sort the display into any of seven sequences via function
  244.           keys.
  245.  
  246.           The  Esc key  is a "Quit" key; it  takes you up  a  level  in the
  247.           hierarchy of display screens or terminates the program if you are
  248.           at  the restart screen.  You  may also define a function key as a
  249.           "Quit" key for the file display screen.
  250.  
  251.           The utility can be restarted without having to be  invoked again.
  252.           The restart screen  allows you to reuse or modify previous backup
  253.           file specifications, or terminate  the  utility.  This eliminates
  254.           having to reload the program from disk/diskette for each use when
  255.           you  have several  diskettes  or  subdirectories to  backup.  See
  256.           "Appendix B: RESTART DISPLAY SCREEN" on page 19.
  257.  
  258.           Any valid DOS  file may be copied for backup.  Zero  length files
  259.           are  not  considered valid files and  will  not  be  copied.  Any
  260.           attempt to backup  a zero length file will  be ignored during the
  261.           actual copy  processing.  Subdirectory entries will not be copied
  262.           since they are  zero length files.
  263.  
  264.           Paths   are  fully  supported  allowing  you  to  copy  from  any
  265.           subdirectory to any other subdirectory.
  266.  
  267.           Some care is  required when using the Interactive Backup  Utility
  268.           to backup or copy the two files IBMBIO.COM and IBMDOS.COM.  These
  269.           two files  are the DOS system modules loaded into memory when you
  270.           start DOS.  They  need to  be  the  first  files  physically on a
  271.           volume;  they are  normally placed properly by the DOS  FORMAT or
  272.           SYS commands.  While  the Interactive  Backup  Utility  will copy
  273.           these files,  it cannot guarantee  copying them to their required
  274.           locations for creating a DOS system.  They will be copied  to the
  275.           first "available" sectors on the target disk/diskette.
  276.  
  277.  
  278.  
  279.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          3
  280.  
  281.  
  282.                           INTERACTIVE BACKUP UTILITY V2.00
  283.  
  284.  
  285.  
  286.  
  287.  
  288.           BENEFITS
  289.  
  290.  
  291.           The  major  benefit  of  the Interactive  Backup  Utility is  its
  292.           display  of the files selected  for  backup.  This allows you  to
  293.           override and  refine the  selection process  prior to  any backup
  294.           action.
  295.  
  296.           You  are informed about  the  space requirements and  alerted  if
  297.           enough space is not available on the backup disk/diskette.
  298.  
  299.  
  300.  
  301.  
  302.  
  303.           HARDWARE REQUIREMENTS
  304.  
  305.  
  306.           The  Interactive Backup Utility requires two  diskette drives (or
  307.           one diskette drive and one disk) and an eighty column display.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.           SOFTWARE REQUIREMENTS
  314.  
  315.  
  316.           The  Interactive Backup Utility  has  been  written in  assembler
  317.           language to minimize its size and maximize its speed.
  318.  
  319.           The Interactive Backup Utility requires the IBM Personal Computer
  320.           Disk  Operating System (DOS) version 2.00 or later.  It  has been
  321.           tested with DOS versions 2.00, 2.10, 3.20 and 3.30.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          4
  342.  
  343.  
  344.                           INTERACTIVE BACKUP UTILITY V2.00
  345.  
  346.           HOW TO USE THE PROGRAM
  347.  
  348.  
  349.  
  350.  
  351.  
  352.           INVOCATION
  353.  
  354.  
  355.           The Interactive  Backup Utility is  invoked  like  any  other DOS
  356.           external  command by keying in its name, IBU.  The command may be
  357.           qualified by  keying in one or  two  file  specifications  and an
  358.           optional parameter.  The command format is:
  359.  
  360.           IBU [d:][path][filename[.ext]] [d:][path][filename[.ext]] [/O]
  361.  
  362.           The  first  parameter you specify  identifies the source file(s).
  363.           The second  parameter identifies the target file(s).  You may use
  364.           the  global  characters  ? and  *  in  the  filename  and in  the
  365.           extension of both the source and target files.
  366.  
  367.           If you use the /O  parameter the Interactive Backup Utility  will
  368.           display and allow  modification of  various  program options (see
  369.           "CUSTOMIZING THE PROGRAM OPTIONS." on page 7).
  370.  
  371.  
  372.  
  373.           Examples:
  374.  
  375.           1.  IBU
  376.  
  377.               will   display  all  the   files   on   the   default  source
  378.               disk/diskette drive which are candidates  for backup  to  the
  379.               default target drive.
  380.  
  381.           2.  IBU b:
  382.  
  383.               will  display  all  the  files  on  the  B  drive  which  are
  384.               candidates for backup to the default target drive.
  385.  
  386.           3.  IBU *.bas
  387.  
  388.               will display all the  files  on the default source drive with
  389.               an extension  of  BAS which  are candidates for backup to the
  390.               default target drive.
  391.  
  392.           4.  IBU *.abc *.cba
  393.  
  394.               will display all  the files  on the default source drive with
  395.               an  extension of ABC  which are  candidates for backup to the
  396.               default target drive  with  the  same  file  name,  but  with
  397.               extension CBA.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          5
  404.  
  405.  
  406.                           INTERACTIVE BACKUP UTILITY V2.00
  407.  
  408.           5.  IBU xyz*.*
  409.  
  410.               will display all  the files on the default source  drive with
  411.               names beginning XYZ  which are  candidates for backup  to the
  412.               default target drive.
  413.  
  414.           6.  IBU xyz*.* zyx*.*
  415.  
  416.               will  display all the files on the  default source drive with
  417.               names  beginning XYZ  which  are candidates for backup to the
  418.               default target drive with names beginning ZYX.
  419.  
  420.           7.  IBU ab??ef
  421.  
  422.               will display all the files on  the default  source drive with
  423.               names  beginning AB followed by any two characters and ending
  424.               with EF which are candidates for backup to the default target
  425.               drive.  Note that there is no extension.
  426.  
  427.           8.  IBU a:*.pas a:*.pab
  428.  
  429.               will display  all the files on  the A drive with an extension
  430.               of PAS which are candidates for backup to the A drive with an
  431.               extension of PAB.
  432.  
  433.           9.  IBU c:\sub1\sub2\sub3\*.* c:\sub4\*.*
  434.  
  435.               will display all the files in path \sub1\sub2\sub3\ on the  C
  436.               drive which are candidates for backup in path \sub4\ on the C
  437.               drive.
  438.  
  439.  
  440.  
  441.  
  442.           DRIVE SELECTION
  443.  
  444.  
  445.           The source and target drives may be  specified  in one of several
  446.           ways:
  447.  
  448.           1.  You  may  permanently select default  drives  for the program
  449.               using the /O  invocation  parameter,  selecting  the  desired
  450.               source and target default drives and then saving the program.
  451.               These defaults will then  be  the defaults used each time the
  452.               program is invoked unless  overridden as specified below.  If
  453.               you  tend to  always  have the same source and target drives,
  454.               you will want to utilize this facility.
  455.  
  456.           2.  You  may  select  default drives for this invocation  of  the
  457.               program using the  /O  invocation  parameter,  selecting  the
  458.               desired source and target default drives and  then NOT saving
  459.               the program.
  460.  
  461.           3.  You may select default drives each time the restart screen is
  462.               displayed.  This  sets  the  source and target default drives
  463.  
  464.  
  465.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          6
  466.  
  467.  
  468.                           INTERACTIVE BACKUP UTILITY V2.00
  469.  
  470.               for the  program  until overridden  on  a  succeeding restart
  471.               screen.
  472.  
  473.           4.  You may explicitly specify the source and the target drive as
  474.               part of  a file specification parameter  either at invocation
  475.               time or at restart time.
  476.  
  477.           5.  The program as distributed uses an algorithm to determine the
  478.               source and  target  drives  when  none of the  above  methods
  479.               apply.  The algorithm is retained from previous  versions  of
  480.               the program.  It is used when either or both of the program's
  481.               default source and target drives are set to "0", i.e., zero.
  482.  
  483.               a.  If your system  does not have  a C drive (your system has
  484.                   only two diskette drives and no hard  disk  or  RAM disk)
  485.                   then:
  486.                   *   If neither source nor target  drive  is  specified as
  487.                       part of the file  specifications  the backup will  be
  488.                       from the DOS system default drive to the other drive.
  489.                   *   If  either  drive is explicitly  specified the  other
  490.                       drive will be the non-specified drive.
  491.  
  492.               b.  If your system has a C drive then:
  493.                   *   If  neither source nor target  drive is  specified as
  494.                       part of the file specifications then:
  495.                       -   If A  is the  DOS system default drive the backup
  496.                           will be from drive A to drive C.
  497.                       -   If  A  is  not the DOS  system default drive  the
  498.                           backup will be from the default drive to drive A.
  499.  
  500.                   *   If either drive is explicitly specified and the other
  501.                       is not specified then:
  502.                       -   If  the explicitly specified drive is not the DOS
  503.                           system default drive, the other drive will be the
  504.                           DOS system default drive.
  505.                       -   If A is not the DOS system default drive, and the
  506.                           explicitly specified  drive  is  the  DOS  system
  507.                           default  drive,  the  other  drive  will be the A
  508.                           drive.
  509.                       -   If A is  the DOS system default  drive,  and  the
  510.                           explicitly specified  drive  is the A drive,  the
  511.                           other drive will be the C drive.
  512.  
  513.  
  514.  
  515.  
  516.           CUSTOMIZING THE PROGRAM OPTIONS.
  517.  
  518.  
  519.           If you key the /O parameter when invoking the program the current
  520.           default options are displayed.  You  can change  the  defaults to
  521.           suit your needs.  Changes are made by rotating valid alternatives
  522.           for each default.  Forward and backward rotation is controlled by
  523.           function  keys.  You move the cursor from field to field and area
  524.           to area using the cursor movement keys:
  525.  
  526.  
  527.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          7
  528.  
  529.  
  530.                           INTERACTIVE BACKUP UTILITY V2.00
  531.  
  532.               Up-arrow - move the cursor up one field.
  533.               Down-arrow - move the cursor down one field.
  534.               Left-arrow - move the cursor left one field.
  535.               Right-arrow - move the cursor right one field.
  536.               Tab - move the cursor right one field.
  537.               Shift-tab - move the cursor left one field.
  538.               Enter - move the cursor to the first field on the next row.
  539.  
  540.           There are three major areas on the  customizing screen, each area
  541.           contained within a box.  Movement of the cursor from one area  to
  542.           another  can only occur when the cursor  is in the first or  last
  543.           row  of an area.  You can move the cursor  up or down to the next
  544.           area.
  545.  
  546.           You may restore the settings to their  values  upon entry to  the
  547.           customizing screen at any time by pressing the Esc key.
  548.  
  549.           When  you  have  completed your  modifications  you may save them
  550.           permanently  by pressing F9  and then modifying, as desired,  the
  551.           program file name (of  course,  the  file  extension  must remain
  552.           "COM" or  the program will not  be executable.)  If you press F10
  553.           after making  any  changes  the  modifications will  be for  this
  554.           session only, i.e., only for this invocation of the program.
  555.  
  556.  
  557.  
  558.           THE PROGRAM OPTIONS.
  559.  
  560.  
  561.  
  562.           BACKUP CONTROL: used to  control  selection  of backup  candidate
  563.           files.  It can be set to:
  564.  
  565.           *   DATE - select backup candidates based on their directory date
  566.               and time compared to the date and time of the backup file,
  567.           *   ARCHIVE ATTRIBUTE  -  select  a  file  for  backup if its DOS
  568.               directory archive attribute is on, implying that the file has
  569.               been modified or is new,
  570.           *   DATE AND ARCHIVE ATTRIBUTE - select a file for backup if both
  571.               its date  and  archive attribute imply  it needs to be backed
  572.               up.
  573.  
  574.           BACKUP CONTROL can also be changed at restart time.
  575.  
  576.  
  577.           DEFAULT SOURCE DRIVE and DEFAULT TARGET DRIVE: can be set to zero
  578.           (0) to indicate the DOS system default drive or any valid letter,
  579.           A-Z.  If you tend to  always backup from the same source drive to
  580.           the same target  drive, e.g., from your "C:" drive to  your  "A:"
  581.           drive, you will want to set the  default source drive  to "C" and
  582.           the default target drive to "A".
  583.  
  584.           DEFAULT SOURCE DRIVE and DEFAULT TARGET DRIVE can also be changed
  585.           at restart time.
  586.  
  587.  
  588.  
  589.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          8
  590.  
  591.  
  592.                           INTERACTIVE BACKUP UTILITY V2.00
  593.  
  594.           SPACE TO BE RESERVED FOR "COMMAND.COM": can be set  in increments
  595.           of 1,024  to be from 0 to 655,360 (640K) bytes.  The program uses
  596.           as much  memory as  it needs, and  is  available,  to copy files.
  597.           This leads to the possibility of  overlaying the resident portion
  598.           of the DOS COMMAND.COM; if  a program  overlays COMMAND.COM, then
  599.           DOS  must  reload  COMMAND.COM when the program terminates.  In a
  600.           diskette  only system,  reloading  COMMAND.COM  frequently  means
  601.           having to insert  the DOS system disk  in  the drive used to boot
  602.           your PC - a minor nuisance.  The amount of memory required by the
  603.           resident portion of COMMAND.COM varies  by DOS version.  If after
  604.           terminating this program you frequently get a  message  something
  605.           like "Insert COMMAND.COM disk in drive A: and strike any key when
  606.           ready,"  then you should experiment by  setting  this default  to
  607.           3,072 and increasing it until you no longer get the message.
  608.  
  609.           SPACE  TO BE RESERVED FOR  "COMMAND.COM" can also  be changed  at
  610.           restart  time, but this will not preserve "COMMAND.COM" if it has
  611.           already been overlayed.
  612.  
  613.  
  614.           FUNCTION KEYS: can be set to the functions  defined in "FUNCTIONS
  615.           AVAILABLE WHILE DISPLAYING FILE NAMES" on page 10.  The unshifted
  616.           function keys are identified as F1 to F0, the shift-function keys
  617.           as  S1  to  S0,  the  Ctrl-function keys  as C1  to  C0, and  the
  618.           Alt-function keys as A1 to A0.
  619.  
  620.  
  621.           COLORS: can be set for the different areas of the display screens
  622.           if  you  are  using  a  color  adapter.  These  options  are  not
  623.           displayed unless you are using a color  adapter.  Foreground  and
  624.           background colors can be rotated for each area.
  625.  
  626.           The different areas are:
  627.  
  628.           *   HEADING - refers  to  the  heading area  of the file  display
  629.               screen where  the  source and target  file specifications and
  630.               space statistics are displayed.
  631.           *   MESSAGES - refers primarily  to the last  line  of the screen
  632.               when error messages are being displayed.
  633.           *   FILES 1,3,... - refers to the  file display  area of the file
  634.               display screen where the odd numbered files are displayed.
  635.           *   FILES 2,4,... - refers to the file display  area of the  file
  636.               display screen where the even numbered files are displayed.
  637.           *   INPUT - refers to any area that can be modified by rotating a
  638.               valid entry into it or which can be keyed into.
  639.           *   FUNCTION KEYS - refers  to the last line of the file  display
  640.               screen  where  the  function  key  definitions  are  normally
  641.               displayed.
  642.           *   OTHER - refers to any area not defined above.
  643.  
  644.           Colors  for FILES 1,3,... and FILES 2,4,... may  also  be changed
  645.           when the file display screen is  being displayed  by pressing the
  646.           "Color" function key.
  647.  
  648.  
  649.  
  650.  
  651.           INTERACTIVE BACKUP UTILITY USERS GUIDE                          9
  652.  
  653.  
  654.                           INTERACTIVE BACKUP UTILITY V2.00
  655.  
  656.           FUNCTIONS AVAILABLE WHILE DISPLAYING FILE NAMES
  657.  
  658.  
  659.           The following functions may be assigned to functions keys.  Forty
  660.           function keys are supported by the  program: the normal unshifted
  661.           function  keys, the shift-function keys, the  Ctrl-function  keys
  662.           and   the  Alt-function   keys.  Function   key  assignments  are
  663.           displayed on the last line  of  the  screen; holding down a shift
  664.           key,  Ctrl  or Alt key displays the  functions  assigned  to  the
  665.           combination of those keys and the  function keys.  The program is
  666.           distributed  with each  of  these  functions  assigned.  You  may
  667.           change the  assignments after  specifying  the  /O parameter when
  668.           invoking  the Interactive Backup  Utility  (see  "CUSTOMIZING THE
  669.           PROGRAM OPTIONS." on page 7).
  670.  
  671.  
  672.           Adate = Sort by Date and Time.
  673.  
  674.               Sort the display by the source file date and time, i.e.,  the
  675.               oldest file first.
  676.  
  677.  
  678.           Asize = Sort by Size.
  679.  
  680.               Sort the display by the source file size, i.e.,  the smallest
  681.               file first.
  682.  
  683.  
  684.           Color = Modify the color adapter display attributes.
  685.  
  686.               You will be prompted to modify the display attributes for the
  687.               monitor(s) attached to  your  color adapter.  This  gives you
  688.               the opportunity  to  determine the attributes  which are most
  689.               pleasant on the monitor you are using.
  690.  
  691.               See message number 701 and COLOR ADAPTER CONTROL.
  692.  
  693.               Note.  Unless you are  actually  using a color  adapter  this
  694.               function is  undefined even though the word  Color appears on
  695.               your display.
  696.  
  697.               Colors for all areas may  be modified after specifying the /O
  698.               invocation parameter (see  "CUSTOMIZING THE PROGRAM OPTIONS."
  699.               on page 7).
  700.  
  701.  
  702.           Dates = Sort Descending by Date and Time.
  703.  
  704.               Sort  the  display  into descending order  by the source file
  705.               date and time, i.e., the latest date and time first.
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         10
  714.  
  715.  
  716.                           INTERACTIVE BACKUP UTILITY V2.00
  717.  
  718.           Delet = Mark for deletion.
  719.  
  720.               Mark  the file  on  the  line  where the  cursor  resides for
  721.               deletion. A character D is placed on the line  with  the file
  722.               to be deleted. The deletion can be reset and the D removed by
  723.               using the "Unmrk" function key.
  724.  
  725.               All the files marked  for deletion using the "Delet" function
  726.               key may be unmarked by using the "Reset" function key.
  727.  
  728.               A file marked for deletion is actually deleted after pressing
  729.               the "ProcM" function key or the "RUN" function key.
  730.  
  731.  
  732.           eXcld = Exclude.
  733.  
  734.               Mark  the file  on  the  line  where  the cursor resides  for
  735.               exclusion from  backup. An X is placed  on  the line with the
  736.               file to be  excluded. The exclusion  can be  reset and the  X
  737.               removed by using the "Unmrk" function key.
  738.  
  739.               All the files marked for exclusion using the "eXcld" function
  740.               key may be unmarked by using the "Reset" function key.
  741.  
  742.               A file marked for exclusion will be excluded from the display
  743.               after pressing  the "ProcM" function  key. Once excluded from
  744.               the  display a file  may not  be  re-displayed  or  otherwise
  745.               processed without restarting the utility.
  746.  
  747.  
  748.           Exts = Sort by Extension, Filename.
  749.  
  750.               Sort the display by the source file extension and filename.
  751.  
  752.  
  753.           Help.
  754.  
  755.               Display the help screen.
  756.  
  757.  
  758.           Names = Sort by Filename, Extension.
  759.  
  760.               Sort the display by the source filename and extension.
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         11
  776.  
  777.  
  778.                           INTERACTIVE BACKUP UTILITY V2.00
  779.  
  780.           Paths = Display the source and target paths.
  781.  
  782.               The file name display will be replaced by a screen which:
  783.               *   Displays  the current source path if different  from  the
  784.                   its default path, i.e., if you specified a source path.
  785.               *   Displays  the default  source  path,  i.e.,  the path  in
  786.                   effect when the utility was invoked.
  787.               *   Displays  the current  target path if different  from the
  788.                   its default path, i.e., if you specified a target path.
  789.               *   Displays  the  default  target  path,  i.e.,  the path in
  790.                   effect when the utility was invoked.
  791.  
  792.               The default paths will always be displayed, the current paths
  793.               only if you specified  a  path.  This function is useful when
  794.               you  need to know  the  status  of  the  paths  to the active
  795.               subdirectories.
  796.  
  797.               The file  name  display  is  reinitialized  by  pressing  any
  798.               non-control key.
  799.  
  800.  
  801.           ProcM = Process all the currently marked files.
  802.  
  803.               Press this  key  if files marked  for  exclusion  are  to  be
  804.               excluded  from any  further display  or  if  files marked for
  805.               deletion are to actually be deleted.  The  number of files to
  806.               be copied and the number of clusters  required  will also  be
  807.               updated in the heading lines.
  808.  
  809.  
  810.           Quit.
  811.  
  812.               Terminate the current display activity.
  813.  
  814.  
  815.           Reset = Reset all marks.
  816.  
  817.               This  will unmark  all  files  currently  marked  for  either
  818.               exclusion  or deletion.  A sub-function sorts  the  files  to
  819.               their original order, i.e., the order in which  they exist in
  820.               the directory of the source disk/diskette.
  821.  
  822.  
  823.           RUN = Backup any unmarked file.
  824.  
  825.               Perform the backup operation.  A sub-function first processes
  826.               all the marked files.
  827.  
  828.  
  829.           Sizes = Sort Descending by Size.
  830.  
  831.               Sort the display into descending  order  by  the  size of the
  832.               source file, i.e., the largest file first.
  833.  
  834.  
  835.  
  836.  
  837.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         12
  838.  
  839.  
  840.                           INTERACTIVE BACKUP UTILITY V2.00
  841.  
  842.           Unmrk = Unmark.
  843.  
  844.               Unmark the file on the line where  the cursor resides. When a
  845.               file  has been previously  marked for exclusion or  deletion,
  846.               this  key may be used to reset the mark. The use of marks for
  847.               exclusion and deletion  and  the  ability to reset  the marks
  848.               gives you a  chance  to  change your  mind about excluding or
  849.               deleting a file.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.           OTHER KEYS SUPPORTED WHILE DISPLAYING FILE NAMES
  858.  
  859.  
  860.           The cursor control keys  and the page  control  keys  are used to
  861.           manipulate the display screen.
  862.  
  863.               HOME  - Re-display the first page and position  the cursor at
  864.               the first file.
  865.  
  866.               END  -  Display or re-display the  last page and position the
  867.               cursor at the last file.
  868.  
  869.               PgUp  -  Scroll  up  one  full  page,  displaying those files
  870.               closer to the beginning of the current sorting sequence.
  871.  
  872.               PgDn  -  Scroll down one  full page,  displaying  those files
  873.               closer to the end of the current sorting sequence.
  874.  
  875.               Cursor  Down  -  Move the cursor down to  the  next displayed
  876.               file. If at the bottom of the display page scroll the current
  877.               display a half page.
  878.  
  879.               Cursor  Up  -  Move  the  cursor  up  to  the  next displayed
  880.               candidate file. If at the top of the  display page scroll the
  881.               current display a half page.
  882.  
  883.  
  884.           Return - Same as the Cursor Down key.
  885.  
  886.           Esc - provides the same function as the "Quit" function key while
  887.           displaying files.  If  you  use the Esc key while a file is being
  888.           copied, the backup operation will be  terminated after the active
  889.           copy completes.
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         13
  900.  
  901.  
  902.                           INTERACTIVE BACKUP UTILITY V2.00
  903.  
  904.           Ctrl-Break - Terminate  the current  processing. You  may use the
  905.           Ctrl-Break anytime you wish to  interrupt the  utility.  In  most
  906.           cases  you will be immediately presented  with message number 302
  907.           which allows you to exit to DOS or restart the utility.
  908.  
  909.           If you use the  Ctrl-Break key while a file is being  copied, the
  910.           backup copy will be  deleted from the target disk/diskette.  This
  911.           means that neither the old  backup  copy, which  has already been
  912.           deleted, nor the new copy will exist on the target disk/diskette.
  913.           Once the copy process has started, it  is not possible to recover
  914.           the previous backup copy of a file.
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         14
  962.  
  963.  
  964.                           INTERACTIVE BACKUP UTILITY V2.00
  965.  
  966.           COLOR ADAPTER CONTROL WHILE DISPLAYING FILE NAMES
  967.  
  968.  
  969.           You can control  the colors used by the  program for all  screens
  970.           and  all areas by specifying the /O parameter at invocation time.
  971.           Older versions of this  program  allowed for changing the  colors
  972.           only on the file display  screen and that capability is described
  973.           below.
  974.  
  975.           The file display screen can have different colors for alternating
  976.           pairs  of source  and target  file specifications.  You  have the
  977.           option of modifying the display attributes so that you can find a
  978.           combination that works well with your monitor.
  979.  
  980.           To change the color adapter attributes you  must  first press the
  981.           "Color" function key.  This causes message 701 to be displayed:
  982.  
  983.           701 : CURRENT C/G ATTRIBUTES ARE ABCD.4321
  984.  
  985.           The  current  color  attributes  are displayed in  place  of  the
  986.           characters ABCD.  The characters 4321 are not part of the message
  987.           but  are used here to represent where  you key in new attributes.
  988.           The cursor will initially be where the 4 is.
  989.  
  990.           The character positions above represent the following:
  991.  
  992.               A is the first background color.
  993.               B is the first foreground or character color.
  994.               C is the second background color.
  995.               D is the second foreground or character color.
  996.               4 will become the first background color.
  997.               3 will become the first foreground color.
  998.               2 will become the second background color.
  999.               1 will become the second foreground color.
  1000.  
  1001.           Any of  the above  character  positions may contain or have keyed
  1002.           into it  a valid  hexadecimal digit, i.e., in the  range 0-9,A-F.
  1003.           Both uppercase and lowercase alphabetic characters  may be keyed,
  1004.           but all characters will be displayed in  uppercase.  Once a valid
  1005.           character  has  been keyed and displayed  you may not  change it;
  1006.           complete the  current entry  and press the  "Color"  function key
  1007.           again to make any changes.
  1008.  
  1009.           There are over 65,000 combinations available.  Some are great ---
  1010.           some are awful --- and some will display nothing!
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         15
  1024.  
  1025.  
  1026.                           INTERACTIVE BACKUP UTILITY V2.00
  1027.  
  1028.             CODE    BACKGROUND                         FOREGROUND
  1029.             ----    -------------------------------    -------------
  1030.               0     BLACK                              BLACK
  1031.               1     BLUE                               BLUE
  1032.               2     GREEN                              GREEN
  1033.               3     CYAN                               CYAN
  1034.               4     RED                                RED
  1035.               5     MAGENTA                            MAGENTA
  1036.               6     BROWN                              BROWN
  1037.               7     LIGHT GRAY                         LIGHT GRAY
  1038.               8     BLACK, BLINKING FOREGROUND         DARK GRAY
  1039.               9     BLUE, BLINKING FOREGROUND          LIGHT BLUE
  1040.               A     GREEN, BLINKING FOREGROUND         LIGHT GREEN
  1041.               B     CYAN, BLINKING FOREGROUND          LIGHT CYAN
  1042.               C     RED, BLINKING FOREGROUND           LIGHT RED
  1043.               D     MAGENTA, BLINKING FOREGROUND       LIGHT MAGENTA
  1044.               E     BROWN, BLINKING FOREGROUND         YELLOW
  1045.               F     LIGHT GRAY, BLINKING FOREGROUND    WHITE
  1046.  
  1047.           A complete discussion of the C/G display attributes is beyond the
  1048.           scope of this  documentation.  The PC Technical  Reference manual
  1049.           contains that information.
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.           INTERACTIVE BACKUP UTILITY USERS GUIDE                         16
  1086.  
  1087.  
  1088.                           INTERACTIVE BACKUP UTILITY V2.00
  1089.  
  1090.           APPENDIX A: FILE NAME DISPLAY SCREEN
  1091.  
  1092.  
  1093.  
  1094.           The  file name  screen  for  the  Interactive  Backup Utility  is
  1095.           composed of three major areas.
  1096.  
  1097.           The first two lines of the screen are the area for displaying
  1098.  
  1099.           *   the source and target file specifications.
  1100.  
  1101.               The source is displayed on line  1 and the  target on line 2.
  1102.               The file specifications include the drive, file name and file
  1103.               extension.  The  path,  if  one exists,  can be displayed  by
  1104.               pressing the "Paths" function key.  A  "?"  character  in the
  1105.               source  file  name  or  extension  indicates  a  "wild  card"
  1106.               position, i.e., one not checked when determining which source
  1107.               files are  candidates for backup.  In  the case of the target
  1108.               file specification  a "?"  means this position in the name or
  1109.               extension is or will be  a duplicate of the  same position in
  1110.               the source file name or extension.
  1111.  
  1112.           *   the DOS date, MM/DD/YY, and time, HH:MM, when the program was
  1113.               invoked or restarted.
  1114.  
  1115.           *   the  free  space for the source  and target volumes  in total
  1116.               bytes and cluster count.
  1117.  
  1118.           *   the number of files selected as candidates for backup.
  1119.  
  1120.           *   the clusters required to  copy  the backup candidates  to the
  1121.               target volume.
  1122.  
  1123.               If  this  number  is  greater  than  the number  of  clusters
  1124.               available on the  target disk/diskette, then you must exclude
  1125.               one or more files before pressing the "RUN" key; otherwise an
  1126.               error will occur when the target  disk/diskette  becomes full
  1127.               during  the  copying of  one of  the files (see message 902).
  1128.               The field for this  number  will be treated as a message area
  1129.               when it is greater than the number  of available clusters  on
  1130.               the  target disk/diskette.  The number will be followed  by a
  1131.               minus sign (-) if  the  number of clusters required to backup
  1132.               the  selected  files  is  negative,  indicating that the free
  1133.               space on the target volume will increase after the copying is
  1134.               complete.
  1135.  
  1136.           The middle portion  of  the screen  is used to display the  files
  1137.           selected  for backup.  The source file  is displayed on one  line
  1138.           and the target file is  displayed  on the  next line.  The  first
  1139.           position of each source file  line is used as an area to place an
  1140.           "X"  or  a  "D"  if  the  file has  been marked for exclusion  or
  1141.           deletion.  The  remainder  of the source line and the target line
  1142.           contain
  1143.  
  1144.           *   the file name and extension.
  1145.  
  1146.  
  1147.           Appendix A: FILE NAME DISPLAY SCREEN                           17
  1148.  
  1149.  
  1150.                           INTERACTIVE BACKUP UTILITY V2.00
  1151.  
  1152.               Note: if a file must be created on the target volume in order
  1153.               to  copy a file from the source volume, only the  target file
  1154.               name and extension will be displayed.
  1155.  
  1156.           *   the date and time the file was last modified.
  1157.  
  1158.               Note:   while  only hours and minutes are displayed, the time
  1159.               used internally is in two second increments which is what DOS
  1160.               stores in the disk/diskette directory.
  1161.  
  1162.           *   the file size in bytes and number of clusters.
  1163.  
  1164.           *   the file's directory attributes.
  1165.  
  1166.               The file attributes are
  1167.                   00 - no special attributes
  1168.                   01 - read only file
  1169.                   02 - hidden file (not displayed by the DIR command.)
  1170.                   04 - system file (normally a DOS system file.)
  1171.                   08 - volume label entry
  1172.                   10 - sub-directory entry
  1173.                   20 - archive bit
  1174.  
  1175.               The attributes are stored in the disk/diskette directory in a
  1176.               single byte.  The above represents the hexadecimal mapping of
  1177.               the   bits  in  the  attribute  byte.   The  attributes  will
  1178.               frequently be combined, e.g.,  26 indicates 20 + 02 + 04  and
  1179.               1A (if legitimate) would indicate 10 + 02 + 08.
  1180.  
  1181.               The  following words  and mnemonics are used  to  explain the
  1182.               attribute:
  1183.                   RO     - Read Only.
  1184.                   H      - Hidden
  1185.                   S      - System
  1186.                   LABEL  - Volume Label
  1187.                   SUBDIR - Subdirectory
  1188.                   A      - Archive bit
  1189.  
  1190.           The  last  line of  the  screen is  used to  display function key
  1191.           definitions and error messages.
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.           Appendix A: FILE NAME DISPLAY SCREEN                           18
  1210.  
  1211.  
  1212.                           INTERACTIVE BACKUP UTILITY V2.00
  1213.  
  1214.           APPENDIX B: RESTART DISPLAY SCREEN
  1215.  
  1216.  
  1217.  
  1218.           The restart display  is  provided to enable you to continue using
  1219.           the  utility  without  having  to reinvoke  it  from  DOS.  In  a
  1220.           diskette only  system,  this will reduce the  number of times you
  1221.           must  insert a diskette  containing the utility as well as reduce
  1222.           the number of diskettes which must contain a copy of the utility.
  1223.  
  1224.           Lines 1 and 2 contain the parameters you keyed on the DOS command
  1225.           line or that you specified during the previous restart.  You  may
  1226.           edit this  area to  provide  new file  specifications for another
  1227.           backup operation.  The keys available for  editing are defined on
  1228.           the screen.
  1229.  
  1230.           Line 4 displays the backup option in effect following the words
  1231.  
  1232.           BACKUP OPTION:
  1233.  
  1234.           The backup  option  may be changed by positioning the cursor  and
  1235.           rotating forward or backward to a different option.
  1236.  
  1237.           Line 5 displays the default source drive following the words
  1238.  
  1239.           DEFAULT SOURCE DRIVE:
  1240.  
  1241.           The default may be changed by positioning the cursor and rotating
  1242.           forward or backward to a different drive.
  1243.  
  1244.           Line 6 displays the default target drive following the words
  1245.  
  1246.           DEFAULT TARGET DRIVE:
  1247.  
  1248.           The default may be changed by positioning the cursor and rotating
  1249.           forward or backward to a different drive.
  1250.  
  1251.           The  rest of the screen  except for the last line, which displays
  1252.           message 302, defines  the keys which  may  be  used to modify the
  1253.           file specification  area,  the  backup  option  and  the  default
  1254.           drives.
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.           Appendix B: RESTART DISPLAY SCREEN                             19
  1272.  
  1273.  
  1274.                           INTERACTIVE BACKUP UTILITY V2.00
  1275.  
  1276.           APPENDIX C: MESSAGES
  1277.  
  1278.  
  1279.  
  1280.           All  messages generated by the Interactive Backup Utility will be
  1281.           displayed on the last line of the screen.  Each message will have
  1282.           the following format:
  1283.  
  1284.           ### : MESSAGE
  1285.  
  1286.           where  ### is a unique number.  Unless  prompted  otherwise,  all
  1287.           messages  require that you press a non-control  key  such as  the
  1288.           space bar or return key in order for the program to proceed.
  1289.  
  1290.  
  1291.  
  1292.  
  1293.           001 : DOS VERSION 2.0 OR HIGHER REQUIRED
  1294.  
  1295.               This version of the  Interactive Backup Utility requires  DOS
  1296.               version 2.0 or higher.
  1297.  
  1298.  
  1299.  
  1300.           002 : PRESS Esc TO BYPASS SAVE, F1 FOR HELP, ENTER TO PROCESS.
  1301.  
  1302.               This message  appears  after  you  have requested a permanent
  1303.               change  to the  program's  function key definitions and other
  1304.               options.  Pressing  the  Esc  key  will  bypass  the save and
  1305.               return  you  to the option modification screen.  Pressing the
  1306.               F1 key will provide additional help.  Pressing the ENTER  key
  1307.               will save the program using the displayed file specification.
  1308.  
  1309.  
  1310.  
  1311.           201 : INSERT DISKETTES AS INDICATED ABOVE AND PRESS ANY KEY.
  1312.  
  1313.               The  source  drive  and  the   target   drive  are  displayed
  1314.               immediately above this  message.  If you need to  change  the
  1315.               diskettes currently in either of the  drives  you  must do so
  1316.               now.
  1317.  
  1318.  
  1319.  
  1320.           202 : INVALID SOURCE/TARGET PATH SPECIFICATION. PRESS ANY KEY.
  1321.  
  1322.               The  path specified  was not acceptable  to  DOS.  Press  any
  1323.               non-control  key  and  the utility  will  return you  to  the
  1324.               restart screen where the path specification will be displayed
  1325.               as part of your previous specifications.
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.           Appendix C: MESSAGES                                           20
  1334.  
  1335.  
  1336.                           INTERACTIVE BACKUP UTILITY V2.00
  1337.  
  1338.           203 : SOURCE/TARGET PATH HAS BECOME INVALID.
  1339.  
  1340.               The  utility has  attempted to  issue  a  DOS  CHDIR  (Change
  1341.               Directory Command) for the source or target path as indicated
  1342.               and DOS has returned an  invalid path  response.  This  might
  1343.               occur  if  you  have  changed  diskettes  after responding to
  1344.               message  201.  Press any non-control key and the utility will
  1345.               return you to the restart screen.
  1346.  
  1347.  
  1348.  
  1349.           204 : PRESS ANY KEY TO CONTINUE.
  1350.  
  1351.               The utility requires that  you  press  some  non-control  key
  1352.               before it  will  resume.  This message  appears following the
  1353.               display  of  the  current and default  paths  resulting  from
  1354.               pressing the "Path" function key or while displaying a "HELP"
  1355.               screen.
  1356.  
  1357.  
  1358.  
  1359.           301  : PATH COULD NOT BE  RESTORED FOR  SOURCE/TARGET.  PRESS ANY
  1360.           KEY.
  1361.  
  1362.               Any time paths have been specified for a backup operation the
  1363.               Interactive Backup Utility  will  attempt to restore the path
  1364.               as  it  existed  at the  time  the  utility  was invoked.  It
  1365.               attempts  this restoration  prior to  displaying the  restart
  1366.               screen.  If  restoration  fails  the path  for the  specified
  1367.               device will be its root directory.
  1368.  
  1369.  
  1370.  
  1371.           302 : PRESS Esc TO TERMINATE, F1 FOR HELP, ENTER TO PROCESS.
  1372.  
  1373.               All  current  processing  has completed  or  you have pressed
  1374.               Ctrl-Break, Esc  or  the "Quit" function  key.  Pressing  Esc
  1375.               will terminate  the utility and return you to  DOS.  Pressing
  1376.               the  F1  key  will provide  additional  help.  Modifying  the
  1377.               previous source and  target file specifications and  pressing
  1378.               the ENTER key restarts the utility.
  1379.  
  1380.  
  1381.  
  1382.           501 : TOO  MANY SOURCE/TARGET FILES  FOR AVAILABLE MEMORY.  PRESS
  1383.           ANY KEY.
  1384.  
  1385.               The program  utilizes all  the memory  available to it, up to
  1386.               64K bytes, in building tables of filenames.  However, in this
  1387.               case,  while  building  either  source  or  target  directory
  1388.               tables, an out-of-memory  condition has been detected.  It is
  1389.               suggested  that you qualify the relevant filespec  to  reduce
  1390.               the number of directory entries that need to be processed, or
  1391.               increase  the amount of memory available to the program if it
  1392.               is currently less than 80K bytes.
  1393.  
  1394.  
  1395.           Appendix C: MESSAGES                                           21
  1396.  
  1397.  
  1398.                           INTERACTIVE BACKUP UTILITY V2.00
  1399.  
  1400.               Press any non-control key and the utility will return  you to
  1401.               the restart screen.
  1402.  
  1403.  
  1404.  
  1405.           502 : TOO MANY FILES FOR AVAILABLE MEMORY. PRESS ANY KEY.
  1406.  
  1407.               The program  utilizes all the memory available to  it,  up to
  1408.               64K bytes,  in building tables of filenames.  However in this
  1409.               case, while  building  the  table  of  backup  candidates, an
  1410.               out-of-memory condition has been detected.  It  is  suggested
  1411.               that you qualify the source filespec to  reduce the number of
  1412.               files which are  backup candidates, or increase the amount of
  1413.               memory available to  the program if it is currently less than
  1414.               80K bytes.
  1415.  
  1416.               Press any non-control key and the utility will  return you to
  1417.               the restart screen.
  1418.  
  1419.  
  1420.  
  1421.           601 : NO BACKUP CANDIDATE FILES. PRESS ANY KEY.
  1422.  
  1423.               No files on  the  source  disk/diskette  are  candidates  for
  1424.               backup.  Press  any  non-control  key and  the  utility  will
  1425.               return you to the restart screen.
  1426.  
  1427.  
  1428.  
  1429.           602 : FILE TO BE DELETED DOES NOT EXIST ON INPUT DISKETTE.
  1430.  
  1431.               The displayed file, previously marked for deletion can not be
  1432.               found  on  the  input  disk/diskette during processing of the
  1433.               marked  files.  You  must have changed  diskettes.  Press any
  1434.               non-control key to continue.
  1435.  
  1436.  
  1437.  
  1438.           603 : SUBDIRECTORIES CAN NOT BE DELETED.
  1439.  
  1440.               You have  attempted  to  delete  a  DOS  subdirectory  entry.
  1441.               Deletion  of  subdirectories  is  not  supported.  Press  any
  1442.               non-control key to continue.
  1443.  
  1444.  
  1445.  
  1446.           604 : DELETE READ-ONLY FILE? (Y/N):
  1447.  
  1448.               This  prompt is  presented  prior  to  actual  deletion of  a
  1449.               read-only file.  Pressing  the "Y" key, either upper or lower
  1450.               case, will  confirm the deletion.  Pressing the "N"  key will
  1451.               prevent the deletion of the file.  Any other response will be
  1452.               ignored.
  1453.  
  1454.  
  1455.  
  1456.  
  1457.           Appendix C: MESSAGES                                           22
  1458.  
  1459.  
  1460.                           INTERACTIVE BACKUP UTILITY V2.00
  1461.  
  1462.  
  1463.           701 : CURRENT COLOR ATTRIBUTES ARE abcd.
  1464.  
  1465.               You have pressed function key F2.
  1466.  
  1467.               The   current  color  attributes  are   displayed  where  the
  1468.               characters  "abcd"  are.  You  will  be  able  to  enter  new
  1469.               attributes  following  the period in the message.  See "COLOR
  1470.               ADAPTER CONTROL WHILE DISPLAYING FILE NAMES" on page 15.
  1471.  
  1472.  
  1473.  
  1474.           802 : OUTPUT DISKETTE IS FULL.
  1475.  
  1476.               The output disk/diskette  has become full while  copying  the
  1477.               displayed file.  Press  any non-control  key  and the utility
  1478.               will return you to the restart screen.
  1479.  
  1480.               Any partially copied file will have the current date and time
  1481.               and a file size of 0 on the target disk/diskette.  Be sure to
  1482.               delete any partially copied file on the target disk/diskette.
  1483.  
  1484.               This message can occur  even when the  space requirements for
  1485.               all the candidate files are  less than the space available on
  1486.               the  target: the clusters required  by  the file being copied
  1487.               when this message occurs are greater than the space currently
  1488.               available; files further down the candidate  list are smaller
  1489.               than  their predecessors on  the target  and will free  space
  1490.               when copied.  If  the clusters available field on  line  2 of
  1491.               the display is not highlighted as a message, this is what has
  1492.               happened.  You   should  sort  the   candidate  list  into  a
  1493.               different  sequence  to eliminate this condition or "eXclude"
  1494.               some  candidates  from the  list and  perform multiple copies
  1495.               using the restart capability of the utility.
  1496.  
  1497.  
  1498.  
  1499.           803 :  Ctrl-Break  = IMMEDIATE  QUIT, Esc  =  QUIT AFTER  CURRENT
  1500.           FUNCTION.
  1501.  
  1502.               This message will display while  files are being copied.  The
  1503.               CTRL-BREAK  will cause the copy function to be terminated and
  1504.               the backup file being created to  be  deleted from the target
  1505.               disk/diskette.  The Esc  key will cause the  copy function to
  1506.               be terminated  following completion of the current file copy.
  1507.               Use of either key will return you to the restart screen.
  1508.  
  1509.  
  1510.  
  1511.           901 : SOURCE/TARGET INVALID FUNCTION NUMBER.
  1512.  
  1513.               An  invalid DOS function  has  been requested.  This  is  DOS
  1514.               error return  code  01.  This should only occur if there is a
  1515.               programming error.  If  you do  get this message let me  know
  1516.               about it, please.  Press any non-control key and  the utility
  1517.  
  1518.  
  1519.           Appendix C: MESSAGES                                           23
  1520.  
  1521.  
  1522.                           INTERACTIVE BACKUP UTILITY V2.00
  1523.  
  1524.               will return you to the restart screen.
  1525.  
  1526.  
  1527.  
  1528.           902 : SOURCE/TARGET FILE NOT FOUND.
  1529.  
  1530.               An  attempt to process either  a  source  or  target file has
  1531.               failed because the  file can not be found.  This is DOS error
  1532.               return  code  02.  You  have probably  swapped diskettes in a
  1533.               drive  since  the  directory of that  drive was read  by  the
  1534.               program.  Press  any  non-control  key  and the  utility will
  1535.               return you to the restart screen.
  1536.  
  1537.  
  1538.  
  1539.           903 : SOURCE/TARGET PATH NOT FOUND.
  1540.  
  1541.               A path specification has  become invalid.  This  is DOS error
  1542.               return  code 03.  You  have  probably swapped  diskettes in a
  1543.               drive  since the path on that  drive  was  validated  by  the
  1544.               program.  Press  any  non-control key and  the  utility  will
  1545.               return you to the restart screen.
  1546.  
  1547.  
  1548.  
  1549.           904 : SOURCE/TARGET, TOO MANY OPEN FILES (NO HANDLES LEFT).
  1550.  
  1551.               An invalid  handle condition has occurred.  This is DOS error
  1552.               return  code 04.  The  FILES= parameter  in  your  CONFIG.SYS
  1553.               system  file  probably  needs  to  be  increased.  Press  any
  1554.               non-control  key and the  utility  will  return  you  to  the
  1555.               restart screen.
  1556.  
  1557.           905 : SOURCE/TARGET ACCESS DENIED.
  1558.  
  1559.               Access to a file has been denied  by DOS.  This is DOS  error
  1560.               return code 05.  Press  any  non-control key and the  utility
  1561.               will return you to the restart screen.
  1562.  
  1563.           906 : SOURCE/TARGET, INVALID HANDLE.
  1564.  
  1565.               A file handle  has become invalid.  This  is DOS error return
  1566.               code  06.  Press  any  non-control  key  and the utility will
  1567.               return you to the restart screen.
  1568.  
  1569.           912 : SOURCE/TARGET, INVALID ACCESS CODE.
  1570.  
  1571.               This is DOS  error return code 0C.  Press any non-control key
  1572.               and the utility will return you to the restart screen.
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.           Appendix C: MESSAGES                                           24
  1582.  
  1583.  
  1584.                           INTERACTIVE BACKUP UTILITY V2.00
  1585.  
  1586.           999 : SOURCE/TARGET, xxH, UNDEFINED ERROR CODE.
  1587.  
  1588.               A DOS error return code other than one of those defined above
  1589.               has  occurred.  The hexadecimal error code  replaces the "xx"
  1590.               in the message.  Press  any  non-control  key and the utility
  1591.               will return you to the restart screen.
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.           Appendix C: MESSAGES                                           25
  1644.  
  1645.  
  1646.                           INTERACTIVE BACKUP UTILITY V2.00
  1647.  
  1648.           APPENDIX D: USER SUPPORTED SOFTWARE CONCEPT
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.           AVAILABILITY
  1656.  
  1657.  
  1658.           Available from  Mike Hodapp  under the  "user supported software"
  1659.           concept.  See below.
  1660.  
  1661.  
  1662.  
  1663.           COPYING
  1664.  
  1665.  
  1666.           The Interactive Backup  Utility can be copied onto your diskettes
  1667.           for use on your machine.
  1668.  
  1669.  
  1670.  
  1671.           DISCLAIMER
  1672.  
  1673.  
  1674.           In no  event  will the author be  liable to you  for any damages,
  1675.           including any lost profits, lost savings  or  other incidental or
  1676.           consequential damages arising out of  the use  of or inability to
  1677.           use this program, even if the  author  has  been  advised of  the
  1678.           possibility of such damages, or for any claim by any other party.
  1679.  
  1680.  
  1681.  
  1682.           PERMISSION TO COPY
  1683.  
  1684.  
  1685.           Clubs  and other non-profit  organizations are granted permission
  1686.           by the  author to freely copy this  program and documentation and
  1687.           share it with their members, so long as:
  1688.  
  1689.           1.  No  price  is  charged  for  the  software or  documentation.
  1690.               However, a distribution  cost may be  charged for the cost of
  1691.               the diskette.
  1692.  
  1693.           2.  Club members  are informed of  the user-supported concept and
  1694.               encouraged to support it with their donations.
  1695.  
  1696.           3.  The  program  or documentation is not modified in any way and
  1697.               are distributed together.
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.           Appendix D: USER SUPPORTED SOFTWARE CONCEPT                    26
  1706.  
  1707.  
  1708.                           INTERACTIVE BACKUP UTILITY V2.00
  1709.  
  1710.           THE USER-SUPPORTED CONCEPT
  1711.  
  1712.  
  1713.  
  1714.                                User-Supported Software
  1715.               If you are using this program and find it to be of value
  1716.                        your contribution will be appreciated.
  1717.                                  ($20 is suggested)
  1718.  
  1719.                                      Mike Hodapp
  1720.                                   5609 Apache Road
  1721.                                 Louisville, KY 40207
  1722.  
  1723.           Regardless of whether you make a contribution, you are encouraged
  1724.           to copy and share this program.
  1725.  
  1726.  
  1727.           User-supported software is an experiment in distributing computer
  1728.           programs, based on these beliefs:
  1729.  
  1730.           1.  That the value and  utility  of software is best  assessed by
  1731.               the user on his/her own system.
  1732.  
  1733.           2.  That  the  creation  of  personal  computer software  can and
  1734.               should be supported by the computing community.
  1735.  
  1736.           3.  That  copying of programs should be encouraged,  rather  than
  1737.               restricted.
  1738.  
  1739.           Anyone may request a copy of  a user-supported program by sending
  1740.           a blank,  formatted  disk  to  the  author  of  the  program.  An
  1741.           addressed, postage-paid return mailer must accompany the disk (no
  1742.           exceptions, please). A copy of the program, with documentation on
  1743.           the disk, will be sent by  return mail.  The program will carry a
  1744.           notice suggesting a contribution to the program's author.  Making
  1745.           a contribution is completely voluntary on the part of each user.
  1746.  
  1747.           Free distribution of  software and voluntary payment for  its use
  1748.           eliminates costs for advertising and copy protection schemes.
  1749.  
  1750.           Users obtain  quality software at reduced  cost. They can  try it
  1751.           out before buying, and do so at their own pace and in the comfort
  1752.           of their own home  or  office.  The  best programs  will survive,
  1753.           based purely on their quality and usefulness.
  1754.  
  1755.           Please join the experiment.
  1756.  
  1757.           If you believe in these ideals, your contribution is solicited to
  1758.           help make them work.
  1759.  
  1760.  
  1761.  
  1762.  
  1763.           For those  of  you  requiring an  invoice  in  order  to initiate
  1764.           payment through  your  company accounting  system,  the following
  1765.  
  1766.  
  1767.           Appendix D: USER SUPPORTED SOFTWARE CONCEPT                    27
  1768.  
  1769.  
  1770.                           INTERACTIVE BACKUP UTILITY V2.00
  1771.  
  1772.           invoice  is provided.  Those  who wish an  invoice for their  tax
  1773.           records may also find it useful.
  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.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.           Appendix D: USER SUPPORTED SOFTWARE CONCEPT                    28
  1830.  
  1831.  
  1832.                           INTERACTIVE BACKUP UTILITY V2.00
  1833.  
  1834.                                 --------------------
  1835.                                        INVOICE
  1836.                                 --------------------
  1837.  
  1838.  
  1839.  
  1840.  
  1841.           Purchased from:
  1842.                Mike Hodapp
  1843.                5609 Apache Road
  1844.                Louisville, KY 40207
  1845.  
  1846.  
  1847.           DATE:     /     /
  1848.           ----------------------------------------------------------------
  1849.                                                  PRICE     PRICE
  1850.           PRODUCT                      QTY       EACH      EXTENDED
  1851.           -------------------------    ---       -----     --------
  1852.  
  1853.           INTERACTIVE BACKUP UTILITY
  1854.             program and
  1855.             documentation                1        $20        $20
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.                                                 SALES TAX      0
  1863.  
  1864.                                     --------------------------------------
  1865.                                     PLEASE PAY THIS AMOUNT    $20    TOTAL
  1866.           ----------------------------------------------------------------
  1867.  
  1868.  
  1869.  
  1870.           Please make check payable to : Mike Hodapp
  1871.  
  1872.  
  1873.           You may retain this Invoice
  1874.           for your tax records.
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.