home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 11a / catlog1.zip / CATLOG1.DOC next >
Text File  |  1990-09-19  |  5KB  |  85 lines
  1.                               CATLOG1.EXE
  2.                       Floppy Disk Catalog Utility
  3.  
  4.  
  5.     The purpose of this program is to generate and  maintain  a  catalog  of
  6.     floppy disks so that you can quickly and easily locate any file.
  7.  
  8.     CATLOG1 is geared mainly toward bulletin board system operators.
  9.  
  10.     When you first start the program, it will ask you to enter the letter of
  11.     the floppy drive that you wish to catalog.
  12.  
  13.     It will then ask you to enter the path and filename  of  the  file  that
  14.     contains  the names and descriptions of all your files - in other words,
  15.     your allfiles list.  The file descriptions should start in column 30  or
  16.     beyond.
  17.  
  18.     You  will  then  be  prompted to enter the path and filename of the file
  19.     that you want your catalog saved to.   I  suggest  using  a  name  which
  20.     refers  to  the  type of files on the floppies.  For example, if you are
  21.     cataloging the "Utilities" area of  your  bbs,  enter  "UTILS"  for  the
  22.     filename.
  23.  
  24.     You  next  enter  a suitable category name.  Using the previous example,
  25.     "Utilities" would be a suitable category name.  This is used  as  header
  26.     information in the output file.
  27.  
  28.     Finally,  enter  a starting number.  This will be the number of the disk
  29.     within the category that  you  previously  entered.   Again,  using  the
  30.     previous example, if you enter "1" here, the header for the first floppy
  31.     in the output file will be "Utilities 1".  This  number  is  incremented
  32.     after each floppy.
  33.  
  34.     At  this  point, the program will check the files on the floppy and find
  35.     the matching filenames and descriptions on the allfiles list.   It  will
  36.     save  this information in the output file.  If any file on the floppy is
  37.     NOT found in the allfiles list, the file name, size, and  date  will  be
  38.     saved  to  the  output file and the description will say "NO DESCRIPTION
  39.     FOUND".  After the first floppy is complete, you will be told  to  enter
  40.     the  next floppy and press "Y" to continue, or to press any other key to
  41.     stop.
  42.  
  43.     After you have finished cataloging all the files in this category, press
  44.     any  key  (other than "Y") to finish.  At this point, several statistics
  45.     will be displayed.  These include:  total files processed, average  file
  46.     size, number of files with no descriptions found, and more.
  47.  
  48.     There are two DOS environment variables that you have the option to set.
  49.     The first one is CATLOG and should be set to equal the path and filename
  50.     of  your  allfiles list.  For example, if you keep your allfiles list in
  51.     the directory D:\QBBS\RECENT (and it is named ALLFILES.LST),  you  would
  52.     do   this:    SET   CATLOG=D:\QBBS\RECENT\ALLFILES.LST.    This  is  NOT
  53.     necessary, but it does save some  typing  if  you  use  the  program  to
  54.     catalog  several  file categories in one session.  If this environmental
  55.     variable is not set, the program will ask you for this information.   If
  56.     the variable IS set, the program will skip the question.
  57.  
  58.     The  other  environment  variable  is  COLM.   This  one  is used if the
  59.     descriptions in your allfiles list DO NOT start in column 30.  You would
  60.     set  this  to equal the column number of the first character of the file
  61.     descriptions.  For example, if your descriptions start in column 14  (as
  62.     in  a QuickBBS FILES.BBS file), you would do this:  SET COLM=14.  Again,
  63.     this is necessary ONLY if your file descriptions do NOT start in  column
  64.     30.
  65.  
  66.     Here  is  a sample run:  I want to catalog the backup floppies I have of
  67.     the utility directory of my bulletin board.  I  start  the  program  and
  68.     enter  the  information  it asks me.  I tell it "D:\UTILS" for an output
  69.     filename, "Utilities" for a  category  name,  and  "1"  for  a  starting
  70.     number.   Now  I  just  feed floppies and keep pressing "Y" until I have
  71.     gone through all the backup floppies (in this case, we'll say it was  15
  72.     disks).   At  this  point,  I  press  any key other than "Y" to exit the
  73.     program.  The next time I have backups in this category to categorize, I
  74.     will  give the program all the same information, except I'll use "16" as
  75.     a starting number.  The new information will be appended to the old  and
  76.     I'll have an ongoing list of which files are on which floppies.
  77.  
  78.     If  you  find this program useful in any way, all I ask is that you call
  79.     my bbs or netmail me and let me know.  Any and all comments are welcome.
  80.  
  81.                              Ron  Bergeron
  82.                               The Machine
  83.                              (508)948-2921
  84.                            FidoNet 1:324/124
  85.