home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 096 / testdir3.arc / TESTDIR.DOC next >
Encoding:
Text File  |  1985-01-16  |  4.0 KB  |  108 lines
  1.     TESTDIR.EXE  written by     Terry Duke
  2.                                Data 806-763-3375
  3.                                Voice 806-765-7009
  4.  
  5.     This one is for the Sysops of the RBBS bulletin boards.
  6.  
  7.  
  8.  
  9.     Basically what TESTDIR does is check the directories against the files 
  10. actually on the disk. The output of the program will give:
  11.    
  12. 1. All the files that are on disk and not in directories.
  13. 2. All the files that are in directories and not on disk.
  14. 3. All the files that are duplicated in more than one directory.
  15.  
  16.  
  17.     To use this program a few preliminary steps must be taken.
  18.  
  19.  First there are some restrictions on the format of the directorys.
  20.  The files names must be the first words on the lines with no leading
  21.  spaces.
  22.  The file names may be in the formats of:
  23.  
  24. FILENAME EXT
  25. NAME     EXT
  26. NAME.EXT
  27.  
  28. IF THE EXTENTION DOES NOT START ON COLUMN 10 THEN A PERIOD MUST
  29. BE IN THE FILESPEC WITH NO SPACES
  30.  
  31.  
  32.  Any lines that do not contain a file name also have some restrictions.
  33.    Lines that start with a space astrick or any extended ascii
  34.    character will be ignored.
  35.    Any blank line is ignored and the first line of the directory is
  36.    ignored. 
  37.    The directory files must end with the normal Crtl Z character
  38.    some word processors, notibly Word Star do not terminate the
  39.    file with Crtl Z.
  40.  
  41.  Previous versions of this program call dirtest or testdir would
  42. not work if there were commas in the directories. This version 
  43. does not have that limitation. 
  44.  
  45.  
  46.    Testdir will ask you for the drives to search.
  47.    Include all drives with bbs files on them.
  48.    Enter the drive letters with no delimiters i.e.  CDE
  49.  
  50.    Then you will be asked for the output device.
  51.    Output can be sent to the screen printer of a file.
  52.    If the file is chosen it will be called BBS.ERR and will be
  53.    put on the default drive. I included the file option so
  54.    the program could be run remotely and the output file downloaded.
  55.    If the printer is chosen LPT1 is assumed.
  56.    
  57.    You will then be asked for the drive containing the download 
  58.    directories.
  59.  
  60.    The directories must have the name DIRxx where xx is the directory number.
  61.    xx must be a number from 1 to 98. If letters are used for xx errors 
  62.    will result.
  63.  
  64.    You will then be asked for the drive containing the upload directory.
  65.    If you do not want the upload directory to be included hit
  66.    enter without any drive letter.
  67.  
  68.    The upload directory is assumed to be DIR99.
  69.  
  70.    You will then be asked for the drive containing BBSYSTEM.
  71.    If you do not have a BBSYSTEM file hit enter without any drive 
  72.    letter.
  73.    
  74.    BBSYSTEM can be used to keep any files that you know to be on
  75.    disk and not in any directory. If you put these file in 
  76.    bbsystem they will not come out in the output listing.
  77.    Bbsystem format is similar to a directory. There must be some
  78.    character on the line after the filename. I use a period in
  79.    the following format. Remember the first line of the file is ignored.
  80.  
  81. FILENAME.EXT.      
  82. FILENAME    .
  83. DIR         .
  84.  
  85.  
  86. If you got this program from Testdir3.lbr then there are two versions
  87. of testdir in the library. Testdir.exe has a file limitation of 1500
  88. total files but run reletively fast considering all it has to do.
  89. Testdir2.exe has a limit of 5000 files but is much slower, especially
  90. the sort. Testdir2 creates a temporary file on the default drive and
  91. then deletes it when it is done. The temporary file is called BBS.TMP.
  92. BBS.TMP will show up on the output listing if it is not in the BBSYSTEM
  93. file. 
  94.    The two versions are provided for the greatest utility for everyone.
  95. Those with under 1500 files can take advantage of the speed of TESTDIR
  96. and those with over 1500 files can use TESTDIR2. The two versions 
  97. are necessary beacause of the small amount of string space provided
  98. by compiled basic.
  99.  
  100.  
  101.  
  102.                   Good luck, 
  103.                             Terry
  104.  
  105.  
  106.  
  107.  
  108.