home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / cdisk410.zip / CATDISK.DOC next >
Text File  |  1989-04-26  |  136KB  |  3,433 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                            DISK CATALOG SYSTEM (CATDISK)
  21.  
  22.                                    USER'S GUIDE
  23.  
  24.  
  25.                                    Version 4.10
  26.  
  27.                                   April 26, 1989
  28.  
  29.  
  30.                      Copyright (C) 1986, 1989 By Rick Hillier
  31.  
  32.                                All Rights Reserved.
  33.  
  34.  
  35.  
  36.                                    _______
  37.                               ____|__     |               (tm)
  38.                            --|       |    |-------------------
  39.                              |   ____|__  |  Association of
  40.                              |  |       |_|  Shareware
  41.                              |__|   o   |    Professionals
  42.                            -----|   |   |---------------------
  43.                                 |___|___|    MEMBER
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                          T A B L E   O F   C O N T E N T S
  70.  
  71.  
  72.       1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . .  2
  73.            Overview . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  74.            Features . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  75.            Licensing And Distribution . . . . . . . . . . . . . . . . .  3
  76.            Public Domain And Shareware Libraries . . .  . . . . . . . .  4
  77.            ASP . . .  . . . . . . . . . . . . . . . . . . . . . . . . .  4
  78.  
  79.       2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . . .  5
  80.            What You Should Have Received  . . . . . . . . . . . . . . .  5
  81.            System Requirements  . . . . . . . . . . . . . . . . . . . .  5
  82.            Initial Note On Archive Files  . . . . . . . . . . . . . . .  5
  83.            Configuring CATDISK  . . . . . . . . . . . . . . . . . . . .  5
  84.            Default Settings . . . . . . . . . . . . . . . . . . . . . .  9
  85.            Upgrading From V3.61 or Later  . . . . . . . . . . . . . . .  9
  86.            General Considerations When Configuring CATDISK  . . . . . . 10
  87.            Sample Configurations  . . . . . . . . . . . . . . . . . . . 11
  88.            IMPORTANT NOTE . . . . . . . . . . . . . . . . . . . . . . . 12
  89.            Starting CATDISK . . . . . . . . . . . . . . . . . . . . . . 13
  90.  
  91.       3. USING CATDISK  . . . . . . . . . . . . . . . . . . . . . . . . 15
  92.            Using The Menus  . . . . . . . . . . . . . . . . . . . . . . 15
  93.            Option 1 - Set Drive For Cataloging  . . . . . . . . . . . . 16
  94.            Option 2 - Settings And Toggles Menu . . . . . . . . . . . . 17
  95.                1 - Set Current Report Destination   . . . . . . . . . . 17
  96.                2 - Toggle Archive Extract   . . . . . . . . . . . . . . 17
  97.                3 - Set Current Catalog File   . . . . . . . . . . . . . 18
  98.                4 - Pause  . . . . . . . . . . . . . . . . . . . . . . . 18
  99.                5 - Add/Update File Comments While Cataloging  . . . . . 18
  100.                6 - Printer Report Type  . . . . . . . . . . . . . . . . 18
  101.              ESC - Return To Main Menu  . . . . . . . . . . . . . . . . 19
  102.              Option 3 - Labeling A Disk . . . . . . . . . . . . . . . . 20
  103.              Option 4 - Cataloging A Disk . . . . . . . . . . . . . . . 21
  104.              Option 5 - UnCataloging A Disk . . . . . . . . . . . . . . 23
  105.              Option 6 - Show Diskette Summary . . . . . . . . . . . . . 24
  106.              Option 7 - Show Files For A Volume . . . . . . . . . . . . 26
  107.              Option 8 - Show Files For An Archive . . . . . . . . . . . 28
  108.              Option 9 - Show Selected Files . . . . . . . . . . . . . . 30
  109.              Option 0 - Show ALL Files  . . . . . . . . . . . . . . . . 32
  110.              Option F1 - Add/Change File Comments . . . . . . . . . . . 34
  111.              Option F2 - Show Files By Comment  . . . . . . . . . . . . 36
  112.              Option F3 - Temporarily Exit To DOS  . . . . . . . . . . . 38
  113.              Option <drive_letter>: Show Disk Directory   . . . . . . . 39
  114.              Option ESC - Exit To DOS  . . .. . . . . . . . . . . . . . 40
  115.  
  116.         Appendix A - The Scroll Bar . . . . . . . . . . . . . . . . . . 41
  117.         Appendix B - Archive Support  . . . . . . . . . . . . . . . . . 42
  118.         Appendix C - Duplicate Filenames And Cataloging Hard Drives . . 43
  119.         Appendix D - Support And Updates  . . . . . . . . . . . . . . . 44
  120.         Appendix E - Questions And Answers  . . . . . . . . . . . . . . 45
  121.         Appendix F - CATDISK PLUS . . . . . . . . . . . . . . . . . . . 47
  122.         Appendix G - Other Programs Available . . . . . . . . . . . . . 48
  123.  
  124.         CATDISK V3.81 Registration Form . . . . . . . . . . . . . . . . 50
  125.  
  126.  
  127.  
  128.  
  129.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  130.  
  131.                                        Page 1
  132.  
  133.  
  134.  
  135.                             1.  I N T R O D U C T I O N
  136.  
  137.  
  138.         OVERVIEW
  139.  
  140.         Overheard:  "I know I have that file in an archive on a disk SOMEWHERE!
  141.                     If only I could FIND it!"
  142.  
  143.         Sound familiar?  Many people I know are in this predicament.
  144.  
  145.         Enter CATDISK, the disk cataloging system.  CATDISK can help you
  146.         organize your disks in such a way that it is easy to find a file from
  147.         within a large collection by creating a collective directory of all the
  148.         files contained in your collection.  See the FEATURES section below for
  149.         a listing of CATDISK's capabilities.
  150.  
  151.  
  152.         FEATURES
  153.  
  154.         . Completely menu-driven and very easy to use.
  155.         . Easy to use configuration utility allows customization of many of the
  156.           program's features.
  157.         . All screen colors can be customized to your liking.
  158.         . Command line options can be stored in the DOS environment area
  159.           negating the need to memorize them.
  160.         . Cataloging/Uncataloging functions are completely automatic.
  161.         . A disk volume label can be changed from within CATDISK.
  162.         . Can support up to 32,767 files or 2,000 disks per catalog,
  163.           whichever comes first.
  164.         . Supports multiple catalog files.
  165.         . This limit can be reduced through the configuration utility to better
  166.           optimize memory usage.
  167.         . Supports sub-directories up to 32 levels deep with an upper limit of
  168.           256 directories per disk being cataloged.
  169.         . Able to read the directory contents of .ARC, .LBR, .ZIP, .LZH, .LZS,
  170.           .ZOO and LBR files.  See the appendix on ARCHIVE SUPPORT in this user
  171.           manual for further details.
  172.         . Supports 256 each of .ARC, .PAK, .ZIP, .LZH, .LZS, .ZOO .LBR files
  173.           per directory being cataloged.
  174.         . ARC, LBR, PAK, ZIP, LZH, LZS and ZOO file extraction is optional and
  175.           can be decided while running the program.
  176.         . You can attach a 30 character comment to each file in the catalog.
  177.           This can be done either while cataloging a disk, or at a later time.
  178.         . Summary report shows disk capacity, space used and space free on
  179.           each disk in the catalog to aid in optimization of disk usage.
  180.         . Files can be viewed by DOS wildcards, Volume ID, ARCHIVE ID, or by
  181.           keywords or phrases in the file comments.
  182.         . Reports can be sent to screen, printer, or disk file.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  196.  
  197.                                        Page 2
  198.  
  199.  
  200.  
  201.         LICENSING AND DISTRIBUTION
  202.  
  203.         CATDISK is copyright and has been released for distribution as
  204.         SHAREWARE.  Please note that a great deal of effort and time has been
  205.         invested in the development of this program.  You are granted a license
  206.         to try CATDISK for a reasonable trial period without risk.  If, after
  207.         this time, you find the program useful and intend to use it in managing
  208.         your disk collection, you are expected to register.
  209.  
  210.         The base registration fee is $15.  This will entitle you to continue to
  211.         use CATDISK beyond a reasonable trial period as well as entitle you to
  212.         program support.  You will find a registration form at the end of this
  213.         user manual that outlines the procedures for registering your copy of
  214.         the program.  Should you decide that you would like the latest release
  215.         (or a pending release if you already have the latest) appropriate
  216.         information is contained on the same form.
  217.  
  218.         Please keep in mind that I must have a registration form on file for
  219.         you before I can offer product support.
  220.  
  221.         Operators of electronic bulletin boards (Sysops) are encouraged to post
  222.         CATDISK for downloading by their users.
  223.  
  224.         CATDISK may be uploaded to and downloaded from commercial systems such
  225.         as CompuServe, the Source, and BIX, so long as the only charge paid by
  226.         the subscriber is for on-line time and there is no charge for the
  227.         program.  Those copying, sharing, and/or electronically transmitting
  228.         the program are required not to delete or modify the copyright notice
  229.         and restrictive notices from the program or documentation; anyone doing
  230.         so will be treated as a contributory copyright violator.
  231.  
  232.         If you are passing this program on to others, uploading it to a
  233.         bulletin board system, or including it in a users group library, do not
  234.         separate the files contained in this ARC file - pass the ARC file on to
  235.         the intended party.  This ensures that those who receive the program
  236.         will have all the correct configuration utilities and documentation
  237.         necessary to get CATDISK up and running quickly.  A listing of what
  238.         files you should have and the purpose of each is listed later in this
  239.         manual.
  240.  
  241.         The CATDISK documentation may not be modified by users. The program may
  242.         not be separated from the documentation when distributed.  Printed or
  243.         Photocopies ("Xeroxed") copies of the CATDISK documentation (i.e., this
  244.         manual) may not be distributed or sold without the written permission
  245.         of the author.
  246.  
  247.         No other person other than the author, Rick Hillier, may accept payment
  248.         or royalties for this program.
  249.  
  250.         This license to use CATDISK does NOT include the right to distribute or
  251.         sell CATDISK.  Distribution terms are detailed on the next page.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  262.  
  263.                                        Page 3
  264.  
  265.  
  266.  
  267.         PUBLIC DOMAIN AND SHAREWARE LIBRARIES
  268.  
  269.         Distributors of "public domain" or user-supported software libraries
  270.         must obtain written permission to distribute copies of CATDISK.  No one
  271.         may use CATDISK as a promotion for any commercial venture or as an
  272.         enticement for the user to pay for any program, product, or service
  273.         unless they have received the express written permission of the
  274.         program's author.
  275.  
  276.         In order to distribute CATDISK, a dealer or disk vendor must comply
  277.         with the following conditions:
  278.  
  279.              (1)  You must obtain written permission from Rick Hillier to
  280.                   distribute CATDISK.  If you receive no reply, write again:
  281.                   my silence does NOT constitute permission, and you may not
  282.                   distribute "pending" receipt of permission.
  283.  
  284.              (2)  A maximum disk fee as set by Rick Hillier in the vendor
  285.                   contract must not be exceeded.  CATDISK may not be included
  286.                   on any disk sold for more than this maximum, including CD-ROM
  287.                   or optical disks, without express written permission from
  288.                   Rick Hillier.
  289.  
  290.              (3)  Vendors may not modify or delete ANY files on the disk.
  291.                   Vendors may add a "GO" program, and/or a reasonable number of
  292.                   small text files designed to assist or provide a service to
  293.                   the user, but these added files must be easily identifiable
  294.                   and end-users must be allowed to delete the added files.
  295.  
  296.              (4)  Vendors must make a reasonable effort to distribute only the
  297.                   most recent versions of CATDISK.  All vendors who have
  298.                   requested and received written permission to distribute
  299.                   CATDISK will be notified of updates as they are released.
  300.  
  301.              (5)  All disk vendors must comply with any and all vendor
  302.                   guidelines or vendor requirements set forth by the
  303.                   Association of Shareware Professionals (ASP); for more
  304.                   information about ASP, contact its chairman, Jim Button, at
  305.                   Buttonware in Seattle.  Violation of any ASP guideline or
  306.                   requirement automatically revokes permission to distribute
  307.                   CATDISK.
  308.  
  309.         Until formal requirements are adopted by the ASP, you must comply with
  310.         the following guidelines: Vendors must make an attempt to educate users
  311.         on the nature of Shareware.  Catalogs, advertisements, order forms, and
  312.         all disks sold should contain ASP-approved or recommended wording
  313.         describing the nature of shareware, and should explicitly state that no
  314.         part of disk sale revenues are paid to the programs' authors.  When
  315.         vendor catalogs or advertisements carry both Shareware and PD programs,
  316.         the Shareware programs must be differentiated from the public domain
  317.         programs in some way (in the description, with an asterisk, by listing
  318.         the registration fee, etc.).
  319.  
  320.  
  321.         ASP
  322.  
  323.         CATDISK is a Shareware program conforming to standards as established
  324.         by the Association of Shareware Professionals (ASP) located at
  325.         325 118th Ave. S.E., Suite 200, Belleview, WA  98005.
  326.  
  327.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  328.  
  329.                                        Page 4
  330.  
  331.  
  332.  
  333.                            2.  G E T T I N G   S T A R T E D
  334.  
  335.  
  336.         WHAT YOU SHOULD HAVE RECEIVED
  337.  
  338.         CATDISK is distributed in the form of an ARC file conforming to
  339.         SEAWare's ARC utility V5.30 or later.  This ARC file should contain six
  340.         files which are as follows:
  341.  
  342.         CATDISK.EXE    The CATDISK program file.
  343.         CDISKCFG.EXE   The CATDISK configuration program.
  344.         CDISKCVT.EXE   Conversion utility for converting old CATDISK files to
  345.                        the newest format - See the README.1ST file before
  346.                        running.
  347.  
  348.         CATDISK.DOC    The manual you are now reading.
  349.         CATDISK.HST    Revision history of CATDISK.
  350.         README.1ST     Urgent program notes - IT IS IMPORTANT THAT YOU READ
  351.                                               THIS!
  352.  
  353.  
  354.  
  355.         SYSTEM REQUIREMENTS
  356.  
  357.         IBM PC/XT/AT or PS/2 or true compatible computer.
  358.  
  359.         DOS V2.00 or above.
  360.  
  361.         At least one floppy disk drive (Hard Drive Highly Recommended).
  362.  
  363.         256K system RAM - if more is available, CATDISK will have greater
  364.                           internal capacity for reading new files off of the
  365.                           disks being cataloged and will run more efficiently.
  366.  
  367.         INITIAL NOTE ON ARCHIVE FILES
  368.  
  369.         At various points in this user manual, references to ARCHIVE files are
  370.         made.  This is a collective term describing a file that actually
  371.         contains more than one file.  The contained files may or may not be
  372.         compressed.  Currently, this refers to LBR, ARC, PAK, ZIP, LZH, LZS and
  373.         ZOO files.
  374.  
  375.  
  376.         CONFIGURING CATDISK
  377.  
  378.         Many features of CATDISK may be permanently set from the configuration
  379.         program, "CDISKCFG.EXE".  When you start this program, please make sure
  380.         that the program file "CATDISK.EXE" is in the current drive and
  381.         directory, otherwise you will get an error message.
  382.  
  383.         Upon startup, the configuration program will read the current settings
  384.         defined in "CATDISK.EXE", after which, the configuration screen will be
  385.         presented.  You may change any given item on this screen by using the
  386.         <Cursor UP> and <Cursor DOWN> keys to highlight the title of the
  387.         desired field.  The bottom portion of the screen will contain any
  388.         additional information as well as any instructions on how to change the
  389.         selected item.
  390.  
  391.  
  392.  
  393.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  394.  
  395.                                        Page 5
  396.  
  397.  
  398.  
  399.         A discussion of the 10 items on this list follows:
  400.  
  401.          1) SCREEN UPDATE METHOD
  402.  
  403.             You may choose between having your screen updated by using your
  404.             computer's built in BIOS routines, or by using a faster DIRECT
  405.             screen update method.  Using the BIOS is much slower than using
  406.             direct access, but maintains compatibility with such operating
  407.             environments as TopView, Desqview, and DoubleDOS.
  408.             Choosing DIRECT screen access is much quicker, but will be
  409.             incompatible with most multitasking programs such as the above
  410.             mentioned due to the fact that they cannot handle "ill-behaved"
  411.             programs that write directly to the screen.
  412.  
  413.             If you chose DIRECT screen access, a second test is made if you
  414.             have a GRAPHICS display connected in your system.  Some video
  415.             adapters have the nasty side effect of producing static, or "snow"
  416.             when the video memory is accessed directly.  This test will do
  417.             multiple direct access to the video ram on your graphics adapter.
  418.             When you hit a key to stop the test, you will be asked if you saw
  419.             static on the screen.
  420.  
  421.             If you answer "Y" to the prompt, CATDISK will check for horizontal
  422.             retrace before writing to the display.  This will result in a
  423.             slightly slower screen response than normal, but it is almost
  424.             negligible.
  425.  
  426.             If you are not running under a multitasking system, or are using
  427.             DoubleDos in dual screen mode, I would recommend that you use
  428.             DIRECT screen access, as it's much quicker.
  429.  
  430.          2) COLOR OR B & W
  431.  
  432.             This option is self-explanatory.  The appearance of the setup
  433.             screen will depend on the setting of this field.
  434.  
  435.          3) DISK CACHE SIZE
  436.  
  437.             This field will enable you to set the DISK CACHE size. Setting it
  438.             to zero will disable the cache (i.e. turn the feature off).
  439.  
  440.             Setting it to a number greater then zero will turn it on and will
  441.             enable CATDISK to keep the most recently read sectors of the
  442.             CATALOG FILES in memory, resulting in much faster scans through the
  443.             catalog file when looking for a group of files.
  444.  
  445.             Some hard disks use their own device driver, and are incompatible
  446.             with this caching method.  If this is the case, CATDISK will warn
  447.             you of this condition if caching is enabled, but is incompatible
  448.             with your hard disk.  Under these circumstances, the caching
  449.             feature will be turned off during that program run... use this
  450.             configuration option to permanently disable the cache and eliminate
  451.             the warning at each startup.
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  460.  
  461.                                        Page 6
  462.  
  463.  
  464.  
  465.          4) NUMBER OF LINES PER PAGE
  466.  
  467.             The number of lines per page field will enable you to tell CATDISK
  468.             the number of lines of data (EXCLUDING headings) that it should
  469.             place on each page of printer or disk output.  This may be any
  470.             number between 0 and 255.  Entering zero will disable page breaking
  471.             and the output will be presented in a continuous stream with one
  472.             title at the top.
  473.  
  474.          5) PRINTER STARTUP STRING
  475.  
  476.             The printer start up string is a series of ASCII codes (entered
  477.             here as their Ascii VALUES) that will tailor your reports to the
  478.             format you desire.  For example, I use an Epson printer and like to
  479.             set it to 1/8" spacing and get 80 report lines per page.  To do
  480.             this, I send a startup string of "<Esc> <0>" to set this print
  481.             mode.  To enter this string in the configuration program, I would
  482.             enter it as "027 048" without the quotes.  The numbers are simply
  483.             the ASCII values of the characters I wish to send.  If you have a
  484.             setup string entered here and wish to clear it, simply hit <Return>
  485.             in response to the prompt in the bottom area of the screen.
  486.  
  487.          6) PRINTER FINISHING STRING
  488.  
  489.             The printer finishing string is commonly used to reverse the
  490.             startup string entered above and is entered in exactly the same
  491.             way.  In the example above, I would use "<Esc> <2>", which would be
  492.             entered as "027 050" without the quotes.  If you have a setup
  493.             string entered here and wish to clear it, simple hit <Return> in
  494.             response to the prompt in the bottom area of the screen.
  495.  
  496.          7) DEFAULT ARCHIVE EXTRACT STATE
  497.  
  498.             This will control the way CATDISK handles any ARCHIVE files that
  499.             it might encounter when cataloging your disks.
  500.  
  501.             If you set it to OFF, CATDISK will NOT extract any archive files
  502.             that it finds on your disks.
  503.  
  504.             If you set it to ON, CATDISK will expand EVERY ARCHIVE file that it
  505.             finds on your disks.
  506.  
  507.             If you set it to QUERY, CATDISK will ask you for permission to
  508.             expand an ARCHIVE file each time it encounters one.
  509.  
  510.             This can be changed temporarily while running CATDISK.
  511.  
  512.          8) DEFAULT CATALOG DRIVE
  513.  
  514.             The default catalog drive is the drive that CATDISK will assume you
  515.             wish to use for labeling disks and reading them for cataloging
  516.             purposes.  This drive may still be changed at startup time (see
  517.             STARTING CATDISK), or from the menu when catdisk is running.
  518.  
  519.             If you are running on single floppy based system, I would recommend
  520.             that you set this drive to the same drive ID that CATDISK will be
  521.             run from.  CATDISK will prompt you to enter the appropriate disks
  522.             at the appropriate time, and will eliminate potential problems with
  523.             the disk caching feature if enabled (See the file README.1ST).
  524.  
  525.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  526.  
  527.                                        Page 7
  528.  
  529.  
  530.  
  531.          9) CATALOG FILE DIRECTORY
  532.  
  533.             The catalog file directory is the location in your system that
  534.             CATDISK will look for and create its catalog files.  This path may
  535.             contain a drive designator, so that the catalog files may reside on
  536.             a different drive than CATDISK itself, such as a ramdisk (in this
  537.             case don't forget to copy the files to a real disk before you turn
  538.             off or reboot your machine).
  539.  
  540.             If this field is blank, the default drive and directory will be
  541.             used.
  542.  
  543.         10) DISKS/FILES PER CATALOG
  544.  
  545.             The maximum number of disks and files per catalog is simply that.
  546.             When CATDISK starts, it allocates its work space according to this
  547.             setting.  There are currently four possible settings; which one you
  548.             pick is largely dependent upon the environment in which CATDISK is
  549.             to be run.
  550.  
  551.                 These settings are:       DISKS       # FILES
  552.  
  553.                                            2000     32767 (32K)
  554.                                            1500     24576 (24K)
  555.                                            1000     16384 (16K)
  556.                                             500      8192 ( 8K)
  557.  
  558.  
  559.         COLOR CUSTOMIZATION
  560.  
  561.         If you are running on a color monitor and have the color setting in the
  562.         main configuration set to COLOR, you may set your own screen colors if
  563.         you happen to dislike the color scheme that comes with CATDISK.  To do
  564.         so, simply hit <F9> from the configuration screen and follow the menus.
  565.         Once you have selected this option, you will see a menu that will allow
  566.         you to select some general colors such as screen background and border
  567.         color (CGA type displays only - EGA and VGA have no effect), as well as
  568.         an option to reset the author's (that's me!) colors should you really
  569.         make a mess of the color scheme and wish to start over.
  570.  
  571.         The other options will bring up menus that pertain to the various
  572.         screens that you might encounter in your usage of CATDISK.  When you
  573.         reach these, there will be an option available for each item that will
  574.         change its foreground or background color.  Selecting an option will
  575.         step you through the possible color range for that particular item.
  576.  
  577.         Sound confusing?  Try it for yourself... it's really quite easy.  For
  578.         starters, try setting everything to green on cyan <grin> (if you don't
  579.         have a strong stomach, don't bother).
  580.  
  581.         Once you have set all the fields set to your desired settings, you may
  582.         instruct CDISKCFG to save the current settings by pressing <F10>.  Upon
  583.         completion, you will be returned to DOS.
  584.  
  585.         If you do not wish to save the changes you made, simply hit <Esc>, and
  586.         you will be returned to DOS, while the previous configuration will
  587.         remain unscathed.
  588.  
  589.  
  590.  
  591.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  592.  
  593.                                        Page 8
  594.  
  595.  
  596.  
  597.         DEFAULT SETTINGS
  598.  
  599.         1) Screen Update Method:              BIOS
  600.  
  601.         2) Color or B & W:                    B & W
  602.  
  603.         3) Disk Caching:                      0 K (Disabled)
  604.  
  605.         4) Output Lines Per Page:             58
  606.  
  607.         5) Printer Startup String:            Nothing
  608.  
  609.         6) Printer Finishing String:          Nothing
  610.  
  611.         7) Default ARCHIVE Extract State:     ON
  612.  
  613.         8) Catalog Drive:                     A:
  614.  
  615.         9) Catalog File Directory:            Default Drive and Directory
  616.  
  617.         10) Maximum Disks/Files per Catalog:  1000/16384
  618.  
  619.         11) Color Scheme:                     Authors Colors
  620.  
  621.  
  622.  
  623.         UPGRADING FROM V3.61 OR LATER
  624.  
  625.         Before copying the new program files to your work disk, you might want
  626.         to rename the executable file from the previous installation
  627.         (CATDISK.COM or CATDISK.EXE) to another name.  The configuration
  628.         utility, CDISKCFG.EXE has the ability to read the configuration
  629.         information from the release that you were using for easy installation
  630.         into this release.  This can save you some time in setting the program
  631.         up for your preferences, particularly if you've customized all the
  632.         screen colors.
  633.  
  634.         Example - Upgrading from V3.71 to this release:
  635.  
  636.         Procedure:
  637.  
  638.         1)  Rename your old CATDISK.EXE to CAT371.EXE (this file holds the
  639.             configuration information from the last installation.
  640.  
  641.         2)  Run the configuration utility, CDISKCFG.EXE.
  642.  
  643.         3)  Hit <F8>.  CDISKCFG will ask you for the file name of the old
  644.             program file.  Answer "CAT371.EXE" (without the quotes).
  645.  
  646.         4)  A list of supported version numbers will appear at the bottom of
  647.             the screen, with the first entry highlighted.  Use the arrow keys
  648.             to select V3.71 from the list.
  649.  
  650.         5)  Hit <Return> or <Enter> on your keyboard.  CDISKCFG will read in
  651.             the previous configuration information from CAT371.EXE and display
  652.             it on your screen.
  653.  
  654.         6)  Delete CAT371.EXE - it's no longer needed.
  655.  
  656.  
  657.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  658.  
  659.                                        Page 9
  660.  
  661.  
  662.  
  663.         GENERAL CONSIDERATIONS WHEN CONFIGURING CATDISK
  664.  
  665.         When setting CATDISK up, there are a few things you should consider:
  666.  
  667.         If you have a hard disk, you should use it for maintaining your catalog
  668.         files (i.e. set your catalog file directory to somewhere on your hard
  669.         drive).
  670.  
  671.         If possible, set your video update method to DIRECT.  CATDISK runs
  672.         faster in this mode.
  673.  
  674.         If you are using a hard drive or a ram disk to hold your catalog files,
  675.         you should NOT use CATDISK's caching feature.  The cache built into
  676.         CATDISK is meant to aid those with floppy disk based systems when doing
  677.         multiple searches through the catalog file.  Using the cache while
  678.         updating a catalog files imposes additional overhead on the operation.
  679.         It is negligible on floppy based systems, as the bottleneck in the
  680.         operation is the disk itself - on hard drives, it is noticeable.  If
  681.         possible, using one of the commercially available disk caching systems
  682.         is recommended, as they incorporate features into their programs such
  683.         as being able to use extended and expanded memory and the like that are
  684.         not feasible to include in CATDISK.
  685.  
  686.         When setting your printer up for printing reports, try to set the
  687.         printer startup string such that the complete catalog listing (i.e.
  688.         files, stats and comments) can be printed.
  689.  
  690.         The best setting for the default ARCHIVE extract state is QUERY.  Many
  691.         archives do not need to be fully extracted as the name of the archive
  692.         filename itself is all that is necessary in order to identify what is
  693.         on that particular disk.  By using some discretion in deciding which
  694.         archive files need be extracted, you can dramatically reduce the size
  695.         of your catalog files (as well as the time needed to update and search
  696.         them).  Some however, need to be extracted (for example, MISC.ARC).
  697.         This setting gives you the best of both worlds.
  698.  
  699.         When setting the default drive and directory for your catalog files, be
  700.         sure and include it in your DOS PATH as well.  Although this is not
  701.         necessary, it will enable you to run CATDISK from anywhere in your
  702.         system without having to change to that directory before running
  703.         CATDISK.  Setting the PATH for this is only beneficial to those using
  704.         hard drives.
  705.  
  706.         When setting the maximum number of disks and files that can be
  707.         maintained in a catalog file, the best setting should be the LOWEST one
  708.         that will contain your largest catalog file.  This will maximize the
  709.         amount of free memory left over that CATDISK can use to store file
  710.         information being read from disks being cataloged, sorting information,
  711.         caching information, and the like.
  712.  
  713.         Keep in mind that, if you should have a catalog file grow to your set
  714.         maximum, you can always re-configure CATDISK (memory permitting, of
  715.         course) to accommodate a larger configuration, unless you are already
  716.         at the highest setting.  When you next run CATDISK after making these
  717.         changes, your catalog file will then be able to grow to the new
  718.         setting.
  719.  
  720.         If you are running on floppy drives, use the 8K setting for disks/files
  721.         per catalog.  Your files will never exceed this limitation.
  722.  
  723.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  724.  
  725.                                       Page 10
  726.  
  727.  
  728.  
  729.         SAMPLE CONFIGURATIONS
  730.  
  731.         Scenario:  One Hard Disk (C:) and a floppy drive:
  732.  
  733.                    Make a directory "C:\CATDISK" and copy the files CATDISK.EXE
  734.                    and CDISKCFG.EXE to it.  Set the configuration to:
  735.  
  736.                    1) Screen Update Method:              <your option>
  737.                    2) Color or B & W:                    <your option>
  738.                    3) Disk Caching:                      0 K (Disabled)
  739.                    4) Output Lines Per Page:             <your option>
  740.                    5) Printer Startup String:            <your option>
  741.                    6) Printer Finishing String:          <your option>
  742.                    7) Default ARCHIVE Extract State:     <your option>
  743.                    8) Catalog Drive:                     A:
  744.                    9) Catalog File Directory:            C:\CATDISK
  745.                    10) Maximum Disks/Files per Catalog:  <your option>
  746.                    11) Color Scheme:                     <your option>
  747.     
  748.                    Add C:\CATDISK to the DOS PATH and you will be able to call
  749.                    up CATDISK from anywhere in your system.
  750.  
  751.         Scenario:  Two floppy drives:
  752.  
  753.                    Take a blank disk and copy the files CATDISK.EXE and
  754.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  755.                    Set the configuration to:
  756.  
  757.                    1) Screen Update Method:              <your option>
  758.                    2) Color or B & W:                    <your option>
  759.                    3) Disk Caching:                      <your option>
  760.                    4) Output Lines Per Page:             <your option>
  761.                    5) Printer Startup String:            <your option>
  762.                    6) Printer Finishing String:          <your option>
  763.                    7) Default ARCHIVE Extract State:     <your option>
  764.                    8) Catalog Drive:                     A:
  765.                    9) Catalog File Directory:            B:\
  766.                    10) Maximum Disks/Files per Catalog:  500/8192
  767.                    11) Color Scheme:                     <your option>
  768.  
  769.                    When starting CATDISK for the first time, insert the
  770.                    program disk in drive A: and take a blank formatted disk and
  771.                    insert it in drive B:.  This will be your data disk.  When
  772.                    CATDISK has loaded and has displayed the title screen, you
  773.                    may remove the CATDISK program disk from the A: drive.  This
  774.                    will now be the drive from which disks being cataloged will
  775.                    be read.
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  790.  
  791.                                       Page 11
  792.  
  793.  
  794.  
  795.         Scenario:  One floppy drive:
  796.  
  797.                    Take a blank disk and copy the files CATDISK.EXE and
  798.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  799.                    Set the configuration to:
  800.  
  801.                    1) Screen Update Method:              <your option>
  802.                    2) Color or B & W:                    <your option>
  803.                    3) Disk Caching:                      <your option>
  804.                    4) Output Lines Per Page:             <your option>
  805.                    5) Printer Startup String:            <your option>
  806.                    6) Printer Finishing String:          <your option>
  807.                    7) Default ARCHIVE Extract State:     <your option>
  808.                    8) Catalog Drive:                     A:
  809.                    9) Catalog File Directory:            A:\
  810.                    10) Maximum Disks/Files per Catalog:  500/8192
  811.                    11) Color Scheme:                     <your option>
  812.  
  813.                    When starting CATDISK for the first time, insert the
  814.                    program disk in drive A: and start CATDISK. You will need to
  815.                    add the command line option /IP (initial pause - see later
  816.                    in this manual).
  817.  
  818.                    Once CATDISK has loaded, it will pause and ask you to insert
  819.                    your data disk.  If this is the first time you are running
  820.                    CATDISK, use a blank formatted disk.
  821.                    When you catalog a disk, you must first remove the data disk
  822.                    and insert the disk to be cataloged BEFORE activating the
  823.                    catalog function.  When CATDISK is done reading the disk, it
  824.                    will ask you to re-insert the data disk.
  825.  
  826.  
  827.         IMPORTANT NOTE
  828.  
  829.         If you are running CATDISK on a single drive system, I would recommend
  830.         the above configuration for two reasons, even though DOS can make the
  831.         one drive act like A: and B:.
  832.  
  833.         1) Perhaps the most important reason; if you've activated the disk
  834.            caching feature, is that failure to do so may cause a loss of data
  835.            on disks other than your data disk, particularly when you label a
  836.            disk.  The reason being that the cache built into CATDISK references
  837.            the PHYSICAL hardware, not the logical drive that DOS creates (i.e.
  838.            A: and B: use the SAME piece of equipment).
  839.  
  840.            By setting CATDISK to the above configuration, it will be aware that
  841.            the above situation exists and take the correct action when carrying
  842.            out critical functions.
  843.  
  844.         2) This will allow CATDISK to prompt you for the appropriate disks,
  845.            thus avoiding the DOS prompt "Insert disk for drive B:" and the
  846.            like.
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  856.  
  857.                                       Page 12
  858.  
  859.  
  860.  
  861.         STARTING CATDISK
  862.  
  863.         CATDISK is started from the DOS command line by issuing the following:
  864.  
  865.         CATDISK parameters
  866.  
  867.           - where parameters may include any of the following:
  868.  
  869.                /NP        - Specifying this commandline option will cause
  870.                             CATDISK to eliminate the pause after cataloging/
  871.                             un-cataloging a disk.  It will also eliminate the
  872.                             "Insert a disk in drive X:" prompt unless it is
  873.                             absolutely necessary.
  874.  
  875.                /NW        - Under normal circumstances, when you catalog a
  876.                             disk containing a Volume ID that already exists
  877.                             in the current catalog, CATDISK will issue a
  878.                             warning to that effect, and will ask you for
  879.                             verification before proceeding to catalog that
  880.                             disk.  The reason behind this is that there is
  881.                             always the possibility of two different disks
  882.                             having the same Volume ID.  Cataloging one would
  883.                             mean that the files from the other would be
  884.                             un-cataloged in the same process.
  885.  
  886.                             If you specify the /NW option on the command line,
  887.                             this warning will be suppressed, and the disk will
  888.                             be cataloged without further delay.
  889.  
  890.                /NS        - Suppress status indicators during processing.  This
  891.                             speeds up processing time.  Status indicators are
  892.                             there simply to indicate that the computer is
  893.                             actually doing something useful.  Try it either way
  894.                             and set it to your liking.
  895.  
  896.                /AC        - Turn the auto comment feature ON at startup.
  897.                             Normally, CATDISK, upon completion of cataloging a
  898.                             group of files from a disk will immediately
  899.                             return to the menu.  Activating this feature from
  900.                             the commandline (or from the menu) will cause
  901.                             CATDISK to proceed to the section where you may
  902.                             add/modify the file comments for the volume that
  903.                             you just cataloged.
  904.  
  905.                /Ffilename - The default filename that CATDISK uses is "CATDISK"
  906.                             which may be overridden with this parameter.
  907.                             Note that there is no space between the /F and the
  908.                             filename.
  909.  
  910.                /SD        - CATDISK can display screen information for your
  911.                             catalog in two different formats.  The default is
  912.                             to show the Filename, Volume ID, Arc ID, size,
  913.                             date, time and attributes for each record.  There
  914.                             is a second display format that omits the file
  915.                             attributes, but shows the sub-directory that the
  916.                             file occupies on its disk.  Setting this option
  917.                             will make the second format the starting report
  918.                             type.
  919.  
  920.  
  921.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  922.  
  923.                                       Page 13
  924.  
  925.  
  926.  
  927.                /CO        - similar to above, but the third display format that
  928.                             shows file comments will be the default.
  929.  
  930.           - *** NOTE:  If you specify both /SD and /CO at startup, the LAST one
  931.                        that you specified on the command line will take effect.
  932.  
  933.  
  934.                /ASK       - normally, CATDISK will process a request for a
  935.                             report and send it to the location as set in the
  936.                             toggles section of the program (discussed later in
  937.                             this manual).  Some may find it handy to have
  938.                             CATDISK prompt for a report location each time a
  939.                             report is requested.  This feature will make this
  940.                             the default at startup.
  941.  
  942.                /Px        - Set printer output format to report type x, where x
  943.                             is in the range (0-2).
  944.  
  945.                             x Value  Report Type
  946.                             -------  -----------
  947.  
  948.                                0     Show regular file statistics
  949.                                1     Show file comments
  950.                                2     Show file statistics and comments
  951.                                      (selecting this report style assumes that
  952.                                      your printer is set to produce 132 column
  953.                                      reports)
  954.  
  955.                /D:        - Catalog files from drive D: where D: is one of
  956.                             [A - {last drive in your system}].
  957.  
  958.                /IP        - Initial Pause.  This parameter will cause CATDISK
  959.                             to pause after it is loaded so that you may remove
  960.                             the program disk (not needed during the session)
  961.                             and insert the data disk. This option is only
  962.                             needed if you are running on a single drive system.
  963.  
  964.           The slash "/" may be substituted by either a dash "-" or a space " ".
  965.  
  966.           Eg.  CATDISK /FGAMES/NS/AC/CO/P2/B:   or  CATDISK A:
  967.  
  968.         - entering CATDISK ? will bring up a help message indicating the above.
  969.  
  970.         **NOTE:  You may also put the command line options in a DOS environment
  971.         string using the DOS "SET" command.  This command (examples are below),
  972.         may be placed in your AUTOEXEC.BAT file so that you will not need to
  973.         remember which command line options to use to obtain your favorite
  974.         setup, or for that matter, to type them!
  975.  
  976.         - example:  SET CATDISK=/FGAMES/NS/AC/CO/P2/B:
  977.  
  978.         When you start CATDISK under these circumstances, simply type "CATDISK"
  979.         <Enter> and the above options will automatically be invoked.
  980.  
  981.         Please note that if you enter any command line options when starting
  982.         CATDISK, the DOS environment area will be ignored.
  983.  
  984.         Once CATDISK has been successfully started, a title screen will appear.
  985.         Hit any key to ascend to the main menu.
  986.  
  987.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  988.  
  989.                                       Page 14
  990.  
  991.  
  992.  
  993.                              3.  U S I N G   C A T D I S K
  994.  
  995.  
  996.         USING THE MENUS
  997.  
  998.         The major options available from CATDISK such as the main functions
  999.         that you see in the opening menu after the title page disappears can be
  1000.         selected in two different ways.
  1001.  
  1002.         The first, and easiest is just to hit the indicated key beside the
  1003.         desired option.
  1004.  
  1005.         In response to a few requests from registered users, I have also
  1006.         implemented a "point and shoot" method of selecting items from a menu.
  1007.  
  1008.         Simply use the cursor keys to position the flashing arrows in the
  1009.         inverse box that indicates the keystroke required to activate the
  1010.         desired option and hit <Return> (or <CR> to you C programmers).  This
  1011.         will carry out the same function as if you had struck the key in the
  1012.         inverse box.
  1013.  
  1014.         One advantage that the second approach has to the first is that those
  1015.         of you who do not touch type numbers very well (or have a tendency to
  1016.         hit the key beside the one you are after) have another avenue to use to
  1017.         navigate through the menus of CATDISK.
  1018.  
  1019.         Another is that once you have activated a function such as cataloging a
  1020.         disk, you need only type <Return> to re-activate that function as
  1021.         CATDISK will remember the last option you activated (quite handy if you
  1022.         are cataloging multiple disks, as the <Return> key is larger than
  1023.         most... you aren't as apt to miss it).
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1054.  
  1055.                                       Page 15
  1056.  
  1057.  
  1058.  
  1059.         OPTION 1 - SET DRIVE FOR CATALOGING
  1060.  
  1061.         This function allow you to set the drive from which the files to be
  1062.         cataloged will be read.  Simply select letter from (A - x) to select
  1063.         the drive with that DOS letter designation, where x is the last drive
  1064.         that CATDISK detected in your system configuration.  The change will be
  1065.         noted immediately in the status area at the top of the screen.
  1066.  
  1067.         *** NOTE:  If you are running with one floppy drive only and have
  1068.                    turned the caching option on from the configuration utility,
  1069.                    do not set this option to a drive other than the one on
  1070.                    which the catalog files reside (probably A:).  Failure to do
  1071.                    so could cause loss of data on your disks.
  1072.                    See the SAMPLE CONFIGURATIONS section covered earlier in
  1073.                    this section.  You have been warned!
  1074.  
  1075.         Users with a hard-disk, single floppy configuration, who are running
  1076.         CATDISK from the hard disk will NOT experience this problem and may
  1077.         proceed as normal.  It's ONLY if the same PHYSICAL drive is being used
  1078.         for the CATDISK work files AND the disk to be cataloged that the
  1079.         above precautions must be taken.
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1120.  
  1121.                                       Page 16
  1122.  
  1123.  
  1124.  
  1125.         OPTION 2:  SETTINGS AND TOGGLES MENU
  1126.  
  1127.         The options available in this sub-menu will allow you to control the
  1128.         behavior of some of the features of CATDISK.  You can get to this menu
  1129.         by selecting option #2 from the main menu.
  1130.  
  1131.         The options available on this menu are:
  1132.  
  1133.  
  1134.         Sub-option 1 - Set Current Report Destination
  1135.         ----------------------------------------------
  1136.  
  1137.         Selecting this option will affect the report destination and whether or
  1138.         not CATDISK will ask you where the report should go.  Each time you
  1139.         select option 1, CATDISK will run through through a sequence of five
  1140.         possible locations (Screen, LPT1, LPT2, Disk, or ASK ME).
  1141.  
  1142.         Selecting one of the first four will cause CATDISK to immediately
  1143.         generate a report to the selected destination IMMEDIATELY upon
  1144.         selecting it.  You will not be prompted any further, unless you have
  1145.         selected DISK, in which case, you will be asked for a filename in which
  1146.         to place the report.
  1147.  
  1148.         If you select ASK ME, CATDISK will prompt you for a report location
  1149.         (one of the first four in the list) each time you ask it to generate a
  1150.         report.
  1151.  
  1152.         I usually leave this setting set to SCREEN as, most of the time, I
  1153.         browse through my catalog files on the screen.  You, however, may find
  1154.         it handy to set this to ASK ME, especially if you jump to report
  1155.         locations frequently.  If this is the case, you may, if you haven't
  1156.         already, add the command line option /ASK to your current list of
  1157.         options.  This will override the default location of SCREEN at startup,
  1158.         negating the need to set it manually each time you start CATDISK.
  1159.  
  1160.  
  1161.         Sub-option 2 - Toggle Auto ARCHIVE Extract
  1162.         -------------------------------------------
  1163.  
  1164.         Although this setting is permanently set from the CDISKCFG utility, it
  1165.         is can sometimes be convenient to be able to change it during a CATDISK
  1166.         session.  Selecting option 2 will run the Auto ARCHIVE Extract setting
  1167.         through three possibilities, OFF, ON, or QUERY.  The current setting is
  1168.         shown near the top of the screen in the status area.
  1169.  
  1170.         If this feature is turned OFF, any file searches through the catalog,
  1171.         with the exception of OPTION #0 - Show All Files, will NOT show any
  1172.         files that reside in an archive file.  The archive file's presence will
  1173.         still be shown in the listing.
  1174.  
  1175.         If this feature is turned ON, CATDISK will extract the archive
  1176.         directory of any archive it encounters in its search.
  1177.  
  1178.         If it is set to QUERY, CATDISK will prompt you as to whether it should
  1179.         extract the archive directory of any archive that it encounters in its
  1180.         search before proceeding to do so.  Reports generated will act as if
  1181.         the feature is turned ON.
  1182.  
  1183.  
  1184.  
  1185.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1186.  
  1187.                                       Page 17
  1188.  
  1189.  
  1190.  
  1191.         Sub-option 3 - Set Current Catalog File
  1192.         ----------------------------------------
  1193.  
  1194.         Although the catalog filename may be set upon starting up CATDISK, is
  1195.         may also be convenient to be able to change the current file from
  1196.         within a CATDISK session.  Select option #3 from the main menu, and you
  1197.         will be prompted for a new catalog file to use.  Any valid dos filename
  1198.         will do.  Be sure to specify the NAME portion only; do not include the
  1199.         file extension portion.  If the name you specify is valid, it will then
  1200.         be used for all subsequent catalog updates and queries (This is
  1201.         reflected at the top of the screen).  If not, an error message will be
  1202.         issued and no change will be made to the current catalog file name.
  1203.  
  1204.         If you are switching to a catalog that already exists,and it will not
  1205.         fit into the configuration you defined in the configuration program
  1206.         (maximum disks/files per catalog), you will get an error message and
  1207.         the catalog file setting will be left unchanged.
  1208.  
  1209.  
  1210.         Sub-option 4 - Pause For Disk Change or At End of Catalog Update
  1211.         -----------------------------------------------------------------
  1212.  
  1213.         Under normal circumstances, CATDISK will pause at strategic places,
  1214.         either to allow you to view what has just happened (cataloging and
  1215.         un-cataloging), or to prompt you to insert a disk in drive X:
  1216.         (labeling or reading directories, etc).  If you turn this toggle off,
  1217.         CATDISK will only prompt you for a disk when absolutely necessary.  In
  1218.         addition, there will be no pause at the end of a catalog update; you
  1219.         will immediately be returned to the main menu, or to the comment entry
  1220.         screen if you have the AUTO COMMENT feature turned on.
  1221.  
  1222.  
  1223.         Sub-option 5 - Add/Update File Comments While Cataloging
  1224.         ----------------------------------------------------------
  1225.  
  1226.         If this toggle is turned off, CATDISK will proceed back to the main
  1227.         menu upon completion of the process of cataloging a disk.  If you wish
  1228.         to add comments for some/all of the files that you have just
  1229.         cataloged, you may turn this toggle on.  When this is the case,
  1230.         CATDISK will catalog files in the normal manner, but upon completion,
  1231.         you will be taken to another screen that will allow you to scroll
  1232.         through the files you just cataloged and add/update the comments for
  1233.         each file shown.  See Option F1 - Add/Change File Comments for details
  1234.         on how this section of the program works.
  1235.  
  1236.  
  1237.         Sub-option 6 - Toggle Printer Report Type
  1238.         ------------------------------------------
  1239.  
  1240.         CATDISK currently supports three printer report styles, which are
  1241.         detailed here.  The particular report style that you desire may be set
  1242.         with this toggle, and will be reflected in the toggles portion of the
  1243.         menu screen.
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1252.  
  1253.                                       Page 18
  1254.  
  1255.  
  1256.  
  1257.         STATISTICS:  This is the default report style (unless overridden on the
  1258.                      command line), which is to show the path, filename, volume
  1259.                      id, ARCHIVE id, as well as the size, date, time and DOS
  1260.                      directory attributes of each file listed.
  1261.  
  1262.                      This report style corresponds to the command line option
  1263.                      /P0, and will fit on an 80 column printer.
  1264.  
  1265.           COMMENTS:  This report style will substitute file comments for the
  1266.                      size, date, time, and DOS directory attribute.
  1267.  
  1268.                      This report style corresponds to the command line option
  1269.                      /P1, and will fit on an 80 column printer.
  1270.  
  1271.           BOTH:      This report style will show all of the fields from the two
  1272.                      above reports.  Please note that it assumes that you
  1273.                      either have a 132 column printer, or an 80 column printer
  1274.                      set to compressed mode.
  1275.  
  1276.                      It corresponds to the command line option /P2.
  1277.  
  1278.  
  1279.  
  1280.         Sub-option <Esc> - Return To Main Menu
  1281.         --------------------------------------
  1282.  
  1283.         Exactly what it says.
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1318.  
  1319.                                       Page 19
  1320.  
  1321.  
  1322.  
  1323.         OPTION 3:  LABELING A DISK
  1324.  
  1325.         Selection of option #3 on the main menu will allow the VOLUME LABEL of
  1326.         a disk to be set or changed.  Upon selection, CATDISK will attempt to
  1327.         read the current label of the disk.  If none is present, you will be
  1328.         notified of this, and will be given the opportunity to create a volume
  1329.         label for that disk.  See the DOS manual on volume labels for more
  1330.         information.  If a label already exists on the disk, its name will be
  1331.         shown as a reminder, and you will be given an opportunity to change the
  1332.         label name.  Just enter the new label name and hit <CR>.
  1333.  
  1334.         If the label name was valid, the change will be made, otherwise, an
  1335.         error message indicating such will be issued and you will return to the
  1336.         main menu.
  1337.  
  1338.         If you do not wish to enter or change the disk label, simply hit <ESC>
  1339.         at the volume label prompt and you will immediately return to the main
  1340.         menu with no changed made to the disk label.
  1341.  
  1342.         When the volume label has been successfully changed or created, CATDISK
  1343.         will check to see if the old label, if any was present, exists in the
  1344.         current catalog file.  If so, you will be given an opportunity to have
  1345.         CATDISK automatically change the old volume id references to the newly
  1346.         entered one.  If the disk that you re-labeled is one that actually is
  1347.         in the catalog, answer <Y>es to the prompt.  CATDISK will take care of
  1348.         the rest.  This feature can be a great time saver, as it eliminates the
  1349.         need to uncatalog the disk under the old volume id, and re-catalog it
  1350.         under the new name.
  1351.  
  1352.         If the disk is not in the catalog, answer <N>o to the prompt. Answering
  1353.         <Y>es under these circumstances will not damage the catalog file, but
  1354.         will cause confusion as to what disk the altered catalog records reside
  1355.         on.
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1384.  
  1385.                                       Page 20
  1386.  
  1387.  
  1388.  
  1389.         OPTION 4:  CATALOGING A DISK
  1390.  
  1391.         This selection will initiate cataloging of the files on the selected
  1392.         catalog disk as shown in the status area at the top of the screen.  The
  1393.         volume label will be read, and if it doesn't exist, you will be given
  1394.         an opportunity to enter a volume label for the disk.  If you hit <ESC>
  1395.         at the label prompt, the operation will be aborted and you will be
  1396.         returned to the main menu without cataloging your disk.  After entering
  1397.         the label name for that disk, you will be asked if you wish to write
  1398.         that label to disk.  If you answer <Y>es, the disk will be labeled and
  1399.         cataloging will continue.  If you answer <N>o, the label will not be
  1400.         written, but the disk will be cataloged under the name that you gave
  1401.         it.  This will allow easy cataloging of write-protected disks.
  1402.  
  1403.         Please note that volume labels created by Peter Norton's "Volabel"
  1404.         utility may contain lower case characters.  CATDISK will convert the
  1405.         labels to upper case before adding them to the catalog.  This will
  1406.         enable you to manipulate and uncatalog any of these disks.  The
  1407.         physical volume label on the disk will be left unchanged.
  1408.  
  1409.         If the label on the disk to be cataloged already exists in the
  1410.         catalog, you will be notified of this situation, and will be given an
  1411.         opportunity to abort the operation.  This feature has been added as a
  1412.         safeguard against a situation where two disks of the same volume id may
  1413.         be overriding each other and clobbering the catalog contents of the
  1414.         other disk.  If you specified the "/NW" option on at startup, this
  1415.         warning will not be issued.
  1416.  
  1417.         Once the label has been found, the directory and any archive or library
  1418.         entries (if the ARCHIVE auto extract feature option is turned on - it
  1419.         is by default) will be read (if the ARCHIVE auto extract is set to
  1420.         QUERY, you will be asked for verification before a given archive or
  1421.         Library will be read).  This process will be repeated for each
  1422.         sub-directory on the disk as well.  All existing levels of
  1423.         sub-directories will be searched.
  1424.  
  1425.         Upon completion of this, the catalog summary file and master catalog
  1426.         will be updated to reflect the current directory/directories of the
  1427.         disk.  If any files have been added, they will be added to the catalog;
  1428.         if any files have been changed, they will be updated;  if any files
  1429.         have been deleted, they will be removed from the catalog.
  1430.  
  1431.         Keep in mind, that deletion of an ARCHIVE file will cause any files
  1432.         existing within that ARCHIVE file to be uncataloged.  Also, turning the
  1433.         Auto ARCHIVE Extraction feature OFF, or answering <No> to a Extract
  1434.         ARCHIVE prompt to a cataloged ARCHIVE will cause any files in an
  1435.         ARCHIVE file on that disk to be uncataloged as well.
  1436.  
  1437.         Should the disk become full when the cataloging process is underway,
  1438.         the process will be aborted with an error message.  The old catalog
  1439.         file will remain intact (i.e. no changes made), but the summary file
  1440.         will reflect either the presence of the new disk, or the current status
  1441.         of that disk if it already existed in the catalog.  This means that the
  1442.         catalog file will not be accurate as to what's on the disk that you
  1443.         attempted to catalog.   If this error is encountered, you should either
  1444.         try to free up some space on disk on which the catalog file exists, or
  1445.         move the .DTA and .SUM files to another disk (see CONFIGURING CATDISK
  1446.         for details on how to access catalog files on other drives and
  1447.         directories) and retry the operation.
  1448.  
  1449.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1450.  
  1451.                                       Page 21
  1452.  
  1453.  
  1454.  
  1455.         This operation is completely automatic and does not require any further
  1456.         input from the operator once started, unless, of course, the ARCHIVE
  1457.         extract state is set to QUERY.
  1458.  
  1459.         If you have turned on the auto-comment feature either from the
  1460.         command line or from the toggles menu, you will be taken to a section
  1461.         of the program that will allow you to add/update file comments.
  1462.         See "<F1> - Adding/Updating File Comments" later in this manual for
  1463.         details.
  1464.  
  1465.         Please keep in mind that CATDISK has an internal limitation of being
  1466.         able to read in only the first 5000 files of the disk being cataloged.
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1516.  
  1517.                                       Page 22
  1518.  
  1519.  
  1520.  
  1521.         OPTION 5:  UNCATALOGING A DISK
  1522.  
  1523.         There may be times when you will wish to remove a disk's files from the
  1524.         catalog.  Select option #5 from the main menu, and you will be asked to
  1525.         enter the VOLUME NAME of the disk to be uncataloged.  Enter it and hit
  1526.         <CR>.  If the volume label doesn't exist in the catalog, then you will
  1527.         be notified and returned to the main menu.
  1528.  
  1529.         If the volume label is found in the catalog, its entry will be deleted
  1530.         along with all the file names under it.
  1531.  
  1532.         If you do not wish to carry out this operation, hit <Esc> at the volume
  1533.         label prompt and no action will be taken.
  1534.  
  1535.         Should the disk become full during the catalog update process, the
  1536.         process will be aborted with an error message, and the old catalog file
  1537.         will remain intact.  Typically, this error should not occur, unless you
  1538.         have added more files to the disk, or another program has used up more
  1539.         disk space (such as a database expanding a file).  Should this error
  1540.         occur, the summary file will no longer contain a reference to the
  1541.         diskette that was uncataloged, but the catalog file will still contain
  1542.         references to that diskette.
  1543.  
  1544.         Should this be the case, you should either free up some space on the
  1545.         disk, or copy the .SUM and .DTA files to another disk (see CONFIGURING
  1546.         CATDISK for details on accessing catalog files on other drives and
  1547.         directories), catalog the diskette in question, and uncatalog it again.
  1548.         This will remove any references to that disk from the catalog file.
  1549.  
  1550.         If you do not have access to that disk anymore (you may have erased
  1551.         it), simply take a blank diskette, add one file to it, and label it the
  1552.         same as the diskette you wish to uncatalog.  Carry out the above
  1553.         procedure, and you will obtain the same results.
  1554.  
  1555.         In practice, this should not happen, as you would have needed
  1556.         sufficient disk space to create the catalog file in the first place.
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1582.  
  1583.                                       Page 23
  1584.  
  1585.  
  1586.  
  1587.         OPTION 6:  SHOW DISK SUMMARY
  1588.  
  1589.         Selection of option #6 from the main menu will cause CATDISK to display
  1590.         an alphabetical list of VOLUME NAMES and some pertinent statistical
  1591.         information  for each.  This option is handy if, say, you have a bunch
  1592.         of utility disks and want to add a 14K utility program to one of them.
  1593.         This report can be quite useful in making efficient use of existing
  1594.         working diskettes.
  1595.  
  1596.         All the statistical items shown should be self-explanatory, except one;
  1597.         that is, the Slack % factor.  The disks on which DOS stores it files
  1598.         are divided into allocation units called clusters.  The size of each
  1599.         cluster varies with the type and size of disk.  When DOS allocates
  1600.         space on a disk for a file, it is allotted in one cluster units to the
  1601.         file.  Some common cluster sizes are 512 bytes on 160-180K diskettes,
  1602.         and 1024 bytes on 320-360K diskettes.  Some hard disks have larger
  1603.         cluster sizes.
  1604.  
  1605.         Anyway, let's say, for example, that you have a file of 256 bytes.  On
  1606.         a 360K diskette, DOS will allocate 1024 bytes to the file, even though
  1607.         it is only 256 bytes long.  This means that three-quarters of that
  1608.         cluster is unused, or that you have 75% slack for that file.  The
  1609.         figure that you see on the summary report is the overall slack
  1610.         percentage of all the files on the disk.
  1611.  
  1612.         Depending on where you have set your output destination, the following
  1613.         options are applicable:
  1614.  
  1615.         Printer:  A hardcopy summary report will be printed on your printer.
  1616.                   The disk volume names will be echoed to the screen as they
  1617.                   are sent to the printer.  Hitting <Esc> at any time during
  1618.                   report generation will abort it and return to the main menu.
  1619.  
  1620.         Disk:     A listing in the same format as the hardcopy summary report
  1621.                   will be produced in a diskette file.  The default name for
  1622.                   this file is one with the same name as the current catalog
  1623.                   filename with an extension of ".LST".  This may be overridden
  1624.                   at the time that the report is generated.  Hitting <Esc> at
  1625.                   any time during the generation of the report will abort it
  1626.                   and return to the main menu.
  1627.  
  1628.         Screen:   This will allow you to browse through your summary report on
  1629.                   the screen.  Keystrokes available are as follows:
  1630.  
  1631.                   <Cursor UP>   - move up one line in the report.  The screen
  1632.                                   contents will scroll down to make room for
  1633.                                   the new line appearing at the top.
  1634.  
  1635.                   <Cursor DOWN> - move down one line in the report.  The screen
  1636.                                   contents will scroll up to make room for the
  1637.                                   new line appearing at the bottom.
  1638.  
  1639.                   <PgUp>        - move up one page (15 lines) in the report.
  1640.  
  1641.                   <PgDn>        - move down one page (15 lines) in the report.
  1642.  
  1643.                   <Home>        - move to the beginning of the report.
  1644.  
  1645.                   <End>         - move to the end of the report.
  1646.  
  1647.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1648.  
  1649.                                       Page 24
  1650.  
  1651.  
  1652.  
  1653.                   <Grey Plus>   - move down through the report 1/15th of the
  1654.                                   total length of the report (see the appendix
  1655.                                   regarding the SCROLL BAR later in this
  1656.                                   manual).
  1657.  
  1658.                   <Grey Minus>  - move up through the report 1/15th of the
  1659.                                   total length of the report (see the appendix
  1660.                                   regarding the SCROLL BAR later in this
  1661.                                   manual).
  1662.  
  1663.                   <Esc>         - return to the menu.
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1714.  
  1715.                                       Page 25
  1716.  
  1717.  
  1718.  
  1719.         OPTION 7:  SHOW FILES FOR A VOLUME
  1720.  
  1721.         Selecting option #7 will cause CATDISK to display an alphabetical list
  1722.         of files for a particular disk.  If you have the report destination set
  1723.         to "ASK ME", you will be asked for a report location.  After the report
  1724.         destination is established, you will be asked for a volume ID.  Simply
  1725.         enter it and hit <Return>, or hit <Esc> to return to the menu without
  1726.         producing a report.
  1727.  
  1728.         Depending on where you have set your output destination, the following
  1729.         options are applicable:
  1730.  
  1731.         Printer:  A hardcopy file report will be printed on your printer. The
  1732.                   filenames will be echoed to the screen as they are sent to
  1733.                   the  printer.  Hitting <Esc> at any time during report
  1734.                   generation will abort it and return to the main menu.
  1735.  
  1736.         Disk:     A listing in the same format as the hardcopy file report will
  1737.                   be produced in a diskette file.  The default name for this
  1738.                   file is one with the same name as the current catalog
  1739.                   filename with an extension of ".LST".  This may be overridden
  1740.                   at the time that the report is generated.  Hitting <Esc> at
  1741.                   any time during the generation of the report will abort it
  1742.                   and return to the main menu.
  1743.  
  1744.         Screen:   Upon entering the search spec, scanning of the catalog will
  1745.                   commence.  If you have status indicators turned on, a counter
  1746.                   will increment each time a matching file is found.  If at the
  1747.                   and of the search, no files were found, an error message will
  1748.                   be issued and you will be returned to the main menu.
  1749.  
  1750.                   When the search has completed successfully, the file names
  1751.                   will be shown alphabetically, along with the volume name,
  1752.                   archive name, and  other directory information for that file.
  1753.  
  1754.                   Applicable options are as follows:
  1755.  
  1756.                   <Cursor UP>   - move up one line in the report.  The screen
  1757.                                   contents will scroll down to make room for
  1758.                                   the new line appearing at the top.
  1759.  
  1760.                   <Cursor DOWN> - move down one line in the report.  The screen
  1761.                                   contents will scroll up to make room for the
  1762.                                   new line appearing at the bottom.
  1763.  
  1764.                   <PgUp>        - move up one page (15 lines) in the report.
  1765.  
  1766.                   <PgDn>        - move down one page (15 lines) in the report.
  1767.  
  1768.                   <Home>        - move to the beginning of the report.
  1769.  
  1770.                   <End>         - move to the end of the report.
  1771.  
  1772.                   <Grey Plus>   - move down through the report 1/15th of the
  1773.                                   total length of the report (see the appendix
  1774.                                   regarding the SCROLL BAR later in this
  1775.                                   manual).
  1776.  
  1777.  
  1778.  
  1779.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1780.  
  1781.                                       Page 26
  1782.  
  1783.  
  1784.  
  1785.                   <Grey Minus>  - move up through the report 1/15th of the
  1786.                                   total length of the report (see the appendix
  1787.                                   regarding the SCROLL BAR later in this
  1788.                                   manual).
  1789.  
  1790.                   <N>           - change report format to show a standard
  1791.                                   (normal) file report. This is the default if
  1792.                                   you do not specify either /SD or /CO when you
  1793.                                   start CATDISK.
  1794.  
  1795.                   <S>           - change report format to show sub-directories.
  1796.                                   If a sub-directory begins with a tilde (~),
  1797.                                   that means that the sub-directory shown is a
  1798.                                   sub-directory past the first level (i.e.
  1799.                                   a sub-directory within a sub-directory).
  1800.                                   If you wish to have this report format come
  1801.                                   up by default when starting CATDISK, simply
  1802.                                   add /SD to your command line with which you
  1803.                                   invoke CATDISK.
  1804.  
  1805.                   <C>           - change the report format to any comments you
  1806.                                   might have entered for the shown catalog
  1807.                                   entries. If you wish this display format to
  1808.                                   appear by default, use the /CO option when
  1809.                                   starting CATDISK.
  1810.  
  1811.                   <Esc>         - return to the menu.
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1846.  
  1847.                                       Page 27
  1848.  
  1849.  
  1850.  
  1851.         OPTION 8:  SHOW FILES FOR AN ARCHIVE
  1852.  
  1853.         Selecting option #8 will cause CATDISK to display an alphabetical list
  1854.         of files for a particular archive.  If you have the report destination
  1855.         set to "ASK ME", you will be asked for a report location.  After the
  1856.         report destination is established, you will be asked for a Archive to
  1857.         list.  Simply enter it and hit <Return>, or hit <Esc> to return to the
  1858.         menu without producing a report.
  1859.  
  1860.         Depending on where you have set your output destination, the following
  1861.         options are applicable:
  1862.  
  1863.         Printer:  A hardcopy file report will be printed on your printer. The
  1864.                   filenames will be echoed to the screen as they are sent to
  1865.                   the  printer.  Hitting <Esc> at any time during report
  1866.                   generation will abort it and return to the main menu.
  1867.  
  1868.         Disk:     A listing in the same format as the hardcopy file report will
  1869.                   be produced in a diskette file.  The default name for this
  1870.                   file is one with the same name as the current catalog
  1871.                   filename with an extension of ".LST".  This may be overridden
  1872.                   at the time that the report is generated.  Hitting <Esc> at
  1873.                   any time during the generation of the report will abort it
  1874.                   and return to the main menu.
  1875.  
  1876.         Screen:   Upon entering the search spec, scanning of the catalog will
  1877.                   commence.  If you have status indicators turned on, a counter
  1878.                   will increment each time a matching file is found.  If at the
  1879.                   and of the search, no files were found, an error message will
  1880.                   be issued and you will be returned to the main menu.
  1881.  
  1882.                   When the search has completed successfully, the file names
  1883.                   will be shown alphabetically, along with the volume name,
  1884.                   archive name, and  other directory information for that file.
  1885.  
  1886.                   Applicable options are as follows:
  1887.  
  1888.                   <Cursor UP>   - move up one line in the report.  The screen
  1889.                                   contents will scroll down to make room for
  1890.                                   the new line appearing at the top.
  1891.  
  1892.                   <Cursor DOWN> - move down one line in the report.  The screen
  1893.                                   contents will scroll up to make room for the
  1894.                                   new line appearing at the bottom.
  1895.  
  1896.                   <PgUp>        - move up one page (15 lines) in the report.
  1897.  
  1898.                   <PgDn>        - move down one page (15 lines) in the report.
  1899.  
  1900.                   <Home>        - move to the beginning of the report.
  1901.  
  1902.                   <End>         - move to the end of the report.
  1903.  
  1904.                   <Grey Plus>   - move down through the report 1/15th of the
  1905.                                   total length of the report (see the appendix
  1906.                                   regarding the SCROLL BAR later in this
  1907.                                   manual).
  1908.  
  1909.  
  1910.  
  1911.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1912.  
  1913.                                       Page 28
  1914.  
  1915.  
  1916.  
  1917.                   <Grey Minus>  - move up through the report 1/15th of the
  1918.                                   total length of the report (see the appendix
  1919.                                   regarding the SCROLL BAR later in this
  1920.                                   manual).
  1921.  
  1922.                   <N>           - change report format to show a standard
  1923.                                   (normal) file report. This is the default if
  1924.                                   you do not specify either /SD or /CO when you
  1925.                                   start CATDISK.
  1926.  
  1927.                   <S>           - change report format to show sub-directories.
  1928.                                   If a sub-directory begins with a tilde (~),
  1929.                                   that means that the sub-directory shown is a
  1930.                                   sub-directory past the first level (i.e.
  1931.                                   a sub-directory within a sub-directory).
  1932.                                   If you wish to have this report format come
  1933.                                   up by default when starting CATDISK, simply
  1934.                                   add /SD to your command line with which you
  1935.                                   invoke CATDISK.
  1936.  
  1937.                   <C>           - change the report format to any comments you
  1938.                                   might have entered for the shown catalog
  1939.                                   entries. If you wish this display format to
  1940.                                   appear by default, use the /CO option when
  1941.                                   starting CATDISK.
  1942.  
  1943.                   <Esc>         - return to the menu.
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  1978.  
  1979.                                       Page 29
  1980.  
  1981.  
  1982.  
  1983.         OPTION 9:  SHOW SELECTED FILES
  1984.  
  1985.         Selecting option #9 will cause CATDISK to display an alphabetical list
  1986.         of files.  If you have the report destination set to "ASK ME", you will
  1987.         be asked for a report location.  After the report destination is
  1988.         established, you will be asked for a filespec.  This filespec follows
  1989.         the conventional DOS filespec search conventions including wildcard
  1990.         searches.  Hit <Esc> to return to the menus without generating a
  1991.         report.
  1992.  
  1993.         Examples:
  1994.  
  1995.               *.*        - search for everything.
  1996.               *.COM      - search for files ending in .COM
  1997.              A*.EXE      - search for files starting with A and ending in .COM
  1998.         CATDISK.COM      - search specifically for CATDISK.COM
  1999.               *.?Q?      - search for files with an extension containing Q as
  2000.                            its second character.
  2001.              ??.DOC      - search for files with two letters as it filename and
  2002.                            .DOC as its extension.
  2003.  
  2004.         Please refer to the DOS manual for further information on file
  2005.         searching patterns.
  2006.  
  2007.         Depending on where you have set your output destination, the following
  2008.         options are applicable:
  2009.  
  2010.         Printer:  A hardcopy file report will be printed on your printer. The
  2011.                   filenames will be echoed to the screen as they are sent to
  2012.                   the  printer.  Hitting <Esc> at any time during report
  2013.                   generation will abort it and return to the main menu.
  2014.  
  2015.         Disk:     A listing in the same format as the hardcopy file report will
  2016.                   be produced in a diskette file.  The default name for this
  2017.                   file is one with the same name as the current catalog
  2018.                   filename with an extension of ".LST".  This may be overridden
  2019.                   at the time that the report is generated.  Hitting <Esc> at
  2020.                   any time during the generation of the report will abort it
  2021.                   and return to the main menu.
  2022.  
  2023.         Screen:   Upon entering the search spec, scanning of the catalog will
  2024.                   commence.  If you have status indicators turned on, a counter
  2025.                   will increment each time a matching file is found.  If at the
  2026.                   and of the search, no files were found, an error message will
  2027.                   be issued and you will be returned to the main menu.
  2028.  
  2029.                   When the search has completed successfully, the file names
  2030.                   will be shown alphabetically, along with the volume name,
  2031.                   archive name, and  other directory information for that file.
  2032.  
  2033.                   Applicable options are as follows:
  2034.  
  2035.                   <Cursor UP>   - move up one line in the report.  The screen
  2036.                                   contents will scroll down to make room for
  2037.                                   the new line appearing at the top.
  2038.  
  2039.                   <Cursor DOWN> - move down one line in the report.  The screen
  2040.                                   contents will scroll up to make room for the
  2041.                                   new line appearing at the bottom.
  2042.  
  2043.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2044.  
  2045.                                       Page 30
  2046.  
  2047.  
  2048.  
  2049.                   <PgUp>        - move up one page (15 lines) in the report.
  2050.  
  2051.                   <PgDn>        - move down one page (15 lines) in the report.
  2052.  
  2053.                   <Home>        - move to the beginning of the report.
  2054.  
  2055.                   <End>         - move to the end of the report.
  2056.  
  2057.                   <Grey Plus>   - move down through the report 1/15th of the
  2058.                                   total length of the report (see the appendix
  2059.                                   regarding the SCROLL BAR later in this
  2060.                                   manual).
  2061.  
  2062.                   <Grey Minus>  - move up through the report 1/15th of the
  2063.                                   total length of the report (see the appendix
  2064.                                   regarding the SCROLL BAR later in this
  2065.                                   manual).
  2066.  
  2067.                   <N>           - change report format to show a standard
  2068.                                   (normal) file report. This is the default if
  2069.                                   you do not specify either /SD or /CO when you
  2070.                                   start CATDISK.
  2071.  
  2072.                   <S>           - change report format to show sub-directories.
  2073.                                   If a sub-directory begins with a tilde (~),
  2074.                                   that means that the sub-directory shown is a
  2075.                                   sub-directory past the first level (i.e.
  2076.                                   a sub-directory within a sub-directory).
  2077.                                   If you wish to have this report format come
  2078.                                   up by default when starting CATDISK, simply
  2079.                                   add /SD to your command line with which you
  2080.                                   invoke CATDISK.
  2081.  
  2082.                   <C>           - change the report format to any comments you
  2083.                                   might have entered for the shown catalog
  2084.                                   entries. If you wish this display format to
  2085.                                   appear by default, use the /CO option when
  2086.                                   starting CATDISK.
  2087.  
  2088.                   <Esc>         - return to the menu.
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.     
  2108.  
  2109.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2110.  
  2111.                                       Page 31
  2112.  
  2113.  
  2114.  
  2115.         OPTION 0:  SHOW ALL FILES
  2116.  
  2117.         This option, if viewed on the screen will product a report in the same
  2118.         manner as option #9, except that ALL files in the catalog will be
  2119.         included in the list.  It is similar to choosing option #9 and
  2120.         searching for "*.*".  The only difference is that the catalog scan will
  2121.         not take place, as it is not necessary for this function.  If you have
  2122.         the report destination set to "ASK ME", you will be asked for a report
  2123.         location before any further action takes place.
  2124.  
  2125.         Depending on where you have set your output destination, the following
  2126.         options are applicable:
  2127.  
  2128.         Printer:  A hardcopy file report will be printed on your printer. The
  2129.                   filenames will be echoed to the screen as they are sent to
  2130.                   the  printer.  Hitting <Esc> at any time during report
  2131.                   generation will abort it and return to the main menu.
  2132.  
  2133.         Disk:     A listing in the same format as the hardcopy file report will
  2134.                   be produced in a diskette file.  The default name for this
  2135.                   file is one with the same name as the current catalog
  2136.                   filename with an extension of ".LST".  This may be overridden
  2137.                   at the time that the report is generated.  Hitting <Esc> at
  2138.                   any time during the generation of the report will abort it
  2139.                   and return to the main menu.
  2140.  
  2141.                   Upon selecting one of the above two options, CATDISK will
  2142.                   present a menu allowing you to specify how you want the
  2143.                   report sorted.  You may sort this report by filename, Volume
  2144.                   ID, or ARCHIVE ID.  Simply hit the key beside the appropriate
  2145.                   sort spec, and CATDISK will take care of the rest.
  2146.  
  2147.                   If you decide that you do not want to generate a report at
  2148.                   this time, you may press <Esc> to return to the main menu
  2149.                   without taking any further action.
  2150.  
  2151.                   If, during the sorting process, CATDISK runs into a disk
  2152.                   problem (such as a full disk, or a disk media problem (read
  2153.                   or write error), the process will be aborted and no report
  2154.                   will be produced.
  2155.  
  2156.         Screen:   When the screen is selected as the report destination, the
  2157.                   only option is to have ALL files in the current catalog shown
  2158.                   alphabetically, along with the volume name, archive name, and
  2159.                   other directory information for that file.
  2160.  
  2161.                   Applicable options are as follows:
  2162.  
  2163.                   <Cursor UP>   - move up one line in the report.  The screen
  2164.                                   contents will scroll down to make room for
  2165.                                   the new line appearing at the top.
  2166.  
  2167.                   <Cursor DOWN> - move down one line in the report.  The screen
  2168.                                   contents will scroll up to make room for the
  2169.                                   new line appearing at the bottom.
  2170.  
  2171.                   <PgUp>        - move up one page (15 lines) in the report.
  2172.  
  2173.     
  2174.  
  2175.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2176.  
  2177.                                       Page 32
  2178.  
  2179.  
  2180.  
  2181.                   <PgDn>        - move down one page (15 lines) in the report.
  2182.  
  2183.                   <Home>        - move to the beginning of the report.
  2184.  
  2185.                   <End>         - move to the end of the report.
  2186.  
  2187.                   <Grey Plus>   - move down through the report 1/15th of the
  2188.                                   total length of the report (see the appendix
  2189.                                   regarding the SCROLL BAR later in this
  2190.                                   manual).
  2191.  
  2192.                   <Grey Minus>  - move up through the report 1/15th of the
  2193.                                   total length of the report (see the appendix
  2194.                                   regarding the SCROLL BAR later in this
  2195.                                   manual).
  2196.  
  2197.                   <N>           - change report format to show a standard
  2198.                                   (normal) file report. This is the default if
  2199.                                   you do not specify either /SD or /CO when you
  2200.                                   start CATDISK.
  2201.  
  2202.                   <S>           - change report format to show sub-directories.
  2203.                                   If a sub-directory begins with a tilde (~),
  2204.                                   that means that the sub-directory shown is a
  2205.                                   sub-directory past the first level (i.e.
  2206.                                   a sub-directory within a sub-directory).
  2207.                                   If you wish to have this report format come
  2208.                                   up by default when starting CATDISK, simply
  2209.                                   add /SD to your command line with which you
  2210.                                   invoke CATDISK.
  2211.  
  2212.                   <C>           - change the report format to any comments you
  2213.                                   might have entered for the shown catalog
  2214.                                   entries. If you wish this display format to
  2215.                                   appear by default, use the /CO option when
  2216.                                   starting CATDISK.
  2217.  
  2218.                   <Esc>         - return to the menu.
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2242.  
  2243.                                       Page 33
  2244.  
  2245.  
  2246.  
  2247.         OPTION F1:  ADD/CHANGE FILE COMMENTS
  2248.  
  2249.         There are two places from which this feature can be activated; either
  2250.         at the conclusion of the cataloging process, or from the main menu.
  2251.  
  2252.         If you select <F1> from the main menu, you will get a sub-menu that
  2253.         will allow you to specify one of two methods for deciding which files
  2254.         to bring up on the screen for commenting.
  2255.  
  2256.         If you select sub-option #1, you will be asked to specify a disk
  2257.         volume. Upon entry of such, CATDISK will go through the catalog and
  2258.         bring up a list of files that currently reside on that disk volume.
  2259.  
  2260.         If you select sub-option #2, you will be asked for a filespec on which
  2261.         to base the search.  It functions quite similarly to option #9 (see it
  2262.         for details).
  2263.  
  2264.         If you have the auto-comment feature turned on (either from the command
  2265.         line or the toggles menu), this section will be activated as if you had
  2266.         specified the Volume ID of the disk that you just cataloged; those
  2267.         files will appear on the screen.
  2268.  
  2269.         Once CATDISK has found a group of files for commenting, they will
  2270.         appear on the screen in a format similar to the "COMMENT" screen output
  2271.         format, the main difference being that one of the comments (or blanks)
  2272.         are highlighted in an inverse field.
  2273.  
  2274.         To change a comment, simply move the highlight to the file that you
  2275.         wish to comment, and start typing.  When you are done, hit the <Return>
  2276.         key.
  2277.  
  2278.         Other editing keys are as follows:
  2279.  
  2280.           <Left Arrow>  - move cursor one character to the left.
  2281.           <Right Arrow> - move cursor one key to the right.
  2282.           <Home>        - move cursor to the beginning of the line
  2283.                           (once you have started typing).
  2284.           <End>         - move cursor to the end of the line
  2285.                           (once you have started typing).
  2286.           <Ctrl>-<End>  - erase from the cursor to the end of the line.
  2287.           <Del>         - delete the character at the cursor and shift the
  2288.                           characters on the right to the left.
  2289.           <Backspace>   - delete the character before the cursor and shift the
  2290.                           characters on the right to the left.
  2291.           <Ins>         - toggle insert/overstrike mode
  2292.                         - in insert mode the cursor will be slightly fatter
  2293.                           than the one in overstrike mode.
  2294.           <Esc>         - cancel the changes and restore the line to its
  2295.                           original contents.
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2308.  
  2309.                                       Page 34
  2310.  
  2311.  
  2312.  
  2313.         In some (and probably most) cases, the file list will be too large to
  2314.         fit on the screen.  The list may be browsed through by using the keys
  2315.         on the cursor keypad.  Their functions:
  2316.  
  2317.         <UP> and <DOWN>   will move the highlight bar up or down one file.  If
  2318.                           you at a screen margin, and there are still more
  2319.                                             files to be browsed, the listing on
  2320.                           the screen will                      scroll in the
  2321.                           appropriate direction.  If you can't move any more,
  2322.                           you will hear a short beep.
  2323.  
  2324.         <PgUp> and <PgDn> will move you 15 files forward or backward in the
  2325.                           list.  If you can't move any more, you will hear a
  2326.                           short beep.
  2327.  
  2328.         <Home> and <End>  will move you to the beginning or end of the group of
  2329.                           files respectively.
  2330.  
  2331.         When you are done adding/changing file comments, hit <Esc> to return to
  2332.         the main menu.
  2333.  
  2334.         Two options that do not appear on the screen are:
  2335.  
  2336.         <F9> - Repeat Last Entered Comment:  This is handy if you want to
  2337.                repeat a single comment at different places in the list where
  2338.                <F10> (see below) won't suffice, as the comment desired is not
  2339.                directly above the current position.  If no comment was
  2340.                previously entered, or the last entered comment was blank, no
  2341.                action will be taken.
  2342.  
  2343.         <F10> - "Ditto":  Pressing this key will copy the comment from the
  2344.                 entry above.  It is handy if you want to copy a comment down a
  2345.                 consecutive list of files, or one that was already previously
  2346.                 entered at an earlier time, if it is directly above the current
  2347.                 position.  If the comment above is blank, or you are at the top
  2348.                 of the list, no action will be taken.
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2374.  
  2375.                                       Page 35
  2376.  
  2377.  
  2378.  
  2379.         OPTION F2: SHOW FILES BY COMMENT
  2380.  
  2381.         Selecting option <F2> will cause CATDISK to display a list of files in
  2382.         accordance with a comment search spec that you supply.  After selecting
  2383.         a report destination, you will be asked for a comment search spec that
  2384.         you wish the report to be based on.
  2385.  
  2386.         Just enter the string that you want to search for in the catalog's
  2387.         comments section and hit <Enter>, or hit <Esc> to abort the process
  2388.         without generating a report.
  2389.  
  2390.         Here's how the comments are sourced for your search spec.  You enter a
  2391.         "phrase" or "substring" that you want to search for in the file
  2392.         comments.
  2393.         The "phrase" may be an entire comment that you want, it can be just one
  2394.         word, or even just one letter.  When catdisk compares your "phrase" to
  2395.         a comment, it checks to see if that "phrase" is contained anywhere in
  2396.         that comment.  If it does, that file will appear in your report.
  2397.  
  2398.         Example:   "SOURCE" would match:    CATDISK V4.10 source code
  2399.                                             CATDISK V4.10 Source code
  2400.                                             CATDISK V4.10 SOURCE CODE
  2401.                                             Source
  2402.  
  2403.                                                      ... etc ...
  2404.  
  2405.  
  2406.         Please note:  I have had some of my beta-testers ask for wild cards in
  2407.         the comment search (for example, they might not know whether they had
  2408.         "Word Processor" or "Word Proc" for a comment).  This is not really
  2409.         necessary in this case, as, in the above case, entering "PROC" would
  2410.         match both comments.
  2411.  
  2412.         Depending on where you have set your output destination, the following
  2413.         options are applicable:
  2414.  
  2415.         Printer:  A hardcopy file report will be printed on your printer. The
  2416.                   filenames will be echoed to the screen as they are sent to
  2417.                   the  printer.  Hitting <Esc> at any time during report
  2418.                   generation will abort it and return to the main menu.
  2419.  
  2420.         Disk:     A listing in the same format as the hardcopy file report will
  2421.                   be produced in a diskette file.  The default name for this
  2422.                   file is one with the same name as the current catalog
  2423.                   filename with an extension of ".LST".  This may be overridden
  2424.                   at the time that the report is generated.  Hitting <Esc> at
  2425.                   any time during the generation of the report will abort it
  2426.                   and return to the main menu.
  2427.  
  2428.         Screen:   Upon entering the search spec, scanning of the catalog will
  2429.                   commence.  If you have status indicators turned on, a counter
  2430.                   will increment each time a matching file is found.  If at the
  2431.                   and of the search, no files were found, an error message will
  2432.                   be issued and you will be returned to the main menu.
  2433.  
  2434.                   When the search has completed successfully, the file names
  2435.                   will be shown alphabetically, along with the volume name,
  2436.                   archive name, and  other directory information for that file.
  2437.  
  2438.  
  2439.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2440.  
  2441.                                       Page 36
  2442.  
  2443.  
  2444.  
  2445.                   Applicable options are as follows:
  2446.  
  2447.                   <Cursor UP>   - move up one line in the report.  The screen
  2448.                                   contents will scroll down to make room for
  2449.                                   the new line appearing at the top.
  2450.  
  2451.                   <Cursor DOWN> - move down one line in the report.  The screen
  2452.                                   contents will scroll up to make room for the
  2453.                                   new line appearing at the bottom.
  2454.  
  2455.                   <PgUp>        - move up one page (15 lines) in the report.
  2456.  
  2457.                   <PgDn>        - move down one page (15 lines) in the report.
  2458.  
  2459.                   <Home>        - move to the beginning of the report.
  2460.  
  2461.                   <End>         - move to the end of the report.
  2462.  
  2463.                   <Grey Plus>   - move down through the report 1/15th of the
  2464.                                   total length of the report (see the appendix
  2465.                                   regarding the SCROLL BAR later in this
  2466.                                   manual).
  2467.  
  2468.                   <Grey Minus>  - move up through the report 1/15th of the
  2469.                                   total length of the report (see the appendix
  2470.                                   regarding the SCROLL BAR later in this
  2471.                                   manual).
  2472.  
  2473.                   <N>           - change report format to show a standard
  2474.                                   (normal) file report. This is the default if
  2475.                                   you do not specify either /SD or /CO when you
  2476.                                   start CATDISK.
  2477.  
  2478.                   <S>           - change report format to show sub-directories.
  2479.                                   If a sub-directory begins with a tilde (~),
  2480.                                   that means that the sub-directory shown is a
  2481.                                   sub-directory past the first level (i.e.
  2482.                                   a sub-directory within a sub-directory).
  2483.                                   If you wish to have this report format come
  2484.                                   up by default when starting CATDISK, simply
  2485.                                   add /SD to your command line with which you
  2486.                                   invoke CATDISK.
  2487.  
  2488.                   <C>           - change the report format to any comments you
  2489.                                   might have entered for the shown catalog
  2490.                                   entries. If you wish this display format to
  2491.                                   appear by default, use the /CO option when
  2492.                                   starting CATDISK.
  2493.  
  2494.                   <Esc>         - return to the menu.
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2506.  
  2507.                                       Page 37
  2508.  
  2509.  
  2510.  
  2511.         OPTION F3:  TEMPORARILY EXIT TO DOS
  2512.  
  2513.         This option, although not really necessary, has been added in response
  2514.         to the numerous requests that I have had for this feature (shows that I
  2515.         am really paying attention to those suggestions, eh?).  By selecting
  2516.         this option, CATDISK will be temporarily suspended and you will be
  2517.         returned to the DOS prompt.  You may carry out any normal function that
  2518.         you would ordinarily be able to carry out from DOS, provided that there
  2519.         is enough memory remaining in which to run your desired program.
  2520.  
  2521.         When you are done, simply type "EXIT" and hit <Return> to return to
  2522.         CATDISK.
  2523.  
  2524.         Please note that due to the fact that this option will in all
  2525.         probability not be invoked all that often, it does not show on any of
  2526.         the menus.  It is, however available from the main menu by pressing
  2527.         <F3>.
  2528.  
  2529.         Please note that if you have the disk cache active at the time you use
  2530.         this function, the contents of the cache will be pitched before calling
  2531.         DOS.
  2532.  
  2533.         When you are finished with DOS, and wish to return to CATDISK, simply
  2534.         type "EXIT" and hit <Return> to return to CATDISK.  Please be sure and
  2535.         replace any disks that you had in your drives before returning to
  2536.         CATDISK.
  2537.  
  2538.         Possible errors that you may encounter when you use can vary greatly.
  2539.  
  2540.         Possibilities are:  1) There is not enough memory to load a second copy
  2541.                                of the command interpreter (usually
  2542.                                COMMAND.COM), or that memory has been corrupted
  2543.                                by a resident program.
  2544.  
  2545.                             2) If you get an error after returning from DOS, it
  2546.                                usually means that you've loaded a resident
  2547.                                program while out in DOS.  You should refrain
  2548.                                from doing so.
  2549.  
  2550.                             3) Generally, this means that CATDISK was unable to
  2551.                                find COMMAND.COM on the drive and directory
  2552.                                defined by the SET COMSPEC= environment string
  2553.                                (see the DOS manual for details on the SET
  2554.                                command).  This is usually set to the location
  2555.                                from which COMMAND.COM was loaded when the
  2556.                                system was booted. If COMMAND.COM was not found
  2557.                                at the boot location, the root directory of the
  2558.                                current drive is attempted.
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2572.  
  2573.                                       Page 38
  2574.  
  2575.  
  2576.  
  2577.         OPTION <drive_letter>: SHOW DISK DIRECTORY
  2578.  
  2579.         To activate this feature, simply type the drive letter of the disk
  2580.         whose directory you wish to view.  If you haven't included the /NW
  2581.         option in your command line when you started CATDISK,you will be
  2582.         prompted to insert a disk for drive D where D is the drive letter that
  2583.         you typed.
  2584.  
  2585.         You will then be asked for a filespec to match.  This is the same as
  2586.         the filespec prompt in OPTION #9 - SHOW SELECTED FILES.  Upon doing
  2587.         this, the label and directory contents will be read just like they
  2588.         would if they were about to be cataloged, but instead of adding them to
  2589.         your catalog, they will be shown directly on the screen in the same
  2590.         format as option #7 - Show Files For A Volume.  The archive scanning
  2591.         feature functions as normal throughout the program.
  2592.  
  2593.         Upon entering the search spec, scanning of the catalog will
  2594.         commence.  If you have status indicators turned on, a counter  will
  2595.         increment each time a matching file is found.  If at the and of the
  2596.         search, no files were found, an error message will be issued and you
  2597.         will be returned to the main menu.
  2598.  
  2599.         When the search has completed successfully, the file names will be
  2600.         shown alphabetically, along with the volume name, archive name, and
  2601.         other directory information for that file.
  2602.  
  2603.         Applicable options are as follows:
  2604.  
  2605.         <Cursor UP>   - move up one line in the report.  The screen contents
  2606.                         will scroll down to make room for the new line
  2607.                         appearing at the top.
  2608.  
  2609.         <Cursor DOWN> - move down one line in the report.  The screen contents
  2610.                         will scroll up to make room for the new line appearing
  2611.                         at the bottom.
  2612.  
  2613.         <PgUp>        - move up one page (15 lines) in the report.
  2614.  
  2615.         <PgDn>        - move down one page (15 lines) in the report.
  2616.  
  2617.         <Home>        - move to the beginning of the report.
  2618.  
  2619.         <End>         - move to the end of the report.
  2620.  
  2621.         <Grey Plus>   - move down through the report 1/15th of the total length
  2622.                         of the report (see the appendix regarding the SCROLL
  2623.                         BAR later in this manual).
  2624.  
  2625.         <Grey Minus>  - move up through the report 1/15th of the total length
  2626.                         of the report (see the appendix regarding the SCROLL
  2627.                         BAR later in this manual).
  2628.  
  2629.         <N>           - change report format to show a standard (normal) file
  2630.                         report. This is the default if you do not specify
  2631.                         either /SD or /CO when you start CATDISK.
  2632.  
  2633.     
  2634.  
  2635.  
  2636.  
  2637.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2638.  
  2639.                                       Page 39
  2640.  
  2641.  
  2642.  
  2643.         <S>           - change report format to show sub-directories. If a
  2644.                         sub-directory begins with a tilde (~), that means that
  2645.                         the sub-directory shown is a sub-directory past the
  2646.                         first level (i.e. a sub-directory within a
  2647.                         sub-directory).
  2648.                         If you wish to have this report format come up by
  2649.                         default when starting CATDISK, simply add /SD to your
  2650.                         command line with which you invoke CATDISK.
  2651.  
  2652.         <C>           - change the report format to any comments you might have
  2653.                         entered for the shown catalog entries. If you wish this
  2654.                         display format to appear by default, use the /CO option
  2655.                         when starting CATDISK.
  2656.  
  2657.         <Esc>         - return to the menu.
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.         OPTION ESC:  EXIT TO DOS
  2665.  
  2666.         Select this option when you are finished with CATDISK to terminate its
  2667.         operation.  Upon exit, you will be returned to the DOS prompt.
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2704.  
  2705.                                       Page 40
  2706.  
  2707.  
  2708.  
  2709.                               APPENDIX A - THE SCROLL BAR
  2710.  
  2711.         When bringing up a screen report, you may have noticed a hatched bar on
  2712.         the left border of the screen with an inverse 'T' at the top of it and
  2713.         an inverse 'B' at the bottom.  This is a scroll bar, which indicates
  2714.         roughly where you are located along the full length of the current
  2715.         report.  Additionally, this feature will allow you to roughly position
  2716.         yourself in the report by hitting the <Grey Plus> and <Grey Minus>
  2717.         keys.  These keys will move you forward and backward respectively along
  2718.         this scroll bar.  These moves correspond to a move of one fifteenth of
  2719.         the total length of the report in the selected direction, as will be
  2720.         reflected in the page number which will be automatically set.
  2721.  
  2722.         The scroll bar position will also wrap from the top to the bottom if
  2723.         you are at the top and hit the <Grey Minus> key.  The reverse is also
  2724.         true for the <Grey Plus> key.
  2725.  
  2726.         In a long report, this represents a much nicer way of getting to, say,
  2727.         the files beginning with "R" without having to hit the <PgDn> key a
  2728.         hundred times.  Remember... the scroll bar is used to ROUGHLY position
  2729.         yourself among a group of files in a screen report.
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2770.  
  2771.                                       Page 41
  2772.  
  2773.  
  2774.  
  2775.                              APPENDIX B - ARCHIVE SUPPORT
  2776.  
  2777.         This version of CATDISK currently supports the archive utilities from
  2778.         System Enhancement Associates and PKWare, PAK files (similar to ARC
  2779.         files) created by the PAK utility from NoGate Consulting, ZIP files
  2780.         created by PKWare's PKZIP utilities, LZH files created by the LHARC
  2781.         utility from Haruyasu Yoshizaki, LZS files created by the LARC utility
  2782.         from K. Miki and the public domain Library Utility (LU).
  2783.  
  2784.         CATDISK can extract directory information from archives created with
  2785.         SEAWARE'S ARC utility, version 5.30 or earlier, PKWare's PKPAK version
  2786.         3.61 or earlier, or any compatible archive generating program.  These
  2787.         files commonly have a file extension of .ARC, and any files with this
  2788.         extension will be examined by CATDISK to see if it is a valid archive.
  2789.         If so, the directory information of each file in the archive will be
  2790.         extracted and added to the catalog if the Auto Archive Extraction
  2791.         feature is turned ON.  Files extracted from an ARC file will have a
  2792.         file attribute of "*ARC".
  2793.  
  2794.         Similar to the above, any files with a .PAK extension will be examined,
  2795.         and if appropriate, the directory information will be extracted from
  2796.         the file in question.  Files extracted from a PAK file will have a file
  2797.         attribute of "*PAK".
  2798.  
  2799.         ARC or PAK files created with utilities other than the ones listed
  2800.         above should work with CATDISK, but are not guaranteed.
  2801.  
  2802.         Files created with PKWare's PKZIP family of utilities are fully
  2803.         supported.  These files usually have an extension of .ZIP, and any file
  2804.         found with this extension will be examined by CATDISK to see if it is a
  2805.         valid ZIP file.  If this is so, and the Auto Archive Extraction Feature
  2806.         is turned ON, the directory information of each file in the library
  2807.         will be extracted and added to the catalog.  Files extracted from a ZIP
  2808.         file will have a file attribute of "*ZIP".
  2809.  
  2810.         Although ZIP files can contain subdirectory information, this is not
  2811.         the subdirectory that will appear in the catalog listing.  The reason
  2812.         for this is due to the fact that the primary purpose of CATDISK is to
  2813.         be able to locate a given file.  In order to be able to do so, the
  2814.         subdirectory of the ZIP file itself is shown.  The destination of the
  2815.         file when being UNZIPPED is not relevant.
  2816.  
  2817.         Additionally, files created with Haruyasu Yoshizaki's LHARC utility are
  2818.         fully supported.  These files commonly end with a .LZH extension.  Any
  2819.         files with this extension will be examined by CATDISK to see if it is a
  2820.         valid LHARC file.  If so, and you wish the directory contents to be
  2821.         extracted (via the program setting), the process will be carried out.
  2822.         Files extracted from a LZH file will have a file attribute of "*LZH".
  2823.  
  2824.         Files created by the LARC utility from K. Miki are supported in the
  2825.         same way as those created by the LHARc utility mentioned above.  Files
  2826.         extracted from these files will have a file attribute of "*LZS".
  2827.  
  2828.         Files with a .ZOO extension will be examined to determine whether they
  2829.         are a valid ZOO file.  If so, and Archive extraction is enabled, the
  2830.         directory contents of the file will be read and included in the catalog
  2831.         file.  Files extracted from ZOO files will have the attribute "*ZOO".
  2832.  
  2833.  
  2834.  
  2835.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2836.  
  2837.                                       Page 42
  2838.  
  2839.  
  2840.  
  2841.         Files created by the Library Utility (LU) and conform to the fifth
  2842.         revision of the formal definition of the library file format are also
  2843.         fully supported.  These files commonly have a file extension of .LBR,
  2844.         and any files with this extension will be examined by CATDISK to see if
  2845.         they are valid .LBR files.  If this is so, and the Auto ARCHIVE
  2846.         Extraction Feature is turned ON, the directory information of each file
  2847.         in the library will be extracted and added to the catalog.  Files
  2848.         extracted from a LBR file will have an attribute of "*LBR".
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2902.  
  2903.                                       Page 43
  2904.  
  2905.  
  2906.  
  2907.         APPENDIX C - DUPLICATE FILE NAMES AND CATALOGING HARD DISKS
  2908.  
  2909.         A number of users have made a request to have CATDISK show a list of
  2910.         files that have been duplicated over a number of diskettes.  There is
  2911.         no need for an extra option to support this request, as the existing
  2912.         reports that may be derived from options #9 and #0 show files in
  2913.         alphabetical order.  Any duplicate files will be clustered together,
  2914.         and it is quite easy to spot duplicate files in this manner.  If you
  2915.         choose option #9 and ask for a specific file (i.e. no wildcards), ALL
  2916.         instances of that file in the catalog will be reported.
  2917.  
  2918.         Even though CATDISK is capable of reading a hard disk and cataloging it
  2919.         to some degree (the first 5000 files), it was never meant to catalog a
  2920.         hard disk, as there are many excellent hard disk managers on the market
  2921.         that do a commendable job of allowing you to browse through your file
  2922.         structure; far better than CATDISK would enable you to.
  2923.  
  2924.         The whole idea behind CATDISK is to maintain a catalog of the files on
  2925.         your removable media, such as floppy diskettes, and removable hard
  2926.         disks such as those found in a Bernoulli box, such that finding them
  2927.         does not require you to insert the disks each time you are looking for
  2928.         a file.  With a non-removable hard disk, the files are all online and
  2929.         cataloging them is, for the most part, un-necessary.
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  2968.  
  2969.                                       Page 44
  2970.  
  2971.  
  2972.  
  2973.                            APPENDIX D - SUPPORT AND UPDATES
  2974.  
  2975.         As I said in the introduction, I will only offer advice and technical
  2976.         support to those who contribute via the SHAREWARE concept.  Users who
  2977.         do contribute will be notified when updates and new products are
  2978.         available. Anyone wishing to offer advice and suggestions are most
  2979.         welcome to do so.
  2980.  
  2981.         I may be reached on CompuServe at I.D. #  73307,333, or on The PEARL
  2982.         BBS in WATERLOO, Ontario, Canada, under my name, Rick Hillier.
  2983.  
  2984.         You may also correspond via your FAX machine, if you have access to
  2985.         one. My FAX number is (519)-884-4887.  This is the best daytime number
  2986.         at which to get an immediate response.
  2987.  
  2988.         Telephone support (or any support for that matter) is available to
  2989.         registered users only.  My voice line is (519)-888-6763.  Best time to
  2990.         reach me at this number is in the evening hours (6 pm to 10 pm Ontario
  2991.         Time).
  2992.  
  2993.         Those of you who register your copy of CATDISK and wish to receive an
  2994.         update to the latest version (from me and not The PEARL), please
  2995.         include an extra $10.00 with your registration to cover materials and
  2996.         shipping costs.  I will send you the latest version of CATDISK upon
  2997.         receipt of your registration.  Please specify the version of CATDISK
  2998.         that you currently have, or better yet, use the registration form at
  2999.         the end of this user manual.  If there have not been any updates made
  3000.         since your version, I will wait until the next release of CATDISK to
  3001.         send your update.
  3002.  
  3003.         To receive CATDISK on a 3.5" diskette, please add an additional $2.50.
  3004.  
  3005.         Optionally, you may include a diskette and diskette mailer with your
  3006.         registration plus $5.00 to cover shipping costs, and I will send you
  3007.         the latest version of CATDISK.
  3008.  
  3009.  
  3010.         ATTENTION OUT OF TOWN CATDISK USERS
  3011.  
  3012.         The most up to date version of CATDISK is always available on The
  3013.         PEARL, which may be reached at (519)-576-6754, 24 hrs. a day.  Please
  3014.         note that The PEARL is a pay board (normally $25/year), but I have made
  3015.         arrangements with the Sysop to obtain memberships for CATDISK
  3016.         subscribers who include an extra five dollars with their subscription,
  3017.         along with their first name, last name, and a password to use on the
  3018.         board.  One restriction must be made on this offer... you must live at
  3019.         least 100 miles outside the Kitchener-Waterloo, Ontario, Canada area in
  3020.         order to qualify.  You will be validated immediately upon my receiving
  3021.         your check or money order.
  3022.  
  3023.         Please note that if you are not a regular member of this BBS, or
  3024.         haven't taken advantage of the above upgrade offer, YOU WILL NOT BE
  3025.         ABLE TO ACCESS THE PROGRAM.
  3026.  
  3027.         Even if you do not wish to have a PEARL membership, you can still see
  3028.         what changes and revisions have been made to date by going to the
  3029.         bulletins section of the board.  You do not have to be a registered
  3030.         PEARL user to use this feature.
  3031.  
  3032.  
  3033.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3034.  
  3035.                                       Page 45
  3036.  
  3037.  
  3038.  
  3039.         If you do have a question, or a bug report, or whatever, in your
  3040.         correspondence, please indicate the following:
  3041.  
  3042.         1)  The version of CATDISK that you are using.
  3043.         2)  The version of DOS that you are using.
  3044.         3)  Your hardware configuration (Model, memory size, printer, etc.)
  3045.         4)  Any resident software that you have loaded in memory at the time.
  3046.             (i.e. Sidekick, SuperKey, Disk Caches, Print Spoolers, Ramdisks,
  3047.             etc.)
  3048.  
  3049.         This information will help me to track any problems and to suggest
  3050.         reasonable solutions to your problems.
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3100.  
  3101.                                       Page 46
  3102.  
  3103.  
  3104.  
  3105.                           APPENDIX E - QUESTIONS AND ANSWERS
  3106.  
  3107.         As CATDISK has developed over the past while, I have received many
  3108.         questions regarding the operation of CATDISK.  The most common are
  3109.         addressed in this section of the manual.
  3110.  
  3111.         Q. When I go to catalog a new disk, CATDISK aborts the catalog file
  3112.            update with an error message that the disk is full, even though
  3113.            there is still room on the disk containing the catalog files.
  3114.  
  3115.         A. When CATDISK updates a catalog file, it does so by merging the new
  3116.            information in with the old, building a new file from the old in the
  3117.            process.  The catch here is that, at the end of the catalog file
  3118.            update, BOTH files actually exist, thereby taking up roughly double
  3119.            the size of the original catalog file.  At the end of this
  3120.            procedure, if successful, CATDISK deletes the old file and renames
  3121.            the new temporary file to what the original catalog file was called.
  3122.            The reason this is necessary is that, while re-cataloging a disk,
  3123.            there is a possibility that files were removed from that disk.  This
  3124.            method of updating the catalog provides a convenient mechanism for
  3125.            removing those files from the catalog.
  3126.  
  3127.         Q. Would it be possible for CATDISK to support ARCHIVES within
  3128.            ARCHIVES?
  3129.  
  3130.         A. Unfortunately, the answer is no.  In order to read the directory of
  3131.            an archive within another archive file, the original one must first
  3132.            be expanded into its separate files.  Firstly, with the ever
  3133.            evolving compression methods employed with new versions of the
  3134.            archive utilities, this would be beyond the scope of this program.
  3135.            Secondly, there would always be the possibility of overwriting an
  3136.            existing file of the same name.  It's just not feasible.
  3137.  
  3138.         Q. In the summary report, I see disk entries for which the amount of
  3139.            free space and the amount of space used adds up to more than the
  3140.            capacity of the disk itself.  The % slack factor is also wrong.
  3141.  
  3142.         A. You probably have a corrupted file allocation table on that disk,
  3143.            and could be in for some serious trouble.  Format a fresh disk and
  3144.            transfer the files to it, and re-catalog it from that new disk.
  3145.  
  3146.         Q. After starting the cataloging process on a diskette, I discovered
  3147.            that the label on the diskette was wrong.  Would it be possible to
  3148.            abort the process, change the label and start over?
  3149.  
  3150.         A. Once the cataloging process is started, it cannot be stopped.  If
  3151.            you've run into a situation like that above, let CATDISK finish the
  3152.            task, and use option #3 to change the label on the diskette.
  3153.            CATDISK has a mechanism to automatically change the old volume label
  3154.            to the new one throughout the catalog files.  It's quick and
  3155.            painless.
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3166.  
  3167.                                       Page 47
  3168.  
  3169.  
  3170.  
  3171.         Q. We have file comments for each file entry in the catalog file.
  3172.            Would it be possible to have comments for each disk in the summary
  3173.            file?
  3174.  
  3175.         A. At present, no, although this is not carved in stone.  The main
  3176.            reason for this is that CATDISK keeps the entire disk summary in
  3177.            memory at all times.  A comment on each disk would significantly
  3178.            increase the memory requirements of CATDISK.
  3179.  
  3180.         Q. I have some self-booting games.  Would it be possible to create a
  3181.            dummy entry for that disk in the catalog?
  3182.  
  3183.         A. Doing this would defeat the purpose for which CATDISK was written.
  3184.            Self-booting games (those that CATDISK won't read) do not have a
  3185.            directory in the conventional sense.  As there are no files per se
  3186.            there is nothing to look for on the diskette.  You need only locate
  3187.            the disk itself in order to use it.
  3188.  
  3189.         Q. I have many disks with numerous insignificant files on them such as
  3190.            printer drivers, etc.  Would it be possible to catalog only selected
  3191.            files from these disks?
  3192.  
  3193.         A. Unfortunately, not at this time.  In order to keep the shareware
  3194.            version of CATDISK simple to use as possible, all files get
  3195.            cataloged hands free.  However, CATDISK PLUS, a commercial release
  3196.            of this program with many enhancements described in more detail in a
  3197.            later appendix, will handle this type of operation.
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3232.  
  3233.                                       Page 48
  3234.  
  3235.  
  3236.  
  3237.                             APPENDIX F - CATDISK PLUS
  3238.  
  3239.         Since its initial release in October of 1986, CATDISK has gone through
  3240.         many changes and has received tremendous support from the many
  3241.         corporations and individuals who have sent in their registration fees.
  3242.         CATDISK is currently in use world-wide in more applications than I
  3243.         could have possibly dreamed of.  Judging from this response, I can
  3244.         safely say that the SHAREWARE system is alive and flourishing as a
  3245.         viable means of making quality software available at reasonable cost.
  3246.  
  3247.         Along the way, many individuals have requested features in the program
  3248.         that are not feasible in the current design of CATDISK.  In creating
  3249.         this program, I set out to make the operation as simple and automatic
  3250.         as possible.  Those requests that melded in with the current design
  3251.         have been implemented, and those that will compliment same will be
  3252.         implemented in the future.
  3253.  
  3254.         However, there have been numerous requests for features that would
  3255.         complicate the design of the shareware version of CATDISK - good
  3256.         requests.
  3257.  
  3258.         Therefore, it is with great pleasure that I am able to announce that a
  3259.         commercial release of the program, CATDISK PLUS, which will be produced
  3260.         by my software company, The DATAMEN Inc.  The initial release date is
  3261.         expected to be in the third quarter of 1989.
  3262.  
  3263.         Please keep in mind that this shareware version will continue to be
  3264.         enhanced and supported - it's still "my baby"!
  3265.  
  3266.         Features include:
  3267.  
  3268.          . A windowed desktop environment with pull down menus for ease of use.
  3269.          . Online context-sensitive help.
  3270.          . Support for the 43 line EGA and the 50 line VGA screen modes.
  3271.          . Full color customization.
  3272.          . All the functional features of the current shareware release.
  3273.          . The ability to selectively catalog files from your disks via three
  3274.            methods, all of which can be used at once:  inclusion filespecs,
  3275.            exclusion filespecs, and the ability to pick and choose list of
  3276.            of files as read from the catalog disk.
  3277.          . A greater variety of reporting features will be available as well
  3278.            as a custom report generator where you can design your own report.
  3279.          . Comment entries for each disk in the catalog.
  3280.          . Longer file comments.
  3281.          . Greater capacity for catalog size.
  3282.          . And many more!
  3283.  
  3284.         One major consideration is that CATDISK PLUS will require a hard disk.
  3285.         Suggested retail price for this product is $69.95 Cdn + $8.00 for
  3286.         shipping and handling.  Dealer inquiries are welcome.
  3287.  
  3288.         Please address all inquiries to:
  3289.  
  3290.               The Datamen
  3291.               405 Barrington Lane
  3292.               Waterloo, ONTARIO
  3293.               Canada   N2T 1H9
  3294.               Phone:  (519)-888-6763
  3295.                 FAX:  (519)-884-4887
  3296.  
  3297.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3298.  
  3299.                                       Page 49
  3300.  
  3301.  
  3302.  
  3303.                         APPENDIX G - OTHER PRODUCTS AVAILABLE
  3304.  
  3305.         For all you avid golfers out there, my software company, The DATAMEN,
  3306.         Inc. has a golf handicap system available, called HANDICAP II, that
  3307.         goes way beyond just calculating a simple golf handicap.
  3308.  
  3309.         Among the many features of this program are:
  3310.  
  3311.           . Pull down menus for ease of use.
  3312.           . On line context sensitive help.
  3313.           . Storage capacity for up to 100 different golf courses.
  3314.           . Storage capacity for up to 32767 rounds of golf.
  3315.             (score and number of putts on each hole can be logged)
  3316.           . Instant retrieval of past played games, and the ability to browse
  3317.             through them.
  3318.           . An expanded handicap card that is more informative than a standard
  3319.             handicap card.
  3320.           . A report showing your average score on each hole on each course.
  3321.             - good for spotting habitual trouble holes.
  3322.           . A report showing your average putts on each green on each course.
  3323.             - good for spotting habitual troublesome greens.
  3324.           . A report showing how often you hit each green in regulation.
  3325.             - good for analyzing your tee-to-green game on each hole.
  3326.           . Many more statistical reports of interest to you.
  3327.           . Full housekeeping routines to correct mistakes (but I'll bet that
  3328.             you never make any, right?!?)
  3329.           . Support for most popular printers.
  3330.  
  3331.           . ALL reports may be viewed on the screen or printed on your
  3332.             printer.
  3333.  
  3334.           . Pop up windows are used extensively, adding to the ease of use of
  3335.             the program.
  3336.  
  3337.         We also have a clubhouse version available with all of the above plus:
  3338.  
  3339.           . A simple date-differential entry system for those who do not wish
  3340.             to have all the detail of the enhanced reports.
  3341.           . Capacity to maintain handicaps for up to 32767 members (you are
  3342.             only limited by disk size).
  3343.           . Full system manager functions available only to authorized users.
  3344.           . A handicap listing (in alphabetical order by member name) of the
  3345.             handicaps of all the members in the system.
  3346.           . This version of HANDICAP II may be used on multi-user systems
  3347.             without user file conflict.
  3348.  
  3349.                                   Ordering Information
  3350.  
  3351.         The GOLFERS version of HANDICAP II is available for $69.95, and the
  3352.         CLUB HOUSE version is available for $295.00.
  3353.  
  3354.         Please note that these prices are in Canadian funds.
  3355.  
  3356.         They may be ordered from:  The Datamen, Inc.
  3357.                                    405 Barrington Lane
  3358.                                    Waterloo, Ontario
  3359.                                    Canada   N2T 1H9
  3360.                            Phone:  (519)-888-6763
  3361.                              FAX:  (519)-884-4887
  3362.  
  3363.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3364.  
  3365.                                       Page 50
  3366.  
  3367.  
  3368.  
  3369.                             CATDISK V4.10 REGISTRATION FORM
  3370.                             ------- ----- ------------ ----
  3371.  
  3372.  
  3373.            Name: ______________________________________________________________
  3374.  
  3375.         Address: ______________________________________________________________
  3376.                  ______________________________________________________________
  3377.                  ______________________________________________________________
  3378.  
  3379.           Phone: _______________________  CompuServe ID Number
  3380.                                           (If applicable)           ___________
  3381.  
  3382.          ____ Registration(s) of CATDISK @15.00 ea                  ___________
  3383.  
  3384.          ____ Registration(s) on The PEARL BBS  @ 5.00 ea           ___________
  3385.                 (See "OUT OF TOWN CATDISK USERS" in appendix D)
  3386.  
  3387.          ____ CATDISK Upgrade(s) (You Supply Diskette & Mailer)     ___________
  3388.                                       @  5.00 ea
  3389.  
  3390.          ____ CATDISK Upgrade(s) (I supply 5.25" Diskette & Mailer) ___________
  3391.                                       @ 10.00 ea
  3392.  
  3393.          ____ CATDISK Upgrade(s) (I supply 3.5" Diskette & Mailer)  ___________
  3394.                                       @ 12.50 ea
  3395.  
  3396.  
  3397.               (Ontario Residents Add 8% Provincial Sales Tax)       ___________
  3398.  
  3399.  
  3400.               NOTE: Check or money order should be made payable to Rick Hillier
  3401.  
  3402.  
  3403.          *** Note:  Site licenses are available.  Please contact Rick Hillier
  3404.                     directly for further details.
  3405.  
  3406.                     You must be registered to qualify for an upgrade
  3407.  
  3408.                 Type of PC Used: ________________________  DOS Version: _______
  3409.  
  3410.          Hardware Configuration: ______________________________________________
  3411.  
  3412.          What Resident Software Do You Run:  __________________________________
  3413.         
  3414.         _______________________________________________________________________
  3415.         
  3416.         _______________________________________________________________________
  3417.  
  3418.         Comments and Suggestions:  ____________________________________________
  3419.  
  3420.          ______________________________________________________________________
  3421.  
  3422.          ______________________________________________________________________
  3423.  
  3424.          ______________________________________________________________________
  3425.         
  3426.          ______________________________________________________________________
  3427.  
  3428.  
  3429.     Diskette Catalog System (CATDISK) V4.10  Copr (C) 1986,1989 by Rick Hillier
  3430.  
  3431.                                       Page 51
  3432.  
  3433.