home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 15a / filcat.zip / FILECAT.DOC < prev    next >
Text File  |  1986-03-05  |  46KB  |  923 lines

  1.                                                                       
  2.  
  3.  
  4.  
  5.  
  6.          
  7.  
  8.  
  9.  
  10.                                   USERS MANUAL
  11.  
  12.  
  13.                                  
  14.                        ---------------------------------
  15.  
  16.                                   FILECAT.COM
  17.  
  18.                        ---------------------------------
  19.  
  20.                            A File Cataloging Utility
  21.                               written by Kenn Flee
  22.                                        of
  23.                                Jamestown Software
  24.  
  25.                                     for the
  26.                          Madison WI IBM-PC USERS GROUP
  27.                                (Turbo Pascal SIG)
  28.  
  29.                                   Version 2.1
  30.                                  March 2, 1986
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.          The Madison IBM-PC User's Group, Turbo Pascal SIG, Jamestown 
  43.          Software and/or Kenn Flee will not be liable for any damages, 
  44.          including any lost profits, lost savings or other incidental 
  45.          or consequential damages arising out of the use of or inabil-
  46.          ity to use FILECAT.COM, even if the GROUP or Jamestown Soft-
  47.          ware has been advised of the possibility of such damages, or 
  48.          for any claim by any other party.
  49.  
  50.          FILECAT.COM is hereby released into the PUBLIC DOMAIN.
  51.  
  52.          
  53.                                      Page 1
  54.  
  55.  
  56.          INTRODUCTION:
  57.  
  58.          This program was written in response to a request by our 
  59.          Turbo Pascal SIG Librarian.  We had a problem with our 
  60.          library disks that many other users have experienced... too 
  61.          many files on too many disks.  What is on each disk?  How can 
  62.          we find a particular file?  How are the various files 
  63.          related?  As we expect our library to grow rapidly, we 
  64.          decided to try to solve the problem before it really got out 
  65.          of hand.
  66.  
  67.          Of course, the problem of too many files scattered all over 
  68.          the place is a familiar one to hard disk users and active 
  69.          programmer types.  I certainly have little files on a bunch 
  70.          of floppies and in various subdirectories all over my hard 
  71.          disk.  Now, I'm not by nature a particularly disorganized 
  72.          person, but I AM active on the local BBS's (downloading 
  73.          everything that looks interesting) and have lots of little 
  74.          Pascal files that I'm sure I wrote for SOME reason.  Anyway, 
  75.          there appears to be a need for an easy-to-use file cataloging 
  76.          utility for use by User Group Librarians, BBS Sysops, AND 
  77.          everyday users.  FILECAT is in response to that need.
  78.  
  79.  
  80.          FEATURES:
  81.  
  82.          * Written in Turbo Pascal (source code available).
  83.          * ISAM database with B+Tree structure.
  84.          * For floppy or harddisk systems.
  85.          * Menu-driven for ease of use.
  86.          * Allows entry of KEYWORDS with keyword search and sort.
  87.          * Library of 700+ common keywords may be accessed.
  88.          * Allows entry of Main File designation and Associated
  89.            File identification.  Searches, sorts and prints listings 
  90.            of "families" of files.
  91.          * Allows creation of a "transfer file" to be included on
  92.            user group library disks.  Senses existence of such a file 
  93.            and allows automatic transfer of the data into the master 
  94.            database file. 
  95.          * Allows file descriptions of over 300 characters.
  96.          * Automatically includes harddisk path and floppy volume name
  97.            location identifiers.
  98.          * Epson printer setup utility.
  99.          * Add, search, sort, edit and delete functions with duplicate
  100.            filenames identified, but allowed.
  101.          * Database file size limited only by floppy disk/hard disk 
  102.            size, or 32,760 records, whichever comes first.
  103.          * Released into the public domain for everyone's use and 
  104.            (hopefully) a standard to be included on all user group 
  105.            library disks.  
  106.  
  107.          
  108.                                      Page 2
  109.  
  110.  
  111.          FILES INCLUDED:
  112.  
  113.          Just four: FILECAT.COM    The program file.
  114.                     FILECAT.000    An overlay file.
  115.                     FILECAT.KWD    A library of Keywords.
  116.                     FILECAT.DOC    This users manual.
  117.          
  118.          The program will create additional files as needed:
  119.  
  120.                     FILECAT.DAT    The database main data file.
  121.                     FILECAT.IXN    The database main index file.
  122.                     TRANSFER.DAT   Either a temporary data file
  123.                                    (when on the disk where FILECAT.COM 
  124.                                    resides) or a transfer file (when
  125.                                    on the source disk).
  126.                     TRANSFER.DXT   A transfer file that has been read
  127.                                    into the main database and renamed
  128.                                    by FILECAT from TRANSFER.DAT.
  129.                     TRANSFER.IXN   A temporary index file.
  130.  
  131.  
  132.  
  133.          INSTALLATION:
  134.  
  135.          Floppy Disk Users:  Put original disk in drive A.
  136.                              Put blank, formatted disk in drive B.
  137.                              Copy FILECAT.COM (Copy A:FILECAT.COM B:).
  138.                              Copy FILECAT.000 (Copy A:FILECAT.000 B:).
  139.                              Copy FILECAT.KWD (Copy A:FILECAT.KWD B:).
  140.  
  141.            Hard Disk Users:  Make a subdirectory (MD \FILECAT).
  142.                              Change subdirectories (CD \FILECAT).
  143.                              Place original disk in drive A.
  144.                              Copy FILECAT files into subdirectory.
  145.                                   (Copy A:\FILECAT.*).
  146.  
  147.          FILECAT will sense the existence of both CGA color cards
  148.          and monochrome cards and adjust itself accordingly.  On color 
  149.          cards driving some composite video monochrome monitors, you 
  150.          may wish to press '8' in the Main Menu to toggle between 
  151.          color mode and black and white mode.
  152.  
  153.  
  154.  
  155.          RUNNING FILECAT:
  156.  
  157.          Floppy Disk Users:  Be sure you see the "A>" prompt!  If you 
  158.                              don't, type A: and return.  Place your 
  159.                              FILECAT working disk in drive A.  Place 
  160.                              your source disk (the one you are going 
  161.                              to get file information from) in drive B.  
  162.                              Type "FILECAT" and return.
  163.  
  164.          
  165.                                      Page 3
  166.  
  167.  
  168.          RUNNING FILECAT (continued):
  169.  
  170.          Hard Disk Users:  IMPORTANT: ALWAYS run FILECAT from the 
  171.                            subdirectory in which it resides!  (If you 
  172.                            don't, the program will get mad at you and 
  173.                            keep asking you to put the disk back in.)
  174.                            Sooo... Change into the FILECAT subdirectory
  175.                            (CD \FILECAT).  Place either a formatted 
  176.                            disk or your source disk in drive A: (If 
  177.                            you don't, FILECAT will complain a little 
  178.                            bit, but no real damage will be done... it 
  179.                            will just be a bit annoying.)  Type 
  180.                            "FILECAT" and return.
  181.  
  182.          The first time you run FILECAT, it will create the 
  183.          FILECAT.DAT data file and FILECAT.IXN index file.  A brief 
  184.          message will appear at the bottom of the screen.
  185.  
  186.  
  187.  
  188.          THE "TRANSFER FILE FOUND..." MESSAGE:
  189.  
  190.          If your source disk (maybe a User Group Library disk) has had 
  191.          a Transfer File stored on it, FILECAT will display the 
  192.          following message:
  193.  
  194.          "TRANSFER file found on Source Directory... Add to database?"
  195.  
  196.          Press "Y" to add the information contained in the transfer 
  197.          file to your database, or "N" if not.  I suggest you answer 
  198.          "Y", 'cause the program is just going to keep asking you at 
  199.          regular intervals if you want to do it, so you may as well 
  200.          get it over with.  When you answer "Y", FILECAT will read the 
  201.          information from the source file, change the "TRANSFER.DAT" 
  202.          name to "TRANSFER.DXT", and stop bothering you.  
  203.  
  204.  
  205.  
  206.          THE "PLACE THE FILECAT.COM DISK IN..." MESSAGE:
  207.  
  208.          If you get this message, you either ran FILECAT with a DOS 
  209.          Prompt different from the disk or subdirectory that FILECAT 
  210.          resides in, or (floppy disk users) you removed the FILECAT 
  211.          disk or opened the disk drive door.  Reread the "RUNNING 
  212.          FILECAT" instructions above.  
  213.  
  214.          
  215.                                      Page 4
  216.  
  217.  
  218.          THE MAIN MENU:
  219.  
  220.          After you get past the previous two messages, you will see 
  221.          the Main Menu.  At the top of the screen are the FILECAT 
  222.          drive/directory, the source drive/directory, the diskette 
  223.          volume name (if source disk is on drive A: or B:) and the DOS 
  224.          version you are running.  (If you aren't using DOS2.x or 
  225.          greater you never got this far... the program kicked you 
  226.          out!)  At the bottom left is the number of bytes left on your 
  227.          FILECAT drive/directory.  If there are less than 2000 bytes 
  228.          left, you will get a flashing warning.
  229.  
  230.          There are 8 choices listed in the main menu as follows:
  231.            
  232.                1 -- CHANGE Source Drive/Directory
  233.                2 -- ENTER New File Data
  234.                3 -- SEARCH Database for KEYWORD MATCH
  235.                4 -- BROWSE/EDIT DataBase Records
  236.                5 -- REPORTS and UTILITIES
  237.  
  238.                7 -- Set Epson Print Codes
  239.                8 -- Change Color
  240.                9 -- End
  241.  
  242.          To select, press the number of the choice desired.  Each 
  243.          choice is described below.
  244.  
  245.  
  246.  
  247.          CHANGE SOURCE DRIVE/DIRECTORY (Main Menu Choice 1):
  248.  
  249.          Identify your source drive (floppies) or directory path (hard 
  250.          disk).  FILECAT will attempt to change to the identified 
  251.          source drive/directory.  If there is a problem FILECAT will 
  252.          revert to the previous identified source drive/directory.  
  253.  
  254.          HINT: If you're not entering new data, either put a formatted 
  255.                disk in the source drive or change the source drive to 
  256.                be the same as the FILECAT drive.  
  257.  
  258.  
  259.  
  260.          ENTER NEW FILE DATA (Main Menu Choice 2):
  261.  
  262.          Before selecting Choice 2, be sure you have the proper source 
  263.          drive/directory identified (Choice 1), and your desired disk 
  264.          in that drive.  If your source drive is A: or B: FILECAT will 
  265.          attempt to read the volume name of the diskette.  If there is 
  266.          no volume name, you will be required to enter a temporary 
  267.          volume name identifier.  
  268.  
  269.          
  270.                                      Page 5
  271.  
  272.  
  273.          ENTER NEW FILE DATA (continued):
  274.  
  275.          The data entry screen will be displayed.  In a window at the 
  276.          right is a list of files on your source disk.  You now have 
  277.          two options.  You may press the F1 function key to enter ALL 
  278.          files into the database or, using the cursor keys, you may 
  279.          select the individual file you wish to add to the database 
  280.          (press return).  If the file has already been entered, the 
  281.          old file data will be displayed and you have the option to 
  282.          delete the old entry or add the selected file.  If the 
  283.          selected file is a new file, the window will disappear and 
  284.          the file information displayed at the top of the screen.  
  285.  
  286.          If you elected to add ALL files, you will be returned to the 
  287.          main menu (You may add keywords and descriptions by pressing 
  288.          "4" and editing the desired entries).  If you selected an 
  289.          individual file you may now add the following information: 
  290.  
  291.          Stand Alone?  This question is one that our Turbo SIG group 
  292.                        found useful and if you understand its intent, 
  293.                        perhaps you can use it your situation.  (If you 
  294.                        don't understand this question, or have no need 
  295.                        for it, just press "Y").  The problem with 
  296.                        Turbo Pascal programs (and others, actually) is 
  297.                        that large applications tend to have a bunch of 
  298.                        "include", "overlay", and "chain" files 
  299.                        associated with them.  In other words, you need 
  300.                        more than just the one source file to make the 
  301.                        program go.  So that we don't break up these 
  302.                        "families" of associated files, this question 
  303.                        allows you to define a group of associated 
  304.                        files that help keep everything connected 
  305.                        together.  Anyway, if this file does not 
  306.                        require other files to work, answer this 
  307.                        question "Y", but if other files ARE required, 
  308.                        answer "N" (No, this file does NOT stand alone, 
  309.                        but requires other files to work).  
  310.          
  311.          ------------------------------------------------------------
  312.  
  313.          If you answered "N" to the question above, you will be asked: 
  314.  
  315.          Main File Name:  Enter the file name (not extension) of the 
  316.                           Main or Primary File associated with this 
  317.                           file.  If this file IS the primary file, 
  318.                           REPEAT the filename of this file.
  319.  
  320.               Extension:  The extension of the file entered in main 
  321.                           file name above.
  322.  
  323.          ------------------------------------------------------------
  324.          
  325.                                      Page 6
  326.  
  327.          ENTER NEW FILE DATA (continued):
  328.  
  329.          Keywords:  Enter some keywords for this file.  Try to 
  330.                     establish some consistency with your keywords...
  331.                     for instance GRAPHICS for all graphic files or 
  332.                     UTILITY for all utility files (See NOTE below).  
  333.                     Maybe an author name for some favorite downloaded 
  334.                     programs.  You may enter one line of keywords, 
  335.                     separating each keyword with a space.  Later you 
  336.                     can search for a keyword and quickly retrieve 
  337.                     files of similiar types.  Compuserve users are 
  338.                     familiar with this type of keyword search, and 
  339.                     once you see the power in the use of keywords, 
  340.                     you'll wonder how you ever got along without them.  
  341.                     Since you have a full line to work with, you may 
  342.                     as well fill it up.  
  343.  
  344.                     NOTE: By pressing the F1 function key, a library 
  345.                     of over 700 common keywords will be displayed.  
  346.                     Use the cursor keys until your choice is 
  347.                     highlighted, then press Enter.  Your selection 
  348.                     will be added to those already on the Keyword 
  349.                     line.  Any NEW keywords you enter will 
  350.                     automatically be added to the library.  
  351.  
  352.                     HINT: If you wish to save disk space so more file 
  353.                     information may be stored, do NOT copy the 
  354.                     FILECAT.KWD file from your distribution disk.  
  355.                     FILECAT will then create a Keyword library of ONLY 
  356.                     those keywords YOU enter.
  357.  
  358.          Description:  Enter up to four lines of descriptive 
  359.                        information about this file.  The space is 
  360.                        allocated, so you use it all if you can.  
  361.  
  362.          Experiment a little with the cursor keys.  HOME and END will 
  363.          move you to the beginning or end of the line.  RIGHT and LEFT 
  364.          move right and left.  UP and DOWN go to the previous or next 
  365.          field.  Insert mode (not overwrite) is always active, so 
  366.          delete, then insert.  BACKSPACE deletes the character to the 
  367.          left of the cursor, DELETE deletes the character under the 
  368.          cursor.  The INSERT key inserts a space, moving the rest of 
  369.          the line to the right.  If FCD (First Char. Delete) is active 
  370.          and you type a character in the first position when there is 
  371.          already text in the field, the field will be blanked. (The 
  372.          use of the CURSOR RIGHT key toggles this feature OFF for one 
  373.          field when FCD is active.  <F8> toggles FCD on/off.  "FCD" is 
  374.          displayed in lower right of screen when FCD is active.) 
  375.          
  376.          When you are done, press the F10 function key.  You will 
  377.          first be asked if you wish to add this record to the database 
  378.          ("Y" to add it, "N" to throw it away), then you will be asked 
  379.          if you wish another entry from this disk/directory ("Y" to do 
  380.          another, "N" to return to the Main Menu.  
  381.            
  382.                                      Page 7
  383.  
  384.  
  385.          SEARCH DATABASE FOR KEYWORD MATCH (Choice 3 in Main Menu):
  386.          
  387.          You will be asked to enter the KEYWORD you wish to search 
  388.          for.  Then you will be given the choice of searching for 
  389.          EXACT matches (full words ONLY that match your search 
  390.          keyword), or PARTIAL matches (words that have your search 
  391.          keyword in them).
  392.          
  393.          As an example, if your search keyword was "DIR", Partial 
  394.          matches would find "DIR", "DIRECTORY", "SUBDIRECTORY" and 
  395.          "ROOTDIRECTORY" but Exact match wouldn't find anything but 
  396.          "DIR".  
  397.  
  398.          If a match is found, it will be displayed and you may press: 
  399.  
  400.                N or C -- Continue the search
  401.                     D -- Delete the record
  402.                     E -- Edit the record
  403.                     * -- Print the record
  404.                     Q -- Quit and return to Main Menu
  405.  
  406.          If you continue to search to the end of the file, you will 
  407.          get the number of matches found.
  408.          
  409.  
  410.  
  411.          BROWSE/EDIT DATABASE RECORDS (Choice 4 in Main Menu):
  412.  
  413.          You will be asked to identify the file name to search for.  
  414.          If you want to start at the beginning of the file, just press 
  415.          return.  (The files will always be displayed -- in all 
  416.          functions -- in alphabetical order by filename).  When any 
  417.          file is displayed, you may press:
  418.  
  419.                     N -- Display next record
  420.                     P -- Display previous record
  421.                     S -- Enter new search filename
  422.                     D -- Delete the record
  423.                     E -- Edit the record
  424.                     * -- Print the record
  425.                     Q -- Quit and return to Main Menu
  426.     
  427.          NOTE:  In the case of APPARENT duplicate entries, check the 
  428.                 record number displayed in the right corner of the 
  429.                 screen BEFORE deleting the record.  They may look the 
  430.                 same, but they are actually different.
  431.  
  432.          When a Main File is displayed (File Name and Main File Name 
  433.          are identical) you may press "A" to locate and display all 
  434.          Associated Files (those with the same Main File Name) in 
  435.          alphabetical order.  To return to normal browsing after 
  436.          viewing associated files, press "S" and enter a new file name 
  437.          to search for.           
  438.          
  439.          
  440.                                      Page 8
  441.  
  442.  
  443.          
  444.          REPORTS AND UTILITIES (Choice 5 in Main Menu):
  445.  
  446.          Use to print predefined reports, or to create/close a 
  447.          transfer file.  (See page 8 following for complete 
  448.          description).  
  449.          
  450.          
  451.  
  452.          SET EPSON PRINT CODES (Choice 7 in Main Menu):
  453.  
  454.          Use to set print size and left margin on Epson FX/MX/RX and 
  455.          code-compatible printers.
  456.          
  457.  
  458.  
  459.          CHANGE COLOR (Choice 8 in Main Menu):
  460.  
  461.          Each time you press "8" in the Main Menu (if you have a color 
  462.          display adapter) the screen color will toggle between color 
  463.          and black/white mode.  This feature was added to try to 
  464.          resolve some display difficulties with monochrome monitors 
  465.          hooked to color cards.  If you have display problems, try 
  466.          this to see if it helps.
  467.  
  468.  
  469.  
  470.          END (Choice 9 in Main Menu):
  471.  
  472.          To end FILECAT and return to DOS.  If you are working on a 
  473.          Transfer File, and have not yet moved it to the source 
  474.          directory, you will be given ONE LAST CHANCE to save the file 
  475.          before FILECAT throws it away forever.
  476.  
  477.  
  478.          ------------------------------------------------------------
  479.  
  480.          REPORTS AND UTILITIES MENU:
  481.  
  482.          You may select any of 5 different printed reports from the 
  483.          Reports and Utilities Menu as described below.  You should 
  484.          set your printer type style and left margin before selecting 
  485.          your first printed listing.  DON'T set an automatic page 
  486.          length, because FILECAT automatically spaces over the perf 
  487.          (assuming a 11" page length).  
  488.  
  489.          
  490.          LISTING OF KEYWORDS AND RELATED FILES
  491.          (Choice 1 in Reports Menu)):
  492.  
  493.          This choice will scan your database for all keywords, then 
  494.          print the keywords in alphabetical order, with all files 
  495.          related to each keyword listed underneath.  
  496.  
  497.          
  498.          
  499.  
  500.          
  501.                                      Page 9
  502.  
  503.  
  504.          REPORTS AND UTILITIES MENU (continued):
  505.  
  506.  
  507.          ALPHABETICAL LIST OF ALL FILES 
  508.          (Choice 2 in Reports Menu):
  509.  
  510.          This choice will print all the information entered for each 
  511.          record in your database, in alphabetical order by file name.
  512.          
  513.          
  514.          LISTING OF DISKS AND RELATED FILES 
  515.          (Choice 3 in Reports Menu):
  516.  
  517.          This will sort the database into Disk/Directory alphabetical 
  518.          order, then print a listing of all Disks and/or 
  519.          Directory/SubDirectories, with all files in each 
  520.          Disk/Directory listed under the Disk/Directory name.  
  521.  
  522.  
  523.          LISTING OF MAIN/ASSOCIATED FILES
  524.          (Choice 4 in Reports Menu):
  525.          
  526.          This will scan the database for all entries identified as NOT 
  527.          stand alone, then read the Main File Name for those files.  
  528.          The located entries will be sorted into alphabetical order 
  529.          and printed with all related files listed under each main 
  530.          file name.
  531.  
  532.  
  533.          FILES LISTED ALPHABETICALLY BY EXTENSION
  534.          (Choice 5 in Reports Menu):
  535.  
  536.          This choice will print all file names, sorted and grouped by 
  537.          extension.
  538.  
  539.  
  540.  
  541.          TRANSFER FILES:
  542.  
  543.          A Transfer File may be created and stored on a diskette to be 
  544.          read into another FILECAT database at a later time by someone 
  545.          else.  Each time the source diskette is changed, FILECAT 
  546.          checks for the existence of a Transfer File and, if found, 
  547.          allows the data to automatically be transfered into the current 
  548.          FILECAT database.  This feature is intended primarily for 
  549.          user group librarians for the convenience of those who 
  550.          acquire the library disks and wish to include the file 
  551.          descriptions in their master FILECAT database.  
  552.  
  553.          
  554.  
  555.          
  556.                                     Page 10
  557.  
  558.  
  559.          TRANSFER FILES (continued):
  560.  
  561.          To create a Transfer File, select choice 6 in the Reports 
  562.          Menu (CREATE and WRITE to Transfer File).  You will be 
  563.          returned to Main Menu.  A flashing message in the lower right 
  564.          corner will remind you that you are now working on a transfer 
  565.          file.  What has happened is that the normal FILECAT.DAT and 
  566.          FILECAT.IXN data and index files have been replaced by 
  567.          temporary TRANSFER.DAT and TRANSFER.IXN data and index files.  
  568.          
  569.          Everything will work as before.  Insert your library diskette 
  570.          and build a database for all files.  When complete, return to 
  571.          the Reports and Utilities Menu.  Note that choice 6 now reads 
  572.          "MOVE Transfer File to Current Source Drive".  If you are 
  573.          ready to move the file, select choice 6.  The program will 
  574.          confirm that you really do wish to move the file and if so, 
  575.          copy it to the source disk.  When complete, you will be given 
  576.          the opportunity to ADD the data to your master database.
  577.  
  578.          NOTE: The TRANSFER.DAT file is in the same format as a normal 
  579.                FILECAT.DAT data file, but without an index file and 
  580.                with deleted record space removed.  Alternately you 
  581.                could simply create a normal FILECAT.DAT data file, 
  582.                then copy it (without the FILECAT.IXN index file) to 
  583.                the library disk, renaming it to TRANSFER.DAT.  There 
  584.                is the possibility that a file created in this manner 
  585.                would be larger (because of deleted records that were 
  586.                not reused) and might not actually be the data file you 
  587.                intended.  
  588.  
  589.          If you attempt to exit FILECAT with an open Transfer File, 
  590.          you will be warned and given another chance to move it to 
  591.          your source disk.  If you choose NOT to move the file now, 
  592.          the next time you run FILECAT the Transfer File will still 
  593.          be open, and the flashing "Working on a Transfer File" 
  594.          displayed at the bottom of your screen.  You MUST eventually 
  595.          move the file in order to return to your normal FILECAT data 
  596.          file.  
  597.       
  598.          HINT: To create a Transfer File on a library disk, first 
  599.                create it ("5" in main menu, followed by "6" in 
  600.                utilities menu).  Then "2" (Enter File Data), followed 
  601.                by "F1" (Enter ALL files).  Now select "4" (Browse), 
  602.                edit in Keywords and Descriptions for active files and 
  603.                delete unwanted files.  Finally, move the Transfer File 
  604.                to the source disk as described above.  Note that you 
  605.                may leave the program to take a break and when you 
  606.                rerun FILECAT, the Transfer File will still be active.         
  607.  
  608.             
  609.                                     Page 11
  610.  
  611.  
  612.          TECHNICAL INFORMATION:
  613.  
  614.          If you wish to try to access the FILECAT.DAT data file, the 
  615.          following describes the record definition. NOTE: actual data 
  616.          begins in record 1 (record 0 is reserved for program use).  
  617.            
  618.            Status    : Integer     { 0=Active  All Else=Deleted }
  619.            FileName  : String[12]  { File Name padded with spaces at 
  620.                                      end + '.' + Extension }
  621.            FileTime  : Integer     { Image of DTA file creation time }
  622.            FileDate  : Integer     { Image of DTA file date }
  623.            FileSize  : Array[1..4] of Byte  { Image of DTA file size }
  624.            Floppy    : Boolean     { True=Floppy  False=Hard Disk }
  625.            Vol/Path  : String[64]  { Disk volume name or Hard Disk 
  626.                                      Directory Path }
  627.            StandAlone  : Boolean     { True=Stand Alone  False=if not }
  628.            MainName    : String[12]  { Main File Name formatted as
  629.                                        FileName above }
  630.            Keys        : String[79]  { Keywords }
  631.            Description : Array[1..4] of String[79] 
  632.                                      { Four lines of description }
  633.  
  634.          Each record is 503 bytes in length with 1 record overhead.  
  635.          Each index key is 14 bytes in length.  FILECAT.COM is written 
  636.          in Turbo Pascal using the Database Toolkit, both by Borland 
  637.          International.  Requires DOS2.x or greater.  Written on an 
  638.          IBM-PC with a color monitor, but should run on close 
  639.          compatibles with monochrome monitors.  Probably should have 
  640.          256K for reasonably fast processing (program uses as much 
  641.          normal memory as available for sorting and B+Tree storage, 
  642.          with disk used for overflow).  
  643.  
  644.  
  645.          SOURCE CODE:
  646.  
  647.          Source code is available to librarians, sysops and other 
  648.          interested users.  However, if this program is to become any 
  649.          kind of standard for library disks, programmers shouldn't 
  650.          mess around with the basic record definition so that the 
  651.          TRANSFER.DAT file may be transported from one group to 
  652.          another.  If you wish to receive a disk with the source code, 
  653.          librarians should send a couple of their library disks in 
  654.          trade, while others should send a formatted disk and postpaid 
  655.          return mailer.  
  656.          
  657.  
  658.          
  659.                                     Page 12
  660.  
  661.  
  662.          Suggestions and comments are welcome.  I'm sure that with 
  663.          some feedback an improved version can be written and 
  664.          distributed.  
  665.  
  666.          Send your source code requests and comments to:
  667.  
  668.                  Kenn Flee
  669.                  Jamestown Software
  670.                  2508 Valley Forge
  671.                  Madison WI  53719
  672.          
  673.          Enjoy!
  674.  
  675.          -----------------------------------------------------------
  676.          
  677.          
  678.          REVISION HISTORY:
  679.  
  680.          02/10/86 -- Original release, version 1.0.
  681.  
  682.          02/16/86 -- Minor problem fixed with Epson setup (change 
  683.          Version     didn't take effect until second line).
  684.          1.1
  685.                      Additional error checking to eliminate possible 
  686.                      entry of "." for Main FileName and Extension.
  687.  
  688.                      Program now defaults to Standalone on first entry 
  689.                      and if Main FileName and Extension are blank.  
  690.  
  691.                      Corrected problem interpreting volume name.
  692.  
  693.                      Added Associated Files group retreival option 
  694.                      when Main File displayed in Browse/Edit Function.  
  695.  
  696.          02/24/86 -- Corrected problem with DOS2.1 disk volume read.
  697.          Version     Now tested and working with both DOS2.1/3.1.
  698.          2.0
  699.                      Added disk volume write if no label found.
  700.  
  701.                      Added library of common keywords, with user-
  702.                      entered keywords added to library automatically.  
  703.  
  704.          03/02/86 -- Corrected Monochrome windowing problem, plus 
  705.          Version     changed some minor annoyances.
  706.          2.1
  707.                      "Add ALL Files" <F1> option added to File Entry.
  708.  
  709.                      Transfer File now remains open if FILECAT is 
  710.                      terminated before Transfer File is moved.
  711.  
  712.                      "First Char. Delete" (FCD) <F8> on/off toggle 
  713.                      added.  See page 6, "Experiment a little...".  
  714.  
  715.          
  716.                                     Page 13
  717.  
  718.           KEYWORD LIST (Press F1 when adding/editing Keywords):
  719.  
  720.           8086            8087            8088            ABSOLUTE        
  721.           ACCESS          ACCURACY        ACCURATE        ACTIVATE        
  722.           ADJUSTMENT      ALGEBRA         ALGEBRAIC       ALLOCATION      
  723.           ALT             ANAGRAM         ANALYSIS        ANIMATION       
  724.           ANNOUNCE        ANNOUNCEMENT    ANSI            ANSWERS         
  725.           APPEND          APPLE           APPOINTMENT     APPROXIMATION   
  726.           ARC             ARCHIVE         ARCHIVED        ARCTAN          
  727.           ARCTANGENT      ARGUMENTS       ARITHMETIC      ARRAY           
  728.           ART             ASCII           ASM             ASSEM           
  729.           ASSEMBLER       ASSEMBLY        ASYNC           AT              
  730.           ATT             ATTENTION       ATTRIBUTE       AUTO-DIAL       
  731.           AXIS            BACKGROUND      BACKUP          BAK             
  732.           BASE            BASES           BASIC           BATCH           
  733.           BBS             BCD             BELL            BENCHMARK       
  734.           BIG             BINARY          BINDING         BIOS            
  735.           BIT             BITACCESS       BLANK           BLINK           
  736.           BLOAD           BLOCK           BLOCKREAD       BLOCKWRITE      
  737.           BOARD           BOOK            BORDER          BOX             
  738.           BREAKDOWN       BREAKUP         BROWSE          BUFFER          
  739.           BUFFERED        BUFFERS         BUG             BUGS            
  740.           BW              BYTE            C               CALCULATION     
  741.           CALCULATOR      CALENDAR        CALL            CALLS           
  742.           CAPS            CASES           CATALOG         CD              
  743.           CELLULAR        CELSIUS         CGA             CHAIN           
  744.           CHANGE          CHANGES         CHAR            CHARACTER       
  745.           CHECK           CHECKING        CHILD           CHOOSE          
  746.           CIPHER          CLEANUP         CLEAR           CLOCK           
  747.           CLOCKCARD       CLONE           CLOSE           CODE            
  748.           CODES           COLOR           COLORS          COM             
  749.           COMBINER        COMM            COMMAND         COMMENT         
  750.           COMMENTS        COMMON          COMMUNICATIONS  COMPARER        
  751.           COMPATIBILITY   COMPATIBLE      COMPATIBLES     COMPILATION     
  752.           COMPILE         COMPILER        COMPLEX         COMPRESS        
  753.           COMPUSERVE      COMSPEC         CONCURRENT      CONFIG          
  754.           CONFIGURATION   CONJECTURE      CONSOLE         CONSTANTS       
  755.           CONTROL         CONVERSION      CONVERT         COPROCESSOR     
  756.           COPY            COPYING         CORRECTION      CORRECTIONS     
  757.           CORRESPONDENCE  COS             CPM             CPM-80          
  758.           CPM-86          CPM80           CPM86           CRASH           
  759.           CRC             CREATE          CRIBBAGE        CRITICAL        
  760.           CROSS           CROSS-REFERENCE CROSSREF        CRUNCH          
  761.           CRYPTOGRAPHY    CURRENT         CURSOR          CURSOR-CONTROL  
  762.           CURVE           CURVEFIT        CYCLIC          DATA            
  763.           DATABASE        DATE            DATES           DBASE           
  764.           DEARC           DEARCHIVE       DEBUG           DEBUGGER        
  765.           DEC             DECIMAL         DECIPHER        DEFAULT         
  766.           DEFINE          DEFINITION      DEL             DELETE          
  767.           DELIMITERS      DEMO            DEMONSTRATION   DESCRIPTION     
  768.           DESCRIPTIONS    DEVICE          DIALING         DIF             
  769.           DIP             DIPSWITCH       DIR             DIRECT
  770.          
  771.                                     Page 14          
  772.  
  773.           KEYWORD LIST (continued):
  774.  
  775.           DIRECTORIES     DIRECTORY       DISK            DISKETTE        
  776.           DISKREAD        DISPLAY         DISTRIBUTION    DMA             
  777.           DOC             DOCUMENT        DOCUMENTATION   DOOR            
  778.           DOS             DOWNLOAD        DOWNLOADS       DRAW            
  779.           DRAWING         DRIVE           DRIVER          DUMBTERM        
  780.           EDIT            EDITING         EDITOR          EGA             
  781.           EMULATE         EMULATION       EMULATOR        ENCIPHER        
  782.           ENGLISH         ENTRIES         ENTRY           ENVIRONMENT     
  783.           EPSON           EQUIPMENT       ERASE           ERROR           
  784.           ERRORS          ESCAPE          EXAMPLE         EXCEPTIONS      
  785.           EXEC            EXECUTE         EXECUTION       EXERCISES       
  786.           EXP             EXPANDED        EXPERIMENT      EXPERIMENTAL    
  787.           EXPONENT        EXPONENTIAL     EXTEND          EXTERNAL        
  788.           EXTREME         FACTOR          FACTORIAL       FAHRENHEIT      
  789.           FAILURE         FAST            FEATURES        FIELD           
  790.           FIELDS          FILE            FILER           FILES           
  791.           FILTER          FINANCIAL       FIND            FITTING         
  792.           FIX             FIXES           FLASH           FLDINPUT        
  793.           FLICKER         FLOATING        FLOPPY          FLUSH           
  794.           FONT            FORM            FORMAT          FORMATTER       
  795.           FORMULAS        FOURIER         FRACTAL         FRAMES          
  796.           FREE            FREESPACE       FREQUENCY       FULLSCREEN      
  797.           FUN             FUNCTION        FUNCTIONKEYS    FUNCTIONS       
  798.           GAME            GAUSSIAN        GEM             GENERAL         
  799.           GENERATOR       GENERIC         GEOMETRY        GET             
  800.           GETENVSTR       GINST           GLOBAL          GRAPHIC         
  801.           GRAPHICS        GRAPHIX         GREGORIAN       GROUP           
  802.           HANDLE          HANDLER         HANDLES         HARDCOPY        
  803.           HARDWARE        HARMONIC        HEAP            HEAPSORT        
  804.           HEATH           HELP            HELPFILE        HELPSCREEN      
  805.           HERCULES        HEWLETT         HEXIDECIMAL     HIDDEN          
  806.           HIGH-INTENSITY  HINTS           HIRES           HP              
  807.           IBM             IBM-PC          IMAGE           IMAGINARY       
  808.           INC             INCLUDE         INDEX           INFLATION       
  809.           INFORMATION     INITIALIZATION  INITIALIZE      INKEY           
  810.           INLINE          INPUT           INPUT-OUTPUT    INSERT          
  811.           INSTALLATION    INT             INT13           INT16           
  812.           INT17           INT24           INTEGER         INTEGER-TO-REAL 
  813.           INTENSITY       INTERCHANGE     INTERFACES      INTERPOLATION   
  814.           INTERPRETER     INTERR          INTERRUPT       INTERRUPTS      
  815.           INTR            IO              IORESULT        JENSEN-WIRTH    
  816.           JOYSTICK        JULIAN          KAYPRO          KBD             
  817.           KERMIT          KEY             KEYBOARD        KEYIN           
  818.           KEYPRESS        KEYPRESSED      KEYS            KEYWORDS        
  819.           KILLER          KOALA           KOALAPAD        LABEL           
  820.           LANGUAGE        LARGE           LEARNING        LEAST           
  821.           LIBRARY         LIFE            LIGHTPEN        LIMIT           
  822.           LINE            LINEAR          LIST            LISTER          
  823.           LISTING         LOAD            LOADER          LOCATION        
  824.           LOCATIONS       LOCK            LOG             LOGARITHM       
  825.           LOGICAL         LONG            LONGJMP         LOST            
  826.          
  827.                                     Page 15
  828.  
  829.           KEYWORD LIST (continued):
  830.  
  831.           LOWERCASE       LU              MACHINE         MACRO           
  832.           MAINTENANCE     MANDELBROT      MANIPULATION    MANUAL          
  833.           MAP             MAPPER          MARKS           MASK            
  834.           MATCH           MATH            MATHEMATICAL    MATRIX          
  835.           MAZE            MEMORY          MENU            MESSAGE         
  836.           MESSAGES        MICROSOFT       MODE            MODEM           
  837.           MODEM7          MODIFICATION    MODIFICATIONS   MODIFIED        
  838.           MODIFIER        MODIFY          MONITOR         MONITORS        
  839.           MONO            MONOCHROME      MOUSE           MS-DOS          
  840.           MSDOS           MULTI-TASKING   MUSIC           NAME            
  841.           NEGATE          NETWORK         NEW             NEWSLETTER      
  842.           NIM             NORMAL          NUM             NUMBER          
  843.           NUMBERS         NUMERIC         NUMERICS        OCTAL           
  844.           OFFSET          OKIDATA         OLD             ONE-DIMENSIONAL 
  845.           OPEN            ORDINAL         OTHELLO         OUT             
  846.           OUTPUT          OVERLAY         OVERLAYS        OVERWRITE       
  847.           PAGES           PARAMETERS      PARITY          PARSER          
  848.           PARTIAL         PASCAL          PASSWORD        PATCH           
  849.           PATH            PC              PC-DOS          PCDOS           
  850.           PCJR            PERFORMANCE     PHANTOM         PI              
  851.           PICTURE         PLAY            PLOT            PLUG            
  852.           POINT           POINTER         PONG            POP             
  853.           PORT            PORTABLE        POSITION        POSITIONING     
  854.           POWER           POWERS          PRETTYPRINTER   PRINT           
  855.           PRINTER         PRINTSCREEN     PRINTUSING      PROBABILITY     
  856.           PROBE           PROBLEM         PROCEDURE       PROCEDURES      
  857.           PROCESS         PROCESSES       PROCESSOR       PRODUCTS        
  858.           PROGRAM         PROGRAMMING     PROJECT         PROMPT          
  859.           PROTECTED       PROTECTION      PROTOCOL        PRTSC           
  860.           PSP             PUSH            QUESTIONS       QUICKSORT       
  861.           QUME            RAINBOW         RAM             RANDOM          
  862.           RANGE           READ            READ-ONLY       READKBD         
  863.           READWRITE       REAL            RECIPE          RECIPROCAL      
  864.           RECOVER         RECURSION       RECURSIVE       REDIRECTION     
  865.           REDUNDANCY      REFERENCE       REFORMATTER     REGISTER        
  866.           REMOVE          REMOVEABLE      RENAME          REPLACEMENT     
  867.           REPORT          RESET           RESIDENT        RESTORE         
  868.           RETRACE         REVERSE-VIDEO   REVERSI         REVIEWS         
  869.           REWRITE         ROBOTICS        ROLODEX         ROM             
  870.           ROOTS           ROUTINE         ROUTINES        RUN             
  871.           RUN-TIME        RUNTIME         SAMPLE          SANYO           
  872.           SAVE            SCALE           SCHEDULER       SCIENTIFIC      
  873.           SCREEN          SCREENS         SCROLL          SEARCH          
  874.           SECTOR          SEGMENT         SERIAL          SERIES          
  875.           SERVICE         SET             SETJMP          SETS            
  876.           SETUP           SHARED          SHAREWARE       SHELL           
  877.           SHIFT           SIDEKICK        SIEVE           SIG             
  878.           SIMPLE          SIMPLEX         SIN             SIZE            
  879.           SNOW            SOFTWARE        SOLVE           SORT            
  880.           SOUND           SOURCE          SOURCES         SPACE           
  881.           SPECIFICATIONS  SPECTRUM        SPEED           SPIRIT          
  882.          
  883.                                     Page 16
  884.  
  885.           KEYWORD LIST (continued):
  886.  
  887.           SPLINE          SPRINT          SQEEZE          SQRT            
  888.           SQUARE          SQUARES         SQUEEZE         SQUEEZED        
  889.           STACK           STATES          STATISTICS      STATUS          
  890.           STAY            STORAGE         STRING          STRIP           
  891.           SUBDIR          SUBPROCESS      SUGGESTION      SUPERKEY        
  892.           SUPPORT         SYMBOL          SYS             SYSTEM          
  893.           TAB             TABLE           TANDY           TELECOMMUNICATI 
  894.           TELEPHONE       TEMPERATURE     TERMINAL        TERMINATE       
  895.           TEST            TEXT            TICK            TIME            
  896.           TIMER           TINST           TIP             TOOLBOX         
  897.           TOOLS           TOPVIEW         TRADE           TRANSCENDENTAL  
  898.           TRANSFORM       TRANSIENT       TRAP            TRAVESTY        
  899.           TREE            TREE-STRUCTURED TRIG            TRUNCATION      
  900.           TURBBS          TURBO           TURBO-ACCESS    TURBOBCD        
  901.           TURBOFIX        TURBOPASCAL     TURBORUN        TYPE            
  902.           TYPED           TYPES           UART            UNDERLINE       
  903.           UNINITIALIZED   UNIX            UNSQEEZE        UNSQUEEZE       
  904.           UNSQUEEZED      UNUSED          UPDATE          UPGRADE         
  905.           UPLOAD          UPLOADS         USER            USERS           
  906.           USING           UTILITIES       UTILITY         VARIABLE        
  907.           VARIABLES       VAX             VDI             VERIFY          
  908.           VERSION         VERSION3.0      VERSIONS        VIDEO           
  909.           VIDEO-MAPPED    VIDTEX          VISICALC        VOLUME          
  910.           WAIT            WANG            WARNING         WIDE            
  911.           WILDCARDS       WINDOW          WINDOWS         WORD            
  912.           WORDSTAR        WORKAROUND      WORLDS          WRITE           
  913.           WRITEALL        WRITELN         WRITING         WUMPUS          
  914.           XEROX           XMODEM          XREF            XT              
  915.           ZENITH                    722 Total Keywords
  916.          
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.