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