home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 005A / DIRCO603.ZIP / DIRCOMP.DOC < prev    next >
Text File  |  1996-03-21  |  13KB  |  261 lines
  1. DIRCOMP.DOC                          1                         Revised: 03/21/96
  2.  
  3. DIRCOMP compares two  complete  subdirectories  and  looks  for  dissimilarities
  4. between files (different sizes or creation dates as well as missing files).   It
  5. produces  a  disk  report  called  (by  default)  C:\DIRCOMP.TXT   showing   the
  6. dissimilarities.  In some ways, this is similar to  a  separate  utility  called
  7. FILUPDAT but DIRCOMP adds a couple of features:
  8.  
  9.   * It can resolve the dissimilarities for you.  When you call the
  10.     routine, you provide a primary subdirectory and a secondary subdirectory.
  11.     If files in the primary subdirectory are more recent than those in the
  12.     secondary subdirectory, DIRCOMP can copy the files for you (similar to the
  13.     DOS REPLACE command with the /U option).
  14.   * In addition, if files exist in the secondary subdirectory that aren't in
  15.     the primary, DIRCOMP can kill the files in the secondary subdirectory for
  16.     you.
  17.   * Can produce a status file showing what was compared, resolved, etc.
  18.   * DIRCOMP can also go through child subdirectories for you and do this
  19.     effort throughout.
  20.   * DIRCOMP can move the files instead of copy them, effectively allowing you
  21.     to prune and graft directory structures.
  22.  
  23. To reduce the risks inherent  in  this  sort  of  automatic  execution,  neither
  24. /UPDATE or /KILL are available if the secondary subdirectory is a network  drive
  25. unless the "/NET" option is passed in.
  26.  
  27. DIRCOMP is typically used in the process of backing up files from one  drive  to
  28. another.  DIRCOMP allows you to easily copy  every  file  and  get  rid  of  now
  29. non-existant files.
  30.  
  31. Most people who report using DIRCOMP  say  they  use  the  program  to  maintain
  32. workstations in a networked environment.  They take the  files  from  a  network
  33. directory and use them to replace the files on the workstation.
  34.  
  35. Note that DOS includes a command called REPLACE which will do some of  the  same
  36. things that this utility does.  The central differences are that  REPLACE  won't
  37. delete mismatched files and it doesn't  produce  a  report  on  inconsistencies.
  38. REPLACE also doesn't have the ability to handle  odd  attributes  or  deal  with
  39. cascading subdirectories.  REPLACE *is* a lot quicker though.
  40.  
  41. Notes:
  42. (1)  I myself have no use whatsoever for this command because  I  don't  do  any
  43.      network maintenance stuff anymore.  It's also a freebie program.  As  such,
  44.      I'm not all that inclined to make a lot of revisions to  the  routine.   As
  45.      with all of my programs, feel free to make suggestions but, especially with
  46.      this command, please don't take it personally if I don't act upon them.
  47. (2)  One user has complained that this utility causes QEMM to shut down after it
  48.      is run.  Any other experience with this?
  49. (3)  One user reported that he was trying to write to a Novell network drive and
  50.      nothing was being copied.  It's possible that  Novell  sets  attributes  in
  51.      unexpected ways.  Using /ATTR=HSR got around this problem.
  52. (4)  Win95 notice:  As with  most  DOS-based  utilities,  this  program  doesn't
  53.      understand the long file names that were introduced with  Windows  95.   It
  54.      also cannot handle long pathnames from Windows 95.
  55.  
  56.  
  57. DIRCOMP.DOC                          2                         Revised: 03/21/96
  58.  
  59. Specifying parameters:
  60.  
  61. Parameters for this program can be set in the following ways.  The last  setting
  62. encountered always wins:
  63.   - Read from an *.INI file (see BRUCEINI.DOC file),
  64.   - Through the use of an environmental variable (SET DIRCOMP=whatever), or
  65.   - From the command line (see "Syntax" below)
  66.  
  67.  
  68. Syntax:
  69.  
  70.     DIRCOMP directory1 directory2 [ /S ] [ /CREATE ] [ /Xfilespec ]...
  71.       [ /UPDATE ] [ /KILL ] [ /CLONE ] [ /MOVE ] [ /ATTR=[H][S][R] ] [ /NET ]
  72.       [ /F[rptfile] | /-F ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  73.       [ /ALL ] [ /Tdrive: | /Tdrive:\path ] [ /COLOR=nnn | /-COLOR ]
  74.       [ /Q ] [ /Iinitfile | /-I ] [ /? ]
  75.  
  76. where:
  77.  
  78. "directory1" is the name of the primary (source) subdirectory.   If  /UPDATE  is
  79. used, the secondary subdirectory's contents will be changed to reflect the  ones
  80. here.
  81.  
  82. "directory2" is the name of the secondary subdirectory  which  will  have  files
  83. copied to it or deleted from it.
  84.  
  85. "/S" goes through and processes subdirectories off  of  the  subdirectories  you
  86. specified in a cascading manner.   You  can  use  this  option  to  copy  entire
  87. directory trees if you want.  Still requires /UPDATE if you want it to  actually
  88. do anything besides report on conditions of course.   The  program  may  not  be
  89. smart enough to delete all embedded subdirectories.   "/-S"  (the  opposite)  is
  90. initially the default.
  91.  
  92. "/CREATE" will create directory2 if it doesn't exist already.   "/-CREATE"  (the
  93. opposite) is initially the default.
  94.  
  95. "/Xfilespec" says to exclude certain filespecs from being considered..  You  can
  96. specify up to 10 exclusion parameters but each must have  their  own  /Xfilespec
  97. statement.  For example, to exclude all files with a CFG  extension,  you  could
  98. say "DIRCOMP (other parms) /X*.CFG".
  99.  
  100. "/UPDATE" says to copy any files from directory1 to directory2 which are  either
  101. (a) newer in directory1 or (b) not in directory2 at all.  Files  will  *NOT*  be
  102. copied if (a) the directory2 files are more recent or (b)  file  sizes  are  the
  103. only difference.  See also /KILL, /CLONE, and /MOVE.  "/-UPDATE" (the  opposite)
  104. is initially the default.
  105.  
  106. "/KILL" says to delete any files in directory2  which  are  not  in  directory1.
  107. /KILL automatically invokes /UPDATE.  "/-KILL" (the opposite) is  initially  the
  108. default.
  109.  
  110. "/CLONE" says to copy all files from directory1 to directory2 even if the  files
  111. in directory2 are more recent than those in  directory1.   /CLONE  automatically
  112. invokes /UPDATE.  "/-CLONE" (the opposite) is initially the default.
  113.  
  114.  
  115. DIRCOMP.DOC                          3                         Revised: 03/21/96
  116.  
  117. "/MOVE" says to move the files instead  of  copying  them.   This  deletes  from
  118. directory1 any file that was copied to directory2.  (The deletion is  done  only
  119. if the initial copy succeeded.) Typically, the option  is  used  in  combination
  120. with  the  /CLONE  option.   Since  this  option  is  kind  of  scarey  if  used
  121. incorrectly, you have to specify /UPDATE as well in order to use  it.   "/-MOVE"
  122. (the opposite) is initially the default.
  123.  
  124. "/ATTR=[H][S][R]" allows you to specify a combination  of  attributes  that  you
  125. want considered.  Normally, hidden, system, and read-only files are  ignored  by
  126. the routine.  Using /ATTR, you can include whatever you  want.   /ATTR=HSR,  for
  127. example, gets them all.
  128.  
  129. "/NET" removes a restriction which does not allow the secondary directory to  be
  130. a network drive.  Note that the test the program performs for this  is  somewhat
  131. imperfect and it may not notice that it's actually a  networked  drive.   Sorry!
  132. "/-NET" (the opposite) is initially the default.
  133.  
  134. "/Frptfile" (or "/Rrptfile") provides the name of the report file to create.  If
  135. "/F" by itself is specified, it's the same thing as  saying  "/FC:\DIRCOMP.TXT".
  136. Specifying "/FSCRN:" will send  the  report  to  the  screen.   The  default  is
  137. initially to create no report at all ("/-F").
  138.  
  139. "/-F" (or "/SKIP" or "/-R") stops the creation of  the  report  file.   This  is
  140. initially the default.
  141.  
  142. "/OVERWRITE" says to overwrite the report file if it's already there.
  143.  
  144. "/APPEND" says to append to the end of any existing report file.
  145.  
  146. "/-OVERWRITE" says to abort if the output file exists already.
  147.  
  148. "/OVERASK" says to prompt if the  output  file  exists  already.   This  is  the
  149. default.
  150.  
  151. "/ALL" says to write all files to the report  file  (typically  C:\DIRCOMP.TXT),
  152. not just the ones that have differences.  "/-ALL" (the  opposite)  is  initially
  153. the default.
  154.  
  155. "/Tdrive:" specifies the drive to  write  any  temporary  ISAM  files  that  the
  156. routine needs.  ISAM data bases are used to store and sort the file names.  ISAM
  157. files cannot be created reliably on certain types  of  drives.   If  a