home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / decus / RB120 / treedupl.mem < prev    next >
Text File  |  1995-05-28  |  52KB  |  1,137 lines

  1.            
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                          TREEDUPL                                         TREEDUPL                                         TREEDUPL                                         TREEDUPL
  12.                             Directory Tree Duplicator Utility
  13.                                      Reference Manual
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                         June 1986
  24.  
  25.           This  document  describes  the  TREEDUPL  Directory  Tree   Duplicator
  26.           Utility.  This utility is unlicensed and unsupported.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.           Revision/Update Information:       This is a new manual.
  35.  
  36.           Operating System and Version:      MS-DOS* version 2.11 or later.
  37.  
  38.           Software Version:                  TREEDUPL version 2.0.
  39.  
  40.                                                               NOT                                                              NOT                                                              NOT          Support:                           THIS SOFTWARE IS NOT  SUPPORTED  BY
  41.                                              DIGITAL EQUIPMENT CORPORATION.
  42.  
  43.           Direct questions and comments to:  Brian Hetrick
  44.                                              ZKO1-3/J10
  45.                                              Digital Equipment Corporation
  46.                                              110 Spit Brook Road
  47.                                              Nashua NH 03062-2698
  48.                                              USA
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.           * MS is a trademark of Microsoft Corporation.
  57.  
  58.           Digital Equipment Corporation                    Maynard Massachusetts
  59.                                                                        June 1986
  60.  
  61.  
  62.  
  63.  
  64.           The information in this document is subject to change  without  notice
  65.           and  should  not  be  construed  as  a commitment by Digital Equipment
  66.           Corporation.  Digital Equipment Corporation assumes no  responsibility
  67.           for any errors that may appear in this document.
  68.  
  69.           The software described in this document is unlicensed and unsupported.
  70.           Digital Equipment Corporation assumes no responsibility for the use or          Digital Equipment Corporation assumes no responsibility for the use or          Digital Equipment Corporation assumes no responsibility for the use or          Digital Equipment Corporation assumes no responsibility for the use or
  71.           reliability of this software.          reliability of this software.          reliability of this software.          reliability of this software.  This  software  is  provided  "as  is,"
  72.           without  any  warranty  of  any  kind,  express  or  implied.  Digital
  73.           Equipment Corporation will not be liable in any event for any  damages
  74.           including  any  loss  of  data, profit, or savings, claims against the
  75.           user by any other party, or  any  other  incidental  or  consequential
  76.           damages arising out of the use of, or inability to use, this software,
  77.           even if Digital Equipment Corporation is advised of the possibility of
  78.           such damage.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.           This documentation and the software it describes have been placed into
  85.           the public domain by Digital Equipment Corporation.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.           The following are trademarks of Digital Equipment Corporation:
  92.  
  93.                DEC             MASSBUS         RSX             VAX
  94.                DECmate         PDP             RT              VAXcluster
  95.                DECnet          P/OS            ULTRIX          VMS
  96.                DECUS           Professional    ULTRIX-32       VT
  97.                DECwriter       Rainbow         ULTRIX-32M      Work Processor
  98.                DIBOL           RSTS            UNIBUS
  99.                                       _ _ _ _ _ _ _
  100.                                      | | | | | | | |
  101.                                      |d|i|g|i|t|a|l|
  102.                                      |_|_|_|_|_|_|_|
  103.                                     Table of Contents                                    Table of Contents                                    Table of Contents                                    Table of Contents
  104.  
  105.  
  106.                                                                             Page
  107.  
  108.           Preface                                                              v
  109.               Intended Audience                                                v
  110.               Structure of This Document                                       v
  111.               Associated Documents                                             v
  112.               Conventions Used in This Document                               vi
  113.               Acknowledgments                                                 vi
  114.  
  115.           Summary                                                              1
  116.               Format                                                           1
  117.                   Command Qualifiers                                           1
  118.                   Command Parameters                                           1
  119.  
  120.               Usage                                                            1
  121.                   Invoking                                                     1
  122.                   Exiting                                                      1
  123.                   Directing Output                                             2
  124.  
  125.           Description                                                          3
  126.               Invoking the Directory Tree Duplicator Utility                   4
  127.               Restrictions                                                     4
  128.  
  129.           Command Qualifiers                                                   6
  130.               /ACCUMULATE Command Qualifier                                    6
  131.                   Format                                                       6
  132.                   Description                                                  6
  133.                   Example                                                      6
  134.  
  135.               /LOG Command Qualifier                                           8
  136.                   Format                                                       8
  137.                   Description                                                  8
  138.                   Example                                                      8
  139.  
  140.           Examples                                                             9
  141.               Backing Up a Hard Disk to a DECnet-DOS Virtual Disk              9
  142.               Restoring a Hard Disk from a DECnet-DOS Virtual Disk            10
  143.                   Constructing the Bootable Diskette Containing DECnet-DOS    10
  144.                   Restoring the Hard Disk from a Virtual Disk Used as a
  145.                       Current Copy                                            12
  146.                   Restoring the Hard Disk from a Virtual Disk Used as an
  147.                       Accumulative Copy                                       13
  148.               Duplicating a Diskette                                          14
  149.               Deleting a Directory Tree                                       15
  150.            
  151.                                                        Directory Tree Duplicator
  152.                                                                          Preface
  153.  
  154.  
  155.                                          Preface                                         Preface                                         Preface                                         Preface
  156.  
  157.  
  158.  
  159.           Intended Audience          Intended Audience          Intended Audience          Intended Audience
  160.  
  161.                This manual is intended for all MS-DOS and DECnet-DOS users.
  162.  
  163.  
  164.  
  165.           Structure of This Document          Structure of This Document          Structure of This Document          Structure of This Document
  166.  
  167.                This document has four major sections:
  168.  
  169.                 o  The Summary section is an  overview  of  the  Directory  Tree
  170.                    Duplicator  Utility  and  is  intended  as  a quick reference
  171.                    guide.  The Format  subsection  describes  the  command  that
  172.                    invokes  the  Directory  Tree Duplicator Utility, listing all
  173.                    command qualifiers  and  parameters.   The  Usage  subsection
  174.                    describes   how  to  invoke  the  Directory  Tree  Duplicator
  175.                    Utility, how to redirect output, and  any  restrictions  that
  176.                    you should be aware of.
  177.  
  178.                 o  The Description section explains how  to  use  the  Directory
  179.                    Tree Duplicator Utility.
  180.  
  181.                 o  The  Command  Qualifier  section   describes   each   command
  182.                    qualifier.  Command qualifiers appear in alphabetical order.
  183.  
  184.                 o  The Examples section contains examples of  common  operations
  185.                    that you perform with the Directory Tree Duplicator Utility.
  186.  
  187.  
  188.  
  189.           Associated Documents          Associated Documents          Associated Documents          Associated Documents
  190.  
  191.                To use the Directory Tree Duplicator Utility, you should also  be
  192.                familiar with the following manual:
  193.  
  194.                    ______ ______ _____      ____  _________  ______                o  MS-DOS User's Guide, or  Disk  Operating  System  manual,  as
  195.                    appropriate
  196.  
  197.                To use the Directory Tree Duplicator Utility in conjunction  with
  198.                DECnet-DOS  virtual  disks,  you should also be familiar with the
  199.                following manual
  200.  
  201.                    __________ ______ _____                o  DECnet-DOS User's Guide
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                                             v
  209.           Directory Tree Duplicator
  210.           Preface
  211.  
  212.  
  213.           Conventions Used in This Document          Conventions Used in This Document          Conventions Used in This Document          Conventions Used in This Document
  214.  
  215.                Convention           Meaning
  216.  
  217.                  TREEDUPL E:\ G:\                 TREEDUPL E:\ G:\                 TREEDUPL E:\ G:\               E>TREEDUPL E:\ G:\   Command examples show all  output  lines  or
  218.                                     prompting  characters that the system prints
  219.                                     or   displays   in   normal    type.     All
  220.                                                                             bold                                                                            bold                                                                            bold                                    user-entered  commands  are  shown  in  bold
  221.                                     type.
  222.  
  223.  
  224.                /[NO]LOG             Square brackets indicate that  the  enclosed
  225.                                     item is optional.
  226.  
  227.                <CTRL/x>             The symbol <CTRL/x> indicates that you  must
  228.                                     press   the   key  labeled  CTRL  while  you
  229.                                     simultaneously  press   another   key,   for
  230.                                     example, <CTRL/C>.
  231.  
  232.  
  233.  
  234.           Acknowledgments          Acknowledgments          Acknowledgments          Acknowledgments
  235.  
  236.                The TREEDUPL Directory Tree Duplicator Utility  uses  the  public
  237.                domain  command  line  parsing  package written by Bela Lubkin of
  238.                Borland International Inc.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                             vi
  267.                                                        Directory Tree Duplicator
  268.                                                                          Summary
  269.  
  270.  
  271.                                          Summary                                         Summary                                         Summary                                         Summary
  272.  
  273.  
  274.                The  TREEDUPL  program  copies  or  duplicates  all   files   and
  275.                directories in an entire directory tree.
  276.  
  277.  
  278.  
  279.           Format          Format          Format          Format
  280.  
  281.                         __________ __________  _________               TREEDUPL sourceroot targetroot [qualifier]
  282.  
  283.                Command Qualifiers            Defaults               Command Qualifiers            Defaults               Command Qualifiers            Defaults               Command Qualifiers            Defaults
  284.  
  285.                /[NO]ACCUMULATE               /ACCUMULATE
  286.                /[NO]LOG                      /LOG
  287.  
  288.  
  289.                Command Parameters               Command Parameters               Command Parameters               Command Parameters
  290.  
  291.                __________               sourceroot
  292.  
  293.                     Specifies the name for the root of the directory tree to  be
  294.                     copied or duplicated.
  295.  
  296.                __________               targetroot
  297.  
  298.                     Specifies the name for the root of the directory  tree  into
  299.                                                    __________                    which  the  tree  specified by sourceroot is to be copied or
  300.                     duplicated.
  301.  
  302.  
  303.  
  304.           Usage          Usage          Usage          Usage
  305.  
  306.                Invoking               Invoking               Invoking               Invoking
  307.  
  308.                     You invoke the Directory Tree Duplicator  Utility  with  the
  309.                     TREEDUPL command.
  310.  
  311.                Exiting               Exiting               Exiting               Exiting
  312.  
  313.                     You exit the Directory Tree Duplicator Utility  normally  by
  314.                     waiting  until  processing  is complete.  The Directory Tree
  315.                     Duplicator  Utility  will  return  control  to  the  command
  316.                     interpreter when processing is complete.
  317.  
  318.                     You  can  exit  the  Directory   Tree   Duplicator   Utility
  319.                     abnormally   by  typing  <CTRL/C>,  if  the  /NOLOG  command
  320.                     qualifier  has  not  been  given  or  if  the  MS-DOS  BREAK
  321.                     parameter is ON.
  322.  
  323.  
  324.                                             1
  325.           Directory Tree Duplicator
  326.           Summary
  327.  
  328.  
  329.                Directing Output               Directing Output               Directing Output               Directing Output
  330.  
  331.                     By default, messages  from  the  Directory  Tree  Duplicator
  332.                     Utility  are  directed to the console device.  Such messages
  333.                     may be directed to another device or a  file  with  the  I/O
  334.                     redirection facilities of the command interpreter.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.                                             2
  383.                                                        Directory Tree Duplicator
  384.                                                                      Description
  385.  
  386.  
  387.                                        Description                                       Description                                       Description                                       Description
  388.  
  389.                The Directory Tree Duplicator Utility is a command-line  oriented
  390.                program  used  to  copy  all  directories  and files in an entire
  391.                directory tree to another directory, or to  force  one  directory
  392.                tree to duplicate another.
  393.  
  394.                Through the use of the Directory Tree Duplicator Utility, you can
  395.                maintain a backup copy of your personal computer's hard disk in a
  396.                DECnet-DOS virtual disk maintained an another node  of  a  DECnet
  397.                network,  or  duplicate  the  complete  contents of a diskette on
  398.                another diskette, or delete an entire directory tree, or move  an
  399.                entire directory tree from one directory to another.
  400.  
  401.  
  402.  
  403.           Invoking the Directory Tree Duplicator Utility          Invoking the Directory Tree Duplicator Utility          Invoking the Directory Tree Duplicator Utility          Invoking the Directory Tree Duplicator Utility
  404.  
  405.                The  Directory  Tree  Duplicator  Utility  is  invoked  with  the
  406.                TREEDUPL  command,  followed by the name of the root directory of
  407.                the source directory tree (the directory tree  to  be  copied  or
  408.                duplicated),  followed  by  the name of the root directory of the
  409.                target directory tree (the directory tree to  be  produced).   No
  410.                wild  card  characters  are  allowed  in  either  name.   Command
  411.                qualifiers may follow any of these  components  of  the  command.
  412.                For  example,  the  following  command copies all directories and
  413.                files on the volume in drive A to the volume in drive B:
  414.  
  415.                       TREEDUPL A:\ B:\                      TREEDUPL A:\ B:\                      TREEDUPL A:\ B:\                    E>TREEDUPL A:\ B:\
  416.  
  417.                If a drive letter is specified, the directory is  interpreted  as
  418.                residing  on  the  volume in the specified drive.  Otherwise, the
  419.                directory is interpreted as residing on the volume in the current
  420.                drive.   If  the directory name starts with a back slash (\), the
  421.                directory name is interpreted as relative to the  root  directory
  422.                of  the  volume.  Otherwise, the directory name is interpreted as
  423.                relative to the current directory on the volume.
  424.  
  425.                If the current directory on the volume in drive  E  is  the  root
  426.                directory,  and the current directory on the volume in drive G is
  427.                \E_SAVE, then the command:
  428.  
  429.                       TREEDUPL E: G:                      TREEDUPL E: G:                      TREEDUPL E: G:                    E>TREEDUPL E: G:
  430.  
  431.                will copy all directories and files on the entire volume in drive
  432.                E  into  a  directory tree rooted at the directory \E_SAVE of the
  433.                volume in drive G.
  434.  
  435.                Except in the root directory of a volume, a single period (.)  in
  436.                the  place  of  the  first  directory  name refers to the current
  437.                directory, and two periods (..)  refers  to  the  parent  of  the
  438.                current  directory.   In  the  root  directory of a volume, these
  439.  
  440.                                             3
  441.           Directory Tree Duplicator
  442.           Description
  443.  
  444.  
  445.                cannot be used.  A single back slash always refers  to  the  root
  446.                directory of a volume.
  447.  
  448.                The Directory Tree Duplicator Utility copies all directories  and
  449.                files  from  the  source  directory  tree to the target directory
  450.                tree.   However,  the  Directory  Tree  Duplicator  Utility  will
  451.                attempt  not  to  copy  files which are apparently already at the
  452.                appropriate  position  in  the  target   directory   tree.    For
  453.                non-directory  files,  the Directory Tree Duplicator Utility will
  454.                not copy a file in the source directory tree (the "source  file")
  455.                if:
  456.  
  457.                 o  There is a  file  of  the  same  name  in  the  corresponding
  458.                    position in the target directory tree (the "target file");
  459.  
  460.                 o  The sizes of the source file and the target file are equal;
  461.  
  462.                 o  The modification dates and times of the source file  and  the
  463.                    target file are equal.
  464.  
  465.                If there is a target file that appears to  be  the  same  as  the
  466.                source file based on these characteristics, then its contents are
  467.                not modified, but its file attributes (read-only, system, hidden,
  468.                and archive) are set to be the same as those of the source file.
  469.  
  470.                If there is a target file that appears to be different  from  the
  471.                source  file based on these characteristics, then the target file
  472.                is deleted and the source file is copied to its place.  The  file
  473.                size,  file  attributes (read only, hidden, system, and archive),
  474.                and file modification date and  time  of  the  copy  are  set  to
  475.                duplicate those of the source file.
  476.  
  477.                For a directory in the source directory tree, the Directory  Tree
  478.                Duplicator  Utility  will create a corresponding directory in the
  479.                target directory  tree  unless  one  already  exists.   The  file
  480.                attributes  of  the  new  or existing directory are set to be the
  481.                same as those of the directory in the source directory tree.
  482.  
  483.                The Directory Tree Duplicator Utility can also delete  all  files
  484.                in the target directory tree that are not in the source directory
  485.                tree.  The /ACCUMULATE command qualifier controls this behavior.
  486.  
  487.                By default, the Directory Tree Duplicator Utility issues messages
  488.                describing  its  actions.  These messages can be suppressed.  The
  489.                /LOG command qualifier controls this behavior.
  490.  
  491.  
  492.  
  493.           Restrictions          Restrictions          Restrictions          Restrictions
  494.  
  495.                The Directory Tree Duplicator Utility cannot be used  to  copy  a
  496.                source  directory tree into a target directory tree whose root is
  497.  
  498.                                             4
  499.                                                        Directory Tree Duplicator
  500.                                                                      Description
  501.  
  502.  
  503.                in the source directory tree itself.  For example, the command:
  504.  
  505.                       TREEDUPL E:\SUBDIR1 E:\SUBDIR1\SUBDIR2                      TREEDUPL E:\SUBDIR1 E:\SUBDIR1\SUBDIR2                      TREEDUPL E:\SUBDIR1 E:\SUBDIR1\SUBDIR2                    E>TREEDUPL E:\SUBDIR1 E:\SUBDIR1\SUBDIR2
  506.  
  507.                would fail as the \SUBDIR1\SUBDIR2 directory is in the  directory
  508.                tree having \SUBDIR1 as its root.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.                                             5
  557.           Directory Tree Duplicator
  558.           Command Qualifiers
  559.  
  560.  
  561.                               /ACCUMULATE Command Qualifier                              /ACCUMULATE Command Qualifier                              /ACCUMULATE Command Qualifier                              /ACCUMULATE Command Qualifier
  562.  
  563.  
  564.  
  565.           Format          Format          Format          Format
  566.  
  567.                /ACCUMULATE
  568.                /NOACCUMULATE
  569.  
  570.  
  571.  
  572.           Description          Description          Description          Description
  573.  
  574.                By default, the Directory Tree  Duplicator  Utility  retains  all
  575.                files  and directories in the target directory, unless there is a
  576.                corresponding file in the source directory tree that is different
  577.                from the file or directory in the target directory.  However, the
  578.                Directory  Tree  Duplicator  Utility  can  "prune"   the   target
  579.                directory tree, that is, delete files and directories that do not
  580.                appear in the source directory  tree.   The  /ACCUMULATE  command
  581.                qualifier  controls this behavior.  If you specify /NOACCUMULATE,
  582.                files and directories in the target directory that do not  appear
  583.                in  the  source directory are deleted.  If you omit the qualifier
  584.                or specify /ACCUMULATE, files in the target directory that do not
  585.                appear in the source directory are retained.
  586.  
  587.                If you specify /NOACCUMULATE, even files and directories  in  the
  588.                target directory tree with the read-only attribute are deleted if
  589.                they do not exist in the source directory tree.
  590.  
  591.  
  592.  
  593.           Example          Example          Example          Example
  594.  
  595.                  TREEDUPL A:\ B:\ /NOACCUMULATE                 TREEDUPL A:\ B:\ /NOACCUMULATE                 TREEDUPL A:\ B:\ /NOACCUMULATE               E>TREEDUPL A:\ B:\ /NOACCUMULATE
  596.                TREEDUPL version 2.0
  597.  
  598.                Copied A:\AUTOEXEC.BAT to B:\AUTOEXEC.BAT
  599.                Copied A:\COMMAND.COM to B:\COMMAND.COM
  600.                Copied A:\CONFIG.SYS to B:\CONFIG.SYS
  601.                Copied A:\IO.SYS to B:\IO.SYS
  602.                Copied A:\MSDOS.SYS to B:\MSDOS.SYS
  603.                Deleted B:\TREEDUPL\CLA.PAS
  604.                Deleted B:\TREEDUPL\TREEDUPL.COM
  605.                Deleted B:\TREEDUPL\TREEDUPL.PAS
  606.                Deleted B:\TREEDUPL
  607.  
  608.                E>
  609.  
  610.                With this command, the directory tree of the  volume  mounted  in
  611.                drive  A  is exactly replicated on the volume mounted in drive B.
  612.                Files on the volume in drive A that are  not  on  the  volume  in
  613.  
  614.                                             6
  615.                                                        Directory Tree Duplicator
  616.                                                               Command Qualifiers
  617.  
  618.  
  619.                drive  B  are  copied  onto  the  volume in drive B; files on the
  620.                volume in drive B that are not on  the  volume  in  drive  A  are
  621.                deleted.   In  the example, the \TREEDUPL directory of the volume
  622.                in drive B did not appear on the volume in drive A,  and  so  the
  623.                directory's contents and then the directory itself were deleted.
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.                                             7
  673.           Directory Tree Duplicator
  674.           Command Qualifiers
  675.  
  676.  
  677.                                   /LOG Command Qualifier                                  /LOG Command Qualifier                                  /LOG Command Qualifier                                  /LOG Command Qualifier
  678.  
  679.  
  680.  
  681.           Format          Format          Format          Format
  682.  
  683.                /LOG
  684.                /NOLOG
  685.  
  686.  
  687.  
  688.           Description          Description          Description          Description
  689.  
  690.                By  default,  the  Directory  Tree  Duplicator  Utility  produces
  691.                messages  describing its actions.  These messages are produced on
  692.                the standard output, which is normally directed to  the  console.
  693.                The  /LOG  command  qualifier  controls  the  production of these
  694.                messages.  If you specify /NOLOG, no messages are  produced.   If
  695.                you  omit  the  qualifier  or specify /LOG, messages are produced
  696.                whenever a file is copied or deleted, a directory is  created  or
  697.                deleted, and whenever a file's attributes are modified.
  698.  
  699.  
  700.  
  701.           Example          Example          Example          Example
  702.  
  703.                  TREEDUPL A:\ B:\ /NOLOG                 TREEDUPL A:\ B:\ /NOLOG                 TREEDUPL A:\ B:\ /NOLOG               E>TREEDUPL A:\ B:\ /NOLOG
  704.                TREEDUPL version 2.0
  705.  
  706.                E>
  707.  
  708.                With this command, messages describing the actions taken  by  the
  709.                Directory Tree Duplicator Utility to copy the files on the volume
  710.                in drive A to the volume in drive B are not issued.
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                             8
  731.                                                        Directory Tree Duplicator
  732.                                                                         Examples
  733.  
  734.  
  735.                                          Examples                                         Examples                                         Examples                                         Examples
  736.  
  737.  
  738.  
  739.           Backing Up a Hard Disk to a DECnet-DOS Virtual Disk          Backing Up a Hard Disk to a DECnet-DOS Virtual Disk          Backing Up a Hard Disk to a DECnet-DOS Virtual Disk          Backing Up a Hard Disk to a DECnet-DOS Virtual Disk
  740.  
  741.                You can make a backup copy of the data on your hard disk using  a
  742.                DECnet-DOS  virtual  disk  as  the backup medium.  The DECnet-DOS
  743.                virtual disk will then be backed  up  to  archival  storage  (for
  744.                example,  magnetic tape) under the standard backup procedures for
  745.                the remote node on which the virtual disk resides.  This form  of
  746.                backup  can  be  unattended,  as  it  is  not necessary to change
  747.                volumes in a small capacity diskette drive.
  748.  
  749.                                                                    _______               You should first decide whether you want to keep a  current  copy
  750.                                                 ____________               of  the data on your disk, or an accumulative copy of the data on
  751.                your disk.  A current copy will have only the data on  your  disk
  752.                as  of  the  most recent backup; an accumulative copy will retain
  753.                old files that you  have  deleted  on  your  disk.   However,  an
  754.                accumulative  copy  will  not  retain  old versions of files that
  755.                still exist; only the most recent version of  any  file  will  is
  756.                retained.   An  accumulative  copy  will require a larger virtual
  757.                disk than will a current copy.  Also,  an  accumulative  copy  is
  758.                more difficult to restore from than is a current copy.
  759.  
  760.                Similarly, if you have several  hard  disks,  you  should  decide
  761.                whether  to  back  these  up  into  a single virtual disk or into
  762.                several virtual disks.  Backing up  several  hard  disks  into  a
  763.                single  virtual disk will require a larger virtual disk than will
  764.                backing up each hard disk into separate virtual disks.
  765.  
  766.                Before backing up your hard disk's data for the first  time,  you
  767.                must  create  the DECnet-DOS virtual disk.  You do this using the
  768.                                _        _       _               DECnet-DOS NDU (Network  Device  Utility)  CREATE  command.   For
  769.                example, the command:
  770.  
  771.                       NDU CREATE DRIVE G NODE EVER11 NDISK HDBACKUP.DSK MAX 32                      NDU CREATE DRIVE G NODE EVER11 NDISK HDBACKUP.DSK MAX 32                      NDU CREATE DRIVE G NODE EVER11 NDISK HDBACKUP.DSK MAX 32                    E>NDU CREATE DRIVE G NODE EVER11 NDISK HDBACKUP.DSK MAX 32
  772.  
  773.                creates a 32 megabyte virtual disk in the  default  directory  of
  774.                the  account  specified  by the default access control string for
  775.                node EVER11, and makes that disk available through  MS-DOS  drive
  776.                letter G.
  777.  
  778.                After using the NDU CREATE command, to create a new virtual disk,
  779.                or  the  NDU  OPEN command, to access an already existing virtual
  780.                disk, you can  backup  your  hard  disk  contents  by  using  the
  781.                Directory Tree Duplication Utility to copy the hard disk contents
  782.                to the virtual disk.  For example, the commands:
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                             9
  789.           Directory Tree Duplicator
  790.           Examples
  791.  
  792.  
  793.                       TREEDUPL E:\ G:\E_BACKUP /NOLOG                      TREEDUPL E:\ G:\E_BACKUP /NOLOG                      TREEDUPL E:\ G:\E_BACKUP /NOLOG                    E>TREEDUPL E:\ G:\E_BACKUP /NOLOG
  794.                     TREEDUPL version 2.0
  795.  
  796.                       TREEDUPL F:\ G:\F_BACKUP /NOLOG                      TREEDUPL F:\ G:\F_BACKUP /NOLOG                      TREEDUPL F:\ G:\F_BACKUP /NOLOG                    E>TREEDUPL F:\ G:\F_BACKUP /NOLOG
  797.                     TREEDUPL version 2.0
  798.  
  799.                copy all files and directories on the hard disk in drive  E  into
  800.                the  directory  \E_BACKUP  on the virtual disk currently accessed
  801.                through drive letter G, and copies all files and  directories  on
  802.                the  hard  disk  in  drive  F into the directory \F_BACKUP on the
  803.                virtual disk currently accessed through drive letter G.   Because
  804.                the   /NOACCUMULATE   command   qualifier   is   not   specified,
  805.                accumulative copies of the data on the hard disks in drives E and
  806.                F are made.  Similarly, the commands:
  807.  
  808.                       TREEDUPL/NOACCUMULATE E:\ G:\E_BACKUP /NOLOG                      TREEDUPL/NOACCUMULATE E:\ G:\E_BACKUP /NOLOG                      TREEDUPL/NOACCUMULATE E:\ G:\E_BACKUP /NOLOG                    E>TREEDUPL/NOACCUMULATE E:\ G:\E_BACKUP /NOLOG
  809.                     TREEDUPL version 2.0
  810.  
  811.                       TREEDUPL/NOACCUMULATE F:\ G:\F_BACKUP /NOLOG                      TREEDUPL/NOACCUMULATE F:\ G:\F_BACKUP /NOLOG                      TREEDUPL/NOACCUMULATE F:\ G:\F_BACKUP /NOLOG                    E>TREEDUPL/NOACCUMULATE F:\ G:\F_BACKUP /NOLOG
  812.                     TREEDUPL version 2.0
  813.  
  814.                construct current copies of the data on the hard disks in  drives
  815.                E and F.
  816.  
  817.  
  818.  
  819.           Restoring a Hard Disk from a DECnet-DOS Virtual Disk          Restoring a Hard Disk from a DECnet-DOS Virtual Disk          Restoring a Hard Disk from a DECnet-DOS Virtual Disk          Restoring a Hard Disk from a DECnet-DOS Virtual Disk
  820.  
  821.                You can restore the contents of a  corrupted  hard  disk  from  a
  822.                DECnet-DOS virtual disk which has been used as an accumulative or
  823.                a current copy of the files and directories on your disk.  As the
  824.                hard  disk  may  be unusable as a system device should this prove
  825.                necessary,  you  will  need  to  have  on  a  diskette  a  system
  826.                sufficient  to  restore  the files and directories on the virtual
  827.                disk to the hard disk.  You can  then  use  this  diskette  based
  828.                system  to restore the contents of the hard disk from the virtual
  829.                disk copy.
  830.  
  831.                Constructing the Bootable Diskette Containing DECnet-DOS               Constructing the Bootable Diskette Containing DECnet-DOS               Constructing the Bootable Diskette Containing DECnet-DOS               Constructing the Bootable Diskette Containing DECnet-DOS
  832.  
  833.                     You must first construct a  bootable  diskette  system  that
  834.                     permits  you  to  access  DECnet-DOS  virtual disks.  First,
  835.                     format a system diskette; for example, the command:
  836.  
  837.                            FORMAT A:/S                           FORMAT A:/S                           FORMAT A:/S                         E>FORMAT A:/S
  838.  
  839.                     will construct  a  bootable  diskette  containing  only  the
  840.                     MS-DOS system on the diskette in drive A.  Then, ensure that
  841.                     the necessary DECnet-DOS files are on the diskette.  You may
  842.                     either  install  DECnet-DOS  onto  the diskette, or copy the
  843.                     DECnet-DOS files from your hard disk onto the diskette.   In
  844.                     either   case,   the   only   purpose   of  this  DECnet-DOS
  845.  
  846.                                             10
  847.                                                        Directory Tree Duplicator
  848.                                                                         Examples
  849.  
  850.  
  851.                     installation is to access a virtual disk on a single  remote
  852.                     node,  so  most  DECnet-DOS  utilities need not be included.
  853.                     For example, a bootable system diskette for a  Rainbow  100A
  854.                     system  to be used with a serial communications line that is
  855.                     dynamically switched to DDCMP  protocol  might  contain  the
  856.                     visible files:
  857.  
  858.                          COMMAND.COM   The MS-DOS command interpreter
  859.                          NDDRV.SYS     Network disk driver
  860.                          FIX100A.COM   Rainbow 100A interrupt structure fixup
  861.                          SCH.EXE       DECnet-DOS scheduler
  862.                          DNP.EXE       DECnet-DOS DECnet process
  863.                          NCP.EXE       Network Control Program
  864.                          NCP.TXT       Initialization commands for NCP
  865.                          NDU.EXE       Network Device Utility
  866.                          CONFIG.SYS    MS-DOS boot configuration commands
  867.                          AUTOEXEC.BAT  Startup commands
  868.                          KERMIT.EXE    Terminal emulation program
  869.                          DECNET        Empty subdirectory
  870.                          TREEDUPL.COM  The Directory Tree Duplicator Utility
  871.  
  872.                     The contents of CONFIG.SYS might be:
  873.  
  874.                          DEVICE=NDDRV.SYS
  875.                          FILES=20
  876.                          BUFFERS=32
  877.  
  878.                     while the contents of AUTOEXEC.BAT might be:
  879.  
  880.                          PATH A:\
  881.                          FIX100A
  882.                          SCH
  883.                          DNP A:\DECNET\
  884.  
  885.                     Complete  installation  of  DECnet-DOS   by   booting   this
  886.                     diskette,  invoking  NCP  to accept the commands in NCP.TXT,
  887.                     and defining the transmit and receive passwords, if any, and
  888.                     defining  the adjacent node and the remote node on which the
  889.                     virtual disk resides.
  890.  
  891.                     You should test  this  diskette  by  rebooting  from  it  to
  892.                     install the now initialized DECnet network, and bring up the
  893.                     DECnet line in the normal fashion.  Then use  the  NDU  OPEN
  894.                     command  to attempt to access the virtual disk you are using
  895.                     as a backup of your hard disk.   When  you  can  access  the
  896.                     files  on  the  virtual  disk  using  only the system on the
  897.                     diskette, you have created the bootable diskette  containing
  898.                     DECnet-DOS  that can be used to restore the hard disk should
  899.                     it become corrupt.
  900.  
  901.  
  902.  
  903.  
  904.                                             11
  905.           Directory Tree Duplicator
  906.           Examples
  907.  
  908.  
  909.                Restoring the Hard Disk from a Virtual Disk  Used  as  a  Current               Restoring the Hard Disk from a Virtual Disk  Used  as  a  Current               Restoring the Hard Disk from a Virtual Disk  Used  as  a  Current               Restoring the Hard Disk from a Virtual Disk  Used  as  a  Current
  910.                Copy               Copy               Copy               Copy
  911.  
  912.                     To restore the contents of the  hard  disk  from  a  virtual
  913.                     disk, you must first ensure that the hard disk is in a state
  914.                     acceptable to MS-DOS.  This may require that you format  the
  915.                     disk,  and,  if the hard disk is to be bootable, install the
  916.                     MS-DOS system.
  917.  
  918.                     When the hard disk has been  prepared,  you  must  boot  the
  919.                     diskette  containing DECnet-DOS, bring up the DECnet line in
  920.                     the  normal  fashion,  and  use  the  NDU  utility  to  make
  921.                     accessible  the  virtual disk containing the current copy of
  922.                     the hard disk's contents.
  923.  
  924.                     If files or directories have been stored onto the hard  disk
  925.                     which  are  not  to  be  destroyed  (for example, the MS-DOS
  926.                     operating system), you must now use the standard MS-DOS COPY
  927.                     and   MKDIR  commands,  or  the  Directory  Tree  Duplicator
  928.                     Utility, to ensure that  these  files  and  directories  are
  929.                     reflected in the virtual disk.  For example, the command:
  930.  
  931.                            TREEDUPL E:\ I:\ /NOLOG                           TREEDUPL E:\ I:\ /NOLOG                           TREEDUPL E:\ I:\ /NOLOG                         A>TREEDUPL E:\ I:\ /NOLOG
  932.                          TREEDUPL version 2.0
  933.  
  934.                     would ensure that restoring the files and directories on the
  935.                     virtual  disk  accessible through drive letter I to the hard
  936.                     disk  in  drive  E  would  not  overwrite  the   files   and
  937.                     directories currently on the hard disk in drive E.
  938.  
  939.                     Now, you can copy the files and directories on  the  virtual
  940.                     disk  to  the  hard disk using the Directory Tree Duplicator
  941.                     Utility.  For example, the command:
  942.  
  943.                            TREEDUPL I:\ E:\ /NOLOG                           TREEDUPL I:\ E:\ /NOLOG                           TREEDUPL I:\ E:\ /NOLOG                         A>TREEDUPL I:\ E:\ /NOLOG
  944.                          TREEDUPL version 2.0
  945.  
  946.                     would copy all files on the virtual disk accessible  through
  947.                     drive letter I to the hard disk in drive E.
  948.  
  949.                     At this point, the files and directories have been restored.
  950.                     You  can  now  boot  the  computer in your usual fashion and
  951.                     proceed with the newly restored hard disk.
  952.  
  953.                Restoring  the  Hard  Disk  from  a  Virtual  Disk  Used  as   an               Restoring  the  Hard  Disk  from  a  Virtual  Disk  Used  as   an               Restoring  the  Hard  Disk  from  a  Virtual  Disk  Used  as   an               Restoring  the  Hard  Disk  from  a  Virtual  Disk  Used  as   an
  954.                Accumulative Copy               Accumulative Copy               Accumulative Copy               Accumulative Copy
  955.  
  956.                     To restore the contents of the  hard  disk  from  a  virtual
  957.                     disk, you must first ensure that the hard disk is in a state
  958.                     acceptable to MS-DOS.  This may require that you format  the
  959.                     disk,  and,  if the hard disk is to be bootable, install the
  960.                     MS-DOS system.
  961.  
  962.                                             12
  963.                                                        Directory Tree Duplicator
  964.                                                                         Examples
  965.  
  966.  
  967.                     When the hard disk has been  prepared,  you  must  boot  the
  968.                     bootable diskette containing DECnet-DOS, bring up the DECnet
  969.                     line in the normal fashion, and use the NDU utility to  make
  970.                     accessible the virtual disk containing the accumulative copy
  971.                     of the hard disk's contents.
  972.  
  973.                     If files or directories have been stored onto the hard  disk
  974.                     which  are  not  to  be  destroyed  (for example, the MS-DOS
  975.                     operating system), you must now use the standard MS-DOS COPY
  976.                     and   MKDIR  commands,  or  the  Directory  Tree  Duplicator
  977.                     Utility, to ensure that  these  files  and  directories  are
  978.                     reflected in the virtual disk.  For example, the command:
  979.  
  980.                            TREEDUPL E:\ I:\ /NOLOG                           TREEDUPL E:\ I:\ /NOLOG                           TREEDUPL E:\ I:\ /NOLOG                         A>TREEDUPL E:\ I:\ /NOLOG
  981.                          TREEDUPL version 2.0
  982.  
  983.                     would ensure that restoring the files and directories on the
  984.                     virtual  disk  accessible through drive letter I to the hard
  985.                     disk  in  drive  E  would  not  overwrite  the   files   and
  986.                     directories currently on the hard disk in drive E.
  987.  
  988.                     If the files and directories on the virtual  disk  will  fit
  989.                     onto the hard disk, the simplest procedure is to restore the
  990.                     entire contents of the virtual disk to  the  hard  disk  and
  991.                     then  to  individually delete files and directory trees that
  992.                     are not needed.  For example, the command:
  993.  
  994.                            TREEDUPL I:\ E:\ /NOLOG                           TREEDUPL I:\ E:\ /NOLOG                           TREEDUPL I:\ E:\ /NOLOG                         A>TREEDUPL I:\ E:\ /NOLOG
  995.                          TREEDUPL version 2.0
  996.  
  997.                     would copy all files on the virtual disk accessible  through
  998.                     drive  letter  I  to the hard disk in drive E.  The unwanted
  999.                     files  and  directories  could  then  be  deleted  with  the
  1000.                     standard  MS-DOS DEL and RMDIR commands, and entire unwanted
  1001.                     directory trees could then be  deleted  with  the  Directory
  1002.                     Tree Duplicator Utility.
  1003.  
  1004.                     If the files and directories on the virtual  disk  will  not
  1005.                     fit   onto  the  hard  disk,  then  copying  all  files  and
  1006.                     directories on the virtual disk to  the  hard  disk  is  not
  1007.                     possible.   You must manually direct a process in which only
  1008.                     some of the files and directories on the  virtual  disk  are
  1009.                     copied onto the hard disk.
  1010.  
  1011.                     The first method of copying only some files and  directories
  1012.                     on the virtual disk onto the hard disk is to copy individual
  1013.                     files and directory trees from the virtual disk to the  hard
  1014.                     disk  using the standard MS-DOS MKDIR and COPY commands, and
  1015.                     the Directory Tree Duplicator Utility.
  1016.  
  1017.                     The second method of copying only some files and directories
  1018.                     on  the  virtual  disk  onto  the  hard  disk  is  to delete
  1019.  
  1020.                                             13
  1021.           Directory Tree Duplicator
  1022.           Examples
  1023.  
  1024.  
  1025.                     individual files and directory trees from the virtual  disk,
  1026.                     using  the  standard  MS-DOS DEL and RMDIR commands, and the
  1027.                     Directory  Tree  Duplicator  Utility,  and  then  copy   all
  1028.                     remaining  files  and directories on the virtual disk to the
  1029.                     hard disk.  Since this process destroys some of the contents
  1030.                     of  the virtual disk, you may want to use the DECnet network
  1031.                     remote node's  file  copy  command  to  create  a  temporary
  1032.                     duplicate  of the virtual disk.  This temporary duplicate of
  1033.                     the virtual disk can be used as the virtual disk from  which
  1034.                     the  restoration  is  to  take  place:  individual files and
  1035.                     directory trees may be deleted  freely  from  the  temporary
  1036.                     duplicate,  without  affecting  the contents of the original
  1037.                     virtual disk.
  1038.  
  1039.                     When  all  files  and  directories  of  interest  have  been
  1040.                     restored,  you  can  boot the computer in your usual fashion
  1041.                     and proceed with the newly restored hard disk.
  1042.  
  1043.  
  1044.  
  1045.           Duplicating a Diskette          Duplicating a Diskette          Duplicating a Diskette          Duplicating a Diskette
  1046.  
  1047.                You can duplicate the contents of a diskette using the  Directory
  1048.                Tree Duplicator Utility.
  1049.  
  1050.                First, place the diskette to  be  duplicated  into  one  diskette
  1051.                drive.   Then,  place the diskette onto which the duplicate is to
  1052.                be made into a second diskette drive.  It is advisable to  format
  1053.                the  second diskette, but this step is often not necessary.  Then
  1054.                use the TREEDUPL command with the /NOACCUMULATE command qualifier
  1055.                to  duplicate  the contents of the first diskette onto the second
  1056.                diskette.
  1057.  
  1058.                For example, if the diskette to be  duplicated  has  been  placed
  1059.                into  drive  A,  and  the  diskette  to receive the copy has been
  1060.                placed into drive B, then the command:
  1061.  
  1062.                       TREEDUPL A:\ B:\ /NOACCUMULATE /NOLOG                      TREEDUPL A:\ B:\ /NOACCUMULATE /NOLOG                      TREEDUPL A:\ B:\ /NOACCUMULATE /NOLOG                    E>TREEDUPL A:\ B:\ /NOACCUMULATE /NOLOG
  1063.  
  1064.                will duplicate the contents of the diskette in drive A  onto  the
  1065.                diskette in drive B.
  1066.  
  1067.                It is possible to duplicate the contents of a  diskette  even  if
  1068.                you have only one diskette drive, as long as you have a hard disk
  1069.                or DECnet-DOS  virtual  disk  with  enough  free  space.   First,
  1070.                duplicate the diskette into a newly created directory on the hard
  1071.                disk or DECnet-DOS virtual disk; then duplicate the directory  on
  1072.                the hard disk or DECnet-DOS virtual disk.
  1073.  
  1074.                For example, the commands:
  1075.  
  1076.                       MKDIR E:\DISKCOPY                      MKDIR E:\DISKCOPY                      MKDIR E:\DISKCOPY                    E>MKDIR E:\DISKCOPY
  1077.  
  1078.                                             14
  1079.                                                        Directory Tree Duplicator
  1080.                                                                         Examples
  1081.  
  1082.  
  1083.                       TREEDUPL A:\ E:\DISKCOPY/NOLOG                      TREEDUPL A:\ E:\DISKCOPY/NOLOG                      TREEDUPL A:\ E:\DISKCOPY/NOLOG                    E>TREEDUPL A:\ E:\DISKCOPY/NOLOG
  1084.                     TREEDUPL version 2.0
  1085.  
  1086.                create a directory on the disk in drive  E,  and  then  copy  the
  1087.                contents  of  the  diskette  in drive A into that directory.  The
  1088.                subsequent command:
  1089.  
  1090.                       TREEDUPL/NOACCUMULATE/NOLOG E:\DISKCOPY A:\                      TREEDUPL/NOACCUMULATE/NOLOG E:\DISKCOPY A:\                      TREEDUPL/NOACCUMULATE/NOLOG E:\DISKCOPY A:\                    E>TREEDUPL/NOACCUMULATE/NOLOG E:\DISKCOPY A:\
  1091.                     TREEDUPL version 2.0
  1092.  
  1093.                will copy the directories and files onto the diskette in drive A.
  1094.  
  1095.  
  1096.  
  1097.           Deleting a Directory Tree          Deleting a Directory Tree          Deleting a Directory Tree          Deleting a Directory Tree
  1098.  
  1099.                You can delete an entire directory  tree,  even  if  it  contains
  1100.                read-only,  hidden,  or  system  files,  using the Directory Tree
  1101.                Duplicator Utility.
  1102.  
  1103.                You first create an empty directory, then copy it to the root  of
  1104.                the  directory tree to be deleted using the /NOACCUMULATE command
  1105.                qualifier, then remove both the empty directory you  created  and
  1106.                the  now-empty  directory.   For example, to remove the directory
  1107.                tree rooted at \WORK\QRTR1, you could issue the commands:
  1108.  
  1109.                       MKDIR \EMPTY                      MKDIR \EMPTY                      MKDIR \EMPTY                    E>MKDIR \EMPTY
  1110.  
  1111.                       TREEDUPL/NOLOG/NOACCUMULATE \EMPTY \WORK\QRTR1                      TREEDUPL/NOLOG/NOACCUMULATE \EMPTY \WORK\QRTR1                      TREEDUPL/NOLOG/NOACCUMULATE \EMPTY \WORK\QRTR1                    E>TREEDUPL/NOLOG/NOACCUMULATE \EMPTY \WORK\QRTR1
  1112.                     TREEDUPL version 2.0
  1113.  
  1114.                       RMDIR \EMPTY                      RMDIR \EMPTY                      RMDIR \EMPTY                    E>RMDIR \EMPTY
  1115.  
  1116.                       RMDIR \WORK\QRTR1                      RMDIR \WORK\QRTR1                      RMDIR \WORK\QRTR1                    E>RMDIR \WORK\QRTR1
  1117.  
  1118.                You must use the /NOACCUMULATE command qualifier, to  delete  the
  1119.                directories   and   files   in   the  directory  tree  rooted  at
  1120.                \WORK\QRTR1; you may optionally use the /NOLOG command  qualifier
  1121.                to suppress the printing of messages naming the files as they are
  1122.                deleted.
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.                                             15
  1137.