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