home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / dfl333.zip / DFL.DOC < prev    next >
Text File  |  1992-10-25  |  116KB  |  2,466 lines
  1.  
  2.  
  3.  
  4.  
  5.                          DUPLICATE FILE LOCATOR
  6.                               Version 3.30
  7.  
  8.                            Table of Contents
  9.  
  10.                                Topic                          Page
  11.  
  12.         1         Introduction to DFL. . . . . . . . . . . .  4
  13.         1.1       DFL Overview . . . . . . . . . . . . . . .  4
  14.         1.2       System Requirements. . . . . . . . . . . .  5
  15.         1.3       Technical Support. . . . . . . . . . . . .  6
  16.         1.4       Registration Info. . . . . . . . . . . . .  6
  17.         1.5       Software License . . . . . . . . . . . . .  7
  18.  
  19.  
  20.         2         Using DFL. . . . . . . . . . . . . . . . .  8
  21.         2.1       Command Line Options . . . . . . . . . . .  8
  22.         2.1.1     /?  List Options . . . . . . . . . . . . .  8
  23.         2.1.2     /d  Drive List . . . . . . . . . . . . . .  8
  24.         2.1.3     /w  Working Disk . . . . . . . . . . . . .  9
  25.         2.1.4     /f  Filename Mask. . . . . . . . . . . . .  9
  26.         2.1.5     /m  Scan Mode. . . . . . . . . . . . . . . 10
  27.         2.1.6     /l  List Output File & Auto Mode . . . . . 10
  28.         2.1.7     /mono  Use monochrome colors . . . . . . . 10
  29.         2.2       Environment Variables. . . . . . . . . . . 11
  30.         2.2.1     DFLDISK=  Working Disk . . . . . . . . . . 11
  31.         2.2.2     DFLCFG=   Save File Directory. . . . . . . 11
  32.         2.3       The Interactive Interface. . . . . . . . . 12
  33.         2.3.1     Menu or Non-menu Access. . . . . . . . . . 12
  34.         2.3.2     Help System. . . . . . . . . . . . . . . . 13
  35.         2.3.3     Scan Status Window . . . . . . . . . . . . 13
  36.         2.3.4     Scan Style Window. . . . . . . . . . . . . 13
  37.         2.3.5     Disk Status Window . . . . . . . . . . . . 13
  38.         2.3.6     Duplicate List Window (Non-menu mode). . . 14
  39.         2.4       Running DFL. . . . . . . . . . . . . . . . 14
  40.         2.4.1     Unattended . . . . . . . . . . . . . . . . 14
  41.         2.4.2     A Fresh Start. . . . . . . . . . . . . . . 14
  42.         2.4.3     Resorting  . . . . . . . . . . . . . . . . 14
  43.         2.5       Duplicate File Search Modes. . . . . . . . 15
  44.         2.5.1     Name Mode. . . . . . . . . . . . . . . . . 15
  45.         2.5.2     FastAlias Mode . . . . . . . . . . . . . . 15
  46.         2.5.3     FullAlias Mode . . . . . . . . . . . . . . 16
  47.         2.5.4     Length Mode. . . . . . . . . . . . . . . . 16
  48.         2.5.5     Partial Name Mode. . . . . . . . . . . . . 16
  49.         2.5.6     Dos Path Mode. . . . . . . . . . . . . . . 16
  50.         2.6       The Filename Mask. . . . . . . . . . . . . 17
  51.         2.7       The Drive Scan List. . . . . . . . . . . . 17
  52.         2.8       Saving the Duplicate List. . . . . . . . . 17
  53.                                                        Page 2
  54.  
  55.  
  56.         3         DFL Online Functions . . . . . . . . . . . 17
  57.         3.1       Overview . . . . . . . . . . . . . . . . . 17
  58.         3.1.1     The Menu Window. . . . . . . . . . . . . . 17
  59.         3.1.2     The Duplicate Window . . . . . . . . . . . 18
  60.         3.1.3     The File View Window . . . . . . . . . . . 19
  61.         3.2       Global Functions . . . . . . . . . . . . . 19
  62.         3.2.1     ESC    Menu & Non-menu Toggle. . . . . . . 19
  63.         3.2.2     Alt-H  Help Menu . . . . . . . . . . . . . 19
  64.         3.2.3     Alt-S  Setup Menu. . . . . . . . . . . . . 20
  65.         3.2.4     Alt-R  Run Menu. . . . . . . . . . . . . . 20
  66.         3.2.5     Alt-E  Exit Menu . . . . . . . . . . . . . 20
  67.         3.2.6     Alt-X  Exit DFL. . . . . . . . . . . . . . 20
  68.         3.2.7     Home   Top of List . . . . . . . . . . . . 21
  69.         3.2.8     End    Bottom of List. . . . . . . . . . . 21
  70.         3.2.9     PgUp   Next Page in List . . . . . . . . . 21
  71.         3.2.10    PgDn   Previous Page in List . . . . . . . 21
  72.         3.2.11    F1     Call for Help . . . . . . . . . . . 21
  73.         3.2.12    SF1    Display Help Topics . . . . . . . . 22
  74.         3.2.13    F2     Drive Selection . . . . . . . . . . 22
  75.         3.2.14    F3     Name Mask Selection . . . . . . . . 22
  76.         3.2.15    F4     Scan Mode Selection . . . . . . . . 22
  77.         3.2.16    F5     Begin Scan. . . . . . . . . . . . . 23
  78.         3.2.17    SF5    Resort Scan . . . . . . . . . . . . 23
  79.         3.2.18    F6     Select First File for Comparison. . 23
  80.         3.2.19    F7     Start Binary File Comparison. . . . 23
  81.         3.2.20    F8     Delete One or More Files. . . . . . 24
  82.         3.2.21    F9     Write Duplicate List. . . . . . . . 24
  83.         3.2.22    F10    View File Contents. . . . . . . . . 24
  84.         3.2.23    'F'    Start ASCII File Comparison . . . . 24
  85.         3.2.24    'T'    Toggle File Tag . . . . . . . . . . 25
  86.         3.2.25    'U'    Untag all Files . . . . . . . . . . 25
  87.         3.2.26    'S'    Shell to DOS. . . . . . . . . . . . 25
  88.         3.2.27    ^C-Z   Display Drive Statistics. . . . . . 25
  89.                                                        Page 3
  90.  
  91.  
  92.         4         DFL Archive Subsystem. . . . . . . . . . . 26
  93.         4.1       Overview . . . . . . . . . . . . . . . . . 26
  94.         4.2       Defining an Archive. . . . . . . . . . . . 26
  95.         4.2.1     Basic Parameters . . . . . . . . . . . . . 26
  96.         4.2.1.1   Title. . . . . . . . . . . . . . . . . . . 26
  97.         4.2.1.2   Extension. . . . . . . . . . . . . . . . . 27
  98.         4.2.1.3   Enable/Disable . . . . . . . . . . . . . . 27
  99.         4.2.1.4   Screen Save. . . . . . . . . . . . . . . . 27
  100.         4.2.2     Archive Programs . . . . . . . . . . . . . 27
  101.         4.2.2.1   Lister Program & Parameters. . . . . . . . 28
  102.         4.2.2.2   Deleter Program & Parameters . . . . . . . 29
  103.         4.2.2.3   Extractor Program & Parameters . . . . . . 29
  104.         4.2.2.4   Compressor Program & Parameters. . . . . . 30
  105.         4.3.3     The Test Run . . . . . . . . . . . . . . . 30
  106.         4.3.4     Archive Lister Output. . . . . . . . . . . 31
  107.         4.3.4.1   Name . . . . . . . . . . . . . . . . . . . 31
  108.         4.3.4.2   Extension. . . . . . . . . . . . . . . . . 31
  109.         4.3.4.3   Length . . . . . . . . . . . . . . . . . . 31
  110.         4.3.4.4   Time . . . . . . . . . . . . . . . . . . . 31
  111.         4.3.4.5   Date . . . . . . . . . . . . . . . . . . . 32
  112.  
  113.         5         DFL File Viewing System. . . . . . . . . . 32
  114.         5.1       Overview . . . . . . . . . . . . . . . . . 32
  115.         5.2       Screen Layout. . . . . . . . . . . . . . . 32
  116.         5.3       Viewer Commands. . . . . . . . . . . . . . 32
  117.         5.3.1     F1 - Quick Help. . . . . . . . . . . . . . 32
  118.         5.3.2     Home & End . . . . . . . . . . . . . . . . 32
  119.         5.3.3     Page Keys. . . . . . . . . . . . . . . . . 33
  120.         5.3.4     Arrow Keys . . . . . . . . . . . . . . . . 33
  121.         5.3.5     ^Home. . . . . . . . . . . . . . . . . . . 33
  122.         5.3.6     ^PgUp & ^PgDn. . . . . . . . . . . . . . . 33
  123.         5.3.7     ^Right & ^Left . . . . . . . . . . . . . . 33
  124.         5.3.8     'W' - Mask High Bits . . . . . . . . . . . 33
  125.         5.3.9     'T' - Tab Toggle . . . . . . . . . . . . . 33
  126.         5.3.10    F2 - Print File. . . . . . . . . . . . . . 33
  127.  
  128.  
  129.         6         Useful Topics. . . . . . . . . . . . . . . 34
  130.         6.1       Users' Questions and Answers . . . . . . . 34
  131.         6.2       DFL Temporary Files & Directories. . . . . 38
  132.         6.3       DOS stack overflow . . . . . . . . . . . . 39
  133.         6.4       Error messages . . . . . . . . . . . . . . 39
  134.         6.4.1     Online Errors. . . . . . . . . . . . . . . 39
  135.         6.4.2     Exit Errors. . . . . . . . . . . . . . . . 47
  136.                                                        Page 4
  137.  
  138.  
  139.         1         Introduction to DFL
  140.  
  141.         In this section, a brief introduction to the capabilities of  DFL 
  142.         is  provided.   Complete information on all of  these  topics  is 
  143.         provided in subsequent sections.
  144.  
  145.         This  manual  sometimes  mentions  other  software  programs   or 
  146.         products.   In  all such cases, any trademarked material  is  the 
  147.         property of the rightful owners.
  148.  
  149.         
  150.         1.1       DFL Overview
  151.  
  152.         Duplicate  File  Locator is a complete software  system  used  to 
  153.         locate, view, compare and delete duplicate files on your computer 
  154.         system.   No   matter  where  the  files   reside:   in   various 
  155.         subdirectories,  on network drives, or even in archive  files  of 
  156.         various  formats,  DFL will find them for you, and allow  you  to 
  157.         view, delete or retain them as you see fit.
  158.  
  159.         After DFL has assembled a list of all of the files to be  consid-
  160.         ered, DFL will search for duplicates in one of two ways.  We call 
  161.         these  NAME mode and ALIAS mode.  In NAME mode, DFL searches  its 
  162.         file list for files which have the same name; in ALIAS mode,  DFL 
  163.         looks  for files which have the same data.  For example, in  NAME 
  164.         mode,  DFL could tell you that one of your files  "SOURCE.C"  has 
  165.         been  copied into any number of places.  In alias mode, DFL  will 
  166.         tell  you that "SOURCE.C" and "SOURCE.BAK" have exactly the  same 
  167.         contents.
  168.  
  169.         DFL version 2.61 could build a list of approximately 8,000  files 
  170.         over  any number of drives.  Beginning with DFL version 3.00,  we 
  171.         have  introduced a virtual memory system to help us  build  large 
  172.         lists of files.  We can now build a list limited only by the free 
  173.         disk  space  you  have to hold our data tables.   DFL  will  need 
  174.         approximately 1 megabyte of disk space for every 25,000 files.
  175.  
  176.         DFL  provides  a number of options particularly  useful  in  NAME 
  177.         mode.   For example, different versions of files  sometimes  have 
  178.         the  version number as part of the file name.  For  example,  DFL 
  179.         has been released in the past as "DFL110", "DFL130", "DFL150" and 
  180.         "DFL261".   By  using the 3 character masking  option,  DFL  will 
  181.         locate  all of these as NAME mode duplicates.  In this  way,  you 
  182.         can see which is the most recent version resident on your  system 
  183.         or network.  We allow you to set any number of characters as  the 
  184.         width to match.
  185.  
  186.         In  NAME mode, files with the same or similar names are  located, 
  187.         but  the contents may be different.  DFL gives you the option  of 
  188.         comparing any two files to see if the contents are the same.   In 
  189.         ALIAS  mode, this comparison is already done for you as  part  of 
  190.         the search process.
  191.                                                        Page 5
  192.  
  193.  
  194.         Many of us,  especially BBS sysops, use file archive programs  to 
  195.         get more files on our disks.  DFL will use your archive  programs 
  196.         to  search for, view or delete files stored inside  your  archive 
  197.         files.   We have tested DFL with ZIP, PAK, ZOO, LZH and  ARC  ar-
  198.         chive  programs successfully.  While we haven't tested  DFL  with 
  199.         all versions of these programs, or any other programs, we know of 
  200.         no  reason why DFL should not work.  If you have any problems  in 
  201.         this area, or any other, please let us know so we can take appro-
  202.         priate  steps.   DFL will even find duplicates  which  reside  in 
  203.         different archive formats.
  204.  
  205.         After  DFL  has searched the file list, any duplicate  files  are 
  206.         displayed  in  the "duplicate window", with the  drive  and  path 
  207.         along  which each file was found, the file length, and  the  file 
  208.         date and time.
  209.  
  210.         You  may  scroll through the duplicate window, compare  pairs  of 
  211.         files,  view  individual files, and tag files for  deletion.   In 
  212.         addition,  you may write the contents of the duplicate window  to 
  213.         an ASCII file so you can review the list off-line.
  214.  
  215.         DFL will allow you to compare files using either a binary,  byte-
  216.         by-byte  comparison, or by using your ASCII file comparison  pro-
  217.         gram  FC.EXE.   The ASCII comparison is particularly  helpful  in 
  218.         checking the differences between to versions of the "same" file.
  219.  
  220.         DFL offers COMPLETE ARCHIVE SUPPORT. This means that files  which 
  221.         are compressed and stored in archives can be handled exactly like 
  222.         normal  files. They can be viewed, deleted or compared  to  other 
  223.         files regardless of the type of archive(s) in which they  reside. 
  224.         Their host archives will be treated as directories. Also,  though 
  225.         implemented  only  as  a setup/diagnostic feature,  DFL  has  the 
  226.         ability  to  add  files  to  archives  using  the   corresponding 
  227.         archive's compression formats.
  228.  
  229.         DFL includes a comprehensive 'archive definition' subsystem which 
  230.         will  allow  you  to  customize it to interface  with  up  to  10 
  231.         different  archive  compression/extraction systems. DFL  is  pre-
  232.         customized for several popular archive systems. 
  233.  
  234.         The  only  difference  between  the  shareware  version  and  the 
  235.         registered version is that the shareware version has opening  and 
  236.         closing  registration  reminder  screens.
  237.  
  238.         1.2       System Requirements
  239.  
  240.         DFL.EXE will run on any PC XT/AT or compatible machine, using any 
  241.         80x86  processor chip, monochrome or color display,  under  MSDOS 
  242.         3.0+  in  about 400k of memory.  Additional memory is  needed  to 
  243.         interface with external archive systems.  For some, this is  only 
  244.         90k.  Others need 190k.  Check the documentation for the specific 
  245.         archive  programs you use.  DFL runs in about 540k of memory  (or 
  246.         less) with the ZIP, PAK, ZOO, LZH and ARC archive programs.
  247.                                                        Page 6
  248.  
  249.  
  250.         1.3       Technical Support
  251.  
  252.         As a DFL user, you may reach us in the following ways:
  253.  
  254.             1. Write:       W. S. Ataras Engineering
  255.                             40 Laughton Street
  256.                             Upper Marlboro, Md. 20772
  257.  
  258.             2. Voice mail:  1-301-249-1141 (East coast)
  259.                Voice mail:  1-408-648-3662 (West coast)
  260.  
  261.             3. BBS:         Toad Hall 415-595-2427 for the current version.
  262.  
  263.                             Leave message to BILL ATARAS.
  264.                             Look for DFL*.*. 
  265.                             The latest version will be a free download.
  266.  
  267.             4. Networks:    RIME - Shareware conference.
  268.  
  269.             5. CompuServe:  William Ataras
  270.                             70322,1514
  271.                             IBM System\Util. Forum
  272.  
  273.         
  274.         1.4       Registration Information
  275.  
  276.         This  is the REGISTERED version of DFL.  You  will  automatically 
  277.         receive  any  new releases issued to correct bugs  identified  in 
  278.         this  version  at  no additional charge.  In  addition,  you  may 
  279.         register  for future versions at reduced rates  in order to  have 
  280.         the  most up-to-date features of DFL economically.
  281.  
  282.         DFL REGISTERED USERS RECEIVE:
  283.  
  284.              1. The latest version.
  285.              2. Any releases issued to correct bugs found in your version.
  286.              3. No shareware reminder screens.
  287.              4. Phone & modem support.
  288.              5. Printed manual.
  289.              6. A 30 day money-back satisfaction guarantee. 
  290.              7. Upgrade & follow-up notifications.
  291.  
  292.         We appreciate your registration, and hope that DFL is of continu-
  293.         ing  value  to you in the future.  If you discover bugs  in  DFL, 
  294.         please  tell us; if you are satisfied with DFL, please tell  your 
  295.         friends  and  associates, and pass on to them your  copy  of  the 
  296.         SHAREWARE version of DFL included on your distribution disk.
  297.                                                        Page 7
  298.  
  299.  
  300.         Unfortunately, in our society, it is necessary for us to let  you 
  301.         know  that  we  can only be responsible for what we  do.   W.  S. 
  302.         Ataras Engineering and its affiliated individuals hereby disclaim 
  303.         all  warranties  relating to this software,  whether  express  or 
  304.         implied,  including without limitation any implied warranties  of 
  305.         merchantability or fitness for a particular purpose.  We will not 
  306.         be liable for any special, incidental, consequential, indirect or 
  307.         similar damages due to loss of data or any other reason, even  if 
  308.         we  or an agent of W. S. Ataras Engineering has been  advised  of 
  309.         the possibility of such damages.  In no event shall our liability 
  310.         for any damages ever exceed the price paid for the license to use 
  311.         software, regardless of the form of the claim.  The person  using 
  312.         the software bears all risk as to the quality and performance  of 
  313.         the software.
  314.  
  315.         
  316.         1.5       Software License
  317.  
  318.         The software license agreement is shown below.
  319.  
  320.         DFL (tm) Duplicate File Locator Version 3.30
  321.         Copyright 1991, W. S. Ataras Engineering
  322.         All rights reserved.
  323.  
  324.         You are free to use DFL on any single computer, provided:
  325.          - no fee is charged for its use
  326.          - it is not modified in any way
  327.  
  328.         You  are free to distribute the SHAREWARE version of DFL on  your 
  329.         distribution disk provided
  330.          - no fee is charged for its use, copying or distribution
  331.          - it is not modified in any way
  332.  
  333.         If you want to charge a fee for distributing either the shareware 
  334.         or  registered  versions  of  DFL,  please  contact  W.S.  Ataras 
  335.         Engineering as described in this documentation. We are more  than 
  336.         happy  to make DFL accessible to everybody but must give  written 
  337.         permission first.
  338.  
  339.         The files on your distribute disk can be identified as follows:
  340.  
  341.          DFL.EXE       - Your personal registered copy of DFL
  342.          DFL.SAV       - The default configuration file
  343.          DFL.DOC       - This file providing the manual for DFL.
  344.          READREG.ME    - Read Me file with misc. notes
  345.          WHATSNEW      - List of new features.
  346.          VENDOR.DOC    - Information for vendors.
  347.          INSTALL.EXE   - DFL installation program.
  348.                                                        Page 8
  349.  
  350.          DFL330.ZIP    - Your SHAREWARE copy of DFL and related files.
  351.                          This shareware distribution file contains
  352.           DFL.EXE      - The shareware executable program
  353.           DFL.SAV      - The default configuration file
  354.           DFL.DOC      - The manual
  355.           ORDER.DOC    - The program registration order form
  356.           DFLREAD.ME   - Read Me file with misc. notes
  357.           WHATSNEW     - List of new features.
  358.           VENDOR.DOC   - Information for vendors.
  359.           INSTALL.EXE  - DFL installation program.
  360.  
  361.  
  362.         2         Using DFL
  363.  
  364.         2.1       Command Line Options
  365.  
  366.         DFL  can be invoked from the DOS command line, or from  within  a 
  367.         batch  file,  These command line options allow you  to  configure 
  368.         and  run  DFL without any interaction.  They are  described  com-
  369.         pletely below.
  370.  
  371.         The  command line has the form: DFL [options], where each  option 
  372.         begins  with a slash and is followed by a space if there are  any 
  373.         subsequent options on the command line.
  374.  
  375.         The above options are used to set DFL's startup operating parame-
  376.         ters.  All of these parameters (except '/w=' - Working disk)  can 
  377.         be changed online via the functions described below.  For details 
  378.         on each of the online functions, please examine the corresponding 
  379.         context help as described below.
  380.  
  381.         
  382.         2.1.1     /?  List Options
  383.  
  384.         This option is used to obtain a complete screen of help  informa-
  385.         tion which describes all of the other command line options.   DFL 
  386.         will display the screen and return to the DOS command line.   You 
  387.         can then compose the command line which you need.
  388.  
  389.         EXAMPLE: DFL /?
  390.  
  391.         
  392.         2.1.2     /d  Drive List
  393.  
  394.         This  option is used to specify the drives to be scanned  in  the 
  395.         subsequent  processing.   If this option is not  used,  only  the 
  396.         current default drive will be processed.
  397.  
  398.         EXAMPLE: DFL /d=cd
  399.                                                        Page 9
  400.  
  401.  
  402.         2.1.3     /w  Working Disk
  403.  
  404.         This option is used to direct DFL to use a specific disk,  rather 
  405.         than the default disk, as the working disk.  The working disk  is 
  406.         used for virtual memory caching
  407.  
  408.            /w=  - Working disk. Default - Current.
  409.  
  410.         Specifies  an  alternate disk for virtual  memory  caching.  This 
  411.         option  overrides the DFLDISK environment variable  above.  DFL's 
  412.         performance  can be increased by caching to a faster device  such 
  413.         as  a  ramdisk.   DFL needs about 1meg of disk  space  for  every 
  414.         25,000  files.  Also, DFL extracts archived files to the  working 
  415.         disk  for  the View and Comparison functions.  The  working  disk 
  416.         should  have enough free space to hold any two archived files  as 
  417.         well as the virtual memory  itself.
  418.         At  startup, the root directory of the working disk  is  searched 
  419.         before the path for the external archive programs (defined  under 
  420.         'Archive  Laws') and file compare program (defined under  'FC.EXE 
  421.         Laws').   You can greatly enhance archive processing by  insuring 
  422.         that  the desired archive programs are in the working  disk  root 
  423.         directory prior to running DFL.
  424.  
  425.          EXAMPLE: DFL /lw=d
  426.  
  427.         
  428.         2.1.4     /f  Filename Mask
  429.  
  430.         This option is used to select the files which participate in  the 
  431.         file  data  acquisition process.  DFL begins  its  processing  by 
  432.         forming  a list of all files, on all of the scanned disks,  which 
  433.         match  the file name mask.  Once this list is built  internal  to 
  434.         DFL, it will begin to look for duplicates by name or content.  If 
  435.         one or more of the archive file processing functions are  active, 
  436.         DFL  will include in the file data list any matching files  found 
  437.         within the archives.
  438.  
  439.            /f=[Scan Mask]
  440.  
  441.         The  default  file name mask is *.*.  In the example  below,  DFL 
  442.         will acquire data only on C-language source files.
  443.  
  444.         EXAMPLE: DFL /f=*.c
  445.                                                        Page 10
  446.  
  447.  
  448.         2.1.5     /m  Scan Mode
  449.  
  450.         This  option is used to set the duplicate search mode.   If  this 
  451.         option is not used, DFL will default to the name mode.
  452.  
  453.            /m=[Scan Mode]
  454.         If  this option is not used, DFL will default to Name mode.   The 
  455.         list of valid options is:
  456.  
  457.             Mode        Parameter               Comment
  458.             -------------------------------------------------------
  459.             Name       /m=name           Find equal file names
  460.             Length     /m=length         Find equal file lengths
  461.             FastAlias  /m=fastalias      Find equal file CRCs. Very fast.
  462.             FullAlias  /m=fullalias      Find equal file contents.
  463.             Dos Path   /m=path           Find executables on the path
  464.             Name 1-11  /m=n1...n11       Find 1st 'n' equal name letters
  465.  
  466.         EXAMPLE: DFL /m=n4
  467.  
  468.         2.1.6     /l  List Output File & Auto Mode
  469.  
  470.         This option is used to identify a file name to contain the dupli-
  471.         cate  information.  DFL will process automatically based  on  the 
  472.         options given, and defaults for the options not given.  Then, the 
  473.         contents  of the duplicate window will be written to  this  file.  
  474.  
  475.         DFL will exit to DOS when processing is complete.
  476.  
  477.            /l(a/w)=[List file]
  478.  
  479.         If the option letter is followed by "a", the new information will 
  480.         be  appended to the existing file;  if the option letter is  fol-
  481.         lowed  by  "w", the file, if it exists, will  have  its  contents 
  482.         discarded before writing the dup info.  The default is "w".
  483.  
  484.         EXAMPLE: DFL /lw=LIST    write dup info to file "LIST"
  485.                  DFL /la=LIST    append new dup data to the end of "LIST"
  486.  
  487.  
  488.         2.1.7    /mono   Use monochrome colors
  489.  
  490.         DFL attempts to auto-detect the type of display card/monitor  you 
  491.         are  using. ON monochrome cards, DFL uses monochrome  colors.  On 
  492.         color  cards, colors are used. There may be a chance that DFL  is 
  493.         unable  to  detect  your hardware and adjust  its  colors  to  be 
  494.         readable.  For example, if you can read some of the  screen,  but 
  495.         not  all,  try the /mono option. This will use  black  and  white 
  496.         colors that should be visible on any screen.
  497.                                                        Page 11
  498.  
  499.  
  500.         2.2       Environment Variables
  501.  
  502.         There  are  two DOS environment variables which can  be  used  as 
  503.         described below.
  504.  
  505.         
  506.         2.2.1     DFLDISK = Working Disk
  507.  
  508.         Use "SET DFLDISK=[drive letter]" in your AUTOEXEC.BAT or from the 
  509.         DOS  command line to define a working disk for DFL.  The  working 
  510.         disk is used for virtual memory caching.  The '/w=' command- line 
  511.         option  described below overrides this.  The default is the  cur-
  512.         rent disk.
  513.  
  514.         DFL's performance can be increased by caching to a faster  device 
  515.         such as a ramdisk.  DFL needs about 1 MB of disk space for  every 
  516.         25,000  files.  Also, DFL extracts archived files to the  working 
  517.         disk  for  the View and Comparison functions.  The  working  disk 
  518.         should  have enough free space to hold any two archived files  as 
  519.         well as the virtual memory files.
  520.  
  521.         At   startup, the root directory of the working disk is  searched 
  522.         before the path for the external archive programs (defined  under 
  523.         'Archive  Laws') and file compare program (defined under  'FC.EXE 
  524.         Laws').   You can greatly enhance archive processing by  insuring 
  525.         that  the desired archive programs are in the working  disk  root 
  526.         directory prior to running DFL.
  527.  
  528.         
  529.         2.2.2     DFLCFG = Save File Directory
  530.  
  531.         Use "SET DFLCFG=[directory spec] in your AUTOEXEC.BAT or from the 
  532.         DOS  command  line  to define the directory  which  contains  the 
  533.         DFL.SAV  file. DFL uses the following priorities  in  determining 
  534.         this directory:
  535.  
  536.             1. Check the DFLCFG environment variable.
  537.             2. Search the current directory for DFL.SAV.
  538.             3. Search the path for DFL.SAV.
  539.             4. Use the DFL.EXE host directory.
  540.  
  541.         DFl.SAV  is used to store the Archive Definitions and other  mis-
  542.         cellaneous  data.  If it does not already exist in the  directory 
  543.         determined above, it will be created and initialized.
  544.  
  545.         The  basic  idea  is that once you tuck away  DFL.EXE  &  DFL.SAV 
  546.         somewhere  on your path, you won't have to worry about them  any-
  547.         more.
  548.                                                        Page 12
  549.  
  550.  
  551.         2.3       The Interactive Interface
  552.  
  553.         When  DFL initializes, you will see a menu bar at the top of  the 
  554.         screen, three status windows below the menu bar and a big  window 
  555.         at  the bottom of the screen.  The status windows  are  described 
  556.         below.   The large window at the bottom is the Duplicate  Window. 
  557.         That is where the list of duplicate files will appear.
  558.  
  559.         You can interface with DFL in either of two windows.  DFL  begins 
  560.         in the first window, the pull down menu window.  While in a menu, 
  561.         use  the Up and Down arrow keys to move the menu cursor bar.  You 
  562.         may  activate  the function under the bar  by  striking  <ENTER>.  
  563.         Context sensitive help can also be obtained by striking <F1>.  To 
  564.         jump  to another menu, either strike its hot key or use the  Left 
  565.         and  Right arrow keys to cycle around.  All functions  and  menus 
  566.         can be accessed independently with their corresponding hot keys.
  567.  
  568.         The  second window is the Duplicate Window.  To jump between  the 
  569.         Duplicate  Window  and  the menu window, strike  the  <ESC>  key.  
  570.         While in the Duplicate Window, use the Up and Down arrow keys  to 
  571.         move  the cursor bar through the file list.  Your relative  posi-
  572.         tion  in the list will be indicated by a small horizontal bar  on 
  573.         the  left border.  If the path for a file is too wide to  fit  in 
  574.         the window, it may be scrolled by using the Left and Right  arrow 
  575.         keys. 
  576.  
  577.         Remember  that  you can activate any function with its  hot  key.  
  578.         You need not use the menus.
  579.  
  580.         Once  you master the hot keys, you'll find it easy  to  configure 
  581.         DFL, build the list of duplicates, and examine the results.
  582.  
  583.         
  584.         2.3.1     Menu or Non-menu Access
  585.  
  586.         DFL  has two primary windows: the Menu window and  the  Duplicate 
  587.         List  window.   The Menu window is used to enter  commands  under 
  588.         normal circumstances.  It also offers context sensitive help  for 
  589.         each menu function before the functions are selected.
  590.  
  591.         You  use the ESC key to switch between windows.  However, as  you 
  592.         gain experience with DFL, you may want to remain in the duplicate 
  593.         list  window and execute the functions directly.  The  designated 
  594.         keys to do this are described below; they are also listed in  the 
  595.         pull-down windows.
  596.                                                        Page 13
  597.  
  598.  
  599.         2.3.2     Help System
  600.  
  601.         DFL is equipped with a complete, on-line, context sensitive  help 
  602.         system.   At  virtually any time, you can press the  F1  key  and 
  603.         obtain specific help about the menu choice which is  highlighted.  
  604.         Press the ESCAPE key to return to the program.
  605.  
  606.         If  you need more help after looking at the context help  window, 
  607.         press F1 again to obtain access to the entire help text.  You can 
  608.         then scroll through the help information using the cursor control 
  609.         keys.   Press  ESCAPE from this help window and  you  will  again 
  610.         return to the menu system.
  611.  
  612.         Help is also available when you are viewing a file.  Again, press 
  613.         F1  to access help information specifically written to  give  you 
  614.         assistance about the file viewing functions available.
  615.  
  616.         
  617.         2.3.3     Scan Status Window
  618.  
  619.         You  will find the following items in the upper three windows  on 
  620.         the  main screen.  These windows report basic  statistics  deter-
  621.         mined while DFL is running.
  622.  
  623.           Directories - Total directories scanned.
  624.           Files       - Total files scanned.
  625.           Duplicates  - Total duplicate files found.
  626.           Dupe Bytes  - Total bytes in the duplicate files.
  627.  
  628.         2.3.4     Scan Style Window
  629.  
  630.           Mask        - Current scan mask.
  631.           Mode        - Current scan mode (Alias/Name/Length/Name 1-11 ).
  632.  
  633.         
  634.         2.3.5     Disk Status Window
  635.  
  636.           Disk        - Current drive being displayed.
  637.           Disk total  - Total bytes on current drive.
  638.           Disk free   - Total free bytes on current drive.
  639.           Disk dups   - Total bytes in duplicate files on current drive.
  640.                                                        Page 14
  641.  
  642.  
  643.         2.3.6     Duplicate List Window (Non-menu mode)
  644.  
  645.         After  the list of duplicate files has been generated,  the  list 
  646.         appears  in the duplicate list window.  You can move between  the 
  647.         duplicate list and menu windows by simply pressing the ESCAPE key 
  648.         whenever DFL is waiting for a key-stroke.
  649.  
  650.         All of the cursor keys are active while you are in the  duplicate 
  651.         list  window.   The horizontal motion cursor keys will  move  you 
  652.         from one entry to another in the main menu bar at the top of  the 
  653.         screen.   The vertical cursor motion keys will move  you  through 
  654.         the  sub-menu items for each main function.  Select any  function 
  655.         by pressing the ENTER key.
  656.  
  657.         2.4       Running DFL
  658.  
  659.         DFL  can  be run in three different ways: from  the  DOS  command 
  660.         line, from a batch file, and interactively using the menu system.
  661.  
  662.         
  663.         2.4.1     Unattended
  664.  
  665.         You can run DFL unattended by installing the DFL command line you 
  666.         want  to use, making sure to include the list file  option  (/l).  
  667.         This option directs DFL process using either the default  parame-
  668.         ters or the command line parameters, to write the duplicate  list 
  669.         to a file automatically and then return to DOS.
  670.  
  671.         
  672.         2.4.2     A Fresh Start
  673.  
  674.         If for any reason you wish to rebuild the list of files, you  can 
  675.         activate the "BEGIN SCAN" function in the "RUN" menu.  Any exist-
  676.         ing  list will be discarded.  Normally, this is not needed  since 
  677.         DFL  maintains a list of all files found internally.   But,  suit 
  678.         yourself.
  679.  
  680.         2.4.3     Resorting
  681.  
  682.         Before DFL can locate the duplicate files, it must first build  a 
  683.         list  of all of the files on the disk or disks to  be  processed.  
  684.         If enabled, this will also include files stored in archive files.  
  685.         After the list is built, DFL will sort the list according to  the 
  686.         mode selected: alphabetically if NAME mode has been selected,  or 
  687.         by file length if ALIAS mode has been selected.
  688.  
  689.         After  using the list as it was originally prepared  and  sorted, 
  690.         you  may  change the mode and resort by commanding DFL  to  start 
  691.         using  the "RESORT" option in the "RUN" menu.  In this case,  DFL 
  692.         will use the previously accumulated list of files.
  693.                                                        Page 15
  694.  
  695.  
  696.         2.5       Duplicate File Search Modes
  697.  
  698.         There  are six  duplicate search modes available.  They  are  de-
  699.         scribed in the next four paragraphs.
  700.  
  701.         
  702.         2.5.1     Name Mode
  703.  
  704.         In  NAME mode, DFL will look for files which have the same  name.  
  705.         If  your hard disk is like mine, you may have several  copies  of 
  706.         COMMAND.COM, for example, in various directories.  By building  a 
  707.         list of files and sorting the list alphabetically, files with the 
  708.         same  name will be adjacent in the list.  DFL will  then  display 
  709.         groups  of two or more files with the same name in the  duplicate 
  710.         window.  A blank line will separate each adjacent group.
  711.  
  712.         The  files  in  each group are selected based solely  on  a  name 
  713.         match.  This  means that, although the names are  the  same,  the 
  714.         contents  may  not be. For example, you will  probably  locate  a 
  715.         large  number of "README" files. Practically every program I  use 
  716.         has one.
  717.  
  718.         To see if the contents are the same, DFL gives you the option  of 
  719.         comparing the contents of any two files.  The use of this  option 
  720.         is described in detail elsewhere in this manual.
  721.  
  722.         
  723.         2.5.2     FastAlias Mode
  724.  
  725.         In  FastAlias mode, DFL attempts to locate files  with  duplicate 
  726.         contents using 32 bit CRCs. That is, files with equal lengths and 
  727.         equal CRCs are assumed to be duplicate. The chances of two  files 
  728.         meeting  this criteria and having different contents are  on  the 
  729.         order  of  1  in  millions.  Under  this  mode,  files  that  are 
  730.         determined to be duplicate are PRACTICALLY GUARANTEED to actually 
  731.         be duplicate. The benefits of this mode are:
  732.  
  733.         1. The  files  are  never actually compared  byte-by-byte  as  in 
  734.            FullAlias mode (described below). This dramatically  decreases 
  735.            the search time and disk activity.
  736.         2. Very   time-consuming  recursive  situations  that  occur   in 
  737.            previous versions of DFL are avoided.
  738.         3. DFL  uses the same 32 bit CRC that is used in ZIP files.  This 
  739.            means  that  doing  a FastAlias search through  ZIP  files  is 
  740.            incredibly  fast  because  CRCs for  the  archived  files  are 
  741.            already  computed and files never need to be extracted  for  a 
  742.            byte-by-byte comparison.
  743.                                                        Page 16
  744.  
  745.  
  746.         2.5.3     FullAlias Mode.
  747.  
  748.         In  FullAlias mode, DFL attempts to locate files  with  duplicate 
  749.         contents  by performing byte-by-byte comparisons of the  contents 
  750.         of  equal  length & CRC files. Under this mode,  files  that  are 
  751.         determined  to  be  duplicate  are  GUARANTEED  to  actually   be 
  752.         duplicate.  This  mode  is  essentially  the  same  as  FastAlias 
  753.         (described  above)  with the addition that the  contents  of  two 
  754.         files are compared after the length and CRC are determined to  be 
  755.         equal. The benefits of this mode are:
  756.  
  757.         1. Because of the CRC layer, DFL knows ahead of time which  files 
  758.            actually  need  to  be  compared  and  thus,  performs   fewer 
  759.            comparisons.  Previous  versions of DFL took  the  John  Wayne 
  760.            approach  and compared all equal length files. Users of  older 
  761.            versions of DFL should notice a dramatic speed improvement  in 
  762.            their Alias searches.
  763.  
  764.         2. Unlike   the   1-in-millions  possibility   under   FastAlias, 
  765.            duplicate files found by FullAlias are GUARANTEED duplicate.
  766.  
  767.         2.5.4     Length Mode
  768.  
  769.         In  length mode, DFL will look for files having the same  length.  
  770.         The  files are not checked automatically to see if they have  the 
  771.         same  contents.  You must use the file compare function on  indi-
  772.         vidual pairs of files manually to check for matching contents.
  773.  
  774.         
  775.         2.5.5     Partial Name Mode
  776.  
  777.         In the partial name mode, files are added to the duplicate window 
  778.         if  the  first few characters of their file names are  the  same.  
  779.         From  the mode select menu, you can set the length of the  number 
  780.         of required matching characters to any number from 1 to 11.   For 
  781.         example,  if  this mode is run with a three character  match  re-
  782.         quirement, the files "DFL261.EXE" and "DFL.ZIP" will be shown  as 
  783.         duplicates.  Obviously, the file comparison function must be used 
  784.         to check for duplicate contents.
  785.  
  786.         2.5.6     Dos Path Mode
  787.  
  788.         Selecting  this mode will cause DFL to scan your Path  (see  your 
  789.         dos  manual  for  a  description  of  the  Path)  for   duplicate 
  790.         executables.  The selected disks and scan mask are ignored.  Only 
  791.         files  matching *.EXE, *.COM and *.BAT on the Path are  examined. 
  792.         As  an  example,  DFL.EXE,  DFL.COM  and  DFL.BAT  are  duplicate 
  793.         executables  that,  if in the Path, can  cause  some  frustrating 
  794.         confusion.
  795.                                                        Page 17
  796.  
  797.  
  798.         2.6       The Filename Mask
  799.  
  800.         A file name mask can be used to limit the search to files  match-
  801.         ing the given mask.  For example, you can process only executable 
  802.         files  by using the mask "*.EXE" or "*.COM".
  803.  
  804.         
  805.         2.7       The Drive Scan List
  806.  
  807.         DFL  can  process any number of disk drives.  Using  the  "SELECT 
  808.         DISKS"  function in the "SETUP" menu, you can turn on or off  any 
  809.         combination  of the available drives.  All drives turned on  will 
  810.         be processed in a single processing run.
  811.  
  812.         2.8       Saving the Duplicate List
  813.  
  814.         After  DFL has generated the list of duplicates, you may want  to 
  815.         postpone  your  review of the list until a later time.   DFL  can 
  816.         help  by  allowing you to write the list to an ASCII  text  file.  
  817.         You  can then print the file, or edit it with any editor, as  you 
  818.         see fit. Use function F9.
  819.  
  820.  
  821.         3         DFL Online Functions
  822.  
  823.         3.1       Overview
  824.  
  825.         When  you  operate DFL in the interactive mode, there  are  three 
  826.         active  windows, plus several status display  windows  available.  
  827.         These will all be discussed below.
  828.  
  829.         DFL has three active windows: the menu window, the duplicate list 
  830.         window,  and the file viewing window.  The menu window gives  you 
  831.         access  to all of the program functions using a system  of  pull-
  832.         down sub-menus.  The duplicate list window is used to display the 
  833.         groups  of duplicate files after your disk drives have been  ana-
  834.         lyzed.  And the file viewing window is used to view any file from 
  835.         the list in the duplicate window.
  836.  
  837.         
  838.         3.1.1     The Menu Window
  839.  
  840.         The  first window available is the MENU window.  In this  window, 
  841.         you  can  access most of the DFL functions.  The arrow  keys  are 
  842.         used to move from function to function, with the current function 
  843.         highlighted using reverse video.  The horizontal cursor keys move 
  844.         you from one primary function to another.  For the primary  func-
  845.         tion selected, the appropriate sub-menu will be displayed.
  846.                                                        Page 18
  847.  
  848.  
  849.         The  vertical cursor keys are used to move from one  sub-function 
  850.         to another.  For all of these functions, a context sensitive help 
  851.         window  can  be called up simply be pressing the  F1  key.   This 
  852.         window will explain the current function.
  853.  
  854.         You activate the current function by pressing the ENTER key.  DFL 
  855.         will go on to perform whatever function you have requested.   All 
  856.         of  the functions available in the menu window will be  described 
  857.         below.
  858.  
  859.         In  addition  to accessing functions using the cursor  and  ENTER 
  860.         key, DFL will also accept function commands directly at any time.  
  861.         Certain  keys will immediately activate corresponding  functions.  
  862.         These hot-keys are listed in the sub-windows and described  below 
  863.         as well.
  864.  
  865.         
  866.         3.1.2     The Duplicate Window
  867.  
  868.         The DUPLICATE window is used by DFL to present the list of dupli-
  869.         cate  files.   After  your disks have been  processed,  DFL  will 
  870.         display  all duplicates as separate groups in the duplicate  win-
  871.         dow.   Along  with each file name, you will see the path  to  the 
  872.         file, the size of the file, the date it was last written, and the 
  873.         time of the last write.
  874.  
  875.         Files  which  are contained in an archive of some  type  will  be 
  876.         marked by an asterisk.  The last file name in the path for such a 
  877.         file will have the normal archive suffix.  This will indicate the 
  878.         type  of  archive which contains the file.  For example,  if  the 
  879.         suffix is ".ZIP", then the file was found in an archive processed 
  880.         by the programs offered by PKWARE, Inc.
  881.  
  882.         You can scroll through the list of files in this window,  compare 
  883.         any  two  files, view any file, delete any single file,  tag  and 
  884.         delete any number of files, or write the list of duplicates to an 
  885.         output file for later processing.  How to perform these functions 
  886.         is described in various sections below.
  887.  
  888.         On the left vertical frame of this window, a small marker appears 
  889.         and  indicates your relative position in the full list of  dupli-
  890.         cates.  This marker moves from top to bottom as you scroll toward 
  891.         the  end of the list.  This helps you estimate where you  are  in 
  892.         the total list.
  893.                                                        Page 19
  894.  
  895.  
  896.         3.1.3     The File View Window
  897.  
  898.         The  file VIEW window allows you to view any file listed  in  the 
  899.         duplicate window.  Often, this will help you in deciding  whether 
  900.         or not to delete a file.  While you are in the duplicate  window, 
  901.         a single file is highlighted at any given time.  You can  immedi-
  902.         ately  view  the file by pressing the F10 key.  The  VIEW  window 
  903.         will  open and replace the duplicate window with the contents  of 
  904.         the selected file.
  905.  
  906.         You  can  scroll through the file, left and right,  up  or  down, 
  907.         using  the cursor control keys.  You can also move to the  begin-
  908.         ning  or  end  of the file by pressing the  HOME  and  END  keys.  
  909.         Naturally, a help window can be accessed using F1 to describe all 
  910.         of the active keys available.
  911.  
  912.         
  913.         3.2       Global Functions
  914.  
  915.         All  of  the functions available using the  cursor  movement  and 
  916.         ENTER  keys  can be accessed directly using the  global  function 
  917.         keys described below.  In general, most of these keys are  active 
  918.         only while you are in the MENU or DUPLICATE windows.
  919.  
  920.         
  921.         3.2.1     ESC    Menu & Non-menu Toggle
  922.  
  923.         The  ESCAPE  key provides a number of utility functions.   It  is 
  924.         used to toggle between the MENU and DUPLICATE windows.  When  you 
  925.         are  viewing  a  file or a help screen, the ESC key  is  used  to 
  926.         return to the prior MENU or DUPLICATE window.
  927.  
  928.         3.2.2     Alt-H  Help Menu
  929.  
  930.         You  can access context sensitive help at most times by  pressing 
  931.         the Alt-H key.  Immediately, a window will open with  information 
  932.         regarding the specific function you are considering.
  933.  
  934.         If  you press this key combination while in a  context  sensitive 
  935.         help  screen,  you  will move into the full  help  system.   From 
  936.         there, you can access all of the normal on-line help topics.
  937.  
  938.         Exit from either help screen by pressing the ESC key.
  939.                                                        Page 20
  940.  
  941.  
  942.         3.2.3     Alt-S  Setup Menu
  943.  
  944.         The setup menu is used to configure DFL for the specific process-
  945.         ing  run you are beginning, and can be accessed by  pressing  the 
  946.         Alt-S key.  You may also define the archive functions you want to 
  947.         include in the processing run.
  948.  
  949.         DFL  can access any of the popular archive programs by  executing 
  950.         the  proper external program.  It is your responsibility  to  ac-
  951.         quire your favorite programs and define for DFL the method needed 
  952.         to use the program.  By accessing your personal archive system in 
  953.         this way, DFL is not locked into any proprietary archive  system, 
  954.         and  you aren't either.  As these programs evolve, you need  only 
  955.         update the information in the DFL configuration file through  the 
  956.         setup menu.
  957.  
  958.         
  959.         3.2.4     Alt-R  Run Menu
  960.  
  961.         The  run menu is used to start a DFL processing run, and  can  be 
  962.         accessed by pressing the Alt-R key.  If you have already built  a 
  963.         list  of files, you can have DFL resort the list for a  different 
  964.         mode, and then build a new list of duplicates.  In this way,  you 
  965.         can  save some time when making a series of different  processing 
  966.         runs.
  967.  
  968.         
  969.         3.2.5     Alt-E  Exit Menu
  970.  
  971.         The exit menu is used to exit DFL and return to DOS, or to  shell 
  972.         to  DOS  temporarily, and can be accessed by pressing  the  Alt-E 
  973.         key.
  974.  
  975.         When you exit to DOS, all of the file list information accumulat-
  976.         ed by DFL is lost, unless you have written the duplicate list  to 
  977.         a file.
  978.  
  979.         You  can shell to DOS to do whatever miscellaneous functions  you 
  980.         desire.   Since  DFL uses a virtual memory system  to  store  its 
  981.         internal data tables, a lot of memory is available to execute DOS 
  982.         functions,  and  the file list information is not lost.   If  you 
  983.         have  shelled out to DOS, you can return to DFL by typing  "EXIT" 
  984.         at any DOS prompt.
  985.  
  986.         3.2.6     Alt-X  Exit DFL
  987.  
  988.         You  can go directly to the DFL exit function by pressing  Alt-X.  
  989.         DFL  will  request  confirmation of your desire  to  exit  before 
  990.         proceeding.
  991.                                                        Page 21
  992.  
  993.  
  994.         3.2.7     Home   Top of List
  995.  
  996.         In  the  duplicate window, you can move to the beginning  of  the 
  997.         list  by pressing the HOME key.  The position marker on the  left 
  998.         window frame will move to the top of the frame.
  999.  
  1000.         In  the file view window, pressing the HOME key will move you  to 
  1001.         the beginning of the file being viewed.
  1002.  
  1003.         
  1004.         3.2.8     End    Bottom of List
  1005.  
  1006.         In  the duplicate window, you can move to the bottom of the  list 
  1007.         by pressing the END key.  The position marker on the left  window 
  1008.         frame will move to the bottom of the frame.
  1009.  
  1010.         In  the file view window, pressing the END key will move  you  to 
  1011.         the end of the file being viewed.
  1012.  
  1013.         
  1014.         3.2.9     PgUp   Next Page in List
  1015.  
  1016.         In  the  duplicate  window, you can move up one  screen  full  of 
  1017.         duplicate files by pressing the PAGE UP key.
  1018.  
  1019.         In  the  file  view window, you can move up one  screen  of  file 
  1020.         information by pressing the PAGE UP key.
  1021.  
  1022.         
  1023.         3.2.10    PgDn   Previous Page in List
  1024.  
  1025.         In  the  duplicate window, you can move down one screen  full  of 
  1026.         duplicate files by pressing the PAGE DOWN key.
  1027.  
  1028.         In  the  file view window, you can move down one screen  of  file 
  1029.         information by pressing the PAGE DOWN key.
  1030.  
  1031.         
  1032.         3.2.11    F1     Call for Help
  1033.  
  1034.         At  any  time,  you can obtain help about the  current  topic  by 
  1035.         pressing  the F1 key.  If you are already in a help  window,  you 
  1036.         will  move to the full DFL help window.  In this window, you  can 
  1037.         scroll through all of the help information available on-line.
  1038.                                                        Page 22
  1039.  
  1040.  
  1041.         3.2.12    SF1    Display Help Topics
  1042.  
  1043.         At any time, you can press the Alt-F1 and open a menu of DFL help 
  1044.         topics.  You can then scroll through this window using the cursor 
  1045.         keys,  and select a topic of interest by pressing the ENTER  key.  
  1046.         Another  window will then pop up giving information on the  topic 
  1047.         of  interest.  From any of these topic windows, you can  move  to 
  1048.         the  full  help  window by pressing F1, or return  to  the  topic 
  1049.         selection window by pressing ESC.
  1050.  
  1051.         
  1052.         3.2.13    F2     Drive Selection
  1053.  
  1054.         By  pressing  the  F2 key when in either the  duplicate  or  menu 
  1055.         windows, you will move to a window which will allow you to select 
  1056.         the disk drives which will participate in the file search.
  1057.  
  1058.         DFL defaults to the current drive.  To select a  different  drive  
  1059.         or multiple drives, use this option.  You will be presented  with  
  1060.         a  window  containing  a list of the  available  drives.   Simply 
  1061.         position  the cursor bar over any drive letter and toggle  it  to 
  1062.         'Yes'  or 'No' using the space bar.  When DFL begins  processing, 
  1063.         the drives that were toggled to 'Yes' will be scanned.
  1064.  
  1065.         
  1066.         3.2.14    F3     Name Mask Selection
  1067.  
  1068.         By  pressing  the  F3 key when in either the  duplicate  or  menu 
  1069.         windows, you will move to a window which will allow you to define 
  1070.         the scan mask.
  1071.  
  1072.         The Scan Mask is used to determine which files DFL will  remember 
  1073.         while scanning the disk(s).  The standard DOS filespec  including 
  1074.         wildcards is accepted.
  1075.  
  1076.         For  example, using '*.*' as the mask will force DFL to  consider 
  1077.         EVERY  file during the scan.  Or, you may scan every file  begin-
  1078.         ning with 'A' by using 'A*.*'.
  1079.  
  1080.  
  1081.         3.2.15    F4     Scan Mode Selection
  1082.  
  1083.         By  pressing  the  F4 key when in either the  duplicate  or  menu 
  1084.         windows, you will move to a window which will allow you to define 
  1085.         the scan mode.
  1086.                                                        Page 23
  1087.  
  1088.  
  1089.         There  are four different scan modes available.  Like all  dupli-
  1090.         cate  file locator programs, you can use DFL to search for  files 
  1091.         with duplicate names.  In addition, DFL provides three additional 
  1092.         modes.  These are described below in more detail.
  1093.  
  1094.           Name     - DFL will find files with identical names.
  1095.           Length   - DFL will find files with equal lengths.
  1096.           Name1-11 - DFL will find files with the first N matching name
  1097.                      letters.
  1098.           Dos Path - DFL  will search the path for duplicate  executables 
  1099.                      like DFL.EXE, DFL.BAT & DFL.COM.
  1100.           Alias    - Also known as 'Content', an Alias scan can be time
  1101.                      consuming,  but very eye-opening.  This method  will
  1102.                      find files with identical contents, archived or not.
  1103.  
  1104.         
  1105.         3.2.16    F5     Begin Scan
  1106.  
  1107.         By pressing the F5 key when in either the duplicate or menu  win-
  1108.         dows, you will begin disk scanning using the mode and mask .
  1109.  
  1110.         
  1111.         3.2.17    SF5    Resort Scan
  1112.  
  1113.         By pressing the shift-F5 key when in either the duplicate or menu 
  1114.         windows, you will resorting the internal file list using the mode 
  1115.         and mask.
  1116.  
  1117.         
  1118.         3.2.18    F6     Select First File for Comparison
  1119.  
  1120.         By  pressing the F6 key while in the duplicate window,  you  will 
  1121.         identify  the  currently  highlighted file for use  in  the  file 
  1122.         comparison process.  The file line will begin blinking until some 
  1123.         other file is selected.
  1124.  
  1125.         If you press F6 while on a selected file line, you will de-select 
  1126.         the file, and it will stop blinking.
  1127.  
  1128.         
  1129.         3.2.19    F7     Start Binary File Comparison
  1130.  
  1131.         If  you press F7 while in the duplicate window, you will start  a 
  1132.         binary  file comparison process between the file currently  high-
  1133.         lighted  and the file selected with the F6 key.  This  comparison 
  1134.         will be performed as a binary, byte-by-byte comparison.  DFL will 
  1135.         report the results of the comparison in a status report window.  
  1136.                                                        Page 24
  1137.  
  1138.  
  1139.         3.2.20    F8     Delete One or More Files
  1140.  
  1141.         When  you  press F8 from within the duplicate  window,  you  will 
  1142.         delete  all tagged files.  If no files are tagged, then you  will 
  1143.         delete the file currently highlighted in the duplicate window.
  1144.  
  1145.         Any file or group of files, archived or not, can be.  Before  DFL 
  1146.         begins  the  delete  process, you will be asked  to  confirm  the 
  1147.         request.  If you answer no, or have no tagged files, you will  be 
  1148.         asked if you want to delete the file under the cursor bar.  Write 
  1149.         protected files are not deleted.
  1150.  
  1151.         Note that, when files are deleted, any sole survivors from  their 
  1152.         group are removed from the duplicate window but not deleted  from 
  1153.         disk.
  1154.  
  1155.  
  1156.         3.2.21    F9     Write Duplicate List
  1157.  
  1158.         When  you press F9 from the duplicate window, you  will  activate 
  1159.         the  DFL function which writes the list of duplicate files to  an 
  1160.         ASCII  file of your choice.  You will be prompted for  the  file-
  1161.         name.  This process may be aborted at any time by hitting the Esc 
  1162.         key.
  1163.  
  1164.         Use LPT1: or PRN to write directly to the printer.  The  pathname 
  1165.         field begins in column 51.  Paths which are longer than 30  char-
  1166.         acters may cause some 80 column printers to wrap lines.
  1167.  
  1168.         
  1169.         3.2.22    F10    View File Contents
  1170.  
  1171.         By pressing F10 from within the duplicate window, you will active 
  1172.         the file view function.  The view window will automatically open, 
  1173.         replacing the duplicate window.
  1174.  
  1175.         You may view any file marked by the cursor bar, archived or  not, 
  1176.         by selecting this function.  While in the file viewing subsystem, 
  1177.         use  the F1 key obtain a list of the various keystrokes  and  op-
  1178.         tions that are available.
  1179.  
  1180.         
  1181.         3.2.23    'F'    Start ASCII File Comparison
  1182.  
  1183.         By  pressing the "F" key while in the duplicate window, you  will 
  1184.         activate the ASCII file comparison routine.
  1185.  
  1186.         This  function causes DFL to run and display the results  of  the 
  1187.         external program FC.EXE Flaws in the Setup menu.  The default  is 
  1188.         FC.EXE,  the DOS file compare program.  However, you  may  define 
  1189.         your  own  provided the of the program goes to the  DOS  standard 
  1190.         output  device.   Examine the documentation for the  program  you 
  1191.         choose to use.
  1192.                                                        Page 25
  1193.  
  1194.  
  1195.         The  two  files may be of different  lengths.   Comparing  binary 
  1196.         files may produce a lengthy or useless list of differences.  This 
  1197.         function  is  normally used to compare the current version  of  a 
  1198.         file  and its backup copy.  If the files are different, the  com-
  1199.         pare  program will attempt to re-synchronize to similar lines  in 
  1200.         the  two files.  Because of the way this compare  program  works, 
  1201.         you  will be presented with a display of the differences  between 
  1202.         the two files.
  1203.  
  1204.         3.2.24    'T'    Toggle File Tag
  1205.  
  1206.         By  pressing this key while in the duplicate window, you can  tag 
  1207.         or  un-tag a file for future deletion.  The file currently  high-
  1208.         lighted  by  the cursor bar will be tagged or  untagged  with  an 
  1209.         arrow character appearing or disappearing on the left side of the 
  1210.         duplicate window.
  1211.  
  1212.         Later,  every  tagged file can be deleted  automatically  by  the 
  1213.         delete function.
  1214.  
  1215.         
  1216.         3.2.25    'U'    Untag all Files
  1217.  
  1218.         By  pressing this key while in the duplicate window,  the  delete 
  1219.         tags  will be cleared from all of the files which may  have  been 
  1220.         tagged.
  1221.  
  1222.         
  1223.         3.2.26    'S'    Shell to DOS
  1224.  
  1225.         This  function causes DFL to shell out to DOS.  DFL  will  remain 
  1226.         resident in about 320k of memory.  To return to DFL, simply enter 
  1227.         the command 'EXIT' at the DOS command line.
  1228.  
  1229.         
  1230.         3.2.27    ^C-Z   Display Drive Statistics
  1231.  
  1232.         Keys  Cntl-C through Cntl-Z select the status at the top  of  the 
  1233.         main screen to reflect the corresponding disk.
  1234.  
  1235.         If selected in the menu window, these keys will present you  with 
  1236.         the  list  of available disks.  From there, simply  position  the  
  1237.         cursor bar over a desired disk and hit the ENTER key.
  1238.  
  1239.         For  each  disk, you will see the total used  bytes,  total  free 
  1240.         bytes and total duplicate bytes.
  1241.                                                        Page 26
  1242.  
  1243.  
  1244.         4         DFL Archive Subsystem
  1245.  
  1246.         4.1       Overview
  1247.  
  1248.         The DFL archive handling system is a method which will allow  you 
  1249.         to  use DFL with your favorite archive processing programs.   For 
  1250.         example,  many  people choose ZIP, PAK, ZOO and  ARC  formats  to 
  1251.         maintain their archives.  In some cases, you may have several  of 
  1252.         these archive types present on your disks.
  1253.  
  1254.         DFL  can use any of these programs because we actually shell  out 
  1255.         invisibly whenever we need to access one of the archives. Because 
  1256.         we use your archive programs, DFL will always remain current with 
  1257.         the latest archive program technology.
  1258.  
  1259.         Also,  during the definition process, DFL will determine  if  the 
  1260.         archive file format can be accessed directly. This preferable  to 
  1261.         shelling to external programs because it is much faster.
  1262.  
  1263.         4.2       Defining an Archive
  1264.  
  1265.         To  use your choice of archive program, we provide a menu  driven 
  1266.         configuration process to gather the necessary information.   This 
  1267.         process is described below.
  1268.  
  1269.         Naturally, it is your responsibility to purchase or register your 
  1270.         particular  archive programs.  DFL will merely use  the  programs 
  1271.         you provide.  Just as you have registered for DFL, please  regis-
  1272.         ter the archive programs you use as well.
  1273.  
  1274.         
  1275.         4.2.1     Basic Parameters
  1276.  
  1277.         When  you  stop to think about it, performing the  DFL  functions 
  1278.         requires only four of the many archive program functions.   These 
  1279.         are:
  1280.  
  1281.           a) output a list of the files in the archive
  1282.           b) extract a file from the archive
  1283.           c) delete a file from the archive
  1284.           d) compress a file and add it to an archive
  1285.  
  1286.         4.2.1.1   Title
  1287.  
  1288.         This  is simply used as a reference.  Currently, it only  appears 
  1289.         in the list window where you previously selected this  definition 
  1290.         and  in the output duplicate list.  It can be any string of  your 
  1291.         choosing, preferably something meaningful.
  1292.                                                        Page 27
  1293.  
  1294.  
  1295.         4.2.1.2   Extension
  1296.  
  1297.         DFL  uses  the file name extension to identify  which  files  are 
  1298.         archives.   For  example, using 'ZIP' will cause  DFL  to  access 
  1299.         files  with  a  'ZIP' extension according  to  the  corresponding 
  1300.         definition.
  1301.  
  1302.         If the Archive Lister can obtain a file list, the archive will be 
  1303.         treated  as  a  pseudo-directory accessible as  outlined  by  the 
  1304.         definition.  Otherwise, DFL assumes its an ordinary file.
  1305.  
  1306.         
  1307.         4.2.1.3   Enable/Disable
  1308.  
  1309.         This  is  a Yes/No option allowing you to enable  or  disable  an 
  1310.         archive during the scan.  When an archive is disabled, files with 
  1311.         extensions that match the Archive Extension field will be treated 
  1312.         as regular files subject to the Scan Mask and Mode.
  1313.  
  1314.         Archives  can be quickly enabled or disabled in the Archive  List 
  1315.         window where the Definitions are selected.
  1316.  
  1317.         
  1318.         4.2.1.4   Screen Save
  1319.  
  1320.         This  is a Yes/No option telling DFL whether to restore the  dis-
  1321.         play  screen  after executing any of  the  corresponding  archive 
  1322.         programs.   It is not necessary for most programs.  We  use  this 
  1323.         function to compensate for any ill-behaved archive programs which 
  1324.         may be distributed.
  1325.  
  1326.         Start with Screen Save OFF.  Later in the definition process, DFL 
  1327.         will  attempt  to create and list a sample archive  to  help  you 
  1328.         describe the Lister Output format.  If the screen display becomes 
  1329.         damaged, this option should be set ON.
  1330.  
  1331.         
  1332.         4.2.2     Archive Programs
  1333.  
  1334.         As  stated  before,  we have tested DFL with  as  many  different 
  1335.         archive programs as we have been able to find.  The list includes 
  1336.         ZIP,  PAK,  LZH,  ZOO, and ARC.  With  the  proper  configuration 
  1337.         information, the versions of these programs which we were able to 
  1338.         obtain all worked perfectly.
  1339.  
  1340.         To enable you to modify your DFL configuration to match a differ-
  1341.         ent  program you may come across, or to adapt to future  versions 
  1342.         which may be released, DFL is equipped with a menu driven  system 
  1343.         to help.
  1344.                                                        Page 28
  1345.  
  1346.  
  1347.         Some of the archive programs we tested include numerous functions 
  1348.         for  your convenience.  DFL, however, requires only a very  basic 
  1349.         sub-set of the possible functions.
  1350.  
  1351.         Perhaps  the  greatest challenge you may have  with  your archive 
  1352.         files  is related to the use of encryption.  At least one of  the 
  1353.         archive  packages  offers file encryption for  security  reasons.  
  1354.         The password must be provided to access the archive file.   Since 
  1355.         the  password  must  be provided on the DOS  command  line  which 
  1356.         activates  the archive program, and this command line is part  of 
  1357.         the DFL configuration information, to use encryption, all of your 
  1358.         archives  must  have the same password, and the  password  itself 
  1359.         must  be included in the DFL configuration file.   Most  security 
  1360.         experts would object to this procedure.  We have no  alternatives 
  1361.         to offer at this time.
  1362.  
  1363.         
  1364.         4.2.2.1   Lister Program & Parameters
  1365.  
  1366.         This is the name of the program which DFL will run when  attempt-
  1367.         ing  to get the list of files contained in an archive.  DFL  will 
  1368.         search  the Dos Path for the given archive lister  program  name.  
  1369.         You need not enter the extension.  DFL tries 'COM' and 'EXE'.  To 
  1370.         obtain any help from the program, hit <F2>.
  1371.  
  1372.         At  startup,  DFL searches the DOS Path for this  program.   This 
  1373.         makes it easy to run DFL on other machines without worrying about 
  1374.         Paths and other related garbage.
  1375.  
  1376.         You will provide the name of your archive program and any command 
  1377.         line  options  needed  to obtain a list of the  files  within  an 
  1378.         archive.  In short, this function is the equivalent of "DIR"  for 
  1379.         and archive file.
  1380.  
  1381.         These  specify  the parameters for the  archive  lister  program.  
  1382.         These  are the same parameters that would normally be entered  on 
  1383.         the  command line.  Use '%1' to represent the  Archive  Filename.  
  1384.         To obtain any help from the program, press <F2>.
  1385.  
  1386.         For example, if you are using the ZIP system, the line
  1387.  
  1388.           PKUNZIP -v archive.zip' equates to DFL parameters:
  1389.  
  1390.           PKUNZIP(.exe) - the program
  1391.           -v %1         - the command line parameters
  1392.  
  1393.         Those  familiar  with the ZIP system will recognize this  as  the 
  1394.         command  which generates a list of the files within  an  archive.  
  1395.         DFL  will  redirect the program output to an internal  file  from 
  1396.         which the necessary information will be read.
  1397.                                                        Page 29
  1398.  
  1399.  
  1400.         4.2.2.2   Deleter Program & Parameters
  1401.  
  1402.         This is the name of the program which DFL will run when  attempt-
  1403.         ing to delete a file contained in an archive.  DFL search the Dos 
  1404.         Path  for a given name.  You need  not enter the extension.   DFL 
  1405.         tries 'COM' & 'EXE'.  To obtain any help from the program,  press 
  1406.         <F2>.
  1407.  
  1408.         At startup, DFL searches the Path for these programs.  This makes 
  1409.         it easy to run DFL on other machines without worrying about Paths 
  1410.         and other related garbage.
  1411.  
  1412.         This specifies the parameters for the Deleter program.  These are 
  1413.         the  same  items that would normally be entered  on  the  command 
  1414.         line.   Use '%1' to represent the Archive Filename.  '%2'  repre-
  1415.         sents  the archived file.  To obtain any help from  the  program, 
  1416.         press <F2>.
  1417.  
  1418.         For example, if you are using the ZIP system, the line
  1419.  
  1420.           PKZIP -d archive.zip equates to DFL parameters:
  1421.  
  1422.           PKZIP(.exe)   - the program
  1423.           -d %1 %2      - the command line parameters
  1424.  
  1425.         Those  familiar  with the ZIP system will recognize this  as  the 
  1426.         command which deletes a file from an archive.
  1427.  
  1428.         
  1429.         4.2.2.3   Extractor Program & Parameters
  1430.  
  1431.         This is the name of the program which DFL will run when  attempt-
  1432.         ing  to extract a file contained in an archive.  DFL will  search 
  1433.         the Dos Path for a given name.  You need not enter the extension.  
  1434.         DFL searches for both 'COM' & 'EXE' if necessary.  To obtain  any 
  1435.         help from the program, press <F2>.
  1436.  
  1437.         At startup, DFL searches the Path for these programs.  This makes 
  1438.         it easy to run DFL on other machines without worrying about Paths 
  1439.         and other related garbage.
  1440.  
  1441.         This  specifies the parameters for the Extractor program.   These 
  1442.         are the same items that would normally be entered on  the command 
  1443.         line.   Use '%1' to represent the Archive Filename.  '%2'  repre-
  1444.         sents  the archived file.  To obtain any help from  the  program, 
  1445.         press <F2>.
  1446.  
  1447.         For example, if you are using the ZIP system, the line
  1448.  
  1449.           PKUNZIP archive.zip    equates to DFL parameters:
  1450.  
  1451.           PKUNZIP(.exe)   - the program
  1452.           %1 %2           - the command line parameters
  1453.                                                        Page 30
  1454.  
  1455.  
  1456.         Those  familiar  with the ZIP system will recognize this  as  the 
  1457.         command which extracts a file from an archive.
  1458.  
  1459.         4.2.2.4   Compressor Program & Parameters
  1460.  
  1461.         This is the name of the program which DFL will run when  attempt-
  1462.         ing  to add a file to an archive.  DFL will search the  DOS  Path 
  1463.         for  a given name.  You need not enter the extension.  DFL  tries 
  1464.         both  'COM'  & 'EXE' if necessary.  To obtain any help  from  the 
  1465.         program, press <F2>.
  1466.  
  1467.         At startup, DFL searches the Path for these programs.  This makes 
  1468.         it easy to run DFL on other machines without worrying about Paths 
  1469.         and other related garbage.
  1470.  
  1471.         This specifies the parameters for the Compressor program.   These 
  1472.         are the same items that would normally be  entered on the command 
  1473.         line.   Use '%1' to represent the Archive Filename.  '%2'  repre-
  1474.         sents  the archived file.  To obtain any help from  the  program, 
  1475.         press <F2>.
  1476.  
  1477.         For example, if you are using the ZIP system, the line
  1478.  
  1479.           PKZIP archive.zip    equates to DFL parameters:
  1480.  
  1481.           PKZIP(.exe)     - the program
  1482.           -ex %1 %2       - the command line parameters
  1483.  
  1484.         Those  familiar  with the ZIP system will recognize this  as  the 
  1485.         command  which adds a file to an archive using  maximum  compres-
  1486.         sion.
  1487.  
  1488.  
  1489.         4.3.3     The Test Run
  1490.  
  1491.         When  each archive function is defined, DFL will request  a  test 
  1492.         run. Type 'y' or 'Y' to have DFL test each specific program as it 
  1493.         is defined.
  1494.  
  1495.         The following procedure is used by DFL automatically:
  1496.  
  1497.           1. Create a 32k dummy file.
  1498.           2. Add it to a dummy archive using the Compressor.
  1499.           3. List the dummy archive using the Lister.
  1500.           4. Extract the dummy file using the Extractor.
  1501.           5. Delete it from the archive using the Deleter.
  1502.  
  1503.         This  will allow you to confirm that DFL is properly  interfacing 
  1504.         with the external programs and make any necessary changes to  the 
  1505.         definition based on the results of the above tests.
  1506.  
  1507.         When  the  DFL configuration process is complete,  all  of  these 
  1508.         temporary files are deleted.
  1509.                                                        Page 31
  1510.  
  1511.  
  1512.         4.3.4     Archive Lister Output
  1513.  
  1514.         Perhaps  the most challenging aspect of configuring DFL  for  and 
  1515.         archive system are the steps needed to teach DFL how to read  the 
  1516.         output file generated by the archive lister program.
  1517.  
  1518.         If DFL recognizes the archive file format, you won't be requested 
  1519.         to continue here. The archives will be directly accessed.
  1520.  
  1521.         After  a sample run of the archive lister program, DFL will  dis-
  1522.         play the output file and have you position the cursor to  certain 
  1523.         specific  fields in a file data line.  DFL uses this  process  to 
  1524.         make  an  internal table which gives the position  in  each  line 
  1525.         where  the  various  fields begin, the  field  width,  and  other 
  1526.         properties.
  1527.  
  1528.         4.3.4.1   Name
  1529.  
  1530.         Use  the cursor left and right movement keys to locate the  first 
  1531.         column of the name of a file within the archive.
  1532.  
  1533.         DFL  will  ask  if the field is right  justified,  its  rightmost 
  1534.         character  will  always be in the same column.  If the  field  is 
  1535.         left justified, its leftmost character will always be in the same 
  1536.         column.
  1537.  
  1538.         Enter 'R' or 'r' if it is right justified.
  1539.         Enter 'L' or 'l' if it is left justified.
  1540.  
  1541.         4.3.4.2   Extension
  1542.  
  1543.         Some  archive lister programs output separate the file  name  and 
  1544.         extension.   In  this  case, DFL must treat the  extension  as  a 
  1545.         separate field and later concatenate it to the name.
  1546.  
  1547.         In  response to the DFL query, enter 'Y' or 'y' if there  are  no 
  1548.         spaces between the file name and extension.
  1549.  
  1550.  
  1551.         4.3.4.3   Length
  1552.  
  1553.         Define  the position and width of the file size within a line  of 
  1554.         the  sample  lister output file.  Follow  procedures  similar  to 
  1555.         those described for defining the file name field, and respond  to 
  1556.         the prompts given.
  1557.  
  1558.         
  1559.         4.3.4.4   Time
  1560.  
  1561.         Define  the position of the file time field within a line of  the 
  1562.         sample  lister output file.  Follow procedures similar  to  those 
  1563.         described above, and respond to the prompts given.
  1564.                                                        Page 32
  1565.  
  1566.  
  1567.         4.3.4.5   Date
  1568.  
  1569.         Define  the position of the file date field within a line of  the 
  1570.         sample  lister output file.  Follow procedures similar  to  those 
  1571.         described above, and respond to the prompts given.
  1572.  
  1573.         5         DFL File Viewing System
  1574.  
  1575.         5.1       Overview
  1576.  
  1577.         While  operating in the duplicate window, you have the option  of 
  1578.         viewing  any file.  The present viewing feature provides only  an 
  1579.         ASCII  display.  Thus, you may not be able to make sense  out  of 
  1580.         what  you  see  when viewing binary files such as  .EXE  or  .COM 
  1581.         files.
  1582.  
  1583.         Active the file viewer by pressing F10 while the desired file  is 
  1584.         highlighted in the duplicate window.
  1585.  
  1586.         The details of the file viewing feature are described below.
  1587.  
  1588.         
  1589.         5.2       Screen Layout
  1590.  
  1591.         When the viewer is activated, a new window is opened, filling the 
  1592.         screen with text from the file.  The top line gives the line  and 
  1593.         column  number of the character in the upper left corner  of  the 
  1594.         window, along with the path and name of the file.
  1595.  
  1596.         5.3       Viewer Commands
  1597.  
  1598.         The  viewer has a distinct set of command keys  identified.
  1599.  
  1600.         
  1601.         5.3.1     F1 - Quick Help
  1602.  
  1603.         The list of active keys and their assigned functions will  pop-up 
  1604.         in a window when you press the F1 key.
  1605.  
  1606.         
  1607.         5.3.2     Home & End
  1608.  
  1609.         Pressing the HOME key will move the display window to the  begin-
  1610.         ning of the file being viewed.
  1611.  
  1612.         Pressing  the END key will move the display window to the end  of 
  1613.         the file being viewed.
  1614.                                                        Page 33
  1615.  
  1616.  
  1617.         5.3.3     Page Keys
  1618.  
  1619.         The  PAGE UP and PAGE DOWN keys can be used to move  the  viewing 
  1620.         window up or down one page of text at a time.
  1621.         
  1622.         5.3.4     Arrow Keys
  1623.  
  1624.         The cursor control keys are used to scroll the viewing window  up 
  1625.         or  down  one line at a time, or left or right one  column  at  a 
  1626.         time.
  1627.  
  1628.         5.3.5     ^Home
  1629.  
  1630.         The Cntl-HOME key will immediately scroll the viewing window such 
  1631.         that  the  first  column of each file line is  in  the  left-most 
  1632.         column of the screen.
  1633.  
  1634.         5.3.6     ^PgUp & ^PgDn
  1635.  
  1636.         Using  Cntl-PAGE  UP and Cntl-PAGE DOWN will  cause  an  animated 
  1637.         scroll of the viewing window up or down a full page of text.
  1638.         
  1639.         5.3.7     ^Right & ^Left
  1640.  
  1641.         Pressing the Cntl-LEFT or Cntl-RIGHT keys will cause an  animated 
  1642.         scroll of the viewing window left or right 40 columns.
  1643.         
  1644.         5.3.8     'W' - Mask High Bits
  1645.  
  1646.         Since  some text files are written with 8 bit  ASCII  characters, 
  1647.         and  others  have the eighth bit set to zero, DFL gives  you  the 
  1648.         option of blanking out the eighth bit if the characters displayed 
  1649.         are confused. Press the W key to toggle the bit 8 mask on or off.
  1650.  
  1651.         5.3.9     'T' - Tab Toggle
  1652.  
  1653.         The readability of text files can sometimes be improved by chang-
  1654.         ing  the  number of columns assigned to each tab  character.   By 
  1655.         pressing  the T key, DFL will alternately select tab spacings  of 
  1656.         0, 4 or 8 columns.
  1657.  
  1658.         5.3.10    F2 - Print File
  1659.  
  1660.         You  may  print the file that is being viewed by hitting  the  F2 
  1661.         key.  This function attempts to copy the file to the PRN  device. 
  1662.         You  should  not  attempt to print a binary file  (one  that  has 
  1663.         unreadable  characters). Printing a binary file will  cause  your 
  1664.         printer to do unpredictable things.
  1665.                                                        Page 34
  1666.  
  1667.  
  1668.         6         Useful Topics
  1669.  
  1670.         6.1       Users' Questions and Answers
  1671.  
  1672.         This is a growing section which contains verbatim copies of email 
  1673.         correspondence between W.S. Ataras Engineering and users of  DFL. 
  1674.         If the conversation was verbal, it will appear here as a close to 
  1675.         the  actual content as memory permits. We welcome questions  from 
  1676.         anyone  even if they aren't registered users. Naturally, not  all 
  1677.         correspondence will be published here.
  1678.  
  1679.  
  1680.         Question:
  1681.  
  1682.         On  the  BBS system with over 1.5 gig of HD, I let  DFL  run  for 
  1683.         approx 4.5 hours and then the system deep ended (required a  cold 
  1684.         boot).  I  mistakenly started running DFL on a 286/10  and  might 
  1685.         have  been  successful if I had run on a 386 with more  ram.  The 
  1686.         problem  is due to intensive disk operations, the BBS comes to  a 
  1687.         virtual standstill while DFL is accessing the HDs (expected not a 
  1688.         complaint).
  1689.  
  1690.         Answer:
  1691.  
  1692.         I'm  assuming  you've  got  a  network  and  the  286/10  was   a 
  1693.         workstation  and you ran with archives ON in ALIAS mode.  All  of 
  1694.         this  applies  proportionally to non-network  installations  even 
  1695.         without  archives.  Just substitute references to  remote  server 
  1696.         disks   with  local  harddisks  and/or  ignore  archive   program 
  1697.         accesses.
  1698.  
  1699.         When   DFL   initializes   it  needs  to   create   2   temporary 
  1700.         subdirectories  and  5 temporary files. 4 of the files  hold  the 
  1701.         virtual  memory garbage and 1 is used to redirect the  output  of 
  1702.         the  archive programs. The 2 dirs are used to extract files  from 
  1703.         archives  for  comparison (alias mode) or  viewing.  DFL  creates 
  1704.         these files/dirs in the root directory of the WORKING DISK  which 
  1705.         defaults  to the disk you were currently logged to when  DFL  was 
  1706.         run. If this disk was remote on the server, then, particularly in 
  1707.         alias  mode, extremely heavy network traffic will result and  any 
  1708.         other  machine using that disk will degrade. Also, each time  DFL 
  1709.         extracts  an  archived  file,  it  must  load  and  execute   the 
  1710.         corresponding archive program (pkunzip.exe etc.). At startup, the 
  1711.         path  is searched for these. If they also reside on the  server's 
  1712.         disk, FURTHER network degradation will result. Here would be  the 
  1713.         scenario:
  1714.  
  1715.           1. Two archived files must be compared for alias dupes.
  1716.           2. Both archives are on the server.
  1717.           3. The archive extractor (assume unzip.exe) is on the server.
  1718.           4. The server is also the working disk.
  1719.                                                        Page 35
  1720.  
  1721.  
  1722.           DFL reads unzip.exe from the server.
  1723.           Unzip.exe reads archive 1 from the server.
  1724.           Unzip.exe writes archived file 1 to the server.
  1725.           DFL reads unzip.exe from the server.
  1726.           Unzip.exe reads archive 2 from the server.
  1727.           Unzip.exe writes archived file 2 to the server.
  1728.           DFL  begins reading both newly extracted files from the  server 
  1729.           to compare.
  1730.           DFL deletes both extracted files from the server.
  1731.  
  1732.         This  will happen perhaps thousands of times for a big disk  with 
  1733.         lots  of archives and doesn't include the scan phase  which,  for 
  1734.         each  archive,  runs unzip.exe from the server  which  reads  the 
  1735.         archive  on the server whose output is redirected to a  temporary 
  1736.         file  on the server which is then scanned and interpreted by  DFL 
  1737.         which  then  may tweak the virtual memory files  on  the  server. 
  1738.         Whew.
  1739.  
  1740.         DFL does, however, let you specify a different working disk using 
  1741.         the  environment variable DFLDISK=C or the command line  argument 
  1742.         /w=c  or  starting  DFL while logged to a  different  disk.  When 
  1743.         running on a workstation, consider the following:
  1744.  
  1745.         If the workstation has a local physical harddisk -
  1746.           Use it as the working disk.
  1747.           Try to setup a cache for it of about 1 meg.
  1748.  
  1749.         If the workstation doesn't have a local physical harddisk -
  1750.           Setup  a RAMDRIVE (fastest option) big enough to hold  the  two 
  1751.           largest  equal  length archived files plus the  virtual  memory 
  1752.           files  (at about 1meg per 20,000 files). Don't lose sleep  over 
  1753.           the  two largest archived files bit. DFL won't crash  if  there 
  1754.           isn't  enough space for the archiver to extract  files  (unless 
  1755.           the archiver crashes). Make a guess.
  1756.  
  1757.         Copy the archive programs that DFL will use (pkunzip.exe etc.) to 
  1758.         the  ROOT DIRECTORY of the working disk. DFL looks  there  before 
  1759.         the path when running external programs.
  1760.  
  1761.         With  that  setup, everything from  the  aforementioned  scenario 
  1762.         would  be  eliminated except for reading archives on  the  server 
  1763.         disk. DFL would access the local device for all other actions  at 
  1764.         full  blast.  The speed of operation and relief  to  the  network 
  1765.         would improve an order of magnitude, especially with the ramdrive 
  1766.         method.
  1767.                                                        Page 36
  1768.  
  1769.  
  1770.         Question:
  1771.  
  1772.         Other  than  the  ASCII file that you have allowed  the  user  to 
  1773.         create  showing  the  dups, apparently a complete  rerun  of  the 
  1774.         entire scan has to be performed to "restart" the operation. I had 
  1775.         thought  that you were creating a database file that would  allow 
  1776.         the  "rescan"  to be restarted and only check  "new"  or  changed 
  1777.         files.
  1778.  
  1779.         Answer:
  1780.  
  1781.         That's  true. DFL currently has no way of saving and restoring  a 
  1782.         session. That functionality will be released in the near future.
  1783.  
  1784.         We  haven't  seen a high demand for systems like DFL  which  work 
  1785.         from  a 'history' database because the disks would still need  to 
  1786.         be   scanned  every  time  to  verify  the   database   contents. 
  1787.         Effectively, the database needs to be re-created each time DFl is 
  1788.         run.  There  may be some time savings in that as  the  disks  are 
  1789.         scanned,  certain  actions for files which are  'already  in  the 
  1790.         database'  would  not need to happen. But then, the  overhead  of 
  1791.         determining if a file is 'already in the database' would probably 
  1792.         outweigh  the other gains. As you can see, we have  devoted  some 
  1793.         thought along those lines. If you have any further ideas,  please 
  1794.         let me know. The subject is by no means closed.
  1795.  
  1796.         If  "rescan"  refers to the Resort option under the run  menu  it 
  1797.         works as follows:
  1798.  
  1799.         DFL  scan the selected disks according to the Scan Mask to  build 
  1800.         the  base filelist. It then processes that list according to  the 
  1801.         Scan  Mode to produce the duplicate list. Resort basically  skips 
  1802.         the  scan  phase  and re-processes  the  existing  base  filelist 
  1803.         according  to  the Scan Mode (which has probably  been  changed). 
  1804.         This  saves whatever time and disk activity the scan phase  would 
  1805.         have  needed  (it  can  be alot on a  big  system  with  archives 
  1806.         enabled).  The idea is, during one session, scan your disks  once 
  1807.         for  the first mode search, then search for duplicates  by  other 
  1808.         modes using resort.
  1809.  
  1810.  
  1811.         Question:
  1812.  
  1813.         I  reran the DFL on my 40 Meg 386/20 notebook, and the scan  took 
  1814.         approximately 1 hour. The results showed about 13 Meg of dups  (I 
  1815.         ran  in ALIAS mode doing the compare by size. After deleting  the 
  1816.         dups  that I did not want, I had a few hundred K of dups  (I  zip 
  1817.         some  of  the work files that I use to save disk space)  but  DFL 
  1818.         showed  over 11 Meg of dups. I could find no reason for the  very 
  1819.         high  DUP count. When I tried to goto a different scan,  thinking 
  1820.         that the scan would take place on the nonexistent database  file, 
  1821.         I lost all information that I had.
  1822.                                                        Page 37
  1823.  
  1824.  
  1825.         Answer:
  1826.  
  1827.         Do you mean this happened?-
  1828.  
  1829.         1. Scanned by alias mode. Saw 13 megs of dupes.
  1830.         2. Tagged and deleted a chunk of files.
  1831.         3. Estimated there were a few hundred K of dupes left.
  1832.         4. DFL indicated 11 megs of dupes.
  1833.  
  1834.         Were there dupes in archives ? How did you determine there were a 
  1835.         few  hundred K of dupes ? As discussed under item 2, the  current 
  1836.         filelist  is  lost  when you begin a new  scan  (unless  you  use 
  1837.         Resort).  Note that the UNCOMPRESSED size of an archived file  is 
  1838.         added  to the total duplicate byte count while the disk space  it 
  1839.         occupies may be far less.
  1840.  
  1841.         Question:
  1842.  
  1843.         When  the scan initially starts, a time remaining is shown,  this 
  1844.         time is apparently based on the size of the archive, or directory 
  1845.         that is currently being tested. The time would start slow and  go 
  1846.         up and down at random (random to me I am sure it would make sense 
  1847.         to  you).  The time is not accurate until the  final  stage  (the 
  1848.         actual comparison of same sized files.
  1849.  
  1850.         Answer:
  1851.  
  1852.         This  is  true.  The  time remaining is  very  hard  to  estimate 
  1853.         accurately during an alias scan. It is a proportion of the number 
  1854.         of  bytes  in files currently processed over the total  bytes  in 
  1855.         files  that need to be processed and the total time expired  over 
  1856.         the total time that will expire. As an example, by comparing  the 
  1857.         first  10 bytes of 2 100k files, DFL may determine that they  are 
  1858.         NOT duplicates, whereas the next 2 100k files may have every byte 
  1859.         compared  to determine they ARE duplicates. There is not  way  to 
  1860.         anticipate  the  fact  that  2 huge equal  length  files  can  be 
  1861.         instantly  found  'not duplicate'. And becomes  more  complicated 
  1862.         when archives are enabled. This throws off the other half of  the 
  1863.         proportion, time remaining. We have considered implementing  some 
  1864.         form of artificial intelligence by maintaining various statistics 
  1865.         and  probabilities for the hardware DFL is running on.  This  may 
  1866.         facilitate better time estimates the more DFL is used on a  given 
  1867.         machine.  In fact, we'll probably be incorporating such a  scheme 
  1868.         in the future, but to tell the truth, other more pressing  issues 
  1869.         have needed attention.
  1870.                                                        Page 38
  1871.  
  1872.  
  1873.         6.2      DFL Temporary Files & Directories
  1874.  
  1875.         When  DFL initializes, it attempts to create the following  files 
  1876.         in  the root directory of the working disk (See sections 2.2.1  & 
  1877.         2.2.2):
  1878.  
  1879.           1TMP????.DFL - Subdirectory for archive file extraction.
  1880.           2TMP????.DFL - Subdirectory for archive file extraction.
  1881.  
  1882.           REDIR???.DFL - File for capturing output of external programs.
  1883.           VIRT????.DFL - Virtual memory file.
  1884.           VIRT????.DFL - Virtual memory file.
  1885.           VIRT????.DFL - Virtual memory file.
  1886.           VIRT????.DFL - Virtual memory file.
  1887.  
  1888.         These  files  are created only during the  archive  definition  & 
  1889.         testing process:
  1890.  
  1891.           FILE????.EX  - Dummy file to be archived.
  1892.           TEST????.aaa - Dummy archive to be created.
  1893.                          The extension is variable, ARC, ZIP etc.
  1894.  
  1895.         The  ?'s represent numbers from 0000 to 9999. These numeric  con-
  1896.         structs  are  used to insure unique filenames for  the  following 
  1897.         reasons:
  1898.  
  1899.         1. It  is  conceivable  that when an  external  program  receives 
  1900.            control  from DFL such as the Shell (See section III.3) or  an 
  1901.            archiver (See section IV.2.b), it crashes the system. When the 
  1902.            system is rebooted, the temporary files would still be present 
  1903.            (and possibly hidden or protected) the next time DFL ran.  See 
  1904.            section IV.4, Troubleshooting.
  1905.  
  1906.            DFL  adheres  to our policy of non-destruction  when  creating 
  1907.            temporary  files of any kind. That is, no matter how slim  the 
  1908.            chance of one of these files belonging to another program, DFL 
  1909.            will  not  overwrite  or  delete them  to  make  way  for  its 
  1910.            temporary  data. Rather, temporary filenames  are  dynamically 
  1911.            generated  to  insure that with each run DFL has  unique  disk 
  1912.            workspace.
  1913.  
  1914.         2. A  different logical drive spec may in reality, refer  to  the 
  1915.            actual working disk. Or, the working disk spec may refer to  a 
  1916.            different  logical  drive. This can cause confusion  when  DFL 
  1917.            scans both disks.
  1918.  
  1919.         3. Any of these files may already exist for a purpose other  than 
  1920.            DFL.
  1921.  
  1922.         On exit, DFL deletes these files.
  1923.                                                        Page 39
  1924.  
  1925.  
  1926.         DFL may not be able to create these files if there are not enough 
  1927.         free  entries in the root directory of the working disk. If  this 
  1928.         occurs,  DFL will exit with an error message (See  section  VI.3) 
  1929.         and you will need to use a different working disk or delete  some 
  1930.         files in the root directory. See section IV.4, Troubleshooting.
  1931.  
  1932.         When  manipulating archived files (viewing, comparing etc.),  you 
  1933.         may  notice that the file appears to be in one of  the  temporary 
  1934.         directories above. This is normal.
  1935.  
  1936.         
  1937.         6.3       DOS Stack Overflow
  1938.  
  1939.         There have been some situations reported where DFL has failed due 
  1940.         to  a "STACK OVERFLOW."  This was reported by a couple  of  users 
  1941.         who  had one of those 3rd party disk caching programs.  To  solve 
  1942.         this,  we have expanded the internal stack used by  DFL  substan-
  1943.         tially, and the problem has not been seen again when the PC TOOLS 
  1944.         cache  program "PC-CACHE.COM" is in use.
  1945.  
  1946.         However,  the stack overflow problem did recur when  a  different 
  1947.         cache  program was in use.  This was eliminated by changing  CON-
  1948.         FIG.SYS  to include the statement "STACKS=8,512".   The  original 
  1949.         statement  was   "STACKS=0,0".  This change  provides  additional 
  1950.         stack  space for OS programs.  We have not carried out  extensive 
  1951.         experiments  with all of the available cache programs, and  there 
  1952.         may be a combination of cache program and STACKS statement  which 
  1953.         cause  the  DFL stack to overflow. If you find  such  a  problem, 
  1954.         please  experiment with your STACKS statement.  If this does  not 
  1955.         solve the problem, by all means report it to us.  We will need to 
  1956.         know  the version of DOS you are using, which cache  program  and 
  1957.         parameters you have, your CONFIG.SYS file, and the type of memory 
  1958.         used  for your cache.  This will help us solve this  problem  for 
  1959.         you and anyone else who runs into it.
  1960.  
  1961.         
  1962.         6.4       Error Messages
  1963.  
  1964.         
  1965.         6.4.1     Online Errors
  1966.  
  1967.         Many  of the self-explanatory errors are signaled by a beep  from 
  1968.         the speaker.  These are errors such as:
  1969.  
  1970.             1. Typing past the end of an entry space.
  1971.             2. Entering an invalid character in a filespec.
  1972.             3. Typing 'Z' when asked to entry 'Y' or 'N'.
  1973.             4. Etc...
  1974.  
  1975.         Other  error and status report messages appear on the  screen  to 
  1976.         give you specific information if importance.  These messages  are 
  1977.         identified below in alphabetical order.
  1978.                                                        Page 40
  1979.  
  1980.  
  1981.         6.4.1.1   "<filespec> not created."
  1982.  
  1983.         This  error  may occur when you are configuring DFL to  use  your 
  1984.         particular  archive program.  During the  configuration  process, 
  1985.         DFL  will test run your archive program to confirm that the  con-
  1986.         figuration information is correct.
  1987.  
  1988.         When DFL test ran the archive program, trying to add a dummy file 
  1989.         to a non-existent archive, the new archive was not created.  This 
  1990.         indicates  that something may be wrong in your definition to  DFL 
  1991.         on how to run the "add file" option of your archive program.  You 
  1992.         should  have  seen some kind of error message  from  the  archive 
  1993.         program.  Perhaps  the  program needs more memory  to  run.   Try 
  1994.         removing any TSRs from memory before running DFL.  DFL uses about 
  1995.         340k.  The archive programs we have tested with DFL require  less 
  1996.         than 200K to run.  Since DFL itself uses 340K, you should have at 
  1997.         least  540K  available.  Run "CHKDSK" to see how much  memory  is 
  1998.         available on your system.
  1999.  
  2000.         
  2001.         6.4.1.2   "A disk drive must be selected to begin processing"
  2002.  
  2003.         This  error will occur if you try to start DFL without  selecting 
  2004.         at least one disk drive for processing.  Select function <F2> and 
  2005.         choose at least one disk for DFL to scan.
  2006.  
  2007.         
  2008.         6.4.1.3   "Can't create <filespec>"
  2009.  
  2010.         This  error  may occur when you are configuring DFL to  use  your 
  2011.         particular  archive program.  During the  configuration  process, 
  2012.         DFL  will test run your archive program to confirm that the  con-
  2013.         figuration information is correct.
  2014.  
  2015.         When  DFL attempts to test run the external archive programs,  it 
  2016.         first creates a 32k dummy file to be archived.  This error  could 
  2017.         indicate a lack of directory space, a lack of disk space, or that 
  2018.         the file <filespec> already exists.  Identify the specific  cause 
  2019.         of the problem and retry.
  2020.  
  2021.         
  2022.         6.4.1.4   "Can't extract that file."
  2023.  
  2024.         In attempting to View an archived file, DFL was unable to extract 
  2025.         it from the host archive.  Select function 'R' to see the  output 
  2026.         of  the last run archive program.  If the archive extractor  pro-
  2027.         duced any error messages, they will appear.  You may need to free 
  2028.         more  memory prior to running DFL.  Also, some  archives  contain 
  2029.         files that have been encrypted with a password. The only way  DFL 
  2030.         can  extract these files is if you add the  appropriate  password 
  2031.         option  to  the extractor program's parameter line.  See  section 
  2032.         4.2.2.
  2033.                                                        Page 41
  2034.  
  2035.  
  2036.         6.4.1.5   "Can't find that program. Try again."
  2037.  
  2038.         You are trying to enter the name of an external program. If it is 
  2039.         not on the path, you must specify drive and directory along  with 
  2040.         the  filename. If you do not specify the extension, DFL will  try 
  2041.         COM and then EXE before giving up.
  2042.  
  2043.         
  2044.         6.4.1.6   "Can't log to disk"
  2045.  
  2046.         You tried to display the statistics of an invalid drive.
  2047.  
  2048.         
  2049.         6.4.1.7   "Can't open current file."
  2050.  
  2051.         DFL was unable to access either the marked file or the file under 
  2052.         the  cursor bar for the comparison function. If the file  is  ar-
  2053.         chived,  select  function 'R' to see the output of the  last  run 
  2054.         external  program.  If the archive extractor produced  any  error 
  2055.         messages, they will appear here. You may need to free more memory 
  2056.         prior to running DFL. Also, some archives contain files that have 
  2057.         been  encrypted  with a password. The only way  DFL  can  extract 
  2058.         these files is if you add the appropriate password option to  the 
  2059.         extractor program's parameter line. See section IV.2.b.
  2060.  
  2061.         If the file is not archived, then you are faced with a  situation 
  2062.         where  DFL    has  in memory the name of a file the  was  scanned  
  2063.         moments earlier but doesn't exist now. This can happen if you are 
  2064.         running  in  a multitasking environment and  other  programs  are 
  2065.         'diddling'  things  in the background. Perhaps one of  the  back-
  2066.         ground  programs  deleted the requested file. DFL has no  way  of 
  2067.         knowing what other programs or TSRs are during in the background.
  2068.  
  2069.         
  2070.         6.4.1.8   "Can't open marked file."
  2071.  
  2072.         DFL was unable to access either the marked file or the file under 
  2073.         the  cursor bar for the comparison function. If the file  is  ar-
  2074.         chived,  select  function 'R' to see the output of the  last  run 
  2075.         external  program.  If the archive extractor produced  any  error 
  2076.         messages, they will appear here. You may need to free more memory 
  2077.         prior to running DFL. Also, some archives contain files that have 
  2078.         been  encrypted  with a password. The only way  DFL  can  extract 
  2079.         these files is if you add the appropriate password option to  the 
  2080.         extractor program's parameter line. See section IV.2.b.
  2081.  
  2082.         If the file is not archived, then you are faced with a  situation 
  2083.         where  DFL    has  in memory the name of a file the  was  scanned  
  2084.         moments earlier but doesn't exist now. This can happen if you are 
  2085.         running  in  a multitasking environment and  other  programs  are 
  2086.         'diddling'  things  in the background. Perhaps one of  the  back-
  2087.         ground  programs  deleted the requested file. DFL has no  way  of 
  2088.         knowing what other programs or TSRs are during in the background.
  2089.                                                        Page 42
  2090.  
  2091.  
  2092.         6.4.1.9   "Can't run C:\COMMAND.COM"
  2093.  
  2094.         There  was some problem in loading and executing COMMAND.COM  for 
  2095.         the  Dos  Shell function.  The path and filename of  the  command 
  2096.         processor are sought using the environment variable COMSPEC.   If 
  2097.         that is not found, DFL defaults to C:\COMMAND.COM.
  2098.  
  2099.         
  2100.         6.4.1.10  "DFL is unable to run that program"
  2101.  
  2102.         There was some problem in loading and executing the corresponding 
  2103.         archive program.  It may be too big, or not exist at all.
  2104.  
  2105.         
  2106.         6.4.1.11  "DFL temporary files have been damaged. Must exit."
  2107.  
  2108.         When  the Dos Shell function is invoked, DFL hides  and  protects 
  2109.         all  of its temporary files and directories.  On return from  the 
  2110.         Shell,  they are unhidden and unprotected.  If DFL is  unable  to 
  2111.         restore any of them, it must exit.
  2112.  
  2113.         
  2114.         6.4.1.12  "Different size files can't be the same."
  2115.  
  2116.         The  binary byte-by-byte comparison function is useless for  dif-
  2117.         ferent  length files. Use the external ASCII  comparison  program 
  2118.         for different length ascii files.
  2119.  
  2120.         
  2121.         6.4.1.13  "FC.EXE produced no results."
  2122.  
  2123.         The ASCII comparison just performed produced no output.
  2124.  
  2125.         
  2126.         6.4.1.14  "Files are not equal."  &  "Files are the same."
  2127.  
  2128.         Possible results from the binary comparison.
  2129.  
  2130.         
  2131.         6.4.1.15  "Must specify '%1' and '%2' parameters."
  2132.  
  2133.         DFL  must pass the archive extractor, adder and deleter  programs 
  2134.         at  least two parameters: the archive filename and  the  archived 
  2135.         file.  You  must indicate where these belong with '%1'  and  '%2' 
  2136.         respectively as if they were run from the command line.
  2137.  
  2138.         
  2139.         6.4.1.16  "Must specify '%1' parameter."
  2140.  
  2141.         DFL must pass the archive lister program at least one  parameter, 
  2142.         the  archive filename.  You must indicate where it  belongs  with 
  2143.         '%1' as if it was run from the command line.
  2144.                                                        Page 43
  2145.  
  2146.  
  2147.         6.4.1.17  "No duplicate files in list.  Function canceled."
  2148.  
  2149.         The requested function will not operate without a list of  dupli-
  2150.         cates.
  2151.  
  2152.  
  2153.         6.4.1.18  "No file is marked."
  2154.  
  2155.         You  must mark a file using the F6 key that you wish compared  to 
  2156.         the one under the cursor bar.
  2157.  
  2158.         
  2159.         6.4.1.19  "No files have been tagged.  Function canceled."
  2160.  
  2161.         The untag function will not work if there are no tagged files.
  2162.  
  2163.         
  2164.         6.4.1.20  "No output available"
  2165.  
  2166.         The  See  Results function will only show you the output  of  the 
  2167.         last  executed  external program if it was  captured.  Currently, 
  2168.         there is none.
  2169.  
  2170.         
  2171.         6.4.1.21  "Not enough memory."  &  "Out of memory."
  2172.  
  2173.         The requested function needs more memory.  Usually, this is about 
  2174.         4k.   If you see this error, you're really pushing the  envelope.  
  2175.         Try to remove any TSR programs or reduce the size of the environ-
  2176.         ment space.
  2177.  
  2178.         
  2179.         6.4.1.22  "Problem creating dummy file"
  2180.  
  2181.         To  test  the archive definition, DFL creates a  32k  dummy  file 
  2182.         named TEST????.aaa.  See section 6.1.  This error indicates  that 
  2183.         DFL was unable to create the temporary file.
  2184.  
  2185.         
  2186.         6.4.1.23  "Problem extracting current file."
  2187.  
  2188.         The  file comparison functions must extract any compressed  files 
  2189.         before  performing the compare.  Select function 'R' to  see  the 
  2190.         output of the last run external program.  If the archive  extrac-
  2191.         tor produced any error messages, they will appear here.  You  may 
  2192.         need  to free more memory prior to running DFL.  Also,  some  ar-
  2193.         chives  contain files that have been encrypted with  a  password.  
  2194.         The only way DFL can extract these files is if you add the appro-
  2195.         priate password option to the extractor program's parameter line.  
  2196.         See section 4.2.2.
  2197.                                                        Page 44
  2198.  
  2199.  
  2200.         6.4.1.24  "Problem extracting marked file."
  2201.  
  2202.         The  file comparison functions must extract any compressed  files 
  2203.         before  performing the compare.  Select function 'R' to  see  the 
  2204.         output of the last run external program.  If the archive  extrac-
  2205.         tor produced any error messages, they will appear here.  You  may 
  2206.         need  to free more memory prior to running DFL.  Also,  some  ar-
  2207.         chives  contain files that have been encrypted with  a  password.  
  2208.         The only way DFL can extract these files is if you add the appro-
  2209.         priate password option to the extractor program's parameter line.  
  2210.         See section 4.2.2.
  2211.  
  2212.         
  2213.         6.4.1.25  "Problem running <archive lister>"
  2214.  
  2215.         This error will occur during the disk scan if DFL cannot  execute 
  2216.         the  lister  program for an archive type that has  been  enabled.  
  2217.         You  may  need to free more memory prior to running  DFL.  Select 
  2218.         function 'R' to see the output of the last run external  program.  
  2219.         If  the  archive lister produced any error  messages,  they  will 
  2220.         appear here.
  2221.  
  2222.         
  2223.         6.4.1.26  "Problem running FC.EXE.  Check FC.EXE rules under 
  2224.                   setup."
  2225.  
  2226.         This error will occur if DFL cannot execute the ascii  comparison 
  2227.         program.  You may need to free more memory prior to running  DFL.  
  2228.         Select  function 'R' to see the output of the last  run  external 
  2229.         program.  If the program produced any error messages,  they  will 
  2230.         appear here.
  2231.  
  2232.         
  2233.         6.4.1.27  "Problem running that program"
  2234.  
  2235.         This  error will occur if DFL cannot execute one of  the  archive 
  2236.         programs  during the test run.  You may need to free more  memory 
  2237.         prior  to running DFL.  Select function 'R' to see the output  of 
  2238.         the last run external program.  If the program produced any error 
  2239.         messages, they may appear here.
  2240.  
  2241.         
  2242.         6.4.1.28  "Problem writing <filename>"
  2243.  
  2244.         The  duplicate  list output function encountered an  error  while 
  2245.         writing the given file.  If you're writing to a floppy, make sure 
  2246.         the  disk is formatted and properly inserted in the drive.  Also, 
  2247.         you  may have run out of disk space, especially if the  duplicate 
  2248.         list is long.
  2249.                                                        Page 45
  2250.  
  2251.  
  2252.         6.4.1.29  "That extension is invalid."
  2253.  
  2254.         If any of these characters are used in the extension field of the 
  2255.         archive  definition, it will be declared invalid- ".*?\/:".  This 
  2256.         doesn't include the quotes.
  2257.  
  2258.         
  2259.         6.4.1.30  "That is a DIRECTORY. Hit a key..."
  2260.  
  2261.         This  error will occur if you enter an invalid list output  file-
  2262.         name.
  2263.  
  2264.  
  2265.         6.4.1.31  "That is a HIDDEN or SYSTEM file. Hit a key..."
  2266.  
  2267.         This  error will occur if you enter an invalid list output  file-
  2268.         name.
  2269.  
  2270.         
  2271.         6.4.1.32  "That is a READ ONLY file. Hit a key..."
  2272.  
  2273.         This  error will occur if you enter an invalid list output  file-
  2274.         name.
  2275.  
  2276.         
  2277.         6.4.1.33  "That's not a file !"
  2278.  
  2279.         This  error  is caused by attempting to perform one of  the  file 
  2280.         operations  on the blank divider lines between the groups in  the 
  2281.         duplicate list window.
  2282.  
  2283.         
  2284.         6.4.1.34  "The viewer couldn't open that file"
  2285.  
  2286.         The viewing system was unable to access the file under the cursor 
  2287.         bar.  If the file is archived, then DFL attempted to extract  it.  
  2288.         Select  function 'R' to see the output of the last  run  external 
  2289.         program.  If the archive extractor produced any  error  messages, 
  2290.         they will appear here.  You may need to free more memory prior to 
  2291.         running  DFL.  Also, some archives contain files that  have  been 
  2292.         encrypted  with a password.  The only way DFL can  extract  these 
  2293.         files  is if you add the appropriate password option to  the  ex-
  2294.         tractor program's parameter line.  See section 4.2.2.
  2295.  
  2296.         If the file is not archived, then you are faced with a  situation 
  2297.         where  DFL has in memory the name of a file the was  scanned  mo-
  2298.         ments earlier but  doesn't exist now.  This can happen if you are 
  2299.         running  in  a multitasking environment and  other  programs  are 
  2300.         'diddling'  things in the background.  Perhaps one of  the  back-
  2301.         ground  programs deleted the requested file.  DFL has no  way  of 
  2302.         knowing  what is happening while TSRs or background programs  are 
  2303.         active.
  2304.                                                        Page 46
  2305.  
  2306.  
  2307.         6.4.1.35  "The viewer needs about 16k more memory"
  2308.  
  2309.         The  viewing system needs about 16k of memory.  If you  see  this 
  2310.         error, you're pushing the envelope.  Try freeing some TSRs before 
  2311.         running DFL.
  2312.  
  2313.         
  2314.         6.4.1.36  "Too many lines/entry. May not work."
  2315.  
  2316.         The format of the archive lister output should not take more than 
  2317.         about 15 lines per file entry.
  2318.  
  2319.         6.4.1.37  "Unable to open the file. Hit a key..."
  2320.  
  2321.         The duplicate list output function was not able to open the given 
  2322.         file.  If you're writing to a floppy, make sure the disk is  for-
  2323.         matted and properly inserted in the drive.
  2324.  
  2325.         
  2326.         6.4.1.38  "Use caution in selecting an output path"
  2327.  
  2328.         In preparing to write the duplicate list, DFL changes back to the 
  2329.         original disk from where it was invoked. If it has trouble  doing 
  2330.         that,  this warning will be displayed before you are prompted  to 
  2331.         enter  the output filename. It means that the disk  configuration 
  2332.         has probably changed since DFL was started and subsequent caution 
  2333.         is  advised.  This may happen if you run DFL from  a  floppy  and 
  2334.         remove the floppy.
  2335.  
  2336.         
  2337.         6.4.1.39  "Why compare a file to itself ?"
  2338.  
  2339.         This is self-explanatory.
  2340.  
  2341.         
  2342.         6.4.1.40  "Why view a file of 0 length ?"
  2343.  
  2344.         This is self-explanatory.
  2345.  
  2346.         
  2347.         6.4.1.41  "You must edit the definition before enabling it."
  2348.  
  2349.         You can't enable an undefined or uninitialized archive type.
  2350.  
  2351.         6.4.1.42   "Bad file: <arcfile>"
  2352.         6.4.1.43   "Read error: <arcfile>"
  2353.         6.4.1.44   "Seek error: <arcfile>"
  2354.         6.4.1.45   "Can't open: <arcfile>"
  2355.         6.4.1.46   "Bad name field: <arcfile>"
  2356.  
  2357.         These  errors can occur when DFL is directly reading an  archive. 
  2358.         The corresponding archive is probably damaged.
  2359.                                                        Page 47
  2360.  
  2361.  
  2362.         6.4.2     Exit Errors
  2363.  
  2364.         The  error messages below are reported when the execution of  DFL 
  2365.         must be aborted due to some fatal error condition.
  2366.  
  2367.         6.4.2.1   "Virtual memory file CRITICAL READ error..."
  2368.  
  2369.         An interpretation window will accompany this message.  This error 
  2370.         may occur if you run out of disk space or an actual error  occurs 
  2371.         on the working disk.
  2372.  
  2373.         6.4.2.2   "Virtual memory file CRITICAL SEEK error..."
  2374.  
  2375.         An interpretation window will accompany this message.  This error 
  2376.         may occur if you run out of disk space or an actual error  occurs 
  2377.         on the working disk.
  2378.  
  2379.  
  2380.         6.4.2.3   "Virtual memory file CRITICAL WRITE error..."
  2381.  
  2382.         An interpretation window will accompany this message.  This error 
  2383.         may occur if you run out of disk space or an actual error  occurs 
  2384.         on the working disk.
  2385.  
  2386.         
  2387.         6.4.2.4   "Virtual memory file READ error..."
  2388.  
  2389.         An interpretation window will accompany this message.  This error 
  2390.         may occur if you run out of disk space or an actual error  occurs 
  2391.         on the working disk.
  2392.  
  2393.         
  2394.         6.4.2.5   "Virtual memory file SEEK error..."
  2395.  
  2396.         An interpretation window will accompany this message.  This error 
  2397.         may occur if you run out of disk space or an actual error  occurs 
  2398.         on the working disk.
  2399.  
  2400.         
  2401.         6.4.2.6   "Virtual memory file WRITE error..."
  2402.  
  2403.         An interpretation window will accompany this message.  This error 
  2404.         may occur if you run out of disk space or an actual error  occurs 
  2405.         on the working disk.
  2406.  
  2407.         
  2408.         6.4.2.7   "Disk specified by '/w=' unavailable."
  2409.  
  2410.         The requested working disk is not accessible by DFL.
  2411.                                                        Page 48
  2412.  
  2413.  
  2414.         6.4.2.8   "Bad filename mask in '/f=' option."
  2415.  
  2416.         The filename mask follows standard Dos filespec syntax  including 
  2417.         wildcards.  Use 'A*.*' to scan all files beginning with 'A'.  Use 
  2418.         '*.EXE' to scan all EXE files.
  2419.  
  2420.         6.4.2.9   "Syntax error in '/d=' option."
  2421.  
  2422.         To  specify  drives  'C:' and 'D:' as the  scan  disks  use  'DFL 
  2423.         /d=cd'.   This is not case-sensitive.  The command  line  options 
  2424.         are  all  separated  by spaces. Type 'DFL /?' to  obtain  a  help 
  2425.         listing with an example of each option.
  2426.  
  2427.         6.4.2.10  "Syntax error in '/f=' option."
  2428.  
  2429.         To use '*.bak' as the filename mask type 'DFL /f=*.bak'.  This is 
  2430.         not case- sensitive.  The command line options are all  separated 
  2431.         by spaces.  Type 'DFL /?' to obtain a help listing with an  exam-
  2432.         ple of each option.
  2433.  
  2434.  
  2435.         6.4.2.11  "Syntax error in '/l(a/w)=' option."
  2436.  
  2437.         To   specify   c:\dfl.lst   as  the   output   file,   use   'DFL 
  2438.         /lw=c:\dfl.lst'.   To  append  the  duplicate  list   output   to 
  2439.         c:\dfl.lst,  use 'DFL /la=c:\dfl.lst'. These are not  case-sensi-
  2440.         tive.   The  command line options are all  separated  by  spaces.  
  2441.         Type  'DFL /?' to obtain a help listing with an example  of  each 
  2442.         option.
  2443.         
  2444.         6.4.2.12  "Syntax error in '/m=' option."
  2445.  
  2446.         To  use  the ALIAS mode type 'DFL /m=alias'.  This is  not  case-
  2447.         sensitive.  The command line options are all separated by spaces.  
  2448.         Type  'DFL /?' to obtain a help listing with an example  of  each 
  2449.         option.
  2450.  
  2451.         
  2452.         6.4.2.13  "Syntax error in '/w=' option."
  2453.  
  2454.         To  specify drive 'D:' as the working disk use 'DFL /w=d'.   This 
  2455.         is  not case- sensitive.  The command line options are all  sepa-
  2456.         rated by spaces.  Type 'DFL /?' to obtain a help listing with  an 
  2457.         example of each option.
  2458.  
  2459.         
  2460.         6.4.2.14  "Bad output filename."
  2461.  
  2462.         The  error  results  if the file specified by  the  command  line 
  2463.         option '/l(a/w)=' is not accessible by DFL.  If the file is on  a 
  2464.         floppy, make sure the disk is formatted and properly inserted  in 
  2465.         the drive.
  2466.