home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / NBS101.ZIP / NBSDOCEN.DOC < prev    next >
Text File  |  1993-09-17  |  59KB  |  1,192 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ NBS       Norton Backup Shell                 │    D.I.S.P.     │────┐
  3. ║                                               │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 1.01                                │     ShareWare   │░░░░│
  8. ║ Rel.Date: September 17th,1993                 │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ NBS.EXE                                     |    └─────────────────┘
  12. ║ │                                             |       ┌─────┐        |
  13. ║ │                                             |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │                                             |     ┌────┴────┐      |
  16. ║ │                                             ------││││││ ═══│-------
  17. ║ │                                                   └─────────┘
  18. ║ │
  19. ║ │ Lines starting with '│' are
  20. ║ │ changes to this release (NA)
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28.  ┌───────┬─────────────────────────────────────────────────────────────┐
  29.  │   0   │ Table of contents                                           │
  30.  └───────┴─────────────────────────────────────────────────────────────┘
  31.  
  32.  1 ----    General information
  33.   1.1      Copyrights and License Agreement
  34.   1.2      Newer versions and contacting the author
  35.  
  36.  2 ----    Package description and requirements
  37.   2.1      Preface
  38.   2.2      Requirements
  39.   2.3      Included files
  40.  
  41.  
  42.  3 ----    Installation description
  43.   3.1      Installation
  44.   3.2      The configuration file(s)
  45.   3.3      INI options
  46.   3.3.1    [General] options
  47.   3.3.2    [Norton] options
  48.   3.3.3    [Cycle] options
  49.  
  50.  4 ----    Run-time information
  51.   4.1      Modes of operation
  52.     4.1.1  First time execution
  53.     4.1.2  Standard calls
  54.     4.1.3  Automated (scheduled) calls
  55.     4.1.4  Checking
  56.     4.1.5  Updating NBS.STA
  57.   4.2      Command-line parameters
  58.   4.3      Errors
  59.  
  60.  5 ----    Version information and credits
  61.   5.1      The BETA-team
  62.   5.2      Credits
  63.   5.3      Version history
  64.   5.4      Copyright, Trademarks
  65.  
  66.  ┌───────┬─────────────────────────────────────────────────────────────┐
  67.  │   1   │ General information                                         │
  68.  └───────┴─────────────────────────────────────────────────────────────┘
  69.  
  70.  1.1 Copyrights and License Agreement
  71.  ────────────────────────────────────
  72.  
  73.  - Users of the NBS-package must accept this disclaimer of warranty:
  74.  
  75.  - The  NBS-package  is  supplied  as  is.   The  author  disclaims  all
  76.    warranties, expressed or implied, including, without limitation,  the
  77.    warranties of merchantability  and of fitness  for any purpose.   The
  78.    author assumes  no liability  for damages,  direct or  consequential,
  79.    which may result from the use of the NBS-package;
  80.  
  81.  - The  NBS-package  is  a  "shareware  program"  and is provided at  no
  82.    charge to the user for evaluation.   Feel free to share it with  your
  83.    friends,  but  please  do  not  give  it  away  altered or as part of
  84.    another  system.   The  essence  of  "user-supported"  software is to
  85.    provide personal  computer users  with quality  software without high
  86.    prices, and yet to provide  incentive for programmers to continue  to
  87.    develop new products.
  88.  
  89.  - If  you find  this program  useful and  find that  you are  using and
  90.    continue the  use of  the NBS-package  after a  30 days trial period,
  91.    you must register the NBS-package as described below;
  92.  
  93.  - Non-commercial can get a license for the usage up to this release  of
  94.    the NBS-package for  a small amount  of money. Look  into the details
  95.    in  REGISTER.NBS.  Previous  registered  users  will  receive  a  big
  96.    reduction to upgrade to the  newer versions. These users should  look
  97.    into the details in UPGRADE.NBS.   For Non-commercial users there  is
  98.    a POSSIBILITY to submit to one of the special contracts as  explained
  99.    in the file REGISTER.NBS.
  100.  
  101.  - Commercial usage of  NBS will cost somewhat  more. Also, a so  called
  102.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  103.    direct to the  SysOp to get  full access) is  has to pay  more than a
  104.    Non-commercial  user.  Both  types  of  users  should  look  into the
  105.    details in REGISTER.NBS;
  106.  
  107.  - The registration of the NBS-package will license ONE copy for use  on
  108.    any computer at any  one time, as long  as the usage confirms  to the
  109.    type of registration you have done (so NON-commercial usage when  you
  110.    have a non-commercial license);
  111.  
  112.  - Anyone  distributing  the  NBS-package  for any kind of remuneration
  113.    must  first   contact  the   Author   at   the  address   above   for
  114.    authorization.
  115.  
  116.  - You are  encouraged  to  pass a copy   of the NBS-package  along   to
  117.    your friends  for  evaluation.   Please  encourage  them to  register
  118.    their copy if they find that they can use it;
  119.  
  120.  - Support  on  NBS,  when  used  in  a  non-commercial environment,  is
  121.    available  by  means  of  written  letters  or by entering the inter-
  122.    national echomail area DISP;
  123.  
  124.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  125.    conference <tm> called DISP (international). Entering this echo  does
  126.    not  exclude  you  of  the  duty  to register the NBS-package, though
  127.    users who evaluate the product can enter the echo for questions;
  128.  
  129.  - The  NBS-package, all  programs, the  documentation and support-files
  130.    is  copyrighted  1990,93  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  131.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  132.    this  package  for  backup  purposes.  Also  you  may  copy and share
  133.    unmodified copies of the whole package, providing that the  copyright
  134.    notice    is    reproduced    and    included    on    all    copies.
  135.    Excluded from this statement  are the support-files written  by other
  136.    authors.  Please  refer  to  the  documentation of these programs for
  137.    copyrights and license agreements;
  138.  
  139.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  140.    decompile  and/or  disassemble  the  software  in  the   NBS-package.
  141.    Patching the medium at  places that carry the  software is seen as  a
  142.    program change and is also forbidden. It is forbidden to create a  so
  143.    called 'bypass' to skip the original introduction screens and  delay.
  144.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  145.    author (Robert W. van Hoeven) himself;
  146.  
  147.  - Performing  any  of  the  illegal  actions as stated in the previous
  148.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  149.    important, to the registered users;
  150.  
  151.  - Bulletin Board  Systems that distribute  the NBS package  can convert
  152.    the WHOLE package  to any archive-system  they like but  all original
  153.    files must  be included  in the  new archive.  The NBS-package on the
  154.    Bulletin Board  can contain  at the  most 2  extra files. These files
  155.    can only be  a commercial for  that Bulletin Board  and/or validation
  156.    data that is presented  as a service to  all users and shall  have no
  157.    other functions;
  158.  
  159.  - After  the normal  trial period  of 30  days, you  must register  the
  160.    soft- ware (see REGISTER.NBS) or you must remove it from your PC;
  161.  
  162.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  163.    answered as soon I have the time  to do so. You can send me  a letter
  164.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  165.    point)  on  node  2:281/904  (RA  Support, Monster, Holland, SysOp is
  166.    Reinier de Groot).  When you want to send me normal mail, address  it
  167.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  168.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  169.    Echomail <tm> area;
  170.  
  171.  
  172.  1.2 Newer versions and contacting the author
  173.  ───────────────────────────────────────────────────────────────────────
  174.  The newest version of  NBS is always available  at the DISP-HQ on  node
  175.  2:281/904.  NBS  is  also  distributed  thru  a  number of DISP support
  176.  nodes and thru some forums in CompuServe. There are six   ways in which
  177.  you can obtain newer versions of NBS:
  178.  
  179.  - Logging on at DISP-HQ or a support node (FidoNet)
  180.    Look into the file SUPPORT.NBS for a full list of support nodes;
  181.  
  182.  - Logging on to a SDS node
  183.    NBS is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  184.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  185.    distribution point in Holland;
  186.  
  187.  - Logging on to your own BBS;
  188.    Chances  are,  that  you  will  find  an older version (international
  189.    users) because it will take some time for the new version to  'bleed'
  190.    thru the net;
  191.  
  192.  - Logging on to CompuServe;
  193.    Important versions of NBS are uploaded to several CompuServe  forums.
  194.    It is intended to upload  versions to the SYMANTEC and  IBMSYS forums
  195.    but depend on the authorization of  the forum sysops. If you are  not
  196.    sure, you can contact me on CompuServe personally;
  197.  
  198.  - Update service;
  199.    You can enter a special update service (read REGISTER.NBS).
  200.  
  201.  
  202.  If you think you have found problems in NBS, or in any other case,  you
  203.  wish to contact the author, you can send me:
  204.  
  205.  - A letter to the address you can find in the header of this file;
  206.  
  207.  - A  NetMail  <tm>  message  to   Rob Van.hoeven (please mind the point
  208.    between Van and Hoeven) at 2:281/904 or (better) 2:281/904.5;
  209.  
  210.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  211.  
  212.  - A  message  (mail  forum)  in  CompuServe to user Robert van  Hoeven,
  213.    with account/user number 100120,1146;
  214.  
  215.  ┌───────┬─────────────────────────────────────────────────────────────┐
  216.  │   2   │ Package description and requirements                        │
  217.  └───────┴─────────────────────────────────────────────────────────────┘
  218.  
  219.  2.1 Preface
  220.  ───────────────────────────────────────────────────────────────────────
  221.  In the many years I have worked with PCs, both professional as well  as
  222.  for  the  hobby,  I  have  used  backup programs to backup my important
  223.  files at least  a few times  in a week.  After I obtained  a tape-drive
  224.  for my own (home) system, I even backup on a day-to-day basis.
  225.  
  226.  In these years I  have used a large  number of backup programs,  all of
  227.  which I have bought  (one recovery of an  important file pays back  the
  228.  price of the single package  and more). All major backup  programs have
  229.  executed frequently over  here, until they  became too old  (and had to
  230.  be updated because of  f.i. a new DOS-version).  Then came the time  to
  231.  evaluate  the  marked  and  to  buy  a  new  version or swap to another
  232.  program.
  233.  
  234.  In recent years  I sticked to  Norton Backup, either  in the integrated
  235.  Norton DeskTop environment, in  the Norton DeskTop Windows  environment
  236.  or in  the DOS  (stand-alone) environment.  I always  had best  results
  237.  with the stand-alone versions, but this is personal.
  238.  
  239.  The current version of Norton Backup (2.2) is now currently being  used
  240.  for  a  number  of  months  (with  great pleasure and without any major
  241.  problems, which can't be said  of certain other backup programs  I used
  242.  in the past).  It is a  very versatile program  which maintains all  my
  243.  tapes, most  of them  with backups  of my  own work,  some of them with
  244.  complete projects (which have to be maintained for backward  reference)
  245.  and some with backups of the software I bought.
  246.  
  247.  But even  a program  like Norton  Backup <tm>  leaves some  whishes for
  248.  features. Some  of them  can be  emulated by  batch-files and  or other
  249.  macro-alike structures,  some of  them can't.  NBS was  written to be a
  250.  helpful  addition  to  the  current  Norton  Backup 2.2 (and even older
  251.  versions).  It  covers  a  number  of  'enhancements'.  This is done by
  252.  renaming NBACKUP.EXE to another name and to rename NBS.EXE to the  name
  253.  NBACKUP.EXE. Now, whenever you call  NBACKUP (either manually or in  an
  254.  automatic way, from  the NSCHED.COM scheduler  program), NBS is  called
  255.  which,  in  turn,  will  call  the  renamed  NBACKUP.EXE. Before Norton
  256.  Backup  is  called,  NBS  can  do  some pre-processing and after Norton
  257.  Backup has  finished, NBS  can do  some post-processing.  In fact,  NBS
  258.  (which stands for Norton Backup Shell) is an incorrect name. It is,  in
  259.  fact, some sort of front-end for Norton Backup.
  260.  
  261.  NBS covers the following 'problems':
  262.  
  263.  - Norton  Backup has  a habit  of creating  a number  of (more  or less
  264.    temporary) files  that can  be removed  after execution  but are  not
  265.    cleaned  automatically.  Examples  are  all  NBackup.* files that are
  266.    left in the data-directory, the RESTORE.TMP file and all *.BAK  files
  267.    which are created when  you update a SET.  NBS can remove these  (and
  268.    other) files, after Norton Backup has done it's job;
  269.  
  270.  - Norton  Backup generates  a lot  of files  in the data-directory (the
  271.    one pointed  to by  the NBACKUP  environment variable,  see the NB2.2
  272.    manual).  When  you  maintain  a  large  number  of  sets for various
  273.    reasons, the data-directory can be as big as 2 to 4 MB (depending  on
  274.    the cleaning you do). For each set  a SET, SAV, SLT and CAT file  and
  275.    depending on the type  of backup one or  more *.FUL, *.INC and  so on
  276.    files.  Most  of  the  time  you  only  need one set (with additional
  277.    files) at one time and most of  these files only stay on disk so  you
  278.    can restore with some ease. NBS  will collect ALL these files into  a
  279.    single PKWare ZIP archive (so they are compressed and it is one  file
  280.    and not tons of files) and will extract only the required files  from
  281.    this ZIP-archive before Norton Backup activates. In my  configuration
  282.    I reduced the overall HDU-consumption from 3 MB to 400K !
  283.  
  284.  - As time passes, your collection of SET/SAV/SLT/CAT and INC/FUL  files
  285.    will get mismatches when you  manually change files (delete, add)  or
  286.    when you don't want Norton  Backup to remove old catalog-files.  This
  287.    can be cleaned  by NBS. NBS  has a special  run-time option (/NBSCHK)
  288.    which will unpack  all SET/SAV/SLT/CAT/INC/FUL (and  remaining) files
  289.    from the archive and will check all files against others. It will  do
  290.    some suggestions what to do about orphan or missing files;
  291.  
  292.  - NBS can  be very helpful  when you work  with backup-cycles on  tape.
  293.    It is advised to use some  sort of scheme (see NB2.2 manual)  but one
  294.    of the  most schemes  gets some  help from  NBS. When  you start each
  295.    cycle (week,  twice a  week, month,  whatever) with  a full backup on
  296.    the tape and  will add (append)  the incremental backups  to the same
  297.    tape until the next cycle (in which cycle you use another tape),  NBS
  298.    is able to display the  tape-number/tape-letter that must be used  on
  299.    this cycle.  NBS will  increment the  number/letter when  a new  full
  300.    backup is detected  at the command-line  (/TF, see NB2.2  manual) for
  301.    the number of tapes you supply;
  302.  
  303.  - NBS  (for tape  users) can  be very  helpful to  determine the moment
  304.    when to clean the tape-drive. Usually you should clean your drive  on
  305.    a regular basis (like once every 8 productive hours). NBS will  count
  306.    the time  spend in  the actual  Norton Backup  as the  time that  the
  307.    tape-drive is  accessed. After  the configured  number of  minutes of
  308.    Norton Backup usage (= aprox.  tape-drive usage), NBS will display  a
  309.    warning to clean the drive;
  310.  
  311.  - NBS will pass the  original errorlevel from Norton Backup  execution.
  312.    Also NBS will be able to run unattended, when /A or a macro-setup  is
  313.    detected  on  the  Norton  Backup  command-line.  In these cases, all
  314.    warnings  are  displayed  (for  example  the  warning  to  clean  the
  315.    tape-drive) but  there will  be no  user interaction  and the warning
  316.    will continue to appear until  you run an attended execution  of NBS.
  317.    NBS will keep  a small log-file  that can be  used as reference  when
  318.    you ALWAYS run NBS in an unattended fashion;
  319.  
  320.  All in all, a number  of pre/post processing options for  Norton Backup
  321.  that can get even more from Norton Backup.
  322.  
  323.  
  324.  
  325.  2.2 Requirements
  326.  ───────────────────────────────────────────────────────────────────────
  327.  NBS requires:      - PC XT/AT/386/486 (or more)
  328.                     - At least 400K free memory;
  329.                     - DOS 3.xx and higher;
  330.                       (tested with 4Dos 4.0, should work with lower
  331.                       versions);
  332.                     - DOS 2.xx ONLY when registered. In this case, a
  333.                       customized version will be created;
  334.                     - HDU optional
  335.                     - The original Norton Backup <tm> version 2.2
  336.                       (should work with lower and compatible versions
  337.                       as well);
  338.                     - A copy of PKWare's PKZIP.EXE and PKUNZIP.EXE;
  339.  
  340.  
  341.  2.3 Included files
  342.  ───────────────────────────────────────────────────────────────────────
  343.  The package includes : NBS.EXE         The main program
  344.                         NBS.INI         An example configuration file
  345.  
  346.  ┌───────┬─────────────────────────────────────────────────────────────┐
  347.  │   3   │ Installation description                                    │
  348.  └───────┴─────────────────────────────────────────────────────────────┘
  349.  
  350.  3.1 Installation
  351.  ────────────────────────────────────────────────────────────────────────
  352.  The installation  of NBS  depends upon  the way  you use Norton Backup.
  353.  You can choose either one of  the suggested ways.  After unpacking  the
  354.  archive in a temporary directory, you can go as follows:
  355.  
  356.  If your Norton Backup is  ALWAYS called from a command-line  (either by
  357.  hand or in a batch-file)  but NOT FROM the NSCHED.COM  schedule program
  358.  that comes with Norton Backup, the installation is as follows:
  359.  
  360.  - Copy the NBS.EXE file to a directory in the DOS-path;
  361.  
  362.  - Copy the  NBS.INI file to  the same directory  or a directory  in the
  363.    DOS-path and alter the contents to suit your needs (see later);
  364.  
  365.  - Alter ALL  calls to Norton  Backup (NBACKUP.EXE) in  all your batches
  366.    (*.BAT or *.BTM)  to NBS.EXE, also  always call NBS  from the command
  367.    line and not NBACKUP;
  368.  
  369.  If your Norton Backup is  sometimes called from a command-line  (either
  370.  by hand or  in a batch-file)  AND ALSO FROM  the schedule program  that
  371.  comes with Norton Backup (NSCHED.COM), the installation is as follows:
  372.  
  373.  - Rename  NBACKUP.EXE in  the Norton  Backup directory  to an alternate
  374.    name (NB.EXE for example);
  375.  
  376.  - Copy the  NBS.EXE file to  the directory where  NBACKUP.EXE (that you
  377.    should have  renamed by  now) resides  and rename  it to  NBACKUP.EXE
  378.    (NBS.EXE is now called NBACKUP.EXE and the original NBACKUP.EXE  also
  379.    has another name);
  380.  
  381.  - Copy the  NBS.INI file to  the same directory  or a directory  in the
  382.    DOS-path and alter the contents to suit your needs (see later).   You
  383.    MUST add the  NortonBackUpProgram option in  the [Norton] section  of
  384.    the NBS.INI file and  this MUST now point  to the renamed version  of
  385.    the original NBACKUP.EXE file;
  386.  
  387.  - You can leave all calls to NBACKUP as they were as NBS is now  called
  388.    instead;
  389.  
  390.  
  391.  In ALL of the above cases:
  392.  
  393.  - After you have altered NBS.INI, you should start with the first  call
  394.    to NBS.EXE (called NBS.EXE or NBACKUP.EXE) in the following way:
  395.  
  396.    - NBS /NBSFTM
  397.  
  398.      - NBS will call the Norton  Backup Program which you should end  at
  399.        the same time;
  400.  
  401.      - NBS will create the first NBS.ZIP file in the assigned directory;
  402.  
  403.    This is MANDATORY.  The /NBSFTM is  used to tell  NBS that it  is the
  404.    first time  execution and  that no  NBS.ZIP file  is available.  This
  405.    could also  be automated  but this  way is  a more  safe way in those
  406.    cases where the NBS.ZIP file is removed by accident.
  407.  
  408.  The above sequence is also important to check your NBS.INI file and  to
  409.  check if all is working OK.
  410.  
  411.  
  412.  3.2 The configuration file(s)
  413.  ────────────────────────────────────────────────────────────────────────
  414.  All programs from the NBS package make use of ONE SINGLE  configuration
  415.  file that is called  NBS.INI. The NBS.INI file  is typically a file  of
  416.  the new  generation of  control-files. The  syntax is  derived from the
  417.  Microsoft Windows <tm>, MS/DOS <tm> (CONFIG.SYS) and OS/2 syntax.
  418.  
  419.  The NBS.INI file is  a normal ASCII (flat)  file with records that  are
  420.  terminated by a CR/LF combination. Most present-day (line) editors  can
  421.  create such  a file  and also  most word-processors  have the option to
  422.  create a (flat) ASCII file (without control-codes!).
  423.  
  424.  There  are  no  formal  rules  for  the syntax of a Windows-alike *.INI
  425.  file.  The  basic  syntax  though  is  in  the  form  of blocks (with a
  426.  block-header) with options. All options between a block-header and  the
  427.  next block-header  (or the  end of  the file)  belong to  the block for
  428.  which the block-header  gives a name.  A block-header is  assigned thru
  429.  the use of brackets before and after the name of the block. Like this:
  430.  
  431.  [General]
  432.  OptionG1=value1
  433.  OptionG2=value2
  434.  
  435.  [Custom]
  436.  OptionC1=value1
  437.  OptionC2=value2
  438.  
  439.  In the example above, there  are two blocks (General and  Custom) which
  440.  are  marked  by  their  block-headers  ([General]  and  [Custom]).  The
  441.  options OptionG1  and OptionG2  belong to  the block  'general' and the
  442.  options OptionC1  and OptionC2  belong to  the block  'custom'.   Until
  443.  MS/DOS 6.0 <tm> it seemed like a rule that a *.INI file could not  have
  444.  duplicate variants of  the same options.  In such cases,  it was common
  445.  to use something like this:
  446.  
  447.  [Custom]
  448.  ExcludeFile-1 = A.A
  449.  ExcludeFile-2 = B.B
  450.  
  451.  or
  452.  
  453.  [Custom]
  454.  ExcludeFile = A.A , B.B
  455.  
  456.  and not
  457.  
  458.  [Custom]
  459.  ExcludeFile = A.A
  460.  ExcludeFile = B.B
  461.  
  462.  Ms/DOS 6.0  <tm> changed  this behavior.  The 'MenuItem'  option is  an
  463.  example of how to break the 'rules'. DISP programs, like NBS, will  now
  464.  use all combinations. In most cases, the variant used, is based on  the
  465.  number  of  possible  values.  When  you  want to exclude more than 100
  466.  files,  both  'ExcludeFile  =  A.A,  B.B,  C.C......' and the form with
  467.  'ExcludeFile-1 =',  'ExcludeFile-2='.... and  so on,  are both useless.
  468.  In these cases,  multiple (duplicate) variants  of the same  option are
  469.  used.
  470.  
  471.  The format of the *.INI file is rather free. The block-headers must  be
  472.  coded as given and  must be enclosed in  brackets. The header (and  the
  473.  options) can start on  any position in the  *.INI file as long  as they
  474.  are  preceded  with  'white'  spaces.  Options  (and  headers) that are
  475.  preceded with a  comment-character ('%'), are  not used, nor  are empty
  476.  lines and invalid options ! The options have the format:
  477.  
  478.  Optionname = value
  479.  
  480.  The '=' character is used to  separate the option and its value(s).  If
  481.  multiple values  precede the  '=' character,  they are  separated by  a
  482.  comma or another character  (like Optionname = value,value,value).  The
  483.  number of  white spaces  between the  optionname and  the '=' character
  484.  and the '='  character and the  value(s) is irrelevant.  An option will
  485.  never exceed one line and a line can never be more than 255  characters
  486.  long.  The case (upper/lower) of all options, block-headers and  values
  487.  is not important, unless specified.
  488.  
  489.  The names used thru all DISP <tm> products are as follows:
  490.  
  491.  - Block-name
  492.    The name of the block that  is preceded with a block-header and  will
  493.    be  active  until  the  next  block-header  or the end of file (which
  494.    comes first);
  495.  
  496.  - Option
  497.    The name of the options within a block;
  498.  
  499.  - Parameter or values
  500.    These are the actual values that belong to an option. Sometimes  they
  501.    are  called  parameter,  but  most  of  the  time we will call them a
  502.    value.
  503.  
  504.  The descriptive syntax of all options is:
  505.  
  506.  [.....]   this value is MANDATORY, it MUST be present and have a  valid
  507.            value;
  508.  
  509.  {.....}   this  value is OPTIONAL. If  it is NOT present,  some default
  510.            is used;
  511.  
  512.  'value'   Values  between  quotes   must  be  coded WITHOUT the  quotes
  513.            themself, UNLESS specified;
  514.  
  515.  The DISP  programs (including  the programs  in the  NBS package)  will
  516.  look for the control-file (NBS.INI in  case of the NBS package) in  the
  517.  following way:
  518.  
  519.  - First the current directory is searched for the NBS.INI file;
  520.  
  521.  - If not present in the  current directory, a search thru the  DOS-path
  522.    is performed until the NBS.INI file is found;
  523.  
  524.  - If the NBS.INI file is not found in the current directory and/or  the
  525.    DOS-path, the directory  where the EXE-file  resides (if this  is not
  526.    the same directory as the  current directory) will be examined.  This
  527.    search is only performed with DOS releases 3.xx and higher;
  528.  
  529.  It is advised to place  the NBS.INI file alongside the  programs and/or
  530.  somewhere in the DOS-path.
  531.  
  532.  The following  chapter   will   contain the  various statements you can
  533.  use in the file.
  534.  
  535.  
  536.  3.3 INI options
  537.  ───────────────────────────────────────────────────────────────────────
  538.  The  next   chapters  contain   the  options   for all programs in  the
  539.  NBS package.
  540.  
  541.  The descriptions are grouped together  in the same blocks as  they have
  542.  to  appear  in  NBS.INI.  Please  refer  to the example NBS.INI that is
  543.  supplied with this package !
  544.  
  545.  
  546.  3.3.1 [General] options
  547.  ───────────────────────────────────────────────────────────────────────
  548.  The following  options, if  defined, must  be defined  inside the block
  549.  with block-header [General]
  550.  
  551.  
  552.  ┌─────────────────────────────────────────────────────────────────────┐
  553.  │ TemporaryDirectory = [dir]                                          │
  554.  └─────────────────────────────────────────────────────────────────────┘
  555.  Usage : NBS  will  create  some   temporary  files  and  a    temporary
  556.          directory.   This  option  (if  available)  will  point  to the
  557.          directory  where  these  temporary  files/directory  is placed.
  558.          When the  option is  NOT available  in NBS.INI,  NBS will check
  559.          for  the  directory  that  is  set  in the environment variable
  560.          TEMP. If this variable is also NOT available, NBS will abort,
  561.  
  562.          [dir] Must  point  to  a   valid  directory. The program   will
  563.                test if  the directory  is available   and will  abort if
  564.                this  is not the case. You can use relative paths !
  565.  
  566.  
  567.  ┌─────────────────────────────────────────────────────────────────────┐
  568.  │ StoreDirectory = [dir]                                              │
  569.  └─────────────────────────────────────────────────────────────────────┘
  570.  Usage : NBS will create and use a special file NBS.ZIP (PKZIP  archive)
  571.          which will contain all sets, catalogs and other related  files.
  572.          NBS  will  extract  files  from  this  archive into the NBackup
  573.          data-directory (see NB2.2  manual, NBACKUP env.  variable). You
  574.          CAN place this file in the  same directory but I advise to  use
  575.          another  directory  where  you  store  these  kind of important
  576.          files. The StoreDirectory option IS MANDATORY and should  point
  577.          to a valid directory where NBS.ZIP is placed and read from.
  578.  
  579.          [dir] Must  point  to  a   valid  directory. The program   will
  580.                test if  the directory  is available   and will  abort if
  581.                this  is not the case.
  582.  
  583.  
  584.  ┌─────────────────────────────────────────────────────────────────────┐
  585.  │ LogPath = [path]                                                    │
  586.  └─────────────────────────────────────────────────────────────────────┘
  587.  Usage : NBS can create a  log-file with all actions. This log-file  can
  588.          be reused, in which case NBS will append to the file, with  all
  589.          next executions. If you want  to have a log-file maintained  by
  590.          NBS, you must include this option.
  591.  
  592.          [path] must either point to  a valid directory (with drive  and
  593.                 directory-name), in which  case NBS will  create NBS.LOG
  594.                 inside  this  directory  or   must  point  to  a   fully
  595.                 specified name  (drive, directory  and filename)  of you
  596.                 log-file, if you want to use another name than NBS.LOG.
  597.  
  598.  
  599.  ┌─────────────────────────────────────────────────────────────────────┐
  600.  │ MergeNBackupLog = [true | false]                                    │
  601.  └─────────────────────────────────────────────────────────────────────┘
  602.  Usage : If your Norton Backup  sets are configured to create a  history
  603.          log-file (not to  be confused with  the *.INC and  *.FUL files)
  604.          with one or  more items included  inside this log,  NBS is able
  605.          to merge this  log into the  NBS log-file (if  set, see above).
  606.          In this case,  NBS will append  all created *.RPT  files in the
  607.          Norton Backup data-directory  into the configured  NBS log-file
  608.          AND will delete these  *.RPT files from the  data-directory. If
  609.          you do not specify this option (or set it to FALSE), the  *.RPT
  610.          will be kept in the  data-directory and will be moved  into the
  611.          NBS.ZIP  file  by  NBS  after  Norton Backup has terminated. It
  612.          will  also  be  extracted  if  next  actions  on  this  set are
  613.          required  so  Norton  Backup  is  still  able  to  append   new
  614.          information to the *.RPT file.
  615.  
  616.          You can either use the TRUE or  FALSE values or use the Y or  N
  617.          values in NBS.INI.
  618.  
  619.  
  620.  ┌─────────────────────────────────────────────────────────────────────┐
  621.  │ UseEMS = [true | false]                                             │
  622.  └─────────────────────────────────────────────────────────────────────┘
  623.  Usage:  NBS will  swap itself  out of  memory before PKZIP/PKUNZIP  and
  624.          the Norton Backup program are called.
  625.  
  626.          Normally  the  swap   routine   will  use   XMS  (first),   EMS
  627.          (second)  or   DISK  (third),   depending  on   the   available
  628.          resources.
  629.  
  630.          If you  don't want  to use   EMS as  a candidate  for swapping,
  631.          you should supply  'UseEMS = false'  or 'UseEMS =  N' (both are
  632.          valid values for this option).
  633.  
  634.          The default (when   you don't supply   the option in   NBS.INI)
  635.          is to  use EMS  when selected,  available and  when enough  EMS
  636.          memory is available.
  637.  
  638.          You   can   supply   both   UseEMS   and   UseXMS  together, to
  639.          allow either  any  type  of   memory  (both  set to true),  one
  640.          type of memory  (one  set  to  true,  the  other  to  false) or
  641.          NO type of memory (both set to false).
  642.  
  643.  
  644.  ┌─────────────────────────────────────────────────────────────────────┐
  645.  │ UseXMS = [true | false]                                             │
  646.  └─────────────────────────────────────────────────────────────────────┘
  647.  Usage : NBS will  swap itself  out of  memory before PKZIP/PKUNZIP  and
  648.          the Norton Backup program are called.
  649.  
  650.          Normally  the  swap   routine   will  use   XMS  (first),   EMS
  651.          (second)  or   DISK  (third),   depending  on   the   available
  652.          resources.
  653.  
  654.          If you  don't want  to use   XMS as  a candidate  for swapping,
  655.          you should supply  'UseXMS = false'  or 'UseXMS =  N' (both are
  656.          valid values for this option).
  657.  
  658.          The default (when   you don't supply   the option in   NBS.INI)
  659.          is to  use XMS  when selected,  available and  when enough  XMS
  660.          memory is available.
  661.  
  662.          You   can   supply   both   UseEMS   and   UseXMS  together, to
  663.          allow either  any  type  of   memory  (both  set to true),  one
  664.          type of memory  (one  set  to  true,  the  other  to  false) or
  665.          NO type of memory (both set to false).
  666.  
  667.  
  668.  ┌─────────────────────────────────────────────────────────────────────┐
  669.  │ PKZIPProgram = [path]                                               │
  670.  └─────────────────────────────────────────────────────────────────────┘
  671.  Usage : NBS  will need a  copy of the  PKZIP.EXE file (from  PKWare) to
  672.          create the NBS.ZIP file. Any version from 1.00 and up will  do.
  673.          This option can point to  the PKZIP.EXE program. If the  option
  674.          is not  available, NBS  will try  to find  PKZIP.EXE in the DOS
  675.          path.
  676.  
  677.          [path] Must point to the valid directory and  file-name of  the
  678.                 PKZIP program.
  679.  
  680.  
  681.  ┌─────────────────────────────────────────────────────────────────────┐
  682.  │ PKUNZIPProgram = [path]                                             │
  683.  └─────────────────────────────────────────────────────────────────────┘
  684.  Usage : NBS will need a  copy of the PKUNZIP.EXE file (from  PKWare) to
  685.          create the NBS.ZIP file. Any version from 1.00 and up will  do.
  686.          This  option  can  point  to  the  PKUNZIP.EXE  program. If the
  687.          option is not  available, NBS will  try to find  PKUNZIP.EXE in
  688.          the DOS path.
  689.  
  690.          [path] Must point to the valid directory and  file-name of  the
  691.                 PKZIP program.
  692.  
  693.  
  694.  3.3.2 [Norton] options
  695.  ───────────────────────────────────────────────────────────────────────
  696.  The following  options, if  defined, must  be defined  inside the block
  697.  with block-header [Norton].
  698.  
  699.  ┌─────────────────────────────────────────────────────────────────────┐
  700.  │ NortonBackupProgram = [path]                                        │
  701.  └─────────────────────────────────────────────────────────────────────┘
  702.  Usage : NBS will need a copy of the Norton Backup program  (NBACKUP.EXE
  703.          or a  renamed equivalent,  see chapter  3.1).   This option can
  704.          point  to  the  Norton  Backup  program.  If  the option is not
  705.          available, NBS will try to find the NBACKUP.EXE program in  the
  706.          DOS-path.  This  can  cause  loops  if  NBS.EXE  is  renamed to
  707.          NBACKUP.EXE,  so  be  careful  to  include this option with the
  708.          correct name of the renamed  NBACKUP.EXE when this is the  case
  709.          !!
  710.  
  711.          [path] Must point to the valid directory and  file-name of  the
  712.                 Norton Backup program.
  713.  
  714.  
  715.  ┌─────────────────────────────────────────────────────────────────────┐
  716.  │ NortonFilesDir = [dir]                                              │
  717.  └─────────────────────────────────────────────────────────────────────┘
  718.  Usage : Normally NBS will use a separate data-directory (see the  NB2.2
  719.          manual about  the NBACKUP  env.var.). This  data-directory will
  720.          contain the SET/CAT/SLT/SAV/INC/FUL (and  so on) files. If  the
  721.          NBACKUP env.var.  is not  set, the  Norton Backup  directory is
  722.          used.
  723.  
  724.          If the NBACKUP  environment variable is  NOT set, the  usage of
  725.          this NortonFilesDir option  is MANDATORY, even  if you use  the
  726.          Norton Backup directory. NBS needs  to know WHERE to place  the
  727.          files that come from NBS.ZIP.  If the NBACKUP env.var. is  set,
  728.          you can leave out this option !
  729.  
  730.          [dir] Must  point  to  a   valid  directory. The program   will
  731.                test if  the directory  is available   and will  abort if
  732.                this  is not the case.
  733.  
  734.  
  735.  ┌─────────────────────────────────────────────────────────────────────┐
  736.  │ DeleteNortonTemp = [mask] {,mask} {,mask} {,mask} {,mask}           │
  737.  └─────────────────────────────────────────────────────────────────────┘
  738.  Usage : This option  will trigger  a NBS  post-processing option.   NBS
  739.          will delete all files that match one or more of the masks  that
  740.          you supply overhere. For example:
  741.  
  742.          DeleteNortonTemp= NBACKUP.* RESTORE.TMP *.BAK
  743.  
  744.          Will delete NBACKUP.LOG, NBACKUP.RST, NBACKUP.TMP,  RESTORE.TMP
  745.          and *.BAK  file AFTER  Norton Backup  has finished  processing.
  746.          This keeps the  Norton Backup directory  (and the NBS.ZIP  file
  747.          that is maintained by NBS) clean.
  748.  
  749.          [mask] must  be  a  valid  DOS  mask (like *.BAK or  FILE.NOW).
  750.                 There must be at least  one mask set and optionally  you
  751.                 can supply more masks (20) which must be separated by  a
  752.                 comma.
  753.  
  754.  
  755.  3.3.3 [Cycle] options
  756.  ───────────────────────────────────────────────────────────────────────
  757.  The following  options, if  defined, must  be defined  inside the block
  758.  with block-header [Cycle].
  759.  
  760.  ┌─────────────────────────────────────────────────────────────────────┐
  761.  │ CycleSet1  = [set-name], [count], [text]                            │
  762.  │ CycleSet2  = [set-name], [count], [text]                            │
  763.  │ CycleSet3  = [set-name], [count], [text]                            │
  764.  │ CycleSet4  = [set-name], [count], [text]                            │
  765.  │ CycleSet5  = [set-name], [count], [text]                            │
  766.  │ CycleSet6  = [set-name], [count], [text]                            │
  767.  │ CycleSet7  = [set-name], [count], [text]                            │
  768.  │ CycleSet8  = [set-name], [count], [text]                            │
  769.  │ CycleSet9  = [set-name], [count], [text]                            │
  770.  └─────────────────────────────────────────────────────────────────────┘
  771.  Usage : You can  instruct NBS that you  maintain sets of media  for the
  772.          backup-process.  In  this  case  (mostly  used with tapes), you
  773.          maintain, for  instance, 3  tapes. The  first tape  is used  to
  774.          keep a full backup and  all next incremental backups until  the
  775.          next full backup is performed. When this is the case, you  will
  776.          then store the next  full backup (and its  incremental backups)
  777.          on the 2nd tape  until the next full  backup. In that case  you
  778.          will  use  the  3th  tape.  When  the  next  full backup is now
  779.          requested you start to reuse the 1th tape and the cycle  starts
  780.          again.
  781.  
  782.          To accommodate this feature (for  up to 10 different set),  you
  783.          can supply the  CycleSet[x] option, where  [x] has the  value 1
  784.          to 9. If present  (and match the current set to be worked  on),
  785.          NBS  will  display  a  message  which  tape to use. There is NO
  786.          check to  see if  this is  the correct  tape. This  is left  to
  787.          Norton Backup or yourself.  If you run unattended,  the message
  788.          will appear but NBS will not wait for a key-stroke. If you  run
  789.          attended, NBS will beep and wait for a keystroke.
  790.  
  791.          Each option will name  the point to the  set it applies to,  it
  792.          will contain the number of backup device-sets (tapes) you  want
  793.          to  use  and  contains  a  text  to be displayed. This text can
  794.          either contain a variable tape-number or tape-letter which  can
  795.          be incorporated inside the text.
  796.  
  797.          [set-name]  This must  contain the  name of  the set for  which
  798.                      the  cycle  control  is  active.  Don't  supply  an
  799.                      extension, only the name.
  800.  
  801.          [count]     This must  be set to  the number of   backup-device
  802.                      sets (tapes) you want  to maintain for this  backup
  803.                      (or restore).  You can  supply any  number but when
  804.                      your (virtual) tape-labels have letters (like  TAPE
  805.                      A, TAPE B and so on), you can only supply a  number
  806.                      up to 26;
  807.  
  808.          [text]      This   must  be  the  text   that  you  want to  be
  809.                      displayed by  NBS. You can include three macros. $A
  810.                      will be  substituted by  the correct  letter (A, if
  811.                      it is the first set,  B for the second and  so on).
  812.                      $N will  be substituted  by the  correct number  (1
  813.                      for the first  tape, 2 for  the second and  so on).
  814.                      You can also supply  $N1, $N2... $N9 in  which case
  815.                      the  number  will  be  padded  with  0  to 8 zeroes
  816.                      before the  number (the  length of  the number will
  817.                      be 1 to 9). $S will be substituted with the name of
  818.                      the SET that is currently in use;
  819.  
  820.          For example, you use TAPE 001,  TAPE 002 and TAPE 003 for  your
  821.          3-week cycle of  backups of your  hard-disk. The Norton  Backup
  822.          set that is used, is called FULLBACK.SET:
  823.  
  824.          CycleSet1 = FULLBACK, 3 , Use TAPE $N3 this week for $S
  825.  
  826.          NBS will display the first week:
  827.  
  828.          'Use TAPE 001 this week for FULLBACK'
  829.  
  830.          And the 3th week:
  831.  
  832.          'Use TAPE 003 this week for FULLBACK'
  833.  
  834.          It is up to you  (and the Norton Backup schedular)  to maintain
  835.          the  correct  sequence  of  full  and  incremental backups. The
  836.          options will  only work  when /TF  (full) or  /TI (incremental)
  837.          command-line  parameters  are  included  with  the  call to the
  838.          Norton Backup program. NSCHED will do this !
  839.  
  840.          See  also  chapter  4  for  specific  details about the NBS.STA
  841.          file.
  842.  
  843.  
  844.  ┌─────────────────────────────────────────────────────────────────────┐
  845.  │ CycleClean = [minutes]                                              │
  846.  └─────────────────────────────────────────────────────────────────────┘
  847.  Usage : You can  instruct NBS to track  the number of minutes  that the
  848.          backup-device is used.  This is an  estimate, because NBS  will
  849.          start to count when Norton Backup is called and will stop  when
  850.          Norton Backup is finished.  Usually you will perform  automatic
  851.          actions  with  Norton  Backup  but  if  you include many manual
  852.          input during the  activation of Norton  Backup, this time  will
  853.          also be counted.
  854.  
  855.          Usually this option is only  useful when you use a  tape-drive.
  856.          Diskette drives  are also  used outside  Norton Backup  but the
  857.          tape-drive is  (normally) only  accessed by  Norton Backup  for
  858.          long  periods.  Tape  drives  should  be  cleaned  on a regular
  859.          frequency (see the manual of your tape-drive).
  860.  
  861.          NBS will  add each  time that  Norton Backup  was called to the
  862.          previous  total.  If  the  total  has  become  bigger  than the
  863.          configured number of minutes, NBS will supply a message on  the
  864.          screen. If NBS runs unattended, the message will appear but  no
  865.          keystroke is  needed. In  this case  the message  will reappear
  866.          until  an  attended  call   to  NBS  is  made   (no  /A  or   a
  867.          marco-execution on the command-line). If NBS run attended,  NBS
  868.          will display the  message, will wait  for a keystroke  and will
  869.          then reset the cycle (after  which the counting will start  all
  870.          over). This is independent of the fact if you actually  cleaned
  871.          the drive. This is your job and can not be monitored by NBS.
  872.  
  873.          [minutes] should  be  set  to  the  estimate number of  minutes
  874.                    after which a cleaning  action of your backup  device
  875.                    is needed.  If no  cleaning cycle  is needed,  supply
  876.                    the value 0.
  877.  
  878.          See  also  chapter  4  for  specific  details about the NBS.STA
  879.          file.
  880.  
  881.  ┌───────┬─────────────────────────────────────────────────────────────┐
  882.  │   4   │ Runtime information                                         │
  883.  └───────┴─────────────────────────────────────────────────────────────┘
  884.  
  885.  4.1 Modes of operation
  886.  ───────────────────────────────────────────────────────────────────────
  887.  NBS can be operated in various modes:
  888.  
  889.  - NBS  will  be  used  to  call  Norton  Backup, while performing  some
  890.    processes  before  Norton  Backup  is  called  (pre-processing)   and
  891.    performing  some  processed  after  Norton  Backup  finished  (called
  892.    post-processing).  Optionally,   you  must   supply  a   NBS-specific
  893.    parameter to tell NBS that it  is the first time it will  execute (it
  894.    will then  assume that  there is  no NBS.ZIP  file available and will
  895.    create a new one at the end of this process);
  896.  
  897.  - NBS will be used to checkout the current collection of SET, SAV,  SLT
  898.    and CAT files  against INC, DIF  and FUL files.  In this process  the
  899.    files  from  COPY-functions  of  Norton  Backup  are ignored. In this
  900.    mode, Norton Backup itself is NOT called;
  901.  
  902.  - NBS can update the NBS.STA (statistical) file to values you like;
  903.  
  904.  It is advised to run NBS  in the check-operation the first time  (or as
  905.  soon as possible).  In the installation  we recommended to  call NBS in
  906.  the mode that calls Norton Backup  because most of you will read  until
  907.  they know  how to  install. In  that case,  the chapter  about checking
  908.  (see later) is  not read and  it would be  possible that the  user gets
  909.  messages and questions that can not be answered with full knowledge  of
  910.  what is happening.
  911.  
  912.  
  913.  4.1.1 First time execution
  914.  ───────────────────────────────────────────────────────────────────────
  915.  As  said,  the  first  time  you  call  NBS,  there  is no NBS.ZIP file
  916.  present.  NBS  could detect this  itself, but for  security reasons, we
  917.  force  the  user  to  actually  supply  options that will tell NBS that
  918.  there is no NBS.ZIP (it could  be possible that the NBS.ZIP file  could
  919.  not be accessed while  it IS present. In  this case NBS would  assume a
  920.  first run and would make a mess of the next call to Norton Backup).
  921.  
  922.  To  tell  NBS  that  it  executes  the  first time, you must supply the
  923.  command-line parameter /NBSCHK to NBS.  This is an unknown command  for
  924.  Norton Backup and is  filtered out by NBS  before NBS calls the  Norton
  925.  Backup program.
  926.  
  927.  
  928.  4.1.2 Standard calls
  929.  ───────────────────────────────────────────────────────────────────────
  930.  With a standard call,  we mean a call  to Norton Backup, either  from a
  931.  normal batch file or from the  command-line. The call can be meant  for
  932.  a specific SET or for  a non-specific reason (like a  tape-directory or
  933.  the creation of a new SET).
  934.  
  935.  All calls that  don't include the  /NBSCHK command-line parameters  are
  936.  treated as normal  calls to Norton  Backup. When NBS  receives a normal
  937.  call, the following sequence is performed:
  938.  
  939.  - Check NBS command-line  to see if there  is a specific SET  specified
  940.    (like NBS Fullback /TI /A, where FULLBACK is the name of the SET);
  941.  
  942.  - Check NBS command-line to see if there is a macro execution  involved
  943.    or an  automated process  (either NBS  @FULLBACK /TI  or NBS FULLBACK
  944.    /TI /A);
  945.  
  946.  - Check to see if /NBSFTM is on the command-line parameters;
  947.  
  948.  - If no /NBSFTM is included, unpack the SET and its related  components
  949.    from  NBS.ZIP.  If  NO  SET  is  specified, unpack ALL SETs and their
  950.    related components;
  951.  
  952.  - If no /NBSFTM is  included, unpack the PROTECT.LST file  (if present)
  953.    from the NBS.ZIP (REMAINDR.NBS directory inside the ZIP);
  954.  
  955.  - Copy the PROTECT.LST to the PROTECT.NBS file;
  956.  
  957.  - Determine the  backup-device set (tape),  if cycle-control is  active
  958.    and matches the set that will be worked on;
  959.  
  960.  - Call Norton Backup;
  961.  
  962.  - Calculate the  number of minutes  the backup/restore-device was  used
  963.    and trigger when the total time expired the configured period;
  964.  
  965.  - On return from Norton Backup, remove all temporary files as specified
  966.    in NBS.INI;
  967.  
  968.  - Merge any *.RPT (report) file to the NBS.LOG (if configured);
  969.  
  970.  - Intelligently merge the PROTECT.NBS and the new PROTECT.LST  together
  971.    and create a  new PROTECT.LST. This  is needed because  Norton Backup
  972.    will create a new PROTECT.LST each time it executes;
  973.  
  974.  - Pack all (new  and old) files into  the NBS.ZIP, even new  SETs which
  975.    are created during the execution  of Norton Backup, are added  to the
  976.    NBS.ZIP file, so don't worry;
  977.  
  978.  - Terminate NBS with the errorlevel returned by Norton Backup;
  979.  
  980.  NBS will manipulate the PROTECT.LST  file in a special way,  because of
  981.  the  way  Norton  Backup  maintains  this  file.  The  result will be a
  982.  complete (!) and correct  protection-list, even when Norton  Backup can
  983.  not detect  all protected  SETs because  these files  are not extracted
  984.  from the NBS.ZIP file.
  985.  
  986.  When NBS extracts files from  NBS.ZIP, it will reset the  attributes to
  987.  0, so Norton Backup  will only backup them  with a full backup  but not
  988.  with  every  incremental  backup.   The  same  goes  for   PROTECT.LST,
  989.  PROTECT.NBS and every other file EXPECT NBS.ZIP.
  990.  
  991.  
  992.  4.1.3 Automated (scheduled) calls
  993.  ───────────────────────────────────────────────────────────────────────
  994.  An  automated  or  scheduled  call  is  performed  when you install the
  995.  Norton Scheduler program (NSCHED.COM).  NSCHED will call Norton  Backup
  996.  with a  certain command-line  on the  scheduled dates,  for a scheduled
  997.  action  or  when  you  call  Norton  Backup  from a batch with either a
  998.  macro-execution (the  @ before  the name  of the  SET) or  with the  /A
  999.  switch.
  1000.  
  1001.  The actions that NBS performs with  an automated call, are the same  as
  1002.  with standard calls, all expect one difference. The difference  between
  1003.  the  two  modes  is  the  fact  that  NBS  will  never  wait for a user
  1004.  keystroke on a question. This means that:
  1005.  
  1006.  - NBS will display any pending tape-number for a backup starts (if  any
  1007.    CycleSetx option matches the SET) but NBS will not stop. It is up  to
  1008.    the user that the correct media is inserted in the drive;
  1009.  
  1010.  - NBS  will display  any pending  expiration of  the cleaning cycle but
  1011.    that  it  will  NOT  reset  the  cleaning-cycle until after the first
  1012.    NON-automated call of NBS;
  1013.  
  1014.  The current version of NSCHED will call Norton Backup with all  options
  1015.  that need to be supplied (both /TF and /TI are of any interest to  NBS)
  1016.  independent  of  the  installed  defaults  for  a given SET. With other
  1017.  words if  your default  for FULLBACK.SET  is an  incremental backup and
  1018.  NSCHED has to perform an incremental backup, /TI is still supplied.
  1019.  
  1020.  
  1021.  4.1.4 Checking
  1022.  ───────────────────────────────────────────────────────────────────────
  1023.  After a certain time it could be possible that there are mismatches  in
  1024.  your Norton  Backup data-files.  This is  not the  case if  you use the
  1025.  correct options  AND leave  all your  data as-is,  but normally it will
  1026.  happen that  you create  an invalid  SET (wrong  name), export  certain
  1027.  INC/FUL files  to other  media or  for other  reasons. NBS  is able  to
  1028.  check  the  majority  of  data-files  that  reside in the Norton Backup
  1029.  data-dir.  This  is done by  calling NBS with  the /NBSCHK command-line
  1030.  parameter.  NBS will do the following:
  1031.  
  1032.  - NBS will unpack ALL files from NBS.ZIP into the data-directory;
  1033.  
  1034.  - It will read all catalog (CAT) files;
  1035.  
  1036.  - It  will  compare  all  SET's  against  CAT's.  If  a CATalog has  no
  1037.    matching SET file,  a message is  displayed. You now  have the option
  1038.    to delete the CAT(alog) file  and all other related files.  These are
  1039.    the SAV, SLT, BAK and RPT files with the same name as the CAT(alog);
  1040.  
  1041.  - It will compare all CAT's against  SET's. If a SET has no catalog,  a
  1042.    message is displayed. You now have  the option to delete the SET  and
  1043.    all belonging files (see previous point);
  1044.  
  1045.  - Now NBS will compare CAT files against the files that belong to  that
  1046.    CAT file. If a CAT points to a file (f.i. a *.INC or *.FUL file)  and
  1047.    that file is NOT present, you have the option to delete the CAT  file
  1048.    and all remaining (related) files. You can also do this by hand.  The
  1049.    fact remains that the CAT-file points to an incomplete set of  files.
  1050.    Another option  is to  restore one  or more  of the *.INC/*.FUL files
  1051.    from the backup-media (if present);
  1052.  
  1053.  - The reversed is  tested. NBS will check  if there remain files  (INC,
  1054.    FUL DIF and  so on) that  don't belong to  any catalog. You  have the
  1055.    option to remove that orphan file or you can check manually;
  1056.  
  1057.  - Last, NBS will check if  there are files that belong to  multiple CAT
  1058.    files. This  can happen  when Norton  Backup creates  a backup with a
  1059.    file like  CE30910A.FUL (for  FULLBACK.SET/FULLBACK.CAT), you  delete
  1060.    the CE30910A.FUL  file and  make a  backup for  NEWSET.SET/NEWSET.CAT
  1061.    after this delete. Chances are, that the resulting file also has  the
  1062.    name  CE30910A.FUL.  Now  FULLBACK.CAT  and  NEWSET.CAT  both have an
  1063.    entry for CE30910A.FUL. NBS can detect this and will display up to  5
  1064.    CAT  files  that  point  to  the  same  file.  No automatic action is
  1065.    possible, because NBS  will not do  a deep examination  of the files.
  1066.    You must write them down and correct the error by hand.
  1067.  
  1068.  If  you  perform  a  regular  check  (/NBSCHK)  and clean all incorrect
  1069.  entries  (either  by  hand  or  automatically),  you  will  end  with a
  1070.  complete clean set of files. You  can run /NBSCHK as many times  as you
  1071.  like,  to  see  if  the  final  result  is clean. After that, perform a
  1072.  /NBSCHK once in a while to see if the files are still correct.
  1073.  
  1074.  
  1075.  4.1.5 Updating NBS.STA
  1076.  ───────────────────────────────────────────────────────────────────────
  1077.  NBS will maintain a file called NBS.STA. This file contains information
  1078.  about  the  last  execution of either NBS and Norton Backup, as well as
  1079.  the values for  the  CycleSetx parameters (the current tape to use) and
  1080.  the seconds  passed  since  the  last  cleaning operation of the backup
  1081.  device.
  1082.  
  1083.  The first time, there will be no NBS.STA. In this case, NBS will create
  1084.  the file (with default values)  from  scratch. All next times, NBS will
  1085.  change and update  the  file. For  example if you change CycleSet1 from
  1086.  FULLBACK.SET to FULL.SET, NBS  will  update the NBS.STA file itself and
  1087.  will reset all the counters involved.
  1088.  
  1089.  There are  2  specific  command-line  paramaters  that  can  be used to
  1090.  update the NBS.STA file (it  is  a  binary file, so you need to use NBS
  1091.  to do this job for you).
  1092.  
  1093.  /NBSCLN will  update  the number of seconds passed after the last clean
  1094.  action to a value  of 0. This comes in handy when you cleaned the drive
  1095.  inbetween and  without  NBS telling you so. After the clean action, you
  1096.  run NBS /NBSCLN only once and the counting starts over from scratch.
  1097.  
  1098.  /NBSCSx=y will  update the current tape-number to use for the CycleSetx
  1099.  to a value of y. If 'y'  is higher than the maximum number of tapes you
  1100.  allow on the CycleSetx option, NBS will abort.
  1101.  
  1102.  When you specify either /NBSCLN or /NBSCSx=y on the command-line, there
  1103.  will be  NO  call  to  Norton Backup (or the renamed version), nor will
  1104.  there be any extraction (and archiving) of files from the NBS.ZIP file.
  1105.  
  1106.  
  1107.  4.2 Command-line parameters
  1108.  ───────────────────────────────────────────────────────────────────────
  1109.  The general syntax  of a call  to NBS is  the same as  a call to Norton
  1110.  Backup but there are a few new parameters that will trigger NBS  itself
  1111.  without interfering with Norton Backup. These extra parameters are:
  1112.  
  1113.  /NBSFTM    You instruct NBS  that it is the first execution and  that a
  1114.             NBS.ZIP has to be created and is NOT already available;
  1115.  
  1116.  /NBSCHK    You   perform checking  of the  files in  the Norton  Backup
  1117.             data-directory. Norton Backup itself is NOT executed;
  1118.  
  1119.  /NBSCLN    Will  reset  the  clean-counter in NBS.ZIP to 0 seconds. Use
  1120.             this if you cleaned the drive in-between;
  1121.  
  1122.  /NBSCSx=y  Will reset the current  tape number in CycleSetx (where x is
  1123.             1 to 9) to  the  value  'y'. 'y'  can not be higher than the
  1124.             maximum number you allow on the CycleSetx option.
  1125.  
  1126.  Newer versions of NBS will have some extra options for certain  special
  1127.  functions (user requests). If they have to be interpreted by NBS,  they
  1128.  will always begin with /NBS......
  1129.  
  1130.  
  1131.  4.3 Errors
  1132.  ───────────────────────────────────────────────────────────────────────
  1133.  All has been  done to keep  the number of  possible errors as  small as
  1134.  possible. Some errors have to do with incorrect options in NBS.INI  and
  1135.  are self-explaining.
  1136.  
  1137.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1138.  │   5   │ Version information and credits                             │
  1139.  └───────┴─────────────────────────────────────────────────────────────┘
  1140.  
  1141.  5.1 The BETA-team
  1142.  ───────────────────────────────────────────────────────────────────────
  1143.  Look into the file SUPPORT.NBS for a full list of all beta-testers  and
  1144.  support nodes.  Not all  beta-testers will  test this  program, because
  1145.  only a few of them own  their own copy of Norton Backup.  The remaining
  1146.  members will only distribute the NBS package.
  1147.  
  1148.  
  1149.  
  1150.  5.2 Credits
  1151.  ───────────────────────────────────────────────────────────────────────
  1152.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  1153.  BETA team):
  1154.  
  1155.  - Symantec Corporation for creating Norton Backup;
  1156.  
  1157.  - All   paying, registered   users. You   made it   possible to enhance
  1158.    NBS with nice features;
  1159.  
  1160.  - All users who did write me bug reports, suggestions and so on;
  1161.  
  1162.  
  1163.  
  1164.  5.3 Version history
  1165.  ───────────────────────────────────────────────────────────────────────
  1166.  ┌───────┬────────────────────────────┐
  1167.  │ 1.01  │ First version              │
  1168.  └───────┴────────────────────────────┘
  1169.   ■ First public version;
  1170.  
  1171.  
  1172.  NBS is tested with PKWare PKZIP version 2.04g and Norton Backup 2.2.      ,
  1173.  
  1174.  
  1175.  5.4 Copyright, Trademarks
  1176.  ───────────────────────────────────────────────────────────────────────
  1177.  Norton Backup     is a trademark  of Symantec Corporation
  1178.  PKZIP and PKUNZIP are  trademarks of PKWare Inc.
  1179.  Windows           is a trademark  of The Microsoft Corporation
  1180.  Ms/DOS            is a trademark  of The Microsoft Corporation
  1181.  4Dos              is a trademark  of J.P. Software/R.C. Conn/T. Rawson
  1182.  
  1183.  NBS is written  in Borland Pascal 7.0, with help of the Turbo  Debugger
  1184.  3.0 and makes extensive use of Object Professional V 1.20.
  1185.  
  1186.  Borland Pascal      is a trademark  of Borland International
  1187.  Turbo Debugger      is a trademark  of Borland International
  1188.  Object Professional is a trademark  of TurboPower Inc.
  1189.  Asynch Professional is a trademark  of TurboPower Inc.
  1190.  
  1191.  [======================== END OF DOCUMENT ============================]
  1192.