home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / c / cdisk637.zip / CATDOCS.EXE / CATDISK.DOC < prev    next >
Text File  |  1993-02-16  |  246KB  |  5,677 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                            DISK CATALOG SYSTEM (CATDISK)
  20.  
  21.                                    USER'S GUIDE
  22.  
  23.  
  24.                                    Version 6.37
  25.  
  26.                                    Feb 16, 1993
  27.  
  28.  
  29.                      Copyright (C) 1986, 1993 By Rick Hillier
  30.  
  31.                                All Rights Reserved.
  32.  
  33.  
  34.  
  35.                                    _______
  36.                               ____|__     |               (tm)
  37.                            --|       |    |-------------------
  38.                              |   ____|__  |  Association of
  39.                              |  |       |_|  Shareware
  40.                              |__|   o   |    Professionals
  41.                            -----|   |   |---------------------
  42.                                 |___|___|    MEMBER
  43.  
  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 . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  75.            Licensing And Distribution . . . . . . . . . . . . . . . . . .   5
  76.            ASP . . .  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  77.  
  78.       2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . . . .   7
  79.            What You Should Have Received  . . . . . . . . . . . . . . . .   7
  80.            System Requirements  . . . . . . . . . . . . . . . . . . . . .   7
  81.            Initial Note On Archive Files  . . . . . . . . . . . . . . . .   7
  82.            Configuring CATDISK  . . . . . . . . . . . . . . . . . . . . .   8
  83.            Excluding Certain Files From Being Cataloged . . . . . . . . .  11
  84.            Color Customization  . . . . . . . . . . . . . . . . . . . . .  12
  85.            Default Settings . . . . . . . . . . . . . . . . . . . . . . .  12
  86.            Upgrading From V3.61 or Later  . . . . . . . . . . . . . . . .  13
  87.            Saving Your Configuration Settings . . . . . . . . . . . . . .  13
  88.            General Considerations When Configuring CATDISK  . . . . . . .  14
  89.            Sample Configurations  . . . . . . . . . . . . . . . . . . . .  15
  90.            IMPORTANT NOTE . . . . . . . . . . . . . . . . . . . . . . . .  16
  91.            Starting CATDISK . . . . . . . . . . . . . . . . . . . . . . .  17
  92.  
  93.       3. USING CATDISK  . . . . . . . . . . . . . . . . . . . . . . . . .  22
  94.            Using The Menus  . . . . . . . . . . . . . . . . . . . . . . .  22
  95.            Selecting A Volume ID From A List  . . . . . . . . . . . . . .  23
  96.            Option 1  - Set Drive For Cataloging . . . . . . . . . . . . .  24
  97.            Option 2  - Set Current Catalog File . . . . . . . . . . . . .  25
  98.            Option 3  - Settings And Toggles Menu  . . . . . . . . . . . .  26
  99.                1  - Set Drive For Cataloging  . . . . . . . . . . . . . .  26
  100.                2  - Pauses On/Off . . . . . . . . . . . . . . . . . . . .  26
  101.                3  - Change Printer Report Type  . . . . . . . . . . . . .  26
  102.                4  - Report Totals On/Off  . . . . . . . . . . . . . . . .  27
  103.                5  - File Comments On The Fly  . . . . . . . . . . . . . .  27
  104.               F1  - Main Archive Comment Copy . . . . . . . . . . . . . .  27
  105.               F2  - Extract 4DOS/NDOS Comments  . . . . . . . . . . . . .  28
  106.                6  - Set Current Report Destination  . . . . . . . . . . .  28
  107.                7  - Activating/Deactivating Two Sided Printer Reports . .  28
  108.                8  - Archive Extract Setting . . . . . . . . . . . . . . .  29
  109.                9  - Comments When ZIPS Not Extracted  . . . . . . . . . .  29
  110.                0  - Aliases On/Off  . . . . . . . . . . . . . . . . . . .  29
  111.               F3  - Suggest Volume Label On/Off . . . . . . . . . . . . .  30
  112.               ESC - Return To Main Menu . . . . . . . . . . . . . . . . .  30
  113.            Option 4  - Labeling A Disk  . . . . . . . . . . . . . . . . .  31
  114.            Option 5  - Cataloging/Re-cataloging A Disk  . . . . . . . . .  32
  115.            Option F1 - UnCataloging A Disk  . . . . . . . . . . . . . . .  35
  116.            Option 6  - Change Comments By Volume ID . . . . . . . . . . .  36
  117.            Option 7  - Change Comments By Filespec  . . . . . . . . . . .  38
  118.            Option 8  - Comment Files By Comment . . . . . . . . . . . . .  38
  119.            Option 9  - Import Comments From A Text File . . . . . . . . .  38
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  130.  
  131.                                       Page 1
  132.  
  133.  
  134.  
  135.              Option 0 - Reports And Inquiries Menu  . . . . . . . . . . .  41
  136.                Screen Based Reports . . . . . . . . . . . . . . . . . . .  41
  137.                Printer Based Reports  . . . . . . . . . . . . . . . . . .  42
  138.                Disk Based Reports . . . . . . . . . . . . . . . . . . . .  42
  139.                1  - Show Disk Summary . . . . . . . . . . . . . . . . . .  43
  140.                2  - Files For A Volume  . . . . . . . . . . . . . . . . .  44
  141.                3  - Files For An Archive  . . . . . . . . . . . . . . . .  46
  142.                4  - Files By Filespec . . . . . . . . . . . . . . . . . .  48
  143.                5  - Files By Comment Text . . . . . . . . . . . . . . . .  50
  144.                F1 - Files By Comment Keywords . . . . . . . . . . . . . .  51
  145.                6  - Files By Comment/Filename Text  . . . . . . . . . . .  52
  146.                7  - Sorted Full File Listings . . . . . . . . . . . . . .  52
  147.                8  - Unique Files Only . . . . . . . . . . . . . . . . . .  53
  148.                9  - Duplicate Files Only  . . . . . . . . . . . . . . . .  53
  149.                0  - Volume Summary/Contents . . . . . . . . . . . . . . .  54
  150.              Option <F2> - Shell To DOS . . . . . . . . . . . . . . . . .  55
  151.              Option <drive_letter> - Show Disk Directory  . . . . . . . .  56
  152.              Option ESC - Exit To DOS . . . . . . . . . . . . . . . . . .  56
  153.  
  154.         Appendix A - The Scroll Bar . . . . . . . . . . . . . . . . . . .  57
  155.         Appendix B - Archive Support  . . . . . . . . . . . . . . . . . .  58
  156.         Appendix C - CATLOOK Command Line Lookup Utility  . . . . . . . .  60
  157.         Appendix D - CATMGR - CATDISK Catalog Manager . . . . . . . . . .  61
  158.         Appendix E - DISKFILL - Optimal Disk Fill Utility . . . . . . . .  65
  159.         Appendix F - Support And Updates  . . . . . . . . . . . . . . . .  75
  160.           Attention Out of Town CATDISK Users . . . . . . . . . . . . . .  76
  161.         Appendix G - Questions And Answers  . . . . . . . . . . . . . . .  77
  162.         Appendix H - CATDISK Companion Programs . . . . . . . . . . . . .  81
  163.         Appendix I - CATDISK PLUS . . . . . . . . . . . . . . . . . . . .  84
  164.         Appendix J - Other Products Available . . . . . . . . . . . . . .  85
  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) V6.37  Copr (C) 1986, 1993 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.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  262.  
  263.                                       Page 3
  264.  
  265.  
  266.  
  267.         FEATURES - CATDISK PROGRAM
  268.  
  269.         - Completely menu-driven and very easy to use.
  270.         - Configuration utility allows customization of the main features.
  271.         - All screen colors may be customized to your liking.
  272.         - Command line options can be stored in the DOS environment area
  273.           negating the need to memorize them.
  274.         - Cataloging/Uncataloging/Re-cataloging functions are fully automated.
  275.         - A disk volume label can be changed from within CATDISK.
  276.         - CATDISK can suggest sequential volume labels for you to use.
  277.         - You can catalog a disk under an alias instead of the volume label.
  278.         - Supports up to 32,767 files or 2,000 disks per catalog, which can be.
  279.           reduced through the config program to better optimize memory usage.
  280.         - Supports multiple catalog files.
  281.         - Supports up to 512 sub-directories PER DISK being cataloged.
  282.         - Able to read the directory contents of ARC, ARJ, DWC, HYP, LBR, LZH,
  283.           LZS,PAK, ZIP, and ZOO archive files.  See the appendix on ARCHIVE
  284.           SUPPORT in this user manual for further details.
  285.         - Archive extraction is optional and can be set while in the program.
  286.         - You can attach a 43 character comment to each file in the catalog,
  287.           which can be done either while cataloging a disk, or at a later time.
  288.         - Can import comments from an ASCII text file, such as a BBS listing.
  289.         - Can read comments from ZIP, ZOO and DWC files.
  290.         - Can extract resolution/color information from GIF (Graphics
  291.           Interchange Format) files and include it as the default comment.
  292.         - Can read 4DOS/NDOS directory comments and add them to your catalog.
  293.         - Summary report shows disk capacity, space used and space free on
  294.           each disk in the catalog to aid in optimization of disk usage.
  295.         - Files can be viewed by DOS wildcards, Volume ID, ARCHIVE ID, or by
  296.           keywords or phrases in the file comments.
  297.         - Reports can be sent to screen, printer, or disk file.
  298.         - Printer reports can be printed in a two-sided format to conserve
  299.           paper (this is, quite possibly, the first environmentally friendly
  300.           software product in terms of built-in reporting facilities).
  301.  
  302.         FEATURES - "CATLOOK" UTILITY
  303.  
  304.         - small size allows it to be used when available memory is restricted.
  305.         - command line parameters allow any of CATDISK's reports to be created.
  306.         - output may be re-directed to a file or printer.
  307.  
  308.         FEATURES - "CATMGR" UTILITY
  309.  
  310.         - can be used to split/merge complete or partial catalog files.
  311.         - menu driven for ease of use.
  312.         - point and shoot selection of individual cataloged volumes to move,
  313.           copy or delete
  314.  
  315.         FEATURES - "DISKFILL" UTILITY
  316.  
  317.         - CATDISK's Optimal Disk Fill Utility automates offloading of files to
  318.           floppies using point and shoot file selection, and uses a "best-fit"
  319.           arrangement to minimize wasted disk space.  As disks are filled with
  320.           files, those disks can be cataloged as you go.  This program can also
  321.           recommend disks to use that have already been cataloged for
  322.           "backfilling" of free space.
  323.  
  324.         - DISKFILL fully supports 4DOS/NDOS file descriptions.
  325.  
  326.  
  327.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  328.  
  329.                                       Page 4
  330.  
  331.  
  332.  
  333.         LICENSING AND DISTRIBUTION
  334.  
  335.         CATDISK is copyright and has been released for distribution as
  336.         SHAREWARE.  Please note that a great deal of time and effort has been
  337.         invested in the development of this program.  You are granted a license
  338.         to try CATDISK for a reasonable trial period without risk.  If, after
  339.         this time, you find the program useful and intend to use it in managing
  340.         your disk collection, you are expected to register.
  341.  
  342.         The base registration fee is $25.  This will entitle you to continue to
  343.         use CATDISK beyond a reasonable trial period as well as entitle you to
  344.         program support.  The registration form, which should be included in
  345.         the distribution package that you received outlines the procedures for
  346.         registering your copy of the program.  Should you decide that you would
  347.         like the latest release (or a pending release if you already have the
  348.         latest) appropriate information is contained on the same form.
  349.  
  350.         Please keep in mind that I must have a registration form on file for
  351.         you before I can offer product support.
  352.  
  353.         Operators of electronic bulletin boards (Sysops) are encouraged to post
  354.         CATDISK for downloading by their users.
  355.  
  356.         CATDISK may be uploaded to and downloaded from commercial systems such
  357.         as CompuServe, the Source, and BIX, so long as the only charge paid by
  358.         the subscriber is for on-line time and there is no charge for the
  359.         program.  Those copying, sharing, and/or electronically transmitting
  360.         the program are required not to delete or modify the copyright notice
  361.         and restrictive notices from the program or documentation; anyone doing
  362.         so will be treated as a contributory copyright violator.
  363.  
  364.         If you are passing this program on to others, uploading it to a
  365.         bulletin board system, or including it in a users group library, do not
  366.         separate the files contained in the distribution archive - pass the
  367.         entire archive on to the intended party.  This ensures that those who
  368.         receive the program will have all the correct configuration utilities
  369.         and documentation necessary to get CATDISK up and running quickly.  A
  370.         listing of what files you should have and the purpose of each is listed
  371.         later in this manual.
  372.  
  373.         The CATDISK documentation may not be modified by users. The program may
  374.         not be separated from the documentation when distributed.  Printed or
  375.         Photocopies ("Xeroxed") copies of the CATDISK documentation (i.e., this
  376.         manual) may not be distributed or sold without the written permission
  377.         of the author.
  378.  
  379.         No other person other than the author, Rick Hillier, may accept payment
  380.         or royalties for this program.
  381.  
  382.         This license to use CATDISK does NOT include the right to distribute or
  383.         sell CATDISK.  Distribution terms are detailed in the file VENDOR.DOC
  384.         which is included with this package.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  394.  
  395.                                       Page 5
  396.  
  397.  
  398.  
  399.         ASP
  400.  
  401.         This program is produced by a member of the Association of Shareware
  402.         Professionals (ASP).  ASP wants to make sure that the shareware
  403.         principle works for you.  If you are unable to resolve a
  404.         shareware-related problem with an ASP member by contacting the member
  405.         directly, ASP may be able to help.  The ASP Ombudsman can help you
  406.         resolve a dispute or problem with an ASP member, but does not provide
  407.         technical support for members' products.  Please write to the ASP
  408.         Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  409.         message via CompuServe mail to ASP Ombudsman 70007,3536
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  460.  
  461.                                       Page 6
  462.  
  463.  
  464.  
  465.                            2.  G E T T I N G   S T A R T E D
  466.  
  467.         WHAT YOU SHOULD HAVE RECEIVED
  468.  
  469.         CATDISK is distributed in the form of a self-extracting executable file
  470.         created with Haruyasu Yokizaki's LHA utility.   This file should
  471.         contain three files which are as follows:
  472.  
  473.         README.1ST   - Urgent program notes - IMPORTANT -- READ THIS FILE!
  474.  
  475.         CATPROGS.EXE - A self-extracting archive containing the CATDISK program
  476.                        files as follows:
  477.  
  478.            CATDISK.EXE  - The CATDISK program file.
  479.            CATLOOK.EXE  - The CATDISK command line utility (lookup program).
  480.            CATMGR.EXE   - The CATDISK catalog file manager (split/merge/delete/
  481.                           copy utility).
  482.            DISKFILL.EXE - An optimal disk fill utility.
  483.            CDISKCFG.EXE - The CATDISK configuration program.
  484.            CDISKCVT.EXE - Conversion utility for converting old CATDISK files
  485.                           to the newest format - See the README.1ST file before
  486.                           running.
  487.            CLEANCAT.EXE - Cleanup utility for catalog entries containing volume
  488.                           labels containing null characters - See the
  489.                           README.1ST file before running.
  490.  
  491.         CATDOCS.EXE  - A self-extracting archive containing the CATDISK
  492.                        documentation files as follows:
  493.  
  494.            PRINTDOC.EXE - A utility program to print the various CATDISK
  495.                           documentation files.  See README.1ST for details.
  496.            CATDISK.DOC  - The manual you are now reading.
  497.            CATDISK.HST  - Revision history for CATDISK since its initial
  498.                           release in October 1986.
  499.            REGISTER.FRM - The registration form for this product.
  500.            SITE.LIC     - The site license registration form for this product.
  501.            VENDOR.DOC   - Vendors must read this agreement and use the attached
  502.                           form for obtaining permission to distribute CATDISK.
  503.  
  504.         To extract the files, just run CATPROGS.EXE and/or CATDOCS.EXE and the
  505.         files will be automatically extracted to the current directory.
  506.  
  507.         SYSTEM REQUIREMENTS
  508.  
  509.         . IBM PC/XT/AT or PS/2 or true compatible computer.
  510.         . DOS V2.00 or above.
  511.         . At least one floppy disk drive (Hard Drive Highly Recommended).
  512.         . 320K RAM - if more is available, CATDISK will have greater internal
  513.                      capacity for reading new files off of the disks being
  514.                      cataloged and will run more efficiently.
  515.  
  516.  
  517.         INITIAL NOTE ON ARCHIVE FILES
  518.  
  519.         At various points in this user manual, references to ARCHIVE files are
  520.         made.  This is a collective term describing a file that actually
  521.         contains more than one file.  The contained files may or may not be
  522.         compressed.  Currently, this refers to ARC, ARJ, DWC, HYP, LBR, LZH,
  523.         LZS, PAK, ZIP and ZOO files.
  524.  
  525.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  526.  
  527.                                       Page 7
  528.  
  529.  
  530.  
  531.         CONFIGURING CATDISK
  532.  
  533.         Many features of CATDISK may be permanently set from the configuration
  534.         program, CDISKCFG.EXE.  When you start this program, please make sure
  535.         that the correct versions of the program files CATDISK.EXE, and
  536.         CATLOOK.EXE are in the current drive and directory, otherwise you will
  537.         get an error message.
  538.  
  539.         There are several utilities available that allow you to compress an
  540.         executable file such that it remains executable, but takes up less room
  541.         on your disk.  Examples of such programs are PKLITE and LZEXE.  If you
  542.         use such programs on CATDISK.EXE and CATLOOK.EXE, CDISKCFG will not be
  543.         able to find the configuration information in those two files.  Once
  544.         you've configured CATDISK to your liking, it's okay to compress the two
  545.         files after making copies of the originals.
  546.  
  547.         Upon startup, the configuration program will read the current settings
  548.         defined in "CATDISK.EXE", after which, the configuration screen will be
  549.         presented.  You may change any given item on this screen by using the
  550.         <Cursor UP> and <Cursor DOWN> keys to highlight the title of the
  551.         desired field.  The bottom portion of the screen will contain any
  552.         additional information as well as any instructions on how to change the
  553.         selected item.
  554.  
  555.         A discussion of the 10 items on this list follows:
  556.  
  557.          1) SCREEN UPDATE METHOD
  558.  
  559.             You may choose between having your screen updated by using your
  560.             computer's built in BIOS routines, or by using a faster DIRECT
  561.             screen update method.  Using the BIOS is much slower than using
  562.             direct access, but maintains compatibility with such operating
  563.             environments as TopView, Desqview, and DoubleDOS.
  564.             Choosing DIRECT screen access is much quicker, but will be
  565.             incompatible with most multitasking programs such as the above
  566.             mentioned due to the fact that they cannot handle "ill-behaved"
  567.             programs that write directly to the screen.
  568.  
  569.             If you chose DIRECT screen access, a second test is made if you
  570.             have a GRAPHICS display connected in your system.  Some video
  571.             adapters have the nasty side effect of producing static, or "snow"
  572.             when the video memory is accessed directly.  This test will do
  573.             multiple direct access to the video ram on your graphics adapter.
  574.             When you hit a key to stop the test, you will be asked if you saw
  575.             static on the screen.
  576.  
  577.             If you answer "Y" to the prompt, CATDISK will check for horizontal
  578.             retrace before writing to the display.  This will result in a
  579.             slightly slower screen response than normal, but it is almost
  580.             negligible.
  581.  
  582.             If you are not running under a multitasking system, or are using
  583.             DoubleDos in dual screen mode, I would recommend that you use
  584.             DIRECT screen access, as it's much quicker.
  585.  
  586.          2) COLOR OR B & W
  587.  
  588.             This option is self-explanatory.  The appearance of the setup
  589.             screen will depend on the setting of this field.
  590.  
  591.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  592.  
  593.                                       Page 8
  594.  
  595.  
  596.  
  597.          3) DISK CACHE SIZE
  598.  
  599.             This field will enable you to set the DISK CACHE size. Setting it
  600.             to zero will disable the cache (i.e. turn the feature off).
  601.  
  602.             Setting it to a number greater then zero will turn it on and will
  603.             enable CATDISK to keep the most recently read sectors of the
  604.             CATALOG FILES in memory, resulting in much faster scans through the
  605.             catalog file when looking for a group of files.
  606.  
  607.             Some hard disks use their own device driver, and are incompatible
  608.             with this caching method.  If this is the case, CATDISK will warn
  609.             you of this condition if caching is enabled, but is incompatible
  610.             with your hard disk.  Under these circumstances, the caching
  611.             feature will be turned off during that program run... use this
  612.             configuration option to permanently disable the cache and eliminate
  613.             the warning at each startup.
  614.  
  615.             If you already have a resident disk cache loaded in your system, DO
  616.             NOT USE CATDISK'S BUILT IN CACHE!!!  The two systems will conflict
  617.             with each other and will probably cause damage to your catalog
  618.             files.
  619.  
  620.          4) NUMBER OF LINES PER PAGE
  621.  
  622.             The number of lines per page field will enable you to tell CATDISK
  623.             the number of lines of data (EXCLUDING headings) that it should
  624.             place on each page of printer or disk output.  This may be any
  625.             number between 0 and 255.  Entering zero will disable page breaking
  626.             and the output will be presented in a continuous stream with one
  627.             title at the top.
  628.  
  629.          5) PRINTER STARTUP STRING
  630.  
  631.             The printer start up string is a series of ASCII codes (entered
  632.             here as their ASCII VALUES) that will tailor your reports to the
  633.             format you desire.  For example, I use an Epson printer and like to
  634.             set it to 1/8" spacing and get 80 report lines per page.  To do
  635.             this, I send a startup string of "<Esc> <0>" to set this print
  636.             mode.  To enter this string in the configuration program, I would
  637.             enter it as "027 048" without the quotes.  The numbers are simply
  638.             the ASCII values of the characters I wish to send.  If you have a
  639.             setup string entered here and wish to clear it, simply hit <Return>
  640.             in response to the prompt in the bottom area of the screen.
  641.  
  642.          6) PRINTER FINISHING STRING
  643.  
  644.             The printer finishing string is commonly used to reverse the
  645.             startup string entered above and is entered in exactly the same
  646.             way.  In the example above, I would use "<Esc> <2>", which would be
  647.             entered as "027 050" without the quotes.  If you have a setup
  648.             string entered here and wish to clear it, simple hit <Return> in
  649.             response to the prompt in the bottom area of the screen.
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  658.  
  659.                                       Page 9
  660.  
  661.  
  662.  
  663.          7) DEFAULT ARCHIVE EXTRACT STATE
  664.  
  665.             This will control the way CATDISK handles any ARCHIVE files that
  666.             it might encounter when cataloging your disks.
  667.  
  668.             If you set it to OFF, CATDISK will NOT extract any archive files
  669.             that it finds on your disks.
  670.  
  671.             If you set it to ON, CATDISK will expand EVERY ARCHIVE file that it
  672.             finds on your disks.
  673.  
  674.             If you set it to QUERY, CATDISK will ask you for permission to
  675.             expand an ARCHIVE file each time it encounters one.
  676.  
  677.             This can be changed temporarily while running CATDISK.
  678.  
  679.          8) DEFAULT CATALOG DRIVE
  680.  
  681.             The default catalog drive is the drive that CATDISK will assume you
  682.             wish to use for labeling disks and reading them for cataloging
  683.             purposes.  This drive may still be changed at startup time (see
  684.             STARTING CATDISK), or from the menu when catdisk is running.
  685.  
  686.             If you are running on single floppy based system, I would recommend
  687.             that you set this drive to the same drive ID that CATDISK will be
  688.             run from.  CATDISK will prompt you to enter the appropriate disks
  689.             at the appropriate time, and will eliminate potential problems with
  690.             the disk caching feature if enabled (See the file README.1ST).
  691.  
  692.          9) CATALOG FILE DIRECTORY
  693.  
  694.             The catalog file directory is the location in your system that
  695.             CATDISK will look for and create its catalog files.  This path may
  696.             contain a drive designator, so that the catalog files may reside on
  697.             a different drive than CATDISK itself, such as a ramdisk (in this
  698.             case don't forget to copy the files to a real disk before you turn
  699.             off or reboot your machine).
  700.  
  701.             If this field is blank, the default drive and directory will be
  702.             used.
  703.  
  704.         10) DISKS/FILES PER CATALOG
  705.  
  706.             The maximum number of disks and files per catalog is simply that.
  707.             When CATDISK starts, it allocates its work space according to this
  708.             setting.  There are currently four possible settings; which one you
  709.             pick is largely dependent upon the environment in which CATDISK is
  710.             to be run.
  711.  
  712.                 These settings are:       DISKS       # FILES
  713.  
  714.                                            2000     32767 (32K)
  715.                                            1500     24576 (24K)
  716.                                            1000     16384 (16K)
  717.                                             500      8192 ( 8K)
  718.  
  719.  
  720.  
  721.  
  722.  
  723.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  724.  
  725.                                       Page 10
  726.  
  727.  
  728.  
  729.         EXCLUDING CERTAIN FILES FROM BEING CATALOGED
  730.  
  731.         There are circumstances where it is desirable to have CATDISK skip over
  732.         certain files while reading in directory information for cataloging
  733.         purposes.  A good example of this may be a situation where the utility
  734.         FILEINFO (from The Norton Utilities) may be used to maintain lists of
  735.         file comments.  This information is stored in each directory in a file
  736.         called FILEINFO.FI, and, if you catalog many diskettes containing this
  737.         file, you will end up with the same filename listed in your catalog
  738.         many times.
  739.  
  740.         Another example would be many DOS system diskettes that contain IO.SYS,
  741.         MSDOS.SYS, COMMAND.COM and AUTOEXEC.BAT.
  742.  
  743.         There is a place in the configuration program where you can give
  744.         CATDISK a list of up to 20 wildcard specifications for files that you
  745.         do not want included in cataloging operations.  When CATDISK scans a
  746.         disk to be cataloged, any files matching one of the specifications in
  747.         the list will be ignored.
  748.  
  749.         One thing to note, though.  If you instruct CATDISK to skip archive
  750.         files, the directory information of those archives will still be
  751.         examined and included in the cataloging operation if appropriate.
  752.  
  753.         The uses for this feature are quite broad.
  754.  
  755.         You can change the list of filespecs to skip over by pressing <F7> from
  756.         the main configuration screen.  You will then see a screen where you
  757.         can fill in up to 20 filespecs that CATDISK should ignore when
  758.         performing cataloging operations.  To change a filespec, simply use the
  759.         cursor keys to move to the desired filespec and type in the new
  760.         information for that area.
  761.  
  762.         To clear out an existing spec, just fill the area with spaces.
  763.  
  764.         When you are finished modifying the list, press <Esc> to return to the
  765.         main configuration screen.
  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) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  790.  
  791.                                       Page 11
  792.  
  793.  
  794.  
  795.         COLOR CUSTOMIZATION
  796.  
  797.         If you would prefer a color scheme other than the default ones supplied
  798.         with CATDISK, you may set your own from within the configuration
  799.         program.  To do so, simply hit <F9> from the configuration screen and
  800.         follow the menus.  Once you have selected this option, you will see a
  801.         menu that will allow you to select some general colors such as screen
  802.         background and border color (CGA type displays only - EGA and VGA have
  803.         no effect), as well as an option to reset the author's (that's me!)
  804.         colors should you really make a mess of the color scheme and wish to
  805.         start over.
  806.  
  807.         The other options will bring up menus that pertain to the various
  808.         screens that you might encounter in your usage of CATDISK.  When you
  809.         reach these, there will be an option available for each item that will
  810.         change its foreground or background color.  Selecting an option will
  811.         step you through the possible color range for that particular item.
  812.  
  813.         On monochrome or black & white systems, you may have to press an option
  814.         key several times to cycle through the available colors, as many of
  815.         these colors may appear the same on these systems.
  816.  
  817.         Does this sound confusing?  Try it for yourself... it's really quite
  818.         easy.  For starters, try setting everything to green on cyan <grin> (if
  819.         you don't have a strong stomach, don't bother).
  820.  
  821.         Once you have set all the fields to your desired settings, you may
  822.         instruct CDISKCFG to save the current settings by pressing <F10>.
  823.         CATDISK will save the appropriate information in the CATDISK.EXE and
  824.         CATLOOK.EXE program files and return to DOS.
  825.  
  826.         If you do not wish to save the changes you made, simply hit <Esc>, and
  827.         you will be returned to DOS, while the previous configuration will
  828.         remain unscathed.
  829.  
  830.  
  831.         DEFAULT SETTINGS
  832.  
  833.         CATDISK is shipped with the following default settings:
  834.  
  835.         1) Screen Update Method:              BIOS
  836.         2) Color or B & W:                    B & W
  837.         3) Disk Caching:                      0 K (Disabled)
  838.         4) Output Lines Per Page:             58
  839.         5) Printer Startup String:            Nothing
  840.         6) Printer Finishing String:          Nothing
  841.         7) Default ARCHIVE Extract State:     ON
  842.         8) Catalog Drive:                     A:
  843.         9) Catalog File Directory:            Default Drive and Directory
  844.         10) Maximum Disks/Files per Catalog:  1000/16384
  845.  
  846.         11) Color Scheme:                     Authors Colors
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  856.  
  857.                                       Page 12
  858.  
  859.  
  860.  
  861.         UPGRADING FROM V3.61 OR LATER
  862.  
  863.         Before copying the new program files to your work disk, you might want
  864.         to rename the executable file from the previous installation
  865.         (CATDISK.COM or CATDISK.EXE) to another name.  The configuration
  866.         utility, CDISKCFG.EXE has the ability to read the configuration
  867.         information from the release that you were using for easy installation
  868.         into this release.  This can save you some time in setting the program
  869.         up for your preferences, particularly if you've customized all the
  870.         screen colors.
  871.  
  872.         Example - Upgrading from V4.50 to this release:
  873.  
  874.         Procedure:
  875.  
  876.         1)  Rename your old CATDISK.EXE to CAT450.EXE (this file holds the
  877.             configuration information from the last installation.
  878.  
  879.         2)  Run the configuration utility, CDISKCFG.EXE.
  880.  
  881.         3)  Hit <F8>.  CDISKCFG will ask you for the file name of the old
  882.             program file.  Answer "CAT450.EXE" (without the quotes).  CDISKCFG
  883.             will search the given file for the appropriate configuration
  884.             information.  If successful, this information will be reflected in
  885.             the configuration options as displayed on the screen.  If you've
  886.             selected the wrong file, you will get an error message, and the old
  887.             settings will remain intact on the screen.
  888.  
  889.         4)  If successful, press <F10>, and the settings will be saved in the
  890.             current CATDISK release.
  891.  
  892.         5)  Delete CAT450.EXE - it's no longer needed.
  893.  
  894.  
  895.         SAVING YOUR CONFIGURATION SETTINGS
  896.  
  897.         When you have all of the configuration options set the way you want
  898.         them, simply press <F10> to save those changes to the various CATDISK
  899.         program files.
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  922.  
  923.                                       Page 13
  924.  
  925.  
  926.  
  927.         GENERAL CONSIDERATIONS WHEN CONFIGURING CATDISK
  928.  
  929.         When setting CATDISK up, there are a few things you should consider:
  930.  
  931.         If you have a hard disk, you should use it for maintaining your catalog
  932.         files (i.e. set your catalog file directory to somewhere on your hard
  933.         drive).
  934.  
  935.         If possible, set your video update method to DIRECT.  CATDISK runs
  936.         faster in this mode.
  937.  
  938.         If you are using a hard drive or a ram disk to hold your catalog files,
  939.         you should NOT use CATDISK's caching feature.  The cache built into
  940.         CATDISK is meant to aid those with floppy disk based systems when doing
  941.         multiple searches through the catalog file.  Using the cache while
  942.         updating a catalog files imposes additional overhead on the operation.
  943.         It is negligible on floppy based systems, as the bottleneck in the
  944.         operation is the disk itself - on hard drives, it is noticeable.  If
  945.         possible, using one of the commercially available disk caching systems
  946.         is recommended, as they incorporate features into their programs such
  947.         as being able to use extended and expanded memory and the like that are
  948.         not feasible to include in CATDISK.
  949.  
  950.         When setting your printer up for printing reports, try to set the
  951.         printer startup string such that the complete catalog listing (i.e.
  952.         files, stats and comments) can be printed.
  953.  
  954.         The best setting for the default ARCHIVE extract state is QUERY.  Many
  955.         archives do not need to be fully extracted as the name of the archive
  956.         filename itself is all that is necessary in order to identify what is
  957.         on that particular disk.  By using some discretion in deciding which
  958.         archive files need be extracted, you can dramatically reduce the size
  959.         of your catalog files (as well as the time needed to update and search
  960.         them).  Some however, need to be extracted (for example, MISC.ARC).
  961.         This setting gives you the best of both worlds.
  962.  
  963.         When setting the default drive and directory for your catalog files, be
  964.         sure and include it in your DOS PATH as well.  Although this is not
  965.         necessary, it will enable you to run CATDISK from anywhere in your
  966.         system without having to change to that directory before running
  967.         CATDISK.  Setting the PATH for this is only beneficial to those using
  968.         hard drives.
  969.  
  970.         When setting the maximum number of disks and files that can be
  971.         maintained in a catalog file, the best setting should be the LOWEST one
  972.         that will contain your largest catalog file.  This will maximize the
  973.         amount of free memory left over that CATDISK can use to store file
  974.         information being read from disks being cataloged, sorting information,
  975.         caching information, and the like.
  976.  
  977.         Keep in mind that, if you should have a catalog file grow to your set
  978.         maximum, you can always re-configure CATDISK (memory permitting, of
  979.         course) to accommodate a larger configuration, unless you are already
  980.         at the highest setting.  When you next run CATDISK after making these
  981.         changes, your catalog file will then be able to grow to the new
  982.         setting.
  983.  
  984.         If you are running on floppy drives, use the 8K setting for disks/files
  985.         per catalog.  Your files will never exceed this limitation.
  986.  
  987.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  988.  
  989.                                       Page 14
  990.  
  991.  
  992.  
  993.         SAMPLE CONFIGURATIONS
  994.  
  995.         Scenario:  One Hard Disk (C:) and a floppy drive:
  996.  
  997.                    Make a directory "C:\CATDISK" and copy the files CATDISK.EXE
  998.                    and CDISKCFG.EXE to it.  Set the configuration to:
  999.  
  1000.                    1) Screen Update Method:              <your option>
  1001.                    2) Color or B & W:                    <your option>
  1002.                    3) Disk Caching:                      0 K (Disabled)
  1003.                    4) Output Lines Per Page:             <your option>
  1004.                    5) Printer Startup String:            <your option>
  1005.                    6) Printer Finishing String:          <your option>
  1006.                    7) Default ARCHIVE Extract State:     <your option>
  1007.                    8) Catalog Drive:                     A:
  1008.                    9) Catalog File Directory:            C:\CATDISK
  1009.                    10) Maximum Disks/Files per Catalog:  <your option>
  1010.                    11) Color Scheme:                     <your option>
  1011.     
  1012.                    Add C:\CATDISK to the DOS PATH and you will be able to call
  1013.                    up CATDISK or CATLOOK from anywhere in your system.
  1014.  
  1015.         Scenario:  Two floppy drives:
  1016.  
  1017.                    Take a blank disk and copy the files CATDISK.EXE and
  1018.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  1019.                    Set the configuration to:
  1020.  
  1021.                    1) Screen Update Method:              <your option>
  1022.                    2) Color or B & W:                    <your option>
  1023.                    3) Disk Caching:                      <your option>
  1024.                    4) Output Lines Per Page:             <your option>
  1025.                    5) Printer Startup String:            <your option>
  1026.                    6) Printer Finishing String:          <your option>
  1027.                    7) Default ARCHIVE Extract State:     <your option>
  1028.                    8) Catalog Drive:                     A:
  1029.                    9) Catalog File Directory:            B:\
  1030.                    10) Maximum Disks/Files per Catalog:  500/8192
  1031.                    11) Color Scheme:                     <your option>
  1032.  
  1033.                    When starting CATDISK for the first time, insert the
  1034.                    program disk in drive A: and take a blank formatted disk and
  1035.                    insert it in drive B:.  This will be your data disk.  When
  1036.                    CATDISK has loaded and has displayed the title screen, you
  1037.                    may remove the CATDISK program disk from the A: drive.  This
  1038.                    will now be the drive from which disks being cataloged will
  1039.                    be read.
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1054.  
  1055.                                       Page 15
  1056.  
  1057.  
  1058.  
  1059.         Scenario:  One floppy drive:
  1060.  
  1061.                    Take a blank disk and copy the files CATDISK.EXE and
  1062.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  1063.                    Set the configuration to:
  1064.  
  1065.                    1) Screen Update Method:              <your option>
  1066.                    2) Color or B & W:                    <your option>
  1067.                    3) Disk Caching:                      <your option>
  1068.                    4) Output Lines Per Page:             <your option>
  1069.                    5) Printer Startup String:            <your option>
  1070.                    6) Printer Finishing String:          <your option>
  1071.                    7) Default ARCHIVE Extract State:     <your option>
  1072.                    8) Catalog Drive:                     A:
  1073.                    9) Catalog File Directory:            A:\
  1074.                    10) Maximum Disks/Files per Catalog:  500/8192
  1075.                    11) Color Scheme:                     <your option>
  1076.  
  1077.                    When starting CATDISK for the first time, insert the
  1078.                    program disk in drive A: and start CATDISK. You will need to
  1079.                    add the command line option /IP (initial pause - see later
  1080.                    in this manual).
  1081.  
  1082.                    Once CATDISK has loaded, it will pause and ask you to insert
  1083.                    your data disk.  If this is the first time you are running
  1084.                    CATDISK, use a blank formatted disk.
  1085.                    When you catalog a disk, you must first remove the data disk
  1086.                    and insert the disk to be cataloged BEFORE activating the
  1087.                    catalog function.  When CATDISK is done reading the disk, it
  1088.                    will ask you to re-insert the data disk.
  1089.  
  1090.  
  1091.         IMPORTANT NOTE
  1092.  
  1093.         If you are running CATDISK on a single drive system, I would recommend
  1094.         the above configuration for two reasons, even though DOS can make the
  1095.         one drive act like A: and B:.
  1096.  
  1097.         1) Perhaps the most important reason; if you've activated the disk
  1098.            caching feature, is that failure to do so may cause a loss of data
  1099.            on disks other than your data disk, particularly when you label a
  1100.            disk.  The reason being that the cache built into CATDISK references
  1101.            the PHYSICAL hardware, not the logical drive that DOS creates (i.e.
  1102.            A: and B: use the SAME piece of equipment).
  1103.  
  1104.            By setting CATDISK to the above configuration, it will be aware that
  1105.            the above situation exists and take the correct action when carrying
  1106.            out critical functions.
  1107.  
  1108.         2) This will allow CATDISK to prompt you for the appropriate disks,
  1109.            thus avoiding the DOS prompt "Insert disk for drive B:" and the
  1110.            like.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1120.  
  1121.                                       Page 16
  1122.  
  1123.  
  1124.  
  1125.         STARTING CATDISK
  1126.  
  1127.         CATDISK is started from the DOS command line by issuing the following:
  1128.  
  1129.         CATDISK parameters
  1130.  
  1131.         - where parameters may include any of the following:
  1132.  
  1133.              /NP        - Specifying this command line option will cause
  1134.                           CATDISK to eliminate the pause after cataloging/
  1135.                           un-cataloging a disk.  It will also eliminate the
  1136.                           "Insert a disk in drive X:" prompt unless it is
  1137.                           absolutely necessary.
  1138.  
  1139.              /NW        - Under normal circumstances, when you catalog a
  1140.                           disk containing a Volume ID that already exists
  1141.                           in the current catalog, CATDISK will issue a
  1142.                           warning to that effect, and will ask you for
  1143.                           verification before proceeding to catalog that disk
  1144.                           The reason behind this is that there is always the
  1145.                           possibility of two different disks having the same
  1146.                           Volume ID.  Cataloging one would mean that the files
  1147.                           from the other would be un-cataloged in the same
  1148.                           process.
  1149.  
  1150.                           If you specify the /NW option on the command line,
  1151.                           this warning will be suppressed, and the disk will
  1152.                           be cataloged without further delay.
  1153.  
  1154.                           This option will also disable CATDISK's warning
  1155.                           before creating any new catalog files when the
  1156.                           current catalog file is changed via CATDISK's menus
  1157.                           to a catalog set that does not exist.
  1158.  
  1159.              /NT        - Suppress totals that CATDISK normally shows at the
  1160.                           end of screen-based and printed reports.
  1161.  
  1162.              /NS        - Suppress status indicators during processing.  This
  1163.                           speeds up processing time.  Status indicators are
  1164.                           there simply to indicate that the computer is
  1165.                           actually doing something useful.  Try it either way
  1166.                           and set it to your liking.
  1167.  
  1168.              /AC        - Turn the auto comment feature ON at startup.
  1169.                           Normally, CATDISK, upon completion of cataloging a
  1170.                           group of files from a disk will immediately
  1171.                           return to the menu.  Activating this feature from
  1172.                           the command line (or from the menu) will cause
  1173.                           CATDISK to proceed to the section where you may
  1174.                           add/modify the file comments for the volume that
  1175.                           you just cataloged.
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1186.  
  1187.                                       Page 17
  1188.  
  1189.  
  1190.  
  1191.              /SD        - CATDISK can display screen information for your
  1192.                           catalog in four different formats.  The default is
  1193.                           to show the Filename, Volume ID, Arcive ID, size,
  1194.                           date, time and attributes for each record.  The
  1195.                           second display format omits the file attributes, but
  1196.                           shows the sub-directory that the file occupies on its
  1197.                           disk.  Setting this option will make the second
  1198.                           format the starting report type.
  1199.  
  1200.              /CO        - similar to above, but activates the third display
  1201.                           format that shows Filename, Volume ID, Archive ID and
  1202.                           file comments will be the starting report type.
  1203.  
  1204.              /SDCO      - similar to above, but activates the fourth display
  1205.                           format that shows a the Subdirectory, Filename,
  1206.                           Volume ID, Archive ID and a slightly truncated
  1207.                           variation of the file comments.
  1208.  
  1209.         - *** NOTE:  If you specify multiple options of /SD, /CO and /SDCO at
  1210.                      startup, the LAST one that you specified on the command
  1211.                      line will take effect.
  1212.  
  1213.              /Ffilename - The default filename that CATDISK uses is "CATDISK"
  1214.                           which may be overridden with this parameter.
  1215.                           Note that there is no space between the /F and the
  1216.                           filename.
  1217.  
  1218.                           If you specify /F? on the command line, CATDISK will
  1219.                           bring up a point and shoot selection menu of all of
  1220.                           the catalogs it detected in your catalog file
  1221.                           directory.  If none are found, an error message will
  1222.                           be displayed and you will be returned to DOS.
  1223.                           Hitting the <Esc> key from within this list will also
  1224.                           cause you to be returned immediately to DOS.
  1225.  
  1226.              /SF        - this will set the default screen format of the disk
  1227.                           summary report to be set to show the entries sorted
  1228.                           in descending order of free disk space, rather than
  1229.                           the default, which is sorted by volume id.  While in
  1230.                           the summary report screen, you can toggle between the
  1231.                           two sort methods by pressing the <Tab> key.
  1232.  
  1233.              /Rx        - this will allow you to set the initial location that
  1234.                           CATDISK will send a report.  This location can
  1235.                           still be changed from within the settings and toggles
  1236.                           menu.  x can be any of the following:
  1237.  
  1238.                           1 - Screen  2 - LPT1   3 - LPT2  4 - Disk File
  1239.                           5 - ASK (Prompt for location before each report)
  1240.  
  1241.              /ALLFILES  - under normal circumstances, the Archive Extract
  1242.                           setting will affect whether or not files contained
  1243.                           inside archive files in your catalog will be included
  1244.                           in a report.  If set to OFF, they will not be
  1245.                           included; setting it to ON or QUERY will cause
  1246.                           CATDISK to include them.  If you add this option to
  1247.                           the command line when starting CATDISK, all files
  1248.                           will be included regardless of the Archive Extract
  1249.                           setting.
  1250.  
  1251.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1252.  
  1253.                                       Page 18
  1254.  
  1255.  
  1256.  
  1257.              /Px        - Set printer output format to report type x, where x
  1258.                           is in the range (0-3).
  1259.  
  1260.                           x Value  Report Type
  1261.                           -------  -----------
  1262.  
  1263.                              0     Show regular file statistics
  1264.                              1     Show file comments
  1265.                              2     Show subdirectory info and comments
  1266.                              3     Show file statistics and comments
  1267.                                    (selecting this report style assumes that
  1268.                                    your printer is set to produce 132 column
  1269.                                    reports)
  1270.  
  1271.              /2         - Turn on CATDISK's two-sided printer reports to cut
  1272.                           down on paper consumption.  See the Settings &
  1273.                           Toggles menu for further details.
  1274.  
  1275.              /D:        - Catalog files from drive D: where D: is one of
  1276.                           [A - {last drive in your system}].
  1277.  
  1278.              /IP        - Initial Pause.  This parameter will cause CATDISK
  1279.                           to pause after it is loaded so that you may remove
  1280.                           the program disk (not needed during the session) and
  1281.                           insert the data disk. This option is only needed if
  1282.                           you are running on a single drive system.
  1283.  
  1284.              /ALIAS     - Adding this option to the command line will activate
  1285.                           the "ALIAS" feature whereby you will be able to
  1286.                           override the name under which a disk will be
  1287.                           cataloged.  Normally, CATDISK will catalog a disk
  1288.                           under the volume label.  This will enable you to
  1289.                           optionally catalog the disk under a different name
  1290.                           without changing the volume label on the disk being
  1291.                           cataloged.
  1292.  
  1293.              /SV        - Have CATDISK suggest sequential volume labels for you
  1294.                           to use when adding a NEW volume label to a disk.
  1295.  
  1296.              /NC        - Normally, when not instructed to read the directory
  1297.                           contents of ZIP or ARJ files, CATDISK will attempt to
  1298.                           read in the main comment from any ZIP or ARJ file
  1299.                           that it encounters.  Adding this option to the
  1300.                           command line  will allow you to turn this feature off
  1301.                           at startup.
  1302.  
  1303.                           Additionally, when CATDISK encounters a GIF file, it
  1304.                           will attempt to read in the resolution/color
  1305.                           information from it and place it in the comment
  1306.                           field.  This option will also disable this feature.
  1307.  
  1308.              /NCC       - normally, at startup, CATDISK will enable a feature
  1309.                           whereby any ZIP or ARJ files containing a main
  1310.                           comment that get expanded will have that main comment
  1311.                           inserted into the comment area of any file entry
  1312.                           extracted from that ZIP/ARJ file that does not
  1313.                           already have a comment.  By adding this option to the
  1314.                           command line, this feature will be turned off at
  1315.                           program startup.
  1316.  
  1317.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1318.  
  1319.                                       Page 19
  1320.  
  1321.  
  1322.  
  1323.              /N4        - Normally, support for this feature should be left on.
  1324.                           4DOs and Norton DOS (NDOS), command interpreter (i.e.
  1325.                           COMMAND.COM) replacements which greatly enhance the
  1326.                           functionality of DOS.  One feature that is
  1327.                           particularly handy is their ability to add comments
  1328.                           to your directory entries at the DOS level using a
  1329.                           command called DESCRIBE.  If you copy or move a file
  1330.                           from the command prompt, that comment goes right
  1331.                           along with the file (the DISKFILL utility, discussed
  1332.                           later in this user manual, can also do this).  These
  1333.                           comments are stored in a hidden file, DESCRIPT.ION in
  1334.                           each subdirectory where file comments are contained.
  1335.  
  1336.                           When CATDISK encounters such a file, the comments are
  1337.                           automatically read into your catalog where applicable
  1338.                           and the hidden file is cataloged with the comment
  1339.                           "4DOS/NDOS File Descriptions."  If you do not want
  1340.                           this file cataloged at all, you can do so from the
  1341.                           configuration utility, CDISKCFG.
  1342.  
  1343.                           By adding this option to the command line when you
  1344.                           start CATDISK, you can disable this feature if it is
  1345.                           causing you any problems (such as having a file
  1346.                           called DESCRIPT.ION from another application).
  1347.  
  1348.              /ND        - shows dates in numeric format as YYYY-MM-DD.
  1349.  
  1350.              /DISKCOM   - during normal re-cataloging operations, CATDISK will
  1351.                           not override a file comment that already exists in
  1352.                           the catalog file with one found on disk (eg. in a ZIP
  1353.                           file, or in a 4DOS description).  This is to protect
  1354.                           any comment "massaging" that you may have done when
  1355.                           that disk was previously cataloged.  Overriding that
  1356.                           comment would undo any editing that you may have
  1357.                           done.  By adding this option to the command line, you
  1358.                           can cause CATDISK to override existing comments with
  1359.                           those found on disk.  This option may only be set at
  1360.                           program startup - there is no option in the settings
  1361.                           & toggles menu to change it.  This option should be
  1362.                           used with caution.
  1363.  
  1364.              /CATALOG   - If this option is added to your command line, CATDISK
  1365.                           will perform a catalog operation on the catalog drive
  1366.                           (the setting from the CDISKCFG program may be
  1367.                           overridden on the command line) and return to DOS
  1368.                           when done.  If you have the autocomments feature in
  1369.                           CATDISK turned on, you will be taken to the comment
  1370.                           entry screen first.  When you exit from this screen,
  1371.                           you will then be returned to DOS.
  1372.  
  1373.                           This option makes it possible to catalog a disk from
  1374.                           a batch file, or from within another application by
  1375.                           shelling out to CATDISK with the correct parameters.
  1376.                           When CATDISK exits, you will be returned to your
  1377.                           application.
  1378.  
  1379.                           NOTE:  It is not advisable to put this option in the
  1380.                           CATDISK environment variable, as it will make it
  1381.                           impossible to get into CATDISK's other functions.
  1382.  
  1383.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1384.  
  1385.                                       Page 20
  1386.  
  1387.  
  1388.  
  1389.              /QUIET     - Silent operation.  Supresses sound in CATDISK.
  1390.  
  1391.              /NOSHELL   - disables the "Shell To Dos" function from all menus.
  1392.                           This may be desirable when allowing others access to
  1393.                           CATDISK from a menu system and you do not wish the
  1394.                           user to be able to access the DOS prompt.  If the
  1395.                           user selects the option to shell out to DOS, and this
  1396.                           option was present, a short beep will sound (unless
  1397.                           you also added /QUIET to the command line) and no
  1398.                           further action will take place.
  1399.  
  1400.              /EXITV     - Normally, when you press the <Esc> key from the main
  1401.                           menu, CATDISK will promptly exit to DOS.  Under
  1402.                           certain circumstances, you may find it beneficial to
  1403.                           have CATDISK verify that you really want to exit from
  1404.                           the program.  By adding this option to the command
  1405.                           line, CATDISK will give you a YES/NO prompt asking
  1406.                           you if you really want to leave the program.
  1407.  
  1408.  
  1409.         The slash "/" may be substituted by either a dash "-" or a space " ".
  1410.  
  1411.         Examples:  CATDISK /FGAMES/NS/AC/CO/P3/R5/ALIAS/B:   or  CATDISK A:
  1412.  
  1413.         - entering CATDISK ? will bring up a help message indicating the above.
  1414.  
  1415.         NOTE:  You may also put the command line options in a CATDISK
  1416.         environment variable using the DOS "SET" command.  This command (see
  1417.         examples below), may be placed in your AUTOEXEC.BAT file so that you
  1418.         will not need to remember which command line options to use to obtain
  1419.         your favorite setup, or for that matter, to type them!
  1420.  
  1421.         - example:  SET CATDISK=/FGAMES/NS/AC/CO/P2/ALIAS/B:
  1422.  
  1423.         When you start CATDISK under these circumstances, simply type "CATDISK"
  1424.         <Enter> and the above options will automatically be invoked.
  1425.  
  1426.         Any options entered on the command line will be added to those
  1427.         specified in the CATDISK environment variable.  This makes it possible
  1428.         to have a base set of options set in the DOS environment and have an
  1429.         optional set that you can specify at the time you run CATDISK.
  1430.  
  1431.         It is also possible to override some of the options as well (for
  1432.         example, the printed report format, the screen report format, the
  1433.         catalog file, and the catalog drive), as CATDISK will pay attention to
  1434.         the last option of a given type.
  1435.  
  1436.  
  1437.         For example, using the above environment example, entering the command
  1438.  
  1439.         CATDISK /A:/P1
  1440.  
  1441.         will cause CATDISK to set the catalog drive to A: (overrides the B:
  1442.         option), and the printer report format to show comments (format #1)
  1443.         instead of statistics and comments (format #2).
  1444.  
  1445.         Once CATDISK has been successfully started, a title screen will appear.
  1446.         Hit any key to proceed to the main menu.
  1447.  
  1448.  
  1449.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1450.  
  1451.                                       Page 21
  1452.  
  1453.  
  1454.  
  1455.                              3.  U S I N G   C A T D I S K
  1456.  
  1457.         USING THE MENUS
  1458.  
  1459.         The major options available from CATDISK such as the main functions
  1460.         that you see in the opening menu after the title page disappears can be
  1461.         selected in two different ways.
  1462.  
  1463.         The first, and easiest is just to hit the indicated key beside the
  1464.         desired option.
  1465.  
  1466.         In response to a requests from registered users, we have also
  1467.         implemented a "point and shoot" method of selecting items from a menu.
  1468.  
  1469.         Simply use the cursor keys to position the flashing arrows in the
  1470.         inverse box that indicates the keystroke required to activate the
  1471.         desired option and hit <Return> or <Enter>.  This will carry out the
  1472.         same function as if you had struck the key in the inverse box.
  1473.  
  1474.         One advantage that the second approach has to the first is that those
  1475.         of you who do not touch type numbers very well (or have a tendency to
  1476.         hit the key beside the one you are after) have another method to use to
  1477.         navigate through the menus of CATDISK.
  1478.  
  1479.         Another is that once you have activated a function such as cataloging a
  1480.         disk, you need only type <Return> to re-activate that function as
  1481.         CATDISK will remember the last option you activated (quite handy if you
  1482.         are cataloging multiple disks, as the <Return> key is larger than
  1483.         most... you aren't as apt to miss it).
  1484.  
  1485.         The menus in CATDISK currently consist of a main menu controlling the
  1486.         main functions of catalog maintenance, a settings & toggles menu
  1487.         containing functions that affect how CATDISK responds to certain
  1488.         situations, and a reports & inquiries menu from which all reports are
  1489.         accessed.
  1490.  
  1491.         Normally, to access the options available in the Settings & Toggles
  1492.         Menu, you have to go to that menu of options from the main menu in
  1493.         order to change any of the settings.  We have provided shortcuts to the
  1494.         options in the Settings & Toggles Menus that are accessible from both
  1495.         the Main Menu and from the Reports & Inquiries Menu.
  1496.  
  1497.         To change any of the settings available in the settings and toggles
  1498.         menu directly from the either the main menu or the reports & inquiries
  1499.         menu, simply hold down the <Alt> key and press the number key (from the
  1500.         top row only, not the numeric keypad) or function key that you would
  1501.         normally hit if you were in the settings and toggles menu.  CATDISK
  1502.         will act on that keystroke as if you had selected that option directly
  1503.         from the settings and toggles appropriate menu.
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1516.  
  1517.                                       Page 22
  1518.  
  1519.  
  1520.  
  1521.         SELECTING A VOLUME NAME FROM A LIST
  1522.  
  1523.         Other than actually labeling a disk, there are three other locations in
  1524.         CATDISK where you will be prompted for a volume label: un-cataloging a
  1525.         disk; generating a report by volume id; and adding file comments by
  1526.         volume.  If you know what volume label is desired at the prompt, you
  1527.         may enter it verbatim.  Leaving it blank, however, will cause CATDISK
  1528.         to come up with a point-and-shoot list of all the volume names in the
  1529.         current catalog file.  When this list first appears, you will notice
  1530.         that the first volume is highlighted.  Selecting a volume from this
  1531.         list is merely a matter of moving the highlight bar to the desired
  1532.         volume and pressing <Enter>.
  1533.  
  1534.         The following options are available:
  1535.  
  1536.           <Cursor UP>   - move up one line in the list.  If you are already at
  1537.                           the top of a column, the highlight bar will move to
  1538.                           the bottom of the previous column if available.
  1539.  
  1540.           <Cursor DOWN> - move down one line in the list.  If you are already
  1541.                           at the bottom of a column, the highlight bar will
  1542.                           move to the top of the next column if available.
  1543.  
  1544.           <PgUp>        - move back 96 lines in the list.
  1545.  
  1546.           <PgDn>        - move ahead 96 lines in the list.
  1547.  
  1548.           <Home>        - move to the beginning of the list.
  1549.  
  1550.           <End>         - move to the end of the list.
  1551.  
  1552.           <Grey Plus>   - move forward in the list 1/15th of the total length
  1553.                           of the list (see the appendix regarding the SCROLL
  1554.                           BAR later in this manual).
  1555.  
  1556.           <Grey Minus>  - move back in the list 1/15th of the total length of
  1557.                           the list (see the appendix regarding the SCROLL BAR
  1558.                           later in this manual).
  1559.  
  1560.           <Enter>       - Select the highlighted volume for the prompt from the
  1561.                           previous screen.
  1562.  
  1563.           <Esc>         - return to the menu with no further action taken.
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1582.  
  1583.                                       Page 23
  1584.  
  1585.  
  1586.  
  1587.         OPTION 1 - SET DRIVE FOR CATALOGING
  1588.  
  1589.         This function allows you to set the drive from which the files to be
  1590.         cataloged will be read.  Simply select letter from (A - x) to select
  1591.         the drive with that DOS letter designation, where x is the last drive
  1592.         that CATDISK detected in your system configuration.  The change will be
  1593.         noted immediately in the status area at the top of the screen.
  1594.  
  1595.         *** NOTE:  If you are running with one floppy drive only and have
  1596.                    turned the caching option on from the configuration utility,
  1597.                    do not set this option to a drive other than the one on
  1598.                    which the catalog files reside (probably A:).  Failure to do
  1599.                    so could cause loss of data on your disks.
  1600.                    See the SAMPLE CONFIGURATIONS section covered earlier in
  1601.                    this section.  You have been warned!
  1602.  
  1603.         Users with a hard-disk, single floppy configuration, who are running
  1604.         CATDISK from the hard disk will NOT experience this problem and may
  1605.         proceed as normal.  It's ONLY if the same PHYSICAL drive is being used
  1606.         for the CATDISK work files AND the disk to be cataloged that the
  1607.         above precautions must be taken.
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1648.  
  1649.                                       Page 24
  1650.  
  1651.  
  1652.  
  1653.         OPTION 2 - SET CURRENT CATALOG FILE
  1654.  
  1655.         Although the catalog filename may be set upon starting up CATDISK, it
  1656.         may also be convenient to be able to change the current file from
  1657.         within a CATDISK session.  Select option #3 from the main menu, and you
  1658.         will be prompted for a new catalog file to use.  Any valid DOS filename
  1659.         will do.  Be sure to specify the NAME portion only; do not include the
  1660.         file extension portion.  If the name you specify is valid, it will then
  1661.         be used for all subsequent catalog updates and queries (This is
  1662.         reflected at the top of the screen).  If not, an error message will be
  1663.         issued and no change will be made to the current catalog file name.
  1664.  
  1665.         If the catalog file set that you specify does not exist, CATDISK will
  1666.         automatically create a new catalog for you.  Before doing so, however,
  1667.         CATDISK will indicate that the summary or catalog file does not exist
  1668.         and request your permission to create it before proceeding.  If you
  1669.         specified /NW on the command line, this warning will not appear -
  1670.         CATDISK will simply proceed to create any necessary files for the
  1671.         specified catalog set.
  1672.  
  1673.         If you don't enter anything for the catalog filename, a list of all
  1674.         current catalog files in the catalog directory will be displayed on the
  1675.         screen.  If the desired catalog is on a removable disk (i.e. floppy
  1676.         disks or removable hard drives), be sure and have that disk in the
  1677.         appropriate drive BEFORE you enter nothing to the prompt so the desired
  1678.         files will appear in the list.  This method can be handy when you are
  1679.         not sure of exactly what you called a particular catalog file.
  1680.  
  1681.         To select a file from the list, simply move the highlight bar around
  1682.         the list of filenames with the cursor keys so that it rests on the
  1683.         desired catalog file.  At this point, hit the <Enter> key, and that
  1684.         file will be selected as if you had typed it at the prompt.  Hitting
  1685.         <Esc> in this screen will abort the operation as if you had pressed
  1686.         <Esc> at the prompt.
  1687.  
  1688.         If you are switching to a catalog that already exists, and it will not
  1689.         fit into the configuration you defined in the configuration program
  1690.         (maximum disks/files per catalog), you will get an error message and
  1691.         the catalog file setting will be left unchanged.
  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) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1714.  
  1715.                                       Page 25
  1716.  
  1717.  
  1718.  
  1719.         OPTION 3:  SETTINGS AND TOGGLES MENU
  1720.  
  1721.         The options available in this sub-menu will allow you to control the
  1722.         behavior of some of the features of CATDISK.  You can get to this menu
  1723.         by selecting option #2 from the main menu.
  1724.  
  1725.         The options available on this menu are:
  1726.  
  1727.  
  1728.         Sub-option 1 - Set Drive For Cataloging
  1729.         ---------------------------------------
  1730.  
  1731.         This is exactly the same for main menu option #1 and is included on the
  1732.         settings and toggles menu for convenience.
  1733.  
  1734.  
  1735.         Sub-option 2 - Pauses On/Off
  1736.         ----------------------------
  1737.  
  1738.         Under normal circumstances, CATDISK will pause at strategic places,
  1739.         either to allow you to view what has just happened (cataloging and
  1740.         un-cataloging), or to prompt you to insert a disk in drive X:
  1741.         (labeling or reading directories, etc).  If you turn this toggle off,
  1742.         CATDISK will only prompt you for a disk when absolutely necessary.  In
  1743.         addition, there will be no pause at the end of a catalog update; you
  1744.         will immediately be returned to the main menu, or to the comment entry
  1745.         screen if you have the AUTO COMMENT feature turned on.
  1746.  
  1747.  
  1748.         Sub-option 3 - Change Printer Report Type
  1749.         -----------------------------------------
  1750.  
  1751.         CATDISK currently supports three printer report styles, which are
  1752.         detailed here.  The particular report style that you desire may be set
  1753.  
  1754.         with this toggle, and will be reflected in the toggles portion of the
  1755.         menu screen.
  1756.  
  1757.         STATISTICS:  This is the default report style (unless overridden on the
  1758.                      command line), which is to show the path, filename, volume
  1759.                      id, archive id, as well as the size, date, time and DOS
  1760.                      directory attributes of each file listed.
  1761.  
  1762.                      This report style corresponds to the command line option
  1763.                      /P0, and will fit on an 80 column printer.
  1764.  
  1765.           COMMENTS:  This report style will show the filename, volume id,
  1766.                      archive id and full comment for each file listed.
  1767.  
  1768.                      This report style corresponds to the command line option
  1769.                      /P1, and will fit on an 80 column printer.
  1770.  
  1771.           SUBDIRS:   This report style will show the subdirectory, filename,
  1772.                      volume id, archive id and a shortened comment for each
  1773.                      file listed.
  1774.  
  1775.                      This report style corresponds to the command line option
  1776.                      /P1, and will fit on an 80 column printer.
  1777.  
  1778.  
  1779.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1780.  
  1781.                                       Page 26
  1782.  
  1783.  
  1784.  
  1785.           ALL INFO:  This report style will show all of the fields from the two
  1786.                      above reports.  Please note that it assumes that you
  1787.                      either have a 132 column printer, or an 80 column printer
  1788.                      set to compressed mode.  It corresponds to the command
  1789.                      line option /P3.
  1790.  
  1791.  
  1792.         Sub-option 4 - Report Totals On/Off
  1793.         -----------------------------------
  1794.  
  1795.         When this setting is turned ON, CATDISK will display a line at the
  1796.         bottom of the screen-based reports showing the totals for the given
  1797.         report showing on the screen.  In printed or disk-based reports, these
  1798.         totals will be shown at the end of a report.
  1799.  
  1800.         One consideration in paginated reports... if your last report page is
  1801.         quite full, there is a possibility that the total line may "bleed" over
  1802.         to the next page on your printer.
  1803.  
  1804.         The presence of a "/T" beside the printer report type in the status
  1805.         area of CATDISK's main screen indicates that this feature is currently
  1806.         turned on.
  1807.  
  1808.  
  1809.         Sub-option 5 - File Comments On The Fly
  1810.         ---------------------------------------
  1811.  
  1812.         If this toggle is turned OFF, CATDISK will proceed back to the main
  1813.         menu upon completion of the process of cataloging a disk.  If you wish
  1814.         to add comments for some/all of the files that you have just
  1815.         cataloged, you may turn this toggle ON.  When this is the case,
  1816.         CATDISK will catalog files in the normal manner, but upon completion,
  1817.         you will be taken to another screen that will allow you to scroll
  1818.         through the files you just cataloged and add/update the comments for
  1819.         each file shown.  See Option F1 - Add/Change File Comments for details
  1820.         on how this section of the program works.
  1821.  
  1822.  
  1823.         Sub-option F1 - Main Archive Comment Copy
  1824.         -----------------------------------------
  1825.  
  1826.         If this feature is turned on, CATDISK will take special action when
  1827.         expanding ZIP and ARJ files.  If a main ZIP/ARJ file comment is found,
  1828.         any file entries extracted that do not have comments will have the main
  1829.         ZIP/ARJ file comment entry inserted instead.  The presence of a "C"
  1830.         beside the Auto Comments setting in the status information at the top
  1831.         of the screen indicates that this feature is turned on.
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1846.  
  1847.                                       Page 27
  1848.  
  1849.  
  1850.  
  1851.         Sub-option F2 - Extract 4DOS/NDOS Comments
  1852.         ------------------------------------------
  1853.  
  1854.         This setting controls whether or not CATDISK will process directory
  1855.         comments created by JP Software's 4DOS or Symantec Software's Norton
  1856.         DOS (NDOS).  If on, CATDISK, during a cataloging operation, will look
  1857.         for a hidden file in each subdirectory called "DESCRIPT.ION", which
  1858.         contains the text for these comments.  Where applicable, these comments
  1859.         will be included in your catalog file automatically.  If off, CATDISK
  1860.         will ignore these comments.  The presence of a "4" beside the Auto
  1861.         Comments setting in the status information at the top of the screen
  1862.         indicates that this feature is turned on.
  1863.  
  1864.         Although not tested, Norton DOS (NDOS) is largely based on JP
  1865.         Software's 4DOS program, and should work in a similar manner to that
  1866.         product.
  1867.  
  1868.  
  1869.         Sub-option 6 - Set Current Report Destination
  1870.         ----------------------------------------------
  1871.  
  1872.         Selecting this option will affect the report destination and whether or
  1873.         not CATDISK will ask you where the report should go.  Each time you
  1874.         select option 1, CATDISK will run through a sequence of five possible
  1875.         locations (SCRN (Screen), LPT1, LPT2, Disk, or ASK).
  1876.  
  1877.         Selecting one of the first four will cause CATDISK to immediately
  1878.         generate a report to the selected destination IMMEDIATELY upon
  1879.         selecting it.  You will not be prompted any further, unless you have
  1880.         selected DISK, in which case, you will be asked for a filename in which
  1881.         to place the report.
  1882.  
  1883.         If you select ASK, CATDISK will prompt you for a report location (one
  1884.         of the first four in the list) each time you ask it to generate a
  1885.         report.
  1886.  
  1887.         I usually leave this setting set to SCREEN as, most of the time, I
  1888.         browse through my catalog files on the screen.  You, however, may find
  1889.         it handy to set this to ASK, especially if you jump to report locations
  1890.         frequently.  If this is the case, you may, if you haven't already, add
  1891.         the command line option /ASK to your current list of options.  This
  1892.         will override the default location of SCREEN at startup, negating the
  1893.         need to set it manually each time you start CATDISK.
  1894.  
  1895.  
  1896.         Sub-option 7 - Print On Both Sides of Page
  1897.         ------------------------------------------
  1898.  
  1899.         Normally, CATDISK will print its hardcopy reports in a continuous
  1900.         stream to the printer.  By turning this feature on, CATDISK will print
  1901.         your reports in a format such that the odd numbered pages will be
  1902.         printed first.  CATDISK will then pause and ask you to re-insert the
  1903.         paper in your printer so that the even numbered pages will print on the
  1904.         back side of the odd numbered pages.  This will cut paper consumption
  1905.         on your reports in half.
  1906.  
  1907.         You will know when this feature is activated when you see a "/2" beside
  1908.         the report location in the information at the top of the screen.
  1909.  
  1910.  
  1911.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1912.  
  1913.                                       Page 28
  1914.  
  1915.  
  1916.  
  1917.         IMPORTANT NOTE:  Re-inserting paper previously printed on back into
  1918.                          some types of laser printers can cause damage to the
  1919.                          internal mechanisms of those printers.  Consult your
  1920.                          printer manual or check with the manufacturer before
  1921.                          using this option with your laser printer.
  1922.  
  1923.         Sub-option 8 - ARCHIVE Extract Setting
  1924.         --------------------------------------
  1925.  
  1926.         Although this setting is permanently set from the CDISKCFG utility, it
  1927.         is sometimes be convenient to be able to change it during a CATDISK
  1928.         session.  Selecting option 8 will run the Auto ARCHIVE Extract setting
  1929.         through three possibilities, OFF, ON, or QUERY.  The current setting is
  1930.         shown near the top of the screen in the status area.
  1931.  
  1932.         If this feature is turned OFF, any archive files encountered during the
  1933.         cataloging process will NOT be expanded.  Also, when generating
  1934.         reports, CATDISK will NOT include any files from the catalog in the
  1935.         report that are contained inside archive files, even though they may be
  1936.         present in the catalog itself (an archive may been expanded from a
  1937.         previous session where it was turned ON).
  1938.  
  1939.         If this feature is turned ON, CATDISK will extract the archive
  1940.         directory of any archive it encounters in its search.  Files contained
  1941.         in archives will be listed in any applicable reports.
  1942.  
  1943.         If it is set to QUERY, CATDISK will prompt you as to whether it should
  1944.         extract the archive directory of any archive that it encounters in its
  1945.         search before proceeding to do so.  Reports generated will act as if
  1946.         the feature is turned ON.
  1947.  
  1948.         Sub-option 9 - Comments When Arcs Not Extracted
  1949.         -----------------------------------------------
  1950.  
  1951.         In the course of its normal operation, CATDISK, when not extracting the
  1952.         directory information from ZIP or ARJ files, will search each one it
  1953.         encounters for the comment of the ZIP/ARJ file itself.  Under some
  1954.         circumstances, such as those where your particular collection of
  1955.         ZIP/ARJ files do not contain comments, or where the vast majority of
  1956.         them contain BBS advertisements (not really what they were intended
  1957.         for), this search can be both time consuming and meaningless.  This
  1958.         toggle will turn this feature on or off.  The presence of a "C" beside
  1959.         the Archive Extract setting in the status information at the top of the
  1960.         screen indicates that this feature is turned on.
  1961.  
  1962.         Although not related to ZIP/ARJ files, this feature will also control
  1963.         whether or not the graphic resolution and color information will be
  1964.         extracted from a GIF file to be included as the default comment for
  1965.         that particular file.
  1966.  
  1967.  
  1968.         Sub-option 0 - Aliases On/Off
  1969.         -----------------------------
  1970.  
  1971.         Activating this option will enable you to override the name under which
  1972.         a disk will be cataloged.  Normally, CATDISK will catalog a disk under
  1973.         the volume label.  This will allow you to optionally catalog the disk
  1974.         under a different name without changing the volume label on the disk
  1975.         being cataloged.
  1976.  
  1977.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  1978.  
  1979.                                       Page 29
  1980.  
  1981.  
  1982.  
  1983.         Keep in mind that if you re-catalog the disk at a later time, you must
  1984.         remember the new name that you gave to the disk in your catalog,
  1985.         otherwise, duplication will occur in your catalog.
  1986.  
  1987.         The presence of a "ALS" beside the "VolLab:" setting in the status area
  1988.         of the screen indicates that this feature is turned on.
  1989.  
  1990.  
  1991.         Sub-option F3 - Suggest Volume Label On/Off
  1992.         -------------------------------------------
  1993.  
  1994.         When this setting is turned ON, CATDISK will suggest a volume label to
  1995.         use when labeling a disk.  You may, of course, change that label at the
  1996.         prompt if you wish.  Depending on what has been done in CATDISK with
  1997.         regard to previous labeling operations, CATDISK will use the following
  1998.         criteria:
  1999.  
  2000.         1) If the disk already has a volume label, CATDISK will suggest that
  2001.            label.
  2002.  
  2003.         If the disk does not have a volume label:
  2004.  
  2005.         2) If you have previously labeled a disk during the current CATDISK
  2006.            session (i.e. you have not exited from the CATDISK program and have
  2007.            returned to it), CATDISK will examine the last entered volume label
  2008.            (entered at the prompt) to see if there is a numeric part of that
  2009.            volume label.  A numeric sequence is considered by CATDISK to be a
  2010.            series of two or more digits in a row.  That numeric part is then
  2011.            incremented by one and that new label becomes the suggested label.
  2012.  
  2013.            Examples:  DISK001   would become  DISK002
  2014.                       DISK001A  would become  DISK002A
  2015.  
  2016.            If two or more separate numerical sequences are present in the
  2017.            volume label, CATDISK will increment the rightmost one.
  2018.  
  2019.            Example:   A001B002 would become A001B003
  2020.  
  2021.            If there is no numerical part in the previous volume label, the
  2022.            volume label will be suggested verbatim.
  2023.  
  2024.         3) If you have not previously labeled a disk during the current CATDISK
  2025.            session, CATDISK will examine your summary file.  If you have
  2026.            previously cataloged disks with CATDISK, the last alphabetical entry
  2027.            in the summary file will be taken and treated as the suggestion in
  2028.            option 2.
  2029.  
  2030.         4) If you have not previously labeled a disk during the current CATDISK
  2031.            session and have not previously cataloged any disks with CATDISK,
  2032.            nothing will be suggested.
  2033.  
  2034.         If this feature is activated, you will see an "SV" to the right of the
  2035.         slash in the "VolLab:" section of the status area of the screen.
  2036.  
  2037.  
  2038.         Sub-option <Esc> - Exit To Main Menu
  2039.         ------------------------------------
  2040.  
  2041.         Exactly what it says.
  2042.  
  2043.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2044.  
  2045.                                       Page 30
  2046.  
  2047.  
  2048.  
  2049.         OPTION 4:  LABELING A DISK
  2050.  
  2051.         Selection of option #4 on the main menu will allow the VOLUME LABEL of
  2052.         a disk to be set or changed.  Upon selection, CATDISK will attempt to
  2053.         read the current label of the disk.  If none is present, you will be
  2054.         notified of this, and will be given the opportunity to create a volume
  2055.         label for that disk.  See the DOS manual on volume labels for more
  2056.         information.  If a label already exists on the disk, its name will be
  2057.         shown as a reminder, and you will be given an opportunity to change the
  2058.         label name.  Just enter the new label name and hit <CR>.
  2059.  
  2060.         Note that if you have the volume label suggestion facility turned on,
  2061.         CATDISK will recommend a sequential volume label for any new disks
  2062.         being labeled.  See the section of this manual dealing with "Suggest
  2063.         Volume Label" setting in the Settings & Toggles chapter for details on
  2064.         what CATDISK will recommend for a volume label under various
  2065.         circumstances.
  2066.  
  2067.         If the label name was valid, the change will be made, otherwise, an
  2068.         error message indicating such will be issued and you will return to the
  2069.         main menu.
  2070.  
  2071.         If you do not wish to enter or change the disk label, simply hit <ESC>
  2072.         at the volume label prompt and you will immediately return to the main
  2073.         menu with no changed made to the disk label.
  2074.  
  2075.         When the volume label has been successfully changed or created, CATDISK
  2076.         will check to see if the old label, if any was present, exists in the
  2077.         current catalog file.  If so, you will be given an opportunity to have
  2078.         CATDISK automatically change the old volume id references to the newly
  2079.         entered one.  If the disk that you re-labeled is one that actually is
  2080.         in the catalog, answer <Y>es to the prompt.  CATDISK will take care of
  2081.         the rest.  This feature can be a great time saver, as it eliminates the
  2082.         need to uncatalog the disk under the old volume id, and re-catalog it
  2083.         under the new name.
  2084.  
  2085.         If the disk is not in the catalog, answer <N>o to the prompt. Answering
  2086.         <Y>es under these circumstances will not damage the catalog file, but
  2087.         will cause confusion as to what disk the altered catalog records reside
  2088.         on.
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2110.  
  2111.                                       Page 31
  2112.  
  2113.  
  2114.  
  2115.         OPTION 5:  CATALOGING/RE-CATALOGING A DISK
  2116.  
  2117.         This selection will initiate cataloging or re-cataloging of the files
  2118.         on the selected catalog disk as shown in the status area at the top of
  2119.         the screen.  The volume label will be read, and if it doesn't exist,
  2120.         you will be given an opportunity to enter a volume label for the disk.
  2121.         If you hit <ESC> at the label prompt, the operation will be aborted and
  2122.         you will be returned to the main menu without cataloging your disk.
  2123.         After entering the label name for that disk, you will be asked if you
  2124.         wish to write that label to disk.  If you answer <Y>es, the disk will
  2125.         be labeled and cataloging will continue.  If you answer <N>o, the label
  2126.         will not be written, but the disk will be cataloged under the name that
  2127.         you gave it.  This will allow easy cataloging of write-protected disks.
  2128.  
  2129.         Please note that volume labels created by Peter Norton's "Volabel"
  2130.         utility may contain lower case characters.  CATDISK will convert the
  2131.         labels to upper case before adding them to the catalog.  This will
  2132.         enable you to manipulate and uncatalog any of these disks.  The
  2133.         physical volume label on the disk will be left unchanged.
  2134.  
  2135.         There are volume label utilities on the market that allow the entry of
  2136.         illegal characters into the volume label.  CATDISK will change these
  2137.         offending characters into spaces when it encounters them.  This will
  2138.         not affect the physical label on the disk, but rather the way CATDISK
  2139.         stores them in its catalog files.
  2140.  
  2141.         If the label on the disk to be cataloged already exists in the
  2142.         catalog, you will be notified of this situation, and will be given an
  2143.         opportunity to abort the operation.  This feature has been added as a
  2144.         safeguard against a situation where two disks of the same volume id may
  2145.         be overriding each other and clobbering the catalog contents of the
  2146.         other disk.  If you specified the "/NW" option on at startup, this
  2147.         warning will not be issued.
  2148.  
  2149.         If you specified /ALIAS in your startup options, a screen will appear
  2150.         showing you what the current volume label is on the disk you are about
  2151.         to catalog.  A prompt will appear below this asking you for a name
  2152.         under which you would like the disk to be cataloged.  The current
  2153.         volume label will be displayed in this area, and you will be allowed to
  2154.         change it before the cataloging process takes place.  This can be very
  2155.         handy in certain situations such as vendor disks that insist that the
  2156.         volume label remain unchanged, as the software uses the volume label to
  2157.         identify the disk.  The volume label on the disk may not mean anything
  2158.         to you, and  using an alias may be desirable in this case.
  2159.  
  2160.         As flexible as the ability to catalog under an alias can be, there are
  2161.         a couple of drawbacks that should be considered before you decide to
  2162.         make the name in the catalog different from the volume label on the
  2163.         disk.  Firstly, if you go to re-catalog the disk at a later time and
  2164.         don't provide exactly the same alias that was used initially, you can
  2165.         wind up with duplicate entries in the catalog file, as CATDISK
  2166.         currently has no way of knowing that the disk has already been
  2167.         cataloged.  Secondly, if at a later date, you use option #3 in CATDISK
  2168.         to change the volume label on a disk that has already been cataloged,
  2169.         CATDISK will have no way of knowing that it should give you the
  2170.         opportunity to change the entries in the catalog to reflect the new
  2171.         volume label, as the entries are not cataloged under the old volume
  2172.         label.
  2173.  
  2174.  
  2175.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2176.  
  2177.                                       Page 32
  2178.  
  2179.  
  2180.  
  2181.         The best advice would be that if you never intend to re-catalog a disk
  2182.         in the future, then it would be ok to use an alias, otherwise, it's
  2183.         best to stick with a meaningful volume label.
  2184.  
  2185.         Once the name of the disk has been established for cataloging purposes,
  2186.         the directory and any archive or library entries (if the ARCHIVE auto
  2187.         extract feature option is turned on - it is by default) will be read
  2188.         (if the ARCHIVE auto extract is set to QUERY, you will be asked for
  2189.         verification before a given archive or Library will be read).  This
  2190.         process will be repeated for each sub-directory on the disk as well.
  2191.         All existing levels of sub-directories will be searched.
  2192.  
  2193.         If the archive comment extract feature is turned on (see sub-option #0
  2194.         in the settings & toggles menu), CATDISK will extract the graphic
  2195.         resolution and color information of any GIF files that it encounters
  2196.         during its operation and place this information in the comment field
  2197.         (if it is a new file, or an existing entry in the catalog file that is
  2198.         blank) as the default comment.  For example, a picture contained in a
  2199.         GIF file that has a resolution of 640 by 480 pixels and contains 256
  2200.         colors will appear as "640x480x256".
  2201.  
  2202.         If CATDISK encounters a ZIP, ARJ, ZOO or DWC file, any comments that
  2203.         may be stored in that file will be read and included in the catalog
  2204.         file, if that archive is expanded.  If the operation is a re-cataloging
  2205.         operation and any extracted filenames already exist in the catalog file
  2206.         with comments attached, the comment from the archive file will be
  2207.         ignored.
  2208.  
  2209.         ZIP and ARJ files, in addition to supporting comment entries for each
  2210.         file contained, can also have a main comment for the ZIP/ARJ file
  2211.         itself.  When CATDISK reads ZIP/ARJ files and finds a main comment, it
  2212.         will insert that main comment in the catalog file for any entries in
  2213.         the ZIP/ARJ file that do not already have comments.  This feature of
  2214.         copying the main ZIP/ARJ file comment can be turned on and off via the
  2215.         settings and toggles menu as desired.
  2216.  
  2217.         If the 4DOS/NDOS comment extract feature is turned on (it is by
  2218.         default), CATDISK will attempt to find a file (that may be hidden) in
  2219.         each subdirectoy called "DESCRIPT.ION".  This file will be present if
  2220.         you have used the 4DOS/NDOS "Describe" command to add file descriptions
  2221.         to your directory entries.  If CATDISK is able to locate this file, it
  2222.         will automatically add any matching comments to your catalog entries
  2223.         where appropriate.
  2224.  
  2225.         Upon completion of this, the catalog summary file and master catalog
  2226.         will be updated to reflect the current directory/directories of the
  2227.         disk.  If any files have been added, they will be added to the catalog;
  2228.         if any files have been changed, they will be updated;  if any files
  2229.         have been deleted, they will be removed from the catalog.
  2230.  
  2231.         If, while reading the disk, CATDISK cannot find any files there, it
  2232.         will ask you if you would like to add that disk to the catalog anyway.
  2233.         Why would you want to add such a disk to the catalog?  The answer to
  2234.         this question can best be explained by an example.
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2242.  
  2243.                                       Page 33
  2244.  
  2245.  
  2246.  
  2247.         You're maintaining a collection of disks for a computer users group.
  2248.         One day, you decide to clean up your collection, eliminating any
  2249.         duplicates that may have crept into the collection.  While you're
  2250.         eliminating the duplicates, several of the disks in the sequence become
  2251.         completely empty.  In this case, it is desirable to have the disk
  2252.         showing in the summary file as having its capacity completely available
  2253.         to accept new files.  Additionally, all the files that were eliminated
  2254.         from that disk will be un-cataloged by CATDISK through its normal
  2255.         function.  If the disk has never been cataloged before, this method
  2256.         represents a way to "pre-allocate" the disks to the collection and
  2257.         initialize their entries in the catalog file.
  2258.  
  2259.         If you would like to have the blank disk included in the catalog,
  2260.         answer YES to the prompt, otherwise, answer NO.  If you elect not to
  2261.         include the disk in the catalog file, and it has already been cataloged
  2262.         before, it would be advisable to remove that volume listing from the
  2263.         catalog file using option #5.
  2264.  
  2265.         Keep in mind, that deletion of an archive file will cause any files
  2266.         existing within that archive file to be uncataloged.  Also, turning the
  2267.         Auto Archive Extraction feature OFF, or answering <No> to a Extract
  2268.         Archive prompt to a cataloged Archive will cause any files in an
  2269.         Archive file on that disk to be uncataloged as well.
  2270.  
  2271.         Should the disk become full when the cataloging process is underway,
  2272.         the process will be aborted with an error message.  The old catalog
  2273.         file will remain intact (i.e. no changes made), but the summary file
  2274.         will reflect either the presence of the new disk, or the current status
  2275.         of that disk if it already existed in the catalog.  This means that the
  2276.         catalog file will not be accurate as to what's on the disk that you
  2277.         attempted to catalog.   If this error is encountered, you should either
  2278.         try to free up some space on disk on which the catalog file exists, or
  2279.         move the .DTA and .SUM files to another disk (see CONFIGURING CATDISK
  2280.         for details on how to access catalog files on other drives and
  2281.         directories) and retry the operation.
  2282.  
  2283.         The cataloging  operation is completely automatic and does not require
  2284.         any further input from the operator once started, unless, of course,
  2285.         the ARCHIVE extract state is set to QUERY.
  2286.  
  2287.         If you have turned on the auto-comment feature either from the
  2288.         command line or from the toggles menu, you will be taken to a section
  2289.         of the program that will allow you to add/update file comments for the
  2290.         group of files that CATDISK just added to or updated in your catalog.
  2291.  
  2292.         See the discussion on "OPTION 7 - CHANGE COMMENTS BY VOLUME ID" for a
  2293.         discussion on how the comment editor works.
  2294.  
  2295.         Please keep in mind that CATDISK has an internal limitation of being
  2296.         able to read in only the first 5000 files of the disk being cataloged,
  2297.         if available memory permits.
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2308.  
  2309.                                       Page 34
  2310.  
  2311.  
  2312.  
  2313.         OPTION F1:  UNCATALOGING A DISK
  2314.  
  2315.         There may be times when you will wish to remove a disk's files from the
  2316.         catalog.  Select option <F1> from the main menu, and you will be asked
  2317.         to enter the VOLUME NAME of the disk to be uncataloged.  Enter it and
  2318.         hit <Enter>.  If the volume label doesn't exist in the catalog, then
  2319.         you will be notified and returned to the main menu.
  2320.  
  2321.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  2322.         will bring up a point-and-shoot menu from which you can select a volume
  2323.         id from those in your current catalog.  See the section entitled
  2324.         "Selecting A Volume Name From A List" previously discussed in this user
  2325.         manual.
  2326.  
  2327.         If the volume label is found in the catalog, its entry will be deleted
  2328.         along with all the file names under it.
  2329.  
  2330.         If you do not wish to carry out this operation, hit <Esc> at the volume
  2331.         label prompt and no action will be taken.
  2332.  
  2333.         Should the disk become full during the catalog update process, the
  2334.         process will be aborted with an error message, and the old catalog file
  2335.         will remain intact.  Typically, this error should not occur, unless you
  2336.         have added more files to the disk, or another program has used up more
  2337.         disk space (such as a database expanding a file).  Should this error
  2338.         occur, the summary file will no longer contain a reference to the
  2339.         diskette that was uncataloged, but the catalog file will still contain
  2340.         references to that diskette.
  2341.  
  2342.         Should this be the case, you should either free up some space on the
  2343.         disk, or copy the .SUM and .DTA files to another disk (see CONFIGURING
  2344.         CATDISK for details on accessing catalog files on other drives and
  2345.         directories), catalog the diskette in question, and uncatalog it again.
  2346.         This will remove any references to that disk from the catalog file.
  2347.  
  2348.         If you do not have access to that disk any more (you may have erased
  2349.         it), simply take a blank diskette, add one file to it, and label it the
  2350.         same as the diskette you wish to uncatalog.  Carry out the above
  2351.         procedure, and you will obtain the same results.
  2352.  
  2353.         In practice, this should not happen, as you would have needed
  2354.         sufficient disk space to create the catalog file in the first place.
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2374.  
  2375.                                       Page 35
  2376.  
  2377.  
  2378.  
  2379.         OPTION 6:  CHANGE COMMENTS BY VOLUME ID
  2380.  
  2381.         There are two basic places from where CATDISK's comment editor may be
  2382.         invoked:  1) At the end of a cataloging operation when AUTOCOMMENTS is
  2383.         turned on; and 2) As a result of option #6, option #7, option #8 or
  2384.         option #9 from the main menu.
  2385.  
  2386.         The actual functionality of the comment editor will be discussed later
  2387.         on in this section.
  2388.  
  2389.         If you select this option #7 from the main menu, you will be asked to
  2390.         specify a disk volume. Upon entry of such, CATDISK will go through the
  2391.         catalog and bring a group of files into the comment editor that
  2392.         currently reside on that disk volume.
  2393.  
  2394.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  2395.         will bring up a point-and-shoot menu from which you can select a volume
  2396.         id from those in your current catalog.  See the section entitled
  2397.         "Selecting A Volume Name From A List" previously discussed in this user
  2398.         manual.
  2399.  
  2400.         Here's how the comment editor works:
  2401.  
  2402.         Once CATDISK has found a group of files for commenting, they will
  2403.         appear on the screen in a format similar to the "COMMENT" screen output
  2404.         format, the main difference being that one of the comments (or blanks)
  2405.         are highlighted in an inverse field.
  2406.  
  2407.         To change a comment, simply move the highlight to the file that you
  2408.         wish to comment, and start typing.  When you are done, hit the <Return>
  2409.         key.
  2410.  
  2411.         Other editing keys are as follows:
  2412.  
  2413.           <Left Arrow>  - move cursor one character to the left.
  2414.           <Right Arrow> - move cursor one key to the right.
  2415.           <Home>        - move cursor to the beginning of the line
  2416.                           (once you have started typing).
  2417.           <End>         - move cursor to the end of the line
  2418.                           (once you have started typing).
  2419.           <Ctrl>-<End>  - erase from the cursor to the end of the line.
  2420.           <Del>         - delete the character at the cursor and shift the
  2421.                           characters on the right to the left.
  2422.           <Backspace>   - delete the character before the cursor and shift the
  2423.                           characters on the right to the left.
  2424.           <Ins>         - toggle insert/overstrike mode
  2425.                         - in insert mode the cursor will be slightly fatter
  2426.                           than the one in overstrike mode.
  2427.  
  2428.           <Esc>         - cancel the changes and restore the line to its
  2429.                           original contents.
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2440.  
  2441.                                       Page 36
  2442.  
  2443.  
  2444.  
  2445.         In some (and probably most) cases, the file list will be too large to
  2446.         fit on the screen.  The list may be browsed through by using the keys
  2447.         on the cursor keypad.  Their functions:
  2448.  
  2449.         <UP> & <DOWN>   will move the highlight bar up or down one file.  If
  2450.                         you at a screen margin, and there are still more
  2451.                         files to be browsed, the listing on the screen will
  2452.                         scroll in the appropriate direction.  If you can't move
  2453.                         any more, you will hear a short beep.
  2454.  
  2455.         <PgUp> & <PgDn> will move you 15 files forward or backward in the list
  2456.                         If you can't move any more, you will hear a short beep.
  2457.  
  2458.         <Home> & <End>  will move you to the beginning or end of the group of
  2459.                         files respectively.
  2460.  
  2461.         <F2>            will repeat the comment on which the highlight bar
  2462.                         currently rests to all entries in the list of files.
  2463.                         If the currently highlighted comment is blank, a short
  2464.                         beep will sound and no further action will be taken.
  2465.                         This option provides a quick way to enter a single
  2466.                         comment for all files on an entire disk... just enter
  2467.                         the first one, re-highlight it and press <F5> to
  2468.                         duplicate it to each entry for that disk.  This option
  2469.                         is not shown at the bottom of the screen due to lack of
  2470.                         room on the instruction line.
  2471.  
  2472.         <F9>            will repeat the Last Entered Comment.  This is handy if
  2473.                         you want to repeat a single comment at different places
  2474.                         in the list where <F10> (see below) won't suffice, as
  2475.                         the comment desired is not directly above the current
  2476.                         position.  If no comment was previously entered, or
  2477.                         the last entered comment was blank, no action will be
  2478.                         taken.
  2479.  
  2480.         <F10>           will "Ditto":  Pressing this key will copy the comment
  2481.                         from the entry above.  It is handy if you want to copy
  2482.                         a comment down a consecutive list of files, or one that
  2483.                         was already previously entered at an earlier time, if
  2484.                         it is directly above the current position.  If the
  2485.                         comment above is blank, or you are at the top of the
  2486.                         list, no action will be taken.
  2487.  
  2488.         <Grey Plus>     move down through the list 1/15th of the total length
  2489.                         of the list (see the appendix regarding the SCROLL BAR
  2490.                         later in this manual).
  2491.  
  2492.         <Grey Minus>    move up through the list 1/15th of the total length of
  2493.                         the list (see the appendix regarding the SCROLL BAR
  2494.                         later in this manual).
  2495.  
  2496.         <Tab>           This will toggle the information shown on the left of
  2497.                         the comment area between three different formats, each
  2498.                         of which show different file information that may be
  2499.                         necessary to derive the desired comment.  This option
  2500.                         is not shown at the bottom of the screen due to lack of
  2501.                         room on the instruction line.
  2502.  
  2503.         <Esc>           Return to the main menu when you are done.
  2504.  
  2505.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2506.  
  2507.                                       Page 37
  2508.  
  2509.  
  2510.  
  2511.         OPTION 7:  ADD/UPDATE COMMENTS BY FILESPEC
  2512.  
  2513.         If you select option #7 from the main menu, you will be asked for a
  2514.         filespec on which to base the search.  This filespec can be a based on
  2515.         CATDISK's enhancements to the DOS wildcard specifications (See option
  2516.         #0 (Reports And Inquiries), sub-option #4 (Show Files By Filespec) for
  2517.         a discussion of wildcard searching.  Once the catalog records are
  2518.         loaded into the comment editor according to your criteria, the same
  2519.         options that apply to option #6 apply here (see it for details).
  2520.  
  2521.  
  2522.         OPTION 8:  SEARCH/EDIT FILES BY COMMENT
  2523.  
  2524.         If you select option #8 from the main menu, CATDISK will ask you for a
  2525.         comment spec on which to base the search.  Simply enter the sub-string
  2526.         for which you wish to search.  A discussion on how CATDISK matches
  2527.         comments can be found in the discussion on option #0 (Reports And
  2528.         Inquiries), sub-option #5 (Files by comment).  Once the catalog records
  2529.         are loaded into the comment editor according to your criteria, the same
  2530.         options that apply to option #6 apply here (see it for details).
  2531.  
  2532.  
  2533.         OPTION 9:  IMPORT COMMENTS FROM A TEXT FILE
  2534.  
  2535.         Option #9, "Import Comments From A Text File", will allow you to bring
  2536.         in file comments from an external source, be it a BBS listing that
  2537.         you've either downloaded or captured with your communications package,
  2538.         or any file that contains plain text.  This file can contain anything:
  2539.         filesizes, dates, times, etc.  The only limitations are that the file
  2540.         contain no tabs, and that each line be no longer than 255 characters.
  2541.  
  2542.         Many utilities such as Norton's fileinfo (FI) utility can re-direct
  2543.         their output to a text file simply by appending ">TEXTFILE" (without
  2544.         the quotes) to the command.  Using Norton's FI utility as an example,
  2545.         you could use "FI A: /C/L >TEXTFILE" to produce a file called TEXTFILE
  2546.         that would contain comments for many of the files on a floppy disk.
  2547.         Please refer to your Norton Utilities manual for details on how to
  2548.         maintain those comments with FI.
  2549.  
  2550.         Once you select option #9, a screen containing the controlling settings
  2551.         for the expected text file will appear.  These settings can be stored
  2552.         in a setup file (profile) for later retrieval.  To avoid disk clutter,
  2553.         profiles are stored in the same directory as your catalog files.  This
  2554.         eliminates the need for having to remember the settings for, say, the
  2555.         file dump from Norton's FI as described earlier on.  You can enter the
  2556.         settings once, save them to a profile and be able to recall them later
  2557.         on.  The first item on the screen indicates what file the current
  2558.         settings came from.
  2559.  
  2560.         The second item is the filename of the textfile from which the comments
  2561.         will be read.  The next 8 settings will depend on the characteristics
  2562.         of the file being read.  The pre-filled numbers assume that you are
  2563.         reading comments from CATDISK's own report printed to disk showing both
  2564.         statistics and comments.
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2572.  
  2573.                                       Page 38
  2574.  
  2575.  
  2576.  
  2577.         The first setting is the beginning and ending character positions of
  2578.         the filename as it appears on each line.  These settings are critical
  2579.         for CATDISK to be able to identify where to put each comment, and must
  2580.         contain a value greater than zero.
  2581.  
  2582.         The second setting is the beginning and ending character positions of
  2583.         the subdirectory, if it exists in the text file.  If the text file
  2584.         contains the subdirectory in which each file resides, you may include
  2585.         it with these settings, or if either the file does not contain
  2586.         subdirectory information, or you do not wish to use it, you may set the
  2587.         beginning and ending positions to zero.  CATDISK will then ignore them.
  2588.  
  2589.         The third setting is the beginning and ending character positions of
  2590.         the volume id, if it exists in the text file.  If the text file
  2591.         contains the volume id for the disk on which each file resides, you may
  2592.         include it with these settings, or if either the file does not contain
  2593.         this information, or you do not wish to use it, you may set the
  2594.         beginning and ending positions to zero.  CATDISK will then ignore them.
  2595.         Finally, the last setting is the starting and ending character
  2596.         positions of the file comment.  These values must also be set to
  2597.         something that is greater than zero, as CATDISK needs a comment to
  2598.         insert for each file that it finds in your catalog file.
  2599.  
  2600.         The easiest way to determine the appropriate settings for the text file
  2601.         you will be importing is to first load it into your favorite text
  2602.         editor.  Place the cursor on the beginning and ending characters of the
  2603.         various items discussed above, and note what column the editor
  2604.         indicates that the current cursor position is.  These will be the
  2605.         values that you will fill in to the control screen.
  2606.  
  2607.         Here are a few important notes regarding the text file.  There is
  2608.         really no need to edit blank lines and headings out of the file before
  2609.         processing, as the chances of CATDISK matching a filename, subdirectory
  2610.         and volume id found in the appropriate character positions in a heading
  2611.         with a file entry in the catalog file are quite slim.  It is important
  2612.         that each data line (not the headings) in the file be structured the
  2613.         same way (i.e. all the columns line up as in a report).  If this is not
  2614.         the case, chaos in the comments fields in the affected files will
  2615.         result.  Lastly, CATDISK has an internal limitation of being able to
  2616.         read in only the first 32,767 non-blank lines in the file.  The rest
  2617.         will be ignored.
  2618.  
  2619.         All this said, changing the settings is a matter of using the <Up> and
  2620.         <Down> arrow keys to highlight the desired setting, typing the new
  2621.         information for that setting and hitting <Enter>.  Pressing <Esc> when
  2622.         not editing a setting will return you to the menu with no further
  2623.         action taken.
  2624.  
  2625.         Retrieving and saving profiles is a simple matter of typing in the
  2626.         desired filename on the first line of the screen.  When you do so, you
  2627.         will be asked if you would like to read settings in from that file, or
  2628.         save the current ones to that file.  If you attempt to read in a
  2629.         profile that does not exist, you will be given an error message and no
  2630.         settings will be changed.  If, however, the file does exist and either
  2631.         a disk read error occurs or it is determined that the file is not a
  2632.         valid profile, the default settings (that which were supplied the first
  2633.         time you used this feature) will be brought in.
  2634.  
  2635.  
  2636.  
  2637.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2638.  
  2639.                                       Page 39
  2640.  
  2641.  
  2642.  
  2643.         If you wish to save the current settings to disk, CATDISK will first
  2644.         check to see if the file already exists.  If so, you will be given a
  2645.         warning to enable you to abandon the operation before you accidentally
  2646.         over-write a valuable program or data file.
  2647.  
  2648.         Any changes made in the settings during an import session will
  2649.         automatically be saved to the current profile on exit from the settings
  2650.         modification screen (via <Esc> or <F10>).  Again, if the file named in
  2651.         the first line exists, you will be given an overwrite warning in case
  2652.         you don't actually want to overwrite the current saved settings with
  2653.         the new ones (i.e. the import operation is a one-time shot in this
  2654.         case).
  2655.  
  2656.         Once you have all the desired settings ready, press <F10> to initiate
  2657.         the insertion of comments in the catalog file.  Here's what CATDISK
  2658.         does to accomplish this.  First, it will read and sort all the entries
  2659.         in the text file.  If CATDISK cannot find the text file, if there is an
  2660.         error in reading the text file, or there is an error in sorting the
  2661.         entries, the process will be aborted.  If the sort is successful,
  2662.         CATDISK will scan your current catalog file for matching entries from
  2663.         the text file.
  2664.  
  2665.         For each match that CATDISK finds, it will determine if the comment
  2666.         field from the catalog file is blank (CATDISK will not overwrite
  2667.         previously entered comments for the sake of integrity).  If so, the
  2668.         first 30 characters of the comment from the text file will be inserted
  2669.         into the comment field for that file in the catalog file.
  2670.  
  2671.         Once this process has completed, a list of the modified entries will be
  2672.         brought into the comment editor for "massaging" if you would like to
  2673.         clean up any entries.  It is highly recommended that you at least go
  2674.         through the list just to make sure that everything went ok.  See the
  2675.         discussion for option #7 - ADD/UPDATE COMMENTS BY FILESPEC for details
  2676.         on how the comment editor works.
  2677.         
  2678.         
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2704.  
  2705.                                       Page 40
  2706.  
  2707.  
  2708.  
  2709.         OPTION 0: REPORTS & INQUIRIES MENU
  2710.  
  2711.         This menu outlines the complete range of screen or printer-based
  2712.         reports that CATDISK is capable of generating.  Selection of an option
  2713.         from this menu is by conventional means as outlined in the section
  2714.         "Using The Menus" earlier on in this user manual.
  2715.  
  2716.         Note that if you have the Report Totals setting turned on, CATDISK will
  2717.         show totals for various items on screen reports, and at the end of
  2718.         disk-based and printer-based reports.
  2719.  
  2720.  
  2721.         Screen-based reports
  2722.         --------------------
  2723.  
  2724.         When viewing a report on your screen, there will be several options
  2725.         available to you.  The following are available in ALL screen based
  2726.         reports:
  2727.  
  2728.           <Cursor UP>   - move up one line in the report.  The screen contents
  2729.                           will scroll down to make room for the new line
  2730.                           appearing at the top.
  2731.  
  2732.           <Cursor DOWN> - move down one line in the report.  The screen
  2733.                           contents will scroll up to make room for the new line
  2734.                           appearing at the bottom.
  2735.  
  2736.           <PgUp>        - move up one page (15 lines) in the report.
  2737.           <PgDn>        - move down one page (15 lines) in the report.
  2738.           <Home>        - move to the beginning of the report.
  2739.           <End>         - move to the end of the report.
  2740.  
  2741.           <Grey Plus>   - move down through the report 1/15th of the total
  2742.                           length of the report (see the appendix regarding the
  2743.                           SCROLL BAR later in this manual).
  2744.  
  2745.           <Grey Minus>  - move up through the report 1/15th of the total length
  2746.                           of the report (see the appendix regarding the SCROLL
  2747.                           BAR later in this manual).
  2748.  
  2749.           <Esc>         - return to the menu.
  2750.  
  2751.           <Tab>         - switch between four different screen report formats
  2752.                           as follows:
  2753.  
  2754.                           1) The default format shows Filename, Volume ID,
  2755.                              Arcive ID, Size, Date, Time and Dos File
  2756.                              Attributes.
  2757.  
  2758.                           2) Shows Subdirectory, Filename, Volume ID,
  2759.                              Arcive ID, Size, Date, and Time.  This corresponds
  2760.                              to the /SD option when starting CATDISK.
  2761.  
  2762.                           3) Shows Filename, Volume ID, Archive ID and File
  2763.                              comments.  This corresponds to the /CO option.
  2764.  
  2765.                           4) Shows Subdirectory, Filename, Volume ID, Archive
  2766.                           ID and a slightly truncated file comment.  This
  2767.                           corresponds to the /SDCO option.
  2768.  
  2769.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2770.  
  2771.                                       Page 41
  2772.  
  2773.  
  2774.  
  2775.         Printer-Based Reports
  2776.         ---------------------
  2777.  
  2778.         If your report is going to a printer (LPT1 or LPT2), and you have
  2779.         activated the two-sided report feature of CATDISK, the odd numbered
  2780.         pages will be printed first, followed by a pause enabling you to reload
  2781.         the paper such that the even numbered pages will print on the back side
  2782.         of the odd numbered pages, followed by the even numbered pages.
  2783.  
  2784.         As the report is printed, the filenames or disk volumes (as appropriate
  2785.         to the report) will be echoed to your screen to keep you informed as to
  2786.         CATDISK's progress.
  2787.  
  2788.         While a report is being printed, you may press <Esc> to abandon the
  2789.         report and return you to the previous menu.
  2790.  
  2791.  
  2792.         Disk-Based Reports
  2793.         ------------------
  2794.  
  2795.         Disk reports are treated the same as printer reports, with the
  2796.         exception that the two-sided report feature does not apply.
  2797.  
  2798.         A listing in the same format as the hardcopy report will be produced in
  2799.         a diskette file.  The default name for this file is one with the same
  2800.         name as the current catalog filename with an extension of ".LST".  This
  2801.         may be overridden at the time that the report is generated.  Hitting
  2802.         <Esc> at any time during the generation of the report will abort it and
  2803.         return to the previous menu.
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2836.  
  2837.                                       Page 42
  2838.  
  2839.  
  2840.  
  2841.         Sub-Option #1: Disk Summary
  2842.         ---------------------------
  2843.  
  2844.         Selection of sub-option #1 from the reports menu will cause CATDISK to
  2845.         display an alphabetical list of VOLUME NAMES and some pertinent
  2846.         statistical information  for each.  This option is handy if, say, you
  2847.         have a bunch of utility disks and want to add a 14K utility program to
  2848.         one of them.  This report can be quite useful in making efficient use
  2849.         of existing working diskettes.
  2850.  
  2851.         All the statistical items shown should be self-explanatory, except one;
  2852.         that is, the Slack % factor.  The disks on which DOS stores it files
  2853.         are divided into allocation units called clusters.  The size of each
  2854.         cluster varies with the type and size of disk.  When DOS allocates
  2855.         space on a disk for a file, it is allotted in one cluster units to the
  2856.         file.  Some common cluster sizes are 512 bytes on 160-180K diskettes,
  2857.         and 1024 bytes on 320-360K diskettes.  Some hard disks have larger
  2858.         cluster sizes.
  2859.  
  2860.         Anyway, let's say, for example, that you have a file of 256 bytes.  On
  2861.         a 360K diskette, DOS will allocate 1024 bytes to the file, even though
  2862.         it is only 256 bytes long.  This means that three-quarters of that
  2863.         cluster is unused, or that you have 75% slack for that file.  The
  2864.         figure that you see on the summary report is the overall slack
  2865.         percentage of all the files on the disk.
  2866.  
  2867.         Depending on where you have set your output destination, the following
  2868.         options are applicable:
  2869.  
  2870.         NOTE:   If you select a printer or disk-based report from CATDISK,
  2871.                 you will be asked if you would like the report to be sorted on
  2872.                 volume ID or by descending free disk space.  Simply hit <V> for
  2873.                 the volume ID sort, or hit <F> for the descending free disk
  2874.                 space report.  Hitting <Esc> at this prompt will cause the
  2875.                 report to be aborted.
  2876.  
  2877.         NOTE:   The <Tab> key has a slightly different function in this report
  2878.                 than in the others.  By pressing <Tab> key, you can switch
  2879.                 the sorted order of the report between alphabetical volume ID
  2880.                 and descending free disk space.  The starting order in which
  2881.                 the report will appear can be controlled with the /SF command
  2882.                 line option at startup.
  2883.  
  2884.     
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2902.  
  2903.                                       Page 43
  2904.  
  2905.  
  2906.  
  2907.         Sub-option #2: Files For A Volume
  2908.         ---------------------------------
  2909.  
  2910.         Selecting sub-option #2 will cause CATDISK to display an alphabetical
  2911.         list of files for a particular disk.  If you have the report
  2912.         destination set to "ASK", you will be asked for a report location.
  2913.         After the report destination is established, you will be asked for a
  2914.         volume ID.  Simply enter it and hit <Return>, or hit <Esc> to return to
  2915.         the menu without producing a report.
  2916.  
  2917.         Once the report location has been determined, CATDISK will ask you for
  2918.         the volume name to match for the report.  You can either enter the
  2919.         exact volume name to match, or a wild-card entry to match for the
  2920.         report.  If you enter an exact entry, CATDISK will first find it in the
  2921.         summary file.  If it does not exist, you will be notified, and the
  2922.         catalog scan will not even take place.  If you want to obtain a report
  2923.         for a group of volumes, here's how the wildcard matching works:
  2924.  
  2925.         As CATDISK scans your catalog for matches, it does a character by
  2926.         character comparison of the pattern that you specified and the volume
  2927.         name for each entry in your catalog.  As soon as a mismatch occurs, the
  2928.         catalog entry is not included in the report.  Two characters have a
  2929.         special meaning in these comparisons.  The question mark (?) will match
  2930.         any character in the position which the question mark occupies.  The
  2931.         asterisk (*) will match any characters to either the end of the volume
  2932.         name, or the next non-asterisk character in the pattern, if there are
  2933.         any.  As a result of this logic, any characters between two asterisks
  2934.         that may occur in the search pattern are ignored.
  2935.  
  2936.         One special case with the asterisk feature is when a pattern is placed
  2937.         in between two asterisks.  CATDISK will then match any volume that
  2938.         contains the pattern anywhere in the name.
  2939.  
  2940.         To better illustrate, here are some examples:
  2941.  
  2942.           Pattern    Volume ID  Match?
  2943.         ----------- ----------- ------
  2944.  
  2945.         VOLUME 1    VOLUME 1     YES
  2946.         VOLUME 1    VOLUME 2      NO   - not an exact match
  2947.         VOL?????    VOLUME 1     YES   - any 8 char name beginning with "VOL"
  2948.         VOL????2    VOLUME 2     YES   - any 8 char name beginning with "VOL"
  2949.                                          that ends with "2"
  2950.         VOL*1       VOLUME 1     YES   - any name beginning with "VOL" and
  2951.                                          ending in "1" (any number of chars)
  2952.         VOL*1       VOLUME 2      NO   - doesn't end in "1"
  2953.         *1          VOLUME 1     YES   - any name ending in "1" (any number of
  2954.                                          chars)
  2955.         *1          VOLUME 2      NO   - doesn't end in "1"
  2956.         ????????    VOLUME 1     YES   - any 8 char volume name
  2957.         ?????????   VOLUME 2      NO   - volume ID is not 9 characters long
  2958.         *           ANYVOLUME    YES   - any volume ID, any number of chars
  2959.         AB*CD*EF    ABEF         YES   - "CD" in the middle ignored
  2960.         *MISC*      CATMISC1     YES   - Contains "MISC" in the volume name.
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  2968.  
  2969.                                       Page 44
  2970.  
  2971.  
  2972.  
  2973.         Note that in the last example, the presence of a leading and trailing
  2974.         asterisk will cause CATDISK to search for the characters enclosed
  2975.         between them as they appear literally.  Wildcard characters must not
  2976.         appear between these delimiters, as they cannot exist in a valid DOS
  2977.         filename (i.e. the volume id) and therefore will not be matched.  For
  2978.         example," *DI?K*" will cause CATDISK to search for "DI?K" in the volume
  2979.         id.  The question mark is not a valid character in a DOS filename,
  2980.         therefore no matches will be found.
  2981.  
  2982.         Optionally, you can leave the volume ID blank.  CATDISK will bring up a
  2983.         point-and-shoot menu from which you can select a volume id from those
  2984.         in your current catalog.  See the section entitled "Selecting A Volume
  2985.         Name From A List" previously discussed in this user manual.
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3034.  
  3035.                                       Page 45
  3036.  
  3037.  
  3038.  
  3039.         Sub-option #3: Files For An Archive
  3040.         -----------------------------------
  3041.  
  3042.         Selecting sub-option #3 will cause CATDISK to display an alphabetical
  3043.         list of files for a particular archive.  If you have the report
  3044.         destination set to "ASK", you will be asked for a report location.
  3045.         After the report destination is established, you will be asked for a
  3046.         Archive to list.  Simply enter it and hit <Return>, or hit <Esc> to
  3047.         return to the menu without producing a report.  If you wish to obtain a
  3048.         report for a group of similarly named archives, you may use wildcards
  3049.         in your search spec.  Here's how they work:
  3050.  
  3051.         As CATDISK scans your catalog for matches, it does a character by
  3052.         character comparison of the pattern that you specified and the volume
  3053.         name for each entry in your catalog.  As soon as a mismatch occurs, the
  3054.         catalog entry is not included in the report.  Two characters have a
  3055.         special meaning in these comparisons.  The question mark (?) will match
  3056.         any character in the position which the question mark occupies.  The
  3057.         asterisk (*) will match any characters to either the end of the volume
  3058.         name, or the next non-asterisk character in the pattern, if there are
  3059.         any.  As a result of this logic, any characters between two asterisks
  3060.         that may occur in the search pattern are ignored.
  3061.  
  3062.         One special case with the asterisk feature is when a pattern is placed
  3063.         in between two asterisks.  CATDISK will then match any archive that
  3064.         contains the pattern anywhere in the name.
  3065.  
  3066.         Under normal circumstances, any files that are not contained in archive
  3067.         files will not appear in this report.  You must specifically ask for
  3068.         "........" (without the quotes) to get a listing of files that did not
  3069.         come from archives (i.e. Archive ID is "........" in the listing).
  3070.  
  3071.         To better illustrate, here are some examples:
  3072.  
  3073.         Pattern   Archive ID  Match?
  3074.         --------  ----------  ------
  3075.         MISC1     MISC1        YES
  3076.         MISC1     MISC2         NO   - not an exact match
  3077.         MI???     MISC1        YES   - any 5 char name beginning with "MI"
  3078.         MI??2     MISC2        YES   - any 5 char name beginning with "MI"
  3079.                                        that ends with "1"
  3080.         MI*1      MISC1        YES   - any name beginning with "MI" and ending
  3081.                                        in "1" (any number of chars)
  3082.         MI*1      MISC2         NO   - doesn't end in "1"
  3083.         *1        MISC1        YES   - any name ending in "1" (any # of chars)
  3084.         *1        MISC2         NO   - doesn't end in "1"
  3085.         ?????     MISC1        YES   - any 5 char volume name
  3086.         ????????  MISC2         NO   - archive ID is not 8 characters long
  3087.         *         ANYARCH      YES   - any archive ID, any number of chars
  3088.         AB*CD*EF  ABEF         YES   - "CD" in the middle ignored
  3089.         *GAME*    AGAME001     YES   - Contains "GAME" in the archive name
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3100.  
  3101.                                       Page 46
  3102.  
  3103.  
  3104.  
  3105.         Note that in the last example, the presence of a leading and trailing
  3106.         asterisk will cause CATDISK to search for the characters enclosed
  3107.         between them as they appear literally.  Wildcard characters must not
  3108.         appear between these delimiters, as they cannot exist in a valid DOS
  3109.         filename (i.e. the archive id) and therefore will not be matched.  For
  3110.         example," *DI?K*" will cause CATDISK to search for "DI?K" in the
  3111.         archive id.  The question mark is not a valid character in a DOS
  3112.         filename, therefore no matches will be found.
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  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) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3166.  
  3167.                                       Page 47
  3168.  
  3169.  
  3170.  
  3171.         Sub-option #4: Files By Filespec
  3172.         --------------------------------
  3173.  
  3174.         Selecting sub-option #4 will cause CATDISK to display an alphabetical
  3175.         list of files for a DOS or a CATDISK enhanced wildcard spec.  If you
  3176.         have the report destination set to "ASK", you will be asked for a
  3177.         report location.  After the report destination is established, you will
  3178.         be asked for a filespec.  This filespec follows the conventional DOS
  3179.         filespec search conventions including wildcard searches.  Hit <Esc> to
  3180.         return to the menus without generating a report.
  3181.  
  3182.         Examples:
  3183.  
  3184.                *.*        - search for everything
  3185.                *          - same as *.*
  3186.                *.         - search for files with no extension
  3187.         CATDISK*.*        - search for files starting with CATDISK and having
  3188.                             any file extension
  3189.         CATDISK*          - same as CATDISK*.*
  3190.         CATDISK*.         - search for files starting with CATDISK and having
  3191.                             no file extension
  3192.                *.COM      - search for files ending in .COM
  3193.               A*.EXE      - search for files starting with A and ending in .EXE
  3194.          CATDISK.EXE      - search specifically for CATDISK.EXE
  3195.                *.?Q?      - search for files with an extension containing Q as
  3196.                             its second character
  3197.               ??.DOC      - search for files with two letters as it filename
  3198.                             and .DOC as its extension
  3199.  
  3200.         Please refer to the DOS manual for further information on file
  3201.         searching patterns.
  3202.  
  3203.         In addition to the standard DOS wildcard matching specifications,
  3204.         CATDISK adds capabilities similar to the pattern matching discussed
  3205.         earlier in the manual under volume name matching and archive id
  3206.         matching.  To apply it to a filename, simply split the filename into
  3207.         its two sections (the part before the period is referred to as the
  3208.         name, and the part after the period is the extension), and apply the
  3209.         principals to each part.  A couple of examples would be:
  3210.  
  3211.             *D.*   - match any filename whose name ends in "D" and has any
  3212.                      extension.
  3213.           C?T*.EXE - match any filename whose name has a "C" in the first
  3214.                      position, any character in the second position, a "T" in
  3215.                      the third position, and has an extension of ".EXE".
  3216.              *.*M  - match any file with any extension that ends in "M".
  3217.            C*K.*   - match any file with any extension whose name starts with
  3218.                      "C" and ends with "K".
  3219.          *DISK*.*  - match any file whose name contains the characters "DISK".
  3220.  
  3221.         Note that in the last example, the presence of a leading and trailing
  3222.         asterisk will cause CATDISK to search for the characters enclosed
  3223.         between them as they appear literally.  Wildcard characters must not
  3224.         appear between these delimiters, as they cannot exist in a valid DOS
  3225.         filename and therefore will not be matched.  For example," *DI?K*.*"
  3226.         will cause CATDISK to search for "DI?K" in the files name.  The
  3227.         question mark is not a valid character in a DOS filename, therefore no
  3228.         matches will be found.
  3229.  
  3230.  
  3231.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3232.  
  3233.                                       Page 48
  3234.  
  3235.  
  3236.  
  3237.         Although this is a slight departure from the DOS standard for file
  3238.         pattern matching, I'm sure that you will find that these extensions add
  3239.         a little more flexibility and power to CATDISK's reporting
  3240.         capabilities.
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  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) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3298.  
  3299.                                       Page 49
  3300.  
  3301.  
  3302.  
  3303.         Sub-option #5: Files By Comment Text
  3304.         ------------------------------------
  3305.  
  3306.         Selecting sub-option #5 will cause CATDISK to display a list of files
  3307.         in accordance with a comment search spec that you supply.  Although
  3308.         CATDISK supports comments of 43 characters in length, the search spec
  3309.         is currently limited to 35 characters, which should suffice for all
  3310.         options.  After selecting a report destination, you will be asked for a
  3311.         comment search spec that you wish the report to be based on.
  3312.  
  3313.         Just enter the string that you want to search for in the catalog's
  3314.         comments section and hit <Enter>, or hit <Esc> to abort the process
  3315.         without generating a report.
  3316.  
  3317.         Here's how the comments are sourced for your search spec.  You enter a
  3318.         "phrase" or "substring" that you want to search for in the file
  3319.         comments.
  3320.  
  3321.         The "phrase" may be an entire comment that you want, it can be just one
  3322.         word, or even just one letter.  When catdisk compares your "phrase" to
  3323.         a comment, it checks to see if that "phrase" is contained anywhere in
  3324.         that comment.  If it does, that file will appear in your report.
  3325.  
  3326.         Example:   "SOURCE" would match:    CATDISK V4.13 source code
  3327.                                             CATDISK V4.13 Source code
  3328.                                             CATDISK V4.13 SOURCE CODE
  3329.                                             Source
  3330.                                                      ... etc ...
  3331.  
  3332.         Leaving the comment entry blank will produce a report containing only
  3333.         the catalog entries that have no comment.
  3334.  
  3335.         Please note:  Several users have asked for wild cards in the comment
  3336.         search (eg.  they might not know whether they had "Word Processor" or
  3337.         "Word Proc" for a comment).  This is not really necessary in this case,
  3338.         as, in the above case, entering "PROC" would match both comments.
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3364.  
  3365.                                       Page 50
  3366.  
  3367.  
  3368.  
  3369.         Sub-option F1:  Files By Comment Keywords
  3370.         -----------------------------------------
  3371.  
  3372.         Upon selecting <F1> from the reports menu, CATDISK will ask you for one
  3373.         or more keywords to match when generating the report.  All keywords are
  3374.         entered on one line, each separated by a space.  The maximum length of
  3375.         this line is 35 characters.
  3376.  
  3377.         Unlike the "Files By Comment Text" report mentioned earlier in this
  3378.         manual, the keyword report will scan through your file comments and
  3379.         look for whole words instead of looking for the text anywhere in the
  3380.         comment.
  3381.  
  3382.         For example, entering "PROCESS" for a keyword would cause a match in
  3383.         the comment "PROCESS CONTROL", but would not cause a match in the
  3384.         comment "WORD PROCESSOR" due to the fact that the "PROCESS" in
  3385.         "PROCESSOR" is not a stand alone word.
  3386.  
  3387.         You can have CATDISK perform the matching operations on multiple
  3388.         keywords by entering them all on the specification line, each separated
  3389.         by a space.  If CATDISK detects that you are looking for more than one
  3390.         keyword, you have two choices on how those keywords will be processed
  3391.         when evaluating a match with a file comment.
  3392.  
  3393.         You will see the prompt:
  3394.  
  3395.             Match Just <O>ne of These Keywords or <A>ll of Them? <O/A>
  3396.  
  3397.         By answering:
  3398.  
  3399.         O) You can have CATDISK assume a match if any one of the keywords are
  3400.            found in the comment.  You may also press the <1> key (instead of
  3401.            the first letter of the word ONE).
  3402.  
  3403.            eg. Keywords:  CATDISK SUMMARY
  3404.                Comment :  CATDISK Summary File For Games   - Match!
  3405.                Comment :  Summary of Monthly Sales         - Match!
  3406.                Comment :  3.. 2.. 1.. Blastoff!            - No Match
  3407.  
  3408.         A)  You can tell CATDISK to include a file in the report only if ALL
  3409.             keywords are found in the comment.  If one or more keywords are not
  3410.             present in the comment, the file will not appear in the report.
  3411.  
  3412.             Using the examples from the previous choice will show the
  3413.             difference in how the comments are evaluated.
  3414.         
  3415.            eg. Keywords:  CATDISK SUMMARY
  3416.                Comment :  CATDISK Summary File For Games   - Match!
  3417.                Comment :  Summary of Monthly Sales         - No Match
  3418.                Comment :  3.. 2.. 1.. Blastoff!            - No Match
  3419.  
  3420.            The second comment does not match under the second criteria due to
  3421.            the fact that the word Summary is present, but the word CATDISK is
  3422.            not.
  3423.  
  3424.  
  3425.         Having both a comment text report and a separate keyword-based report
  3426.         gives you full flexibility in searching for files by comment.
  3427.  
  3428.  
  3429.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3430.  
  3431.                                       Page 51
  3432.  
  3433.  
  3434.  
  3435.         Sub-option #6:  Files By Comment/Filename Text
  3436.         ----------------------------------------------
  3437.  
  3438.         This report is very similar to the Files By Comment Text report except
  3439.         that the filename is also searched for any occurrences of the search
  3440.         spec.  See details on the "Files By Comment Text" report in this user
  3441.         manual for details on how text is compared to determine whether or not
  3442.         a given file should appear in the report.
  3443.  
  3444.  
  3445.         Sub-option #7:  Sorted Full File Listings
  3446.         -----------------------------------------
  3447.  
  3448.         This option, if viewed on the screen will product a report in the same
  3449.         manner as sub-option #4, except that ALL files in the catalog will be
  3450.         included in the list.  It is similar to choosing sub-option #4 and
  3451.         searching for "*.*".
  3452.  
  3453.         If you have the report destination set to "ASK", you will be asked for
  3454.         a report location before any further action takes place.
  3455.  
  3456.         You may sort the full list on various criteria.  Currently, you can
  3457.         sort by filename, file extension, subdirectory, volume id, archive id,
  3458.         comment, file date/time (descending order), or file size (descending or
  3459.         ascending order).
  3460.  
  3461.         To select a criteria, simply hit the number beside it, or select it
  3462.         from the menu using CATDISK's menu selection methods.  The rest is
  3463.         automatic.
  3464.  
  3465.         If, during the sorting phase, which occurs for each option, with the
  3466.         exception of option #1, an error occurs, the process will be aborted
  3467.         and no report will be generated.
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3496.  
  3497.                                       Page 52
  3498.  
  3499.  
  3500.  
  3501.         Sub-option #8: Unique Files Only & Sub-option #9: Duplicate Files Only
  3502.         ----------------------------------------------------------------------
  3503.  
  3504.         Selecting sub-option #8 will cause CATDISK to display a listing of
  3505.         files in your catalog that exist only once.  Selecting sub-option #9
  3506.         will cause CATDISK to display a listing of files that occur more than
  3507.         once in your catalog.
  3508.  
  3509.         The criteria for these two reports is based solely on the filename, and
  3510.         optionally, on the file size (you will be asked whether or not you want
  3511.         it to be included before the catalog scan takes place), and not other
  3512.         items such as subdirectory, file date or file size.  you will be given
  3513.         the option to include or not to include the file size as a criteria in
  3514.         determining a file's uniqueness when you initiate one of these two
  3515.         sub-options.
  3516.  
  3517.         When either of these reports is generated, a full scan will be made
  3518.         through the catalog file to determine which files should be included in
  3519.         the report.  The reason for this is due to the method that CATDISK uses
  3520.         in comparing filenames to determine whether they are duplicate or
  3521.         unique.
  3522.  
  3523.         If, during the scanning process, CATDISK runs into a disk problem, the
  3524.         report will be aborted.
  3525.  
  3526.         Due to the method by which CATDISK scans the catalog, there is a
  3527.         possibility that duplicate files may appear in the unique file reports
  3528.         and vice versa when file size is used as a criteria if the given
  3529.         entries being compared are not right together in the catalog file.  An
  3530.         example may make this clearer:
  3531.  
  3532.         Filename.Ext  Volume ID    File Size
  3533.  
  3534.         TEST    .GIF  GIF0001        123,456
  3535.         TEST    .GIF  GIF0002        123,789
  3536.         TEST    .GIF  GIF0003        123,456
  3537.  
  3538.         In the unique file report, for example, if the file size is omitted
  3539.         from the search criteria, the report will show none of the above three
  3540.         files, which would be correct.
  3541.  
  3542.         If, however, the file size is included, all three of the files will
  3543.         show up due to the fact that the second entry in the file list has a
  3544.         different file size.  The first file is compared to the second one, and
  3545.         the second one is compared to the third during the sequential search of
  3546.         the catalog.  Due to the possibility that there can be many files of
  3547.         the same name occurring in the catalog file, this cannot be currently
  3548.         circumvented.
  3549.  
  3550.         A similar situation can happen in the duplicate files report.  Leaving
  3551.         the file size out of the criteria will yield the correct results.
  3552.         Including it may cause all three files to be left out of the report for
  3553.         the same reasons as in the unique file report.
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3562.  
  3563.                                       Page 53
  3564.  
  3565.  
  3566.  
  3567.         Sub-option #0: Volume Summary/Contents
  3568.         --------------------------------------
  3569.  
  3570.         This report is like combining the summary report with a full file
  3571.         listing.  CATDISK will print each line from your summary report,
  3572.         followed by a complete listing of files contained on that disk.
  3573.  
  3574.         Due to the nature of this report and the methodology that CATDISK uses
  3575.         to generate it, it is not possible to view this report on your screen.
  3576.         A printer location or a disk file must be selected in order to produce
  3577.         this report.
  3578.  
  3579.         If you instruct CATDISK to send this report to the screen, you will get
  3580.         an error message informing you of the above requirements.
  3581.  
  3582.  
  3583.         Sub-option <Esc>: Return To Main Menu
  3584.         -------------------------------------
  3585.  
  3586.         Hitting <Esc> will return you to CATDISK's main menu.
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3628.  
  3629.                                       Page 54
  3630.  
  3631.  
  3632.  
  3633.         OPTION <F4> - TEMPORARILY EXIT TO DOS
  3634.         -------------------------------------
  3635.  
  3636.         This option, although not really necessary, has been added in response
  3637.         to the numerous requests that I have had for this feature (shows that I
  3638.         am really paying attention to those suggestions, eh?).  By selecting
  3639.         this option, CATDISK will be temporarily suspended and you will be
  3640.         returned to the DOS prompt.  You may carry out any normal function that
  3641.         you would ordinarily be able to carry out from DOS, provided that there
  3642.         is enough memory remaining in which to run your desired program.
  3643.  
  3644.         Please note that if you have the disk cache active at the time you use
  3645.         this function, the contents of the cache will be flushed and cleared
  3646.         before calling DOS.  This will not affect any data already on disk.
  3647.  
  3648.         When you are finished with DOS, and wish to return to CATDISK, simply
  3649.         type "EXIT" and hit <Return> to return to CATDISK.  Please be sure and
  3650.         replace any disks that you had in your drives before returning to
  3651.         CATDISK.
  3652.  
  3653.         Note that although the <F4> option does not appear on any of CATDISK's
  3654.         other menus (settings & toggles, reports & inquiries, or the report
  3655.         destination selection menu), you may press <F4> from any of these menus
  3656.         to temporarily exit to DOS.  When you return from DOS, you will be
  3657.         returned to the particular menu from which you shelled out to DOS.
  3658.  
  3659.         Possible errors that you may encounter when you use can vary greatly.
  3660.  
  3661.         Possibilities are:  1) There is not enough memory to load a second copy
  3662.                                of the command interpreter (usually
  3663.                                COMMAND.COM), or that memory has been corrupted
  3664.                                by a resident program.
  3665.  
  3666.                             2) If you get an error after returning from DOS, it
  3667.                                usually means that you've loaded a resident
  3668.                                program while out in DOS.  You should refrain
  3669.                                from doing so.
  3670.  
  3671.                             3) Generally, this means that CATDISK was unable to
  3672.                                find COMMAND.COM on the drive and directory
  3673.                                defined by the SET COMSPEC= environment string
  3674.                                (see the DOS manual for details on the SET
  3675.                                command).  This is usually set to the location
  3676.                                from which COMMAND.COM was loaded when the
  3677.                                system was booted. If COMMAND.COM was not found
  3678.                                at the boot location, the root directory of the
  3679.                                current drive is attempted.
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3694.  
  3695.                                       Page 55
  3696.  
  3697.  
  3698.  
  3699.         OPTION <drive_letter>: SHOW DISK DIRECTORY
  3700.  
  3701.         To activate this feature, simply type the drive letter of the disk
  3702.         whose directory you wish to view.  If you haven't included the /NW
  3703.         option in your command line when you started CATDISK,you will be
  3704.         prompted to insert a disk for drive D where D is the drive letter that
  3705.         you typed.
  3706.  
  3707.         You will then be asked for a filespec to match.  This is the same as
  3708.         the filespec prompt in OPTION #0, Sub-option #4 - SHOW SELECTED FILES.
  3709.         Upon doing this, the label and directory contents will be read just
  3710.         like they would if they were about to be cataloged, but instead of
  3711.         adding them to your catalog, they will be shown directly on the screen
  3712.         in the same format as option #0, Sub-option #2 - Show Files For A
  3713.         Volume.  The archive scanning feature functions as normal throughout
  3714.         the program.
  3715.  
  3716.         Upon entering the search spec, scanning of the catalog will
  3717.         commence.  If you have status indicators turned on, a counter  will
  3718.         increment each time a matching file is found.  If at the and of the
  3719.         search, no files were found, an error message will be issued and you
  3720.         will be returned to the main menu.
  3721.  
  3722.         When the search has completed successfully, the file names will be
  3723.         shown alphabetically, along with the volume name, archive name, and
  3724.         other directory information for that file.
  3725.  
  3726.         For a list of options available, please see the section entitled
  3727.         "SCREEN REPORT OPTIONS AVAILABLE" in this manual.
  3728.  
  3729.  
  3730.  
  3731.         OPTION ESC:  EXIT TO DOS
  3732.  
  3733.         Select this option when you are finished with CATDISK to terminate its
  3734.         operation.  Upon exit, you will be returned to the DOS prompt.
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3760.  
  3761.                                       Page 56
  3762.  
  3763.  
  3764.  
  3765.                               APPENDIX A - THE SCROLL BAR
  3766.  
  3767.         When bringing up a screen report, you may have noticed a hatched bar on
  3768.         the left border of the screen with an inverse 'T' at the top of it and
  3769.         an inverse 'B' at the bottom.  This is a scroll bar, which indicates
  3770.         roughly where you are located along the full length of the current
  3771.         report.  Additionally, this feature will allow you to roughly position
  3772.         yourself in the report by hitting the <Grey Plus> and <Grey Minus>
  3773.         keys.  These keys will move you forward and backward respectively along
  3774.         this scroll bar.  These moves correspond to a move of one fifteenth of
  3775.         the total length of the report in the selected direction, as will be
  3776.         reflected in the page number which will be automatically set.
  3777.  
  3778.         The scroll bar position will also wrap from the top to the bottom if
  3779.         you are at the top and hit the <Grey Minus> key.  The reverse is also
  3780.         true for the <Grey Plus> key.
  3781.  
  3782.         In a long report, this represents a much nicer way of getting to, say,
  3783.         the files beginning with "R" without having to hit the <PgDn> key a
  3784.         hundred times.  Remember... the scroll bar is used to ROUGHLY position
  3785.         yourself among a group of files in a screen report.
  3786.  
  3787.         This scroll bar will appear in the point-and-shoot volume id selection
  3788.         screen as well.  Its functionality is much the same as that discussed
  3789.         above for reports.
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3826.  
  3827.                                       Page 57
  3828.  
  3829.  
  3830.  
  3831.                              APPENDIX B - ARCHIVE SUPPORT
  3832.  
  3833.         This version of CATDISK currently supports the archive utilities from
  3834.         System Enhancement Associates and PKWare, PAK files (similar to ARC
  3835.         files) created by the PAK utility from NoGate Consulting, ZIP files
  3836.         created by PKWare's PKZIP utilities, LZH files created by the LHARC
  3837.         utility from Haruyasu Yoshizaki, LZS files created by the LARC utility
  3838.         from K. Miki, DWC files created by the DWC utility from Dean W. Cooper,
  3839.         and the public domain Library Utility (LU).
  3840.  
  3841.         CATDISK can extract directory information from archives created with
  3842.         SEAWARE'S ARC utility, version 5.30 or earlier, PKWare's PKPAK version
  3843.         3.61 or earlier, or any compatible archive generating program.  These
  3844.         files commonly have a file extension of .ARC, and any files with this
  3845.         extension will be examined by CATDISK to see if it is a valid archive.
  3846.         If so, the directory information of each file in the archive will be
  3847.         extracted and added to the catalog if the Auto Archive Extraction
  3848.         feature is turned ON.  Files extracted from an ARC file will have a
  3849.         file attribute of "*ARC".
  3850.  
  3851.         Similar to the above, any files with a .PAK extension will be examined,
  3852.         and if appropriate, the directory information will be extracted from
  3853.         the file in question.  Files extracted from a PAK file will have a file
  3854.         attribute of "*PAK".
  3855.  
  3856.         ARC or PAK files created with utilities other than the ones listed
  3857.         above should work with CATDISK, but are not guaranteed.
  3858.  
  3859.         Files created with PKWare's PKZIP family of utilities are fully
  3860.         supported.  These files usually have an extension of .ZIP, and any file
  3861.         found with this extension will be examined by CATDISK to see if it is a
  3862.         valid ZIP file.  If this is so, and the Auto Archive Extraction Feature
  3863.         is turned ON, the directory information of each file in the library
  3864.         will be extracted and added to the catalog.  Files extracted from a ZIP
  3865.         file will have a file attribute of "*ZIP".  If the ZIP file contains
  3866.         comments, the first 30 characters will be extracted and included in
  3867.         your catalog file.
  3868.  
  3869.         ZIP files, in addition to supporting comment entries for each file
  3870.         contained, can also have a main comment for the ZIP file itself.  When
  3871.         CATDISK reads ZIP files and finds a main comment, it will insert that
  3872.         main comment in the catalog file for any entries in the ZIP file that
  3873.         do not already have comments.
  3874.  
  3875.         Although ZIP files can contain subdirectory information, this is not
  3876.         the subdirectory that will appear in the catalog listing.  The reason
  3877.         for this is due to the fact that the primary purpose of CATDISK is to
  3878.         be able to locate a given file.  In order to be able to do so, the
  3879.         subdirectory of the ZIP file itself is shown.  The destination of the
  3880.         file when being UNZIPPED is not relevant.
  3881.  
  3882.         Files created by the ARJ utility by Robert K. Jung that have a file
  3883.         extension of .ARJ are fully supported in the same manner as ZIP files.
  3884.         Such files have a file extension of .ARJ and any catalog entries that
  3885.         came from an ARJ file will have a file attribute of "*ARJ".
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3892.  
  3893.                                       Page 58
  3894.  
  3895.  
  3896.  
  3897.         Files created with Haruyasu Yoshizaki's LHA utility (formerly called
  3898.         LHARC) are fully supported.  These files commonly end with a .LZH
  3899.         extension.  Any files with this extension will be examined by CATDISK
  3900.         to see if it is a valid LHARC file.  If so, and you wish the directory
  3901.         contents to be extracted (via the program setting), the process will be
  3902.         carried out.  Files extracted from a LZH file will have a file
  3903.         attribute of "*LZH".
  3904.  
  3905.         Files created by the LARC utility from K. Miki are supported in the
  3906.         same way as those created by the LHARC utility mentioned above.  Files
  3907.         extracted from these files will have a file attribute of "*LZS".
  3908.  
  3909.         Files with a .ZOO extension will be examined to determine whether they
  3910.         are a valid ZOO file.  If so, and Archive extraction is enabled, the
  3911.         directory contents of the file will be read and included in the catalog
  3912.         file.  Files extracted from ZOO files will have the attribute "*ZOO".
  3913.         If the ZOO file contains comments, the first 30 characters will be
  3914.         extracted and included in your catalog file.
  3915.  
  3916.         Files with a .DWC extension will be checked to determine whether they
  3917.         are a valid DWC file.  If so,and archive extraction is enabled, the
  3918.         directory contents of the file will be read and included in the catalog
  3919.         file.  Files extracted from DWC files will have the attribute "*DWC".
  3920.         If the DWC file contains comments, the first 30 characters will be
  3921.         extracted and included in your catalog file.
  3922.  
  3923.         Files created by the archive utility HYPER, having a file extension of
  3924.         .HYP will be examined.  If they are a valid HYPER archive file, the
  3925.         directory contents from this file will be included in the catalog file.
  3926.         Files extracted from HYPER archives will have the attribute "*HYP".
  3927.  
  3928.         Files created by the Library Utility (LU) and conform to the fifth
  3929.         revision of the formal definition of the library file format are also
  3930.         fully supported.  These files commonly have a file extension of .LBR,
  3931.         and any files with this extension will be examined by CATDISK to see if
  3932.         they are valid .LBR files.  If this is so, and the Auto ARCHIVE
  3933.         Extraction Feature is turned ON, the directory information of each file
  3934.         in the library will be extracted and added to the catalog.  Files
  3935.         extracted from a LBR file will have an attribute of "*LBR".
  3936.  
  3937.         Although not an archive file in the formal sense of the word, a GIF
  3938.         file (stands for Graphics Interchange Format) is a special file format
  3939.         that was developed by CompuServe in order to allow many different types
  3940.         of computers to be able to view a graphics image without having to
  3941.         modify the file itself.  GIF viewers are available on a wide variety of
  3942.         hardware platforms to allow you to look at the images contained within
  3943.         a GIF file.  These files can come in a very wide variety of resolutions
  3944.         and color combinations.  CATDISK can look into a GIF file and extract
  3945.         this resolution and color information and include it as a default
  3946.         comment for that GIF file.  For example, a picture that may be 640 by
  3947.         480 pixels with 256 colors would have a comment entry of
  3948.         "1024x768x256".
  3949.  
  3950.         Currently, the GIF87a and GIF89a are supported.
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  3958.  
  3959.                                       Page 59
  3960.  
  3961.  
  3962.  
  3963.                   APPENDIX C - CATLOOK - COMMAND LINE LOOKUP UTILITY
  3964.  
  3965.         CATLOOK is a stand alone reporting utility provided with CATDISK.  It
  3966.         can come in handy on occasions when you either need to generate a quick
  3967.         and dirty report without having to run CATDISK itself, or when you need
  3968.         to generate a report after shelling out to DOS from within an
  3969.         application and there is not enough free memory left over to run
  3970.         CATDISK itself.  CATLOOK will run in 64K of free memory.
  3971.  
  3972.         A summary of the usage of CATLOOK follows:
  3973.  
  3974.         CATLOOK parameters (each must be separated by a slash or a space)
  3975.  
  3976.            /Ffilename - Use this file for the catalog (Default is CATDISK).
  3977.                         NOTE:  No space is allowed between the filename and the
  3978.                                /F.
  3979.  
  3980.            /Rx        - Use report format x, where x is:
  3981.                         0 - Filenames+Statistics        1 - Filenames+Comments
  3982.                         2 - Subdirs+Filenames+Comments  3 - All Catalog Info.
  3983.            /S         - Show a summary report.
  3984.            /Vvolume   - Show files for a volume report for the volume label
  3985.                         specified.
  3986.            /Aarchive  - Show files for an archive report for the archive
  3987.                         specified.
  3988.            /Wpattern  - Show files for a DOS wildcard spec based on the pattern
  3989.                         given.
  3990.            /Ccomment  - Show files containing the comment substring specified.
  3991.            /U         - Show all files that are unique in the catalog file.
  3992.            /D         - Show all files that have duplicates in the catalog
  3993.                         file.
  3994.            /SIZE      - Use file size as an additional criteria in generating
  3995.                         the unique/duplicate file reports.
  3996.            /NT        - supress the totals that are normally printed at the end
  3997.                         of CATLOOK's reports.
  3998.  
  3999.            /Ex        - Show everything sorted by x, where x is:
  4000.                         0 - File Name    1 - File Extension  2 - Subdirectory
  4001.                         3 - Volume Name  4 - Archive ID      5 - Comment
  4002.                         6 - Date/Time
  4003.  
  4004.         Due to the simplicity of this utility, the reports generated by CATLOOK
  4005.         are not paginated, but rather produced with one heading at the top of
  4006.         the report followed by the appropriate listings (equivalent to setting
  4007.         the number of lines per page equal to 0 in the configuration utility).
  4008.  
  4009.         If you are using report format 3 and are directing output to the
  4010.         printer, you must first have your printer set to compressed mode and
  4011.         that this mode must support at least 132 columns of output.
  4012.  
  4013.         The output from CATLOOK can be redirected to a printer or disk file by
  4014.         using the standard DOS method if I/O redirection.  For example:
  4015.  
  4016.           "CATLOOK /S >PRN" (without the quotes) - this will send a summary
  4017.                                                    report to your printer.
  4018.  
  4019.           "CATLOOK /S >LISTING.TXT" - this will send the summary report to a
  4020.                                       disk file called "LISTING.TXT".
  4021.  
  4022.  
  4023.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4024.  
  4025.                                       Page 60
  4026.  
  4027.  
  4028.  
  4029.                      APPENDIX D - CATMGR: CATDISK CATALOG MANAGER
  4030.  
  4031.         Before we even get into discussing this utility, we would like to
  4032.         stress that there is a possibility that a catalog file could get out of
  4033.         synch with the summary file under certain circumstances, particularly
  4034.         if a disk error or a disk-full condition occurs during certain
  4035.         operations.
  4036.  
  4037.         IF YOU USE THIS UTILITY, IT IS A GOOD IDEA TO MAKE A COPY OF YOUR DATA
  4038.         FILES BEFORE PROCEEDING.
  4039.  
  4040.         In response to requests from the many users of CATDISK, we have
  4041.         developed a simple utility that will allow you to manipulate catalog
  4042.         entries among your various catalog files without having to uncatalog
  4043.         disks from one catalog and re-catalog them in another.  With CATMGR,
  4044.         you can copy records from one catalog to another (including a brand new
  4045.         catalog), move records from one catalog to another, delete multiple
  4046.         disks from a catalog in one pass and to change a disks volume id in the
  4047.         catalog file without affecting the volume label on the disk.
  4048.  
  4049.         CATMGR can have two catalog files loaded at one time.  The startup
  4050.         command for CATMGR is as follows:
  4051.  
  4052.         CATMGR CatalogFile1 CatalogFile2
  4053.  
  4054.         - where CatalogFile1 is the catalog file that you wish to be loaded on
  4055.           on the left side of the screen and CatalogFile2 is the catalog file
  4056.           that you wish to be loaded on the right side of the screen. Both of
  4057.           these parameters are optional and you can specify one, both or none
  4058.           of them on the command line.
  4059.  
  4060.         The CATMGR screen is divided into three regions.  The upper left and
  4061.         right portions show information from the summary files from the two
  4062.         active catalog files, and the lower area makes up the instruction and
  4063.         message area.
  4064.  
  4065.         The general strategy with this utility is to tag the entries that you
  4066.         wish to copy, move or delete and then select the appropriate operation
  4067.         to perform.  For copying or moving catalog entries, the side of the
  4068.         screen on which the highlight bar resides is considered the source
  4069.         side, while the other side is considered the destination side.
  4070.  
  4071.         You can tag entries in one of two ways.  The first way is to highlight
  4072.         the desired entries by using the cursor keys and by pressing the
  4073.         <Space Bar>.  CATMGR will indicate that an entry is tagged when there
  4074.         is an arrow to the left of its volume name on the screen.
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4090.  
  4091.                                       Page 61
  4092.  
  4093.  
  4094.  
  4095.         You can move the highlight bar around the screen by using the following
  4096.         keys:
  4097.  
  4098.         <Up Arrow>    - Moves the highlight bar up one line if possible.
  4099.         <Down Arrow>  - Moves the highlight bar down one line if possible.
  4100.         <Left Arrow>  - Moves the highlight bar over to the last position on
  4101.                         the left side of the screen.
  4102.         <Right Arrow> - Moves the highlight bar over to the last position on
  4103.                         the right side of the screen.
  4104.         <PgUp>        - Moves the highlight bar up one screenful (16 lines) if
  4105.                         possible.
  4106.         <PgDn>        - Moves the highlight bar down one screenful (16 lines)
  4107.                         if possible.
  4108.         <Home>        - Moves the highlight bar to the top of the list.
  4109.         <End>         - Moves the highlight bar to the end of the list.
  4110.  
  4111.         The other way to tag entries is to do so in groups.  To bring up a list
  4112.         of tagging functions available, hit the <T> key at the main menu.
  4113.         CATMGR will bring up a list with the following functions that will
  4114.         operate on the side of the screen where the highlight bar currently
  4115.         resides:
  4116.  
  4117.           <A> - This will tag ALL of the entries.
  4118.  
  4119.           <C> - This will clear the tags of ALL of the entries.
  4120.  
  4121.           <S> - You will be prompted for a wildcard specification for all of
  4122.                 the entries that you would like to be tagged.
  4123.  
  4124.           <U> - You will be prompted for a wildcard specification for all of
  4125.                 the entries that you would like tags cleared.
  4126.  
  4127.           <I> - This will "flip" the tagged status of all entries.  This is
  4128.                 useful if, for example, you wish to copy all but five of the
  4129.                 entries of a large catalog file to be copied to a new one.
  4130.            Simply tag the five that you do not wish to copy and then
  4131.            select this option to quickly tag the entries that you do wish
  4132.            to copy.
  4133.  
  4134.         <Esc> - Will return you to the main menu with no further action taken.
  4135.  
  4136.         Please note that for any of the tagging operations in any method, you
  4137.         cannot tag a volume name that exists on the other side of the screen
  4138.         because a copy or move operation will result in a duplicate volume
  4139.         showing in the target catalog.  When tagging an individual entry with
  4140.         the <Space Bar>, CATMGR will warn you of this.  When performing a group
  4141.         tagging function with the <T> options, all appropriate entries will be
  4142.         tagged with duplicates ignored.  There is no warning issued in this
  4143.         case.  Given this, it is advisable to load only one catalog file into
  4144.         memory if the only operations to be performed are deletions.
  4145.  
  4146.         To load a different or new catalog file into either half of the screen,
  4147.         just move the highlight bar to the desired side and press the <L> (Load
  4148.         New File) key.  CATMGR will ask you for the catalog file to be loaded,
  4149.         at which point you may enter the name portion of the catalog file only.
  4150.         Do not specify a file extension in this name; CATMGR will supply the
  4151.         necessary information at the appropriate time.  By hitting the <Esc>
  4152.         key, CATMGR will return you to the main menu with no further action
  4153.         taken.
  4154.  
  4155.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4156.  
  4157.                                       Page 62
  4158.  
  4159.  
  4160.  
  4161.         Upon successful entry of a catalog name, CATMGR will attempt to load
  4162.         the summary file for that catalog into memory.  If successful, those
  4163.         entries will immediately be displayed on your screen, and the catalog
  4164.         name will appear in the title area on its particular side of the
  4165.         screen.  Any previous tags that may have been set on that side of the
  4166.         screen will be cleared.
  4167.  
  4168.         If CATMGR is unable to find the catalog file, that side of the screen
  4169.         will be cleared, and it will be indicated that a new catalog file will
  4170.         be created in the event of a copy or move operation with that side as
  4171.         the destination side.  If you do not perform a copy or move operation
  4172.         into that catalog file, no catalog will be created for that name.
  4173.  
  4174.         Once you have a grouping of catalog entries tagged for an operation,
  4175.         here are the three that you can perform:
  4176.  
  4177.         <C>opy -   hit the <C> key to activate this function.  All tagged
  4178.                    catalog entries will be copied from the source catalog to
  4179.                    the destination catalog.  If an error occurs during this
  4180.                    phase, you will get an error message and the operation will
  4181.                    be aborted.
  4182.  
  4183.                    By far, the most common error will occur when your disk
  4184.                    becomes full.  During the copy process, CATMGR will read
  4185.                    information from both catalog files and merge them together
  4186.                    in a temporary new file.  At the end of the process, all
  4187.                    three files will exist at the same time, after which the old
  4188.                    file is deleted and the new one renamed.  The net result of
  4189.                    this is that you need free disk space equal to the size of
  4190.                    the target catalog file plus the cumulative size of the
  4191.                    number of records that will be copied from the source
  4192.                    catalog.
  4193.  
  4194.                    Once this operation is successful, the summary entries from
  4195.                    the source catalog will be copied into the destination
  4196.                    summary file.  This operation is done in memory, after which
  4197.                    the new summary file is written to disk.  As a general rule,
  4198.                    if there was enough room to update the catalog file, there
  4199.                    will certainly be enough room to create a new summary file.
  4200.  
  4201.                    If an error does occur, it was probably due to a physical
  4202.                    disk error.  If this does happen, your summary file will be
  4203.                    out of synch with its catalog file, and it is probably best
  4204.                    that you exit from CATMGR and restore a backup copy of the
  4205.                    target catalog set.
  4206.  
  4207.         <D>elete - This operation will delete tagged entries from the source
  4208.                    catalog file in a bulk operation, enabling you to perform an
  4209.                    efficient cleanup operation on your catalog file in one
  4210.                    pass, rather than the un-cataloging the entries one at a
  4211.                    time in the CATDISK program itself.
  4212.  
  4213.                    To perform the deletion(s), CATMGR will read through the
  4214.                    source file and build a new catalog file, minus the tagged
  4215.                    entries, of course.  If an error occurs while the new
  4216.                    catalog file is being built, CATMGR will abandon the
  4217.                    deletion operation and leave the original catalog file
  4218.                    intact.
  4219.  
  4220.  
  4221.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4222.  
  4223.                                       Page 63
  4224.  
  4225.  
  4226.  
  4227.                    As in the copy operation, the most common error will be a
  4228.                    disk full error for the similar reasons as the copy
  4229.                    operation.
  4230.  
  4231.                    Once the deletion operation on the catalog file is complete,
  4232.                    the summary file will be updated to reflect the deletions.
  4233.                    Again, the same considerations to a summary file update
  4234.                    apply to the summary update operation for deletions.
  4235.  
  4236.                    If you get an error while the summary file is being updated,
  4237.                    it is advisable that you restore a backup copy of that
  4238.                    catalog file.
  4239.  
  4240.         <M>ove   - this operation will move the entries from the source catalog
  4241.                    to the destination catalog.  It basically combines a copy
  4242.                    operation from source to destination, followed by a deletion
  4243.                    of the entries from the source.  The move operation is the
  4244.                    most convenient way to "split" a large catalog file into two
  4245.                    smaller ones, or to "merge" two smaller catalogs into one
  4246.                    large one.
  4247.  
  4248.  
  4249.        The last two options available are:
  4250.  
  4251.        <V> -   The <V> option on the main screen will allow you to change the
  4252.                volume id of the highlighted entry to one that you specify
  4253.                without having to insert that disk in a drive and re-catalog it
  4254.                under a different name.
  4255.  
  4256.                Due to the way that the disk list is maintained in CATMGR, you
  4257.                may only perform this operation if none of the files on the
  4258.                current side of the screen have been tagged.  If you have any
  4259.                entries tagged, you will get an error message.
  4260.  
  4261.                Once you have activated this operation, you will be prompted for
  4262.                a new volume id for the current entry.  If you enter a name that
  4263.                already exists in the current catalog file, you will get an
  4264.                error message.  If you enter the same name for the volume id as
  4265.                it had before, no action will take place.
  4266.  
  4267.                Once a valid volume id has been entered, the rest is automatic.
  4268.  
  4269.                If you inadvertantly activated this option and do not wish to
  4270.                carry out any operation, hit <Esc> at the prompt and you will be
  4271.                returned to the main menu with no action taken.
  4272.  
  4273.        <Esc> - Finally, the last option available to you from the main menu is
  4274.                to exit from CATMGR to DOS.  This is done by pressing the <Esc>
  4275.                key.
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4288.  
  4289.                                       Page 64
  4290.  
  4291.  
  4292.  
  4293.               APPENDIX E - DISKFILL: CATDISK'S OPTIMAL DISK FILL UTILITY
  4294.  
  4295.         While CATDISK provides a way to manage the information that you have
  4296.         stored in a disk library, that still doesn't give us the excuse to
  4297.         waste disk space.  Unfortunately, copying files one at a time to a
  4298.         floppy and using our eyes to read the amount of free space left on the
  4299.         target disk and using our minds to scan the list of files to be
  4300.         offloaded and find the best file to fit that "hole" is tedious at best,
  4301.         especially if the list of files to be offloaded is large.
  4302.  
  4303.         We have developed a companion program to CATDISK called DISKFILL, which
  4304.         is included with CATDISK that addresses this problem.
  4305.  
  4306.         In a nutshell, DISKFILL has the ability to offload selected files from
  4307.         a single subdirectory at a time to a collection of disks (DISKFILL is
  4308.         primarily meant for use with floppies), and copying the files to them
  4309.         in such an order that the least amount of target disk space is wasted.
  4310.  
  4311.         DISKFILL also has the ability to move files (as opposed to copy files),
  4312.         and to delete groups of files as well.  Details on all three operations
  4313.         are discussed in their own sections in this appendix.
  4314.  
  4315.         As each disk is filled with files, DISKFILL can optionally call upon
  4316.         the CATDISK program to automatically catalog your disks as you go.
  4317.  
  4318.         DISKFILL can compare the files in your directory to those in an
  4319.         existing catalog to facilitate weeding out duplicate files BEFORE they
  4320.         get copied into your collection of files.
  4321.  
  4322.         4DOS/NDOS file descriptions are copied to the target disk with the
  4323.         files.  We strongly recommend that you use either 4DOS or NDOS to
  4324.         maintain comments right in the directory itself when you create or
  4325.         obtain the files that make up that directory.  That way, when you
  4326.         offload the files to diskettes and catalog them, there will be no
  4327.         guesswork in entering the file comments, as CATDISK will read them in
  4328.         as the disk gets cataloged.
  4329.  
  4330.         DISKFILL can also compare the list of files to be offloaded against a
  4331.         CATDISK catalog to allow intelligent recommendations of previously
  4332.         cataloged disks so that you may fill up those empty "holes" that may
  4333.         exist in your disk collection.
  4334.  
  4335.         DISKFILL can take one or more optional parameters as follows:
  4336.  
  4337.         DISKFILL parameters pattern
  4338.  
  4339.         where parameters may be one or more of the following:
  4340.  
  4341.         /Ffilename - filename is the name of the catalog file that you wish
  4342.                      DISKFILL to use for recommendations of previously
  4343.                      cataloged disks when offloading files to another media.
  4344.  
  4345.                      NOTE that there is no space between the /F and the
  4346.                      filename.  When specifying the filename, do NOT include a
  4347.                      path or file extension - DISKFILL will know where to look.
  4348.  
  4349.        
  4350.  
  4351.  
  4352.  
  4353.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4354.  
  4355.                                       Page 65
  4356.  
  4357.  
  4358.  
  4359.         /NOTAGALL  - Normally, DISKFILL automatically tags all files when
  4360.                      reading in a new subdirectory, as offloading all files is
  4361.                      the most common operation to perform.  By adding this
  4362.                      parameter to your command line when you start DISKFILL,
  4363.                      you can supress this feature.
  4364.  
  4365.         /QUIET     - Silent operation.  Supresses sound in DISKFILL.
  4366.  
  4367.         /NO4DOS    - Disables support for 4DOS's file descriptions.  If this
  4368.                      option is NOT specified, DISKFILL will copy the 4DOS file
  4369.                      description over to the target diskette for each file that
  4370.                      has one, and any file called DESCRIPT.ION will not be
  4371.                      processed.
  4372.  
  4373.         /NONDOS    - same as the /NO4DOS option outlined above.  4DOS and NDOS
  4374.                      file comments are handled in the same manner.
  4375.  
  4376.         NOTE that with these parameters shown above that, unlike the CATDISK
  4377.         program itself, they MUST be preceded by a slash.  This is due to the
  4378.         fact that the pattern mentioned below may contain a dash in its
  4379.         specification.
  4380.  
  4381.         pattern    - you may specify a wildcard filespec that you wish to be
  4382.                      included in a directory scan.  This filespec may be a
  4383.                      CATDISK enhanced filespec as documented in sub-option #4
  4384.                      of the reports and inquiries section of this user manual.
  4385.                      If no filespec is included on the command line, the
  4386.                      default, "*.*" is used.
  4387.  
  4388.                      NOTE that there is no slash or dash preceding the pattern.
  4389.  
  4390.         You may also put commonly used command line options in a DISKFILL
  4391.         environment variable using the DOS "SET" command.  This command (see
  4392.         examples below), may be placed in your AUTOEXEC.BAT file so that you
  4393.         will not need to remember which command line options to use to obtain
  4394.         your favorite setup, or for that matter, to type them!
  4395.  
  4396.         - example:  SET DISKFILL=/FCATDISK/NOTAGALL/QUIET
  4397.  
  4398.         You may run DISKFILL from any directory on your system.  That directory
  4399.         will be the initial subdirectory scanned on startup.  The subdirectory
  4400.         and filespec to match may be changed from within the program.
  4401.  
  4402.         DISKFILL has a capacity to hold 8000 files from a subdirectory.
  4403.         Once DISKFILL has loaded, it will scan the current directory and
  4404.         present a list of files that match the filespec given.  The procedure
  4405.         here is to tag the files that you wish to be manipulated and select an
  4406.         operation to perform on them.  As the initial or new directory is
  4407.         scanned, DISKFILL automatically selects ALL files for manipulation,
  4408.         unless you specified /NOTAGALL when you started DISKFILL, as this
  4409.         selection will undoubtedly be the most common.
  4410.  
  4411.         You can tag files in one of two ways.  The first way is to highlight
  4412.         the desired file by using the cursor keys and by pressing the
  4413.         <Space Bar>.  DISKFILL will indicate that a file is tagged when there
  4414.         is an arrow to the left of its filename name on the screen.
  4415.  
  4416.  
  4417.  
  4418.  
  4419.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4420.  
  4421.                                       Page 66
  4422.  
  4423.  
  4424.  
  4425.         You can move the highlight bar around the screen by using the following
  4426.         keys:
  4427.  
  4428.         <Up Arrow>    - Moves the highlight bar up one line if possible.
  4429.         <Down Arrow>  - Moves the highlight bar down one line if possible.
  4430.         <PgUp>        - Moves the highlight bar up one screenful (14 lines) if
  4431.                         possible.
  4432.         <PgDn>        - Moves the highlight bar down one screenful (14 lines)
  4433.                         if possible.
  4434.         <Home>        - Moves the highlight bar to the top of the list.
  4435.         <End>         - Moves the highlight bar to the end of the list.
  4436.  
  4437.  
  4438.         The other way to tag entries is to do so in groups.  To bring up a list
  4439.         of tagging functions available, hit the <T> key at the main menu.
  4440.         DISKFILL will bring up a list with the following functions:
  4441.  
  4442.           <A> - This will tag ALL of the files.
  4443.  
  4444.           <C> - This will clear the tags of ALL of the files.
  4445.  
  4446.           <S> - You will be prompted for a wildcard specification for all of
  4447.                 the files that you would like to be tagged.
  4448.  
  4449.           <U> - You will be prompted for a wildcard specification for all of
  4450.                 the files that you would like the tags cleared.
  4451.  
  4452.           <I> - This will "flip" the tagged status of all files.  This is
  4453.                 useful if, for example, you wish to copy all but five of the
  4454.                 files if a long list to be offloaded. Simply tag the five that
  4455.                 you do not wish to copy and then select this option to quickly
  4456.                 tag the entries that you do wish to copy.
  4457.  
  4458.           <F> - This will flip the tagged status of any files that DISKFILL
  4459.                 finds as duplicates in the selected catalog file.  Normally,
  4460.                 when offloading files to floppies and then cataloging them, you
  4461.                 run a good risk of having duplicate files in your collection.
  4462.                 Although CATDISK itself can point them out to you, it is still
  4463.                 best to eliminate them before they get into your collection.
  4464.  
  4465.                 Here are two strategies that you can use to "pre-process" a
  4466.                 directory before offloading files "<M>ove" or "<C>opy":
  4467.  
  4468.                 1) By activating this option with NO FILES FLAGGED, you can
  4469.                    then see which files are indeed duplicates, upon which you
  4470.                    can activate the <D>elete files option from the main menu.
  4471.                    Presto!  No more duplicate files.
  4472.  
  4473.                 2) By activating this option with the files that you intend to
  4474.                    offload already flagged, you can have DISKFILL "un-tag" the
  4475.                    duplicate files that it finds.  You may then offload the
  4476.                    remaining files and examine the duplicate files left over.
  4477.  
  4478.                 In order to use this option, you must have selected a catalog
  4479.                 file to use either from the command line when you started
  4480.                 DISKFILL, or from the main menu by using "<N>ew Catalog File".
  4481.  
  4482.  
  4483.  
  4484.  
  4485.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4486.  
  4487.                                       Page 67
  4488.  
  4489.  
  4490.  
  4491.                 In order to determine whether or not a file is a duplicate,
  4492.                 DISKFILL will use the filename and filesize.  When you hit <F>
  4493.                 to activate this feature, DISKFILL will ask you if it should
  4494.                 use the file date as an additional criteria.  You may answer
  4495.                 <Y>es or <N>o to the prompt, or you may press <Esc> to abandon
  4496.                 the operation.
  4497.  
  4498.                 Once you have determined the criteria for DISKFILL to use, it
  4499.                 will make a pass through your catalog file and compare the
  4500.                 contents of the catalog file to the contents of the currently
  4501.                 selected directory.  Each file that it finds as duplicate will
  4502.                 have its flagged status flipped.  When the operation is
  4503.                 complete, you will be returned to the file list.
  4504.  
  4505.         <Esc> - Will return you to the main menu with no further action taken.
  4506.  
  4507.  
  4508.         Other options available from the main menu are:
  4509.  
  4510.         <P> -     Change Pattern:  DISKFILL will prompt you for a new filespec
  4511.                   to match when scanning the directory.  This is handy if you
  4512.                   only wish to have a grouping of files from the current
  4513.                   subdirectory to be included in the point and shoot list.
  4514.                   Note that after the directory has been re-scanned, ALL files
  4515.                   will be tagged for manipulation.
  4516.  
  4517.         <S> -     Change Subdirectory:  DISKFILL will prompt you for a new
  4518.                   subdirectory to be scanned (the current pattern as noted at
  4519.                   the top of the screen will be used).  Note that after the
  4520.                   directory has been scanned, ALL files will be tagged for
  4521.                   manipulation.
  4522.  
  4523.         <N> -     New Catalog File: DISKFILL will prompt you for a new catalog
  4524.                   to be used in recommending disks from an existing catalog for
  4525.                   backfilling of files.  Do not specify a path or file
  4526.                   extension - DISKFILL will know where to look.  Hit <Esc> at
  4527.                   the prompt to leave the existing (or lack of) catalog
  4528.                   unchanged.  If you do enter a name, DISKFILL will attempt to
  4529.                   load that catalog.  If a problem occurs (eg. file not found
  4530.                   or error reading it), the setting will be cleared (i.e. no
  4531.                   catalog will be used).  If successful, that catalog will be
  4532.                   used in all recommendations and cataloging operations.
  4533.  
  4534.         <Enter> - If the highlight bar is currently pointing to a subdirectory
  4535.                   accessible directly from the current directory, you may press
  4536.                   <Enter> to switch to that subdirectory.  If you are pointing
  4537.                   to <PARENT DIR> and hit <Enter>, you will move down one level
  4538.                   in the disk's subdirectory tree.
  4539.  
  4540.                   By traversing the directory tree in this manner, it is
  4541.                   possible to quickly move from one directory to another in a
  4542.                   point and shoot manner.  It may be quicker to use the <S>
  4543.                   option to move directly to a subdirectory that you enter at a
  4544.                   prompt in some circumstances.  If you wish to switch to
  4545.                   another disk drive, you must use the <S> option.
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4552.  
  4553.                                       Page 68
  4554.  
  4555.  
  4556.  
  4557.         DISKFILL currently has three operations that you can perform on the
  4558.         tagged files:
  4559.  
  4560.         <C> - Copy:  When this option is selected, DISKFILL will ask you for
  4561.                      the drive of the target disk(s) that will received the
  4562.                      tagged files.  Typically, this will be drive A: or drive
  4563.                      B:, but we have allowed any available drive letter in your
  4564.                      system due to the fact that there may be an external
  4565.                      floppy disk using a device driver that is available.  Hit
  4566.                      <Esc> to abandon the operation.
  4567.  
  4568.                      Once you have selected the target drive, DISKFILL will ask
  4569.                      you if you would like to catalog each disk after it has
  4570.                      received more files.  This prompt requires a simple YES or
  4571.                      NO answer, which can be indicated by pressing "Y" for YES
  4572.                      or "N" for NO.  You may press <Esc> at this prompt to
  4573.                      abandon the operation.
  4574.  
  4575.                      DISKFILL will then prompt you to insert a disk in the
  4576.                      target drive.  If you do not wish to continue with the
  4577.                      operation, hit <Esc> to return to the main menu.
  4578.  
  4579.                      You may also press the <S> key at the prompt to shell out
  4580.                      to DOS.  This is handy if you need to check something
  4581.                      outside of the DISKFILL program before proceeding.
  4582.  
  4583.                      If you have instructed DISKFILL to use a catalog file for
  4584.                      the purposes of recommending disks for "backfilling"
  4585.                      previously cataloged disks, you may press <R> at this
  4586.                      prompt.
  4587.  
  4588.                      DISKFILL will then compare the list of files that need to
  4589.                      be copied or moved with the entries in the selected
  4590.                      catalog and will recommend a disk to use for accepting
  4591.                      more files.  The program will attempt to recommend disks
  4592.                      such that the ones with the least amount of free space
  4593.                      (those are the most difficult to fill later) are used
  4594.                      first.
  4595.  
  4596.                      If you have a catalog containing mixed media (hard drives,
  4597.                      two different floppy drive sizes on the A: and B: drives,
  4598.                      etc.), DISKFILL is currently not able to differentiate
  4599.                      between them, so it may be possible for it to suggest a
  4600.                      5-1/4" diskette when you are copying to 3.5" diskettes, or
  4601.                      even you hard drive.  You may also have cataloged program
  4602.                      disks that you have purchased, to which you do not
  4603.                      necessarily want to copy files.  If DISKFILL recommends
  4604.                      such a disk, sit the <S> key at the recommendation prompt
  4605.                      to "Squelch" that disk and not use it for any further
  4606.                      recommendations.  DISKFILL will then recommend another
  4607.                      disk for use.
  4608.  
  4609.                      NOTE: If you need to "re-activate" those disks that have
  4610.                      been "squelched" for another copy process, simply load
  4611.                      that summary file from the main menu before performing any
  4612.                      other copy or move operations.
  4613.  
  4614.  
  4615.  
  4616.  
  4617.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4618.  
  4619.                                       Page 69
  4620.  
  4621.  
  4622.  
  4623.                      Once you have the desired disk inserted, and are ready to
  4624.                      copy files to it, hit any other key to proceed.
  4625.                      The prompt containing all the above mentioned options
  4626.                      will appear before each disk necessary to complete the
  4627.                      operation is to be inserted.
  4628.  
  4629.                      Before DISKFILL begins to copy files to each disk, it will
  4630.                      examine the disk to determine capacity and to check to see
  4631.                      if any files or sub-directories are present on the disk.
  4632.                      If a disk error occurs at this stage, DISKFILL will assume
  4633.                      that the disk is not formatted and will bring up a message
  4634.                      indicating that it thinks that the disk is not formatted.
  4635.  
  4636.                      You have three options at this point:
  4637.  
  4638.                      1) You may hit <S> to shell out to DOS to either examine
  4639.                         the disk, or to invoke your favorite program to
  4640.                         facilitate formatting that diskette.  We have not built
  4641.                         in the facility to load any particular disk formatting
  4642.                         software, as there are many alternatives to the DOS
  4643.                         format command, and the selection of a given program is
  4644.                         a matter of personal preference.  This also leaves open
  4645.                         the possibility of using a disk formatting program that
  4646.                         has the ability to format more capacity on a disk than
  4647.                         normal.
  4648.  
  4649.                         When you are ready to continue with the copy operation
  4650.                         after shelling out to DOS, type "EXIT" and hit <Enter>
  4651.                         to return back to the prompt.
  4652.                     
  4653.                      2) You may hit <Esc> to abort the copy operation and
  4654.                         return to the main menu.
  4655.  
  4656.                      3) You may hit any other key to try a new diskette, at
  4657.                         which time the disk determination will be repeated.
  4658.  
  4659.                      If the target disk has files on it, you will be presented
  4660.                      with another set of options that will allow you to make a
  4661.                      decision on what to do next:
  4662.  
  4663.                      1) You may hit <V> to view the directory of the target
  4664.                         disk to verify that it is the one that you intended to
  4665.                         insert in the drive.  The DOS "DIR/P" command will be
  4666.                         issued.
  4667.  
  4668.                      2) You may hit <S> to shell to DOS.  This option is
  4669.                         available to allow you to examine the situation more
  4670.                         closely, perhaps to examine the directory of the disk
  4671.                         and see if you have inserted the correct diskette.
  4672.                         When you return from the DOS shell, you will be left at
  4673.                         this prompt from which you may take appropriate action.
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4684.  
  4685.                                       Page 70
  4686.  
  4687.  
  4688.  
  4689.                      3) You may press <E> to have DISKFILL erase all visible
  4690.                         files and subdirectories from that disk before
  4691.                         proceeding with the copy operation.
  4692.  
  4693.                         IF YOU ARE USING A TARGET DRIVE OTHER THAN A: or B:,
  4694.                         EXERCISE THIS OPTION WITH EXTREME CAUTION.  IF THE
  4695.                         TARGET DRIVE HAPPENS TO BE A HARD DISK, ALL VISIBLE
  4696.                         FILES AND SUBDIRECTORIES WILL BE ERASED.  YOU HAVE BEEN
  4697.                         WARNED!
  4698.  
  4699.                      4) You may press <T> to try another diskette.  You will
  4700.                         then be returned to the disk insertion prompt.
  4701.  
  4702.                      5) You may press <Esc> to Abort the copy operation
  4703.                         altogether and return to the main menu.
  4704.  
  4705.                      6) You may press any other key to continue on with the
  4706.                         copy operation.  DISKFILL will then add files to those
  4707.                         that already exist on the target diskette as available
  4708.                         space allows.
  4709.  
  4710.                      Once all is ready, DISKFILL will proceed to copy files to
  4711.                      the target diskette.  As each file is copied, it will be
  4712.                      highlighted in the list and a progress indicator will
  4713.                      appear in the instruction area of the screen keeping you
  4714.                      informed of the progress of the copy.  DISKFILL will
  4715.                      buffer as much of the source file into memory as it can
  4716.                      before writing it out to the target diskette in order to
  4717.                      facilitate speed.
  4718.  
  4719.                      As DISKFILL copies files, an indicator at the bottom of
  4720.                      the screen will indicate how much of the read and write
  4721.                      operations are complete.  The indicator beside each status
  4722.                      indicator that is flashing will indicate what DISKFILL is
  4723.                      currently doing.
  4724.  
  4725.                      If you added the /4DOS or /NDOS command line option when
  4726.                      you started DISKFILL, it will, upon copying each file to
  4727.                      the target disk, check to see if the file just copied has
  4728.                      a 4DOS/NDOS file description.  If so, that file
  4729.                      description will be copied over to the target disk if
  4730.                      there is enough room to accomodate it.  It is possible
  4731.                      that disk space may be completely filled and the hidden
  4732.                      file that 4DOS or NDOS maintains cannot be expanded.  If
  4733.                      this occurs, the description will not appear in the
  4734.                      directory of the target disk, even though the file was
  4735.                      successfully copied.  This behavior is consistent with
  4736.                      that of 4DOS and NDOS.
  4737.  
  4738.                      As each file is successfully copied to the target, it will
  4739.                      be "un-tagged" in the file list.  This way, if the copy
  4740.                      process is interrupted or aborted for any reason, you can
  4741.                      effectively pick up where you left off, as the tagged
  4742.                      files will be those that were not copied.
  4743.  
  4744.                      The capacity left over on the target disk will be updated
  4745.                      as each file is copied to it.  Additionally, the
  4746.                      statistics on the right side of the screen will indicate
  4747.                      how many files have yet to be copied.
  4748.  
  4749.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4750.  
  4751.                                       Page 71
  4752.  
  4753.  
  4754.  
  4755.                      If a disk error occurs when copying a file to the target,
  4756.                      that copy will be aborted.  DISKFILL will make an attempt
  4757.                      to remove that file from the target disk, although this
  4758.                      cannot be guaranteed.  The file that was being copied at
  4759.                      the time of the error will remain in the "hit list" to be
  4760.                      copied to a subsequent disk.  You will then be returned to
  4761.                      the prompt for a new disk with which to continue the copy
  4762.                      operation.
  4763.  
  4764.                      It may be advisable to shell out to DOS at this point with
  4765.                      the <S> command to check the disk and perhaps run a
  4766.                      diagnostic program on the target disk in order to map out
  4767.                      any bad areas of the disk.  If this proves to be the cause
  4768.                      of the error, you may be able to continue the copy
  4769.                      operation with that disk.
  4770.  
  4771.                      When DISKFILL has determined that no more files from the
  4772.                      selected list will fit on the target disk, it will do one
  4773.                      of two things:
  4774.  
  4775.                      1) If you indicated that you would like each disk to be
  4776.                         cataloged, DISKFILL will attempt to load CATDISK and
  4777.                         tell it to catalog the disk.
  4778.  
  4779.                         Any command line parameters in the CATDISK environment
  4780.                         variable (see the section on starting CATDISK for
  4781.                         details) will also be in effect for this operation.
  4782.                         When the operation is complete, you will be returned to
  4783.                         the disk insertion prompt where you may continue on
  4784.                         with a new diskette, or abort the operation right
  4785.                         there.
  4786.  
  4787.                         The catalog used in the operation will be determined in
  4788.                         the following order of priority:
  4789.  
  4790.                         i)   If you specified a catalog to be used for
  4791.                              recommendations for backfilling disks, that
  4792.                              catalog will be used in the catalog operation.
  4793.  
  4794.                         ii)  If the above is not the case, any catalog name
  4795.                              specified in the CATDISK environment variable (see
  4796.                              STARTING CATDISK in this manual) will be used.
  4797.  
  4798.                         iii) If neither of the above two are true, the default
  4799.                              catalog name "CATDISK" will be used.
  4800.  
  4801.  
  4802.                         In order for this operation to be successful, two
  4803.                         criteria must be met:
  4804.  
  4805.                         i)  The program CATDISK.EXE must be present in either
  4806.                             the current directory or in a subdirectory
  4807.                             specified in your DOS PATH and
  4808.  
  4809.                         ii) There must be enough memory available (DISKFILL
  4810.                             remains in memory while CATDISK does its thing) to
  4811.                             load CATDISK and complete the function.
  4812.  
  4813.                      
  4814.  
  4815.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4816.  
  4817.                                       Page 72
  4818.  
  4819.  
  4820.  
  4821.                      If one or both of these criteria are not met, the
  4822.                      cataloging operation will not take place, and you will
  4823.                      be notified of the error.
  4824.  
  4825.                      2) If you indicated that you would NOT like each disk to
  4826.                         be cataloged, you will be returned to the disk
  4827.                         insertion prompt where you may continue on with a new
  4828.                         diskette, or abort the operation right there.
  4829.  
  4830.                      When all selected files have been copied to the target
  4831.                      directory, you will automatically be returned to the main
  4832.                      menu where the updated file list will be displayed.  If
  4833.                      all went well, there should be no more files tagged.
  4834.  
  4835.  
  4836.  
  4837.                                           IMPORTANT NOTES
  4838.  
  4839.                      DISKFILL will work best when there is a mix of large and
  4840.                      small files available for copying to the target disk(s),
  4841.                      as DISKFILL will be able to use the smaller files to fill
  4842.                      in the holes left over by the larger files.
  4843.  
  4844.                      It is not necessary to use disks of the same capacity
  4845.                      throughout an entire copy operation.  For example, in a
  4846.                      high capacity 3.5" drive, you could use a mix of 1.44Mb
  4847.                      and 720K floppies.  DISKFILL will copy files to it as the
  4848.                      capacity of each inserted disk allows.
  4849.  
  4850.                      If you have one or several files that are too big to fit
  4851.                      on a target drive, the insert disk prompt will simply be
  4852.                      repeated over and over again until you abort, as DISKFILL
  4853.                      is a very patient program and will wait until a suitable
  4854.                      disk is inserted in the drive.
  4855.  
  4856.                      If you have been using low density media, you may need to
  4857.                      switch to a higher capacity disk format in order to
  4858.                      accommodate the file.
  4859.  
  4860.                      If you have a file that will not fit on a disk of any
  4861.                      capacity, DISKFILL will not be able to offload it.  If the
  4862.                      file is not compressed, you may wish to use one of the
  4863.                      many archive utilities supported by CATDISK to compress
  4864.                      the file to a size that may fit on a target disk, or
  4865.                      alternatively, you may wish to use a file split/merge
  4866.                      utility to break the file down into smaller, more
  4867.                      manageable sub-files.
  4868.  
  4869.         <M> - Move:  The MOVE operation works exactly like the copy operation
  4870.                      except that each file being offloaded is erased after the
  4871.                      copy operation is complete.  If a disk error occurs during
  4872.                      the copying part of the operation, the file involved is
  4873.                      left intact in the source directory where an attempt can
  4874.                      be made to move it to another disk later on in the
  4875.                      operation.
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4882.  
  4883.                                       Page 73
  4884.  
  4885.  
  4886.  
  4887.                      THE MOVE OPERATION IS THE PREFERRED METHOD OF OFFLOADING
  4888.                      FILES TO FLOPPIES.  It is also safe due to the fact that
  4889.                      the only time that the source file is erased is when it
  4890.                      has been successfully copied to the target disk.
  4891.  
  4892.         <D> - Delete:  This operation will quickly delete all selected files
  4893.                        from the source directory.  Once a file has been
  4894.                        deleted, DISKFILL cannot recover it, although it is
  4895.                        possible to use one of the many file unerase utilities
  4896.                        on the market to get the file back.
  4897.  
  4898.                        Due to the potential severity of using this function,
  4899.                        you will be asked for verification before continuing.
  4900.  
  4901.         NOTE:  With the move and delete operations, DISKFILL will not be able
  4902.                to erase a file marked "READ-ONLY".
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  4948.  
  4949.                                       Page 74
  4950.  
  4951.  
  4952.  
  4953.                            APPENDIX F - SUPPORT AND UPDATES
  4954.  
  4955.         As said in the introduction, we will only offer advice and technical
  4956.         support to those who are registered CATDISK users.  Users who do
  4957.         contribute will be notified when updates and new products are
  4958.         available. Anyone wishing to offer advice and suggestions are most
  4959.         welcome to do so.
  4960.  
  4961.         The author may be reached on CompuServe at I.D. #  73307,333, or on our
  4962.         support BBS "The Shareware Connection" in WATERLOO, Ontario, Canada,
  4963.         under my name, Rick Hillier.  For information on obtaining upgrades via
  4964.         this bbs, please see "ATTENTION OUT OF TOWN CATDISK USERS" later on in
  4965.         this appendix.
  4966.  
  4967.         You may also correspond via your FAX machine, if you have access to
  4968.         one. Our FAX number is (519)-884-4887.
  4969.  
  4970.         Telephone support available to registered users only.  Our voice line
  4971.         is (519)-888-6763.  If you get our answering machine, leave a detailed
  4972.         message regarding your question and/or problem, and we will return your
  4973.         call.
  4974.  
  4975.         PLEASE NOTE THAT IN THE EVENT THAT NO ONE IS AVAILABLE TO TAKE A
  4976.         SUPPORT CALL, IT IS OUR POLICY TO RETURN CALLS FROM NON-REGISTERED
  4977.         USERS COLLECT ON AN AS-AVAILABLE BASIS.
  4978.  
  4979.         If you are not a registered user and do have questions, the best place
  4980.         to leave them is in an E-mail message on either on The Shareware
  4981.         Connection or on CompuServe.
  4982.  
  4983.         The base registration fee is $25.00.  When you register your copy of
  4984.         CATDISK, you will receive written confirmation that we have received
  4985.         your registration fee, as well as instructions on how to eliminate the
  4986.         shareware introductory screens and their accompanying random function
  4987.         key presses.  If you would like to receive CATDISK from us on disk or
  4988.         via our support BBS, please read on.
  4989.  
  4990.         Those of you who register your copy of CATDISK and wish to receive an
  4991.         update to the latest version (from me and not the support BBS), please
  4992.         be sure and use the registration form to indicate that you wish to
  4993.         receive the latest version on diskette.  If you do not have the
  4994.         registration form, you can download it from "The Shareware Connection"
  4995.         if you have a modem.  If not, please send a note with your registration
  4996.         fee indicating the CATDISK version that you are currently using.
  4997.  
  4998.         Current prices (in addition to the base registration fee of $25.00) are
  4999.         $10.00 for a 360K 5.25" disk and $12.50 for 720K 3.5" disk.
  5000.  
  5001.         Optionally, you may include a diskette (5.25" or 3.5" disks are fine)
  5002.         and diskette mailer with your registration fee plus $5.00 to cover
  5003.         shipping and duplication costs, and we will send you the latest version
  5004.         of CATDISK.
  5005.  
  5006.         If there have been no upgrades available since your current release,
  5007.         your upgrade will be held until such time as one becomes available,
  5008.         unless you specify that you just want the current release on diskette.
  5009.  
  5010.  
  5011.  
  5012.  
  5013.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5014.  
  5015.                                       Page 75
  5016.  
  5017.  
  5018.  
  5019.         While on the subject of upgrades, once you are a registered CATDISK
  5020.         user, you are considered to be registered for all future CATDISK
  5021.         releases, whether you receive them from us or download them via your
  5022.         favorite bbs when they become available there.  If you do obtain
  5023.         upgrades in that way, you do NOT have to send any type of upgrade fee
  5024.         to us.
  5025.  
  5026.  
  5027.         ATTENTION OUT OF TOWN CATDISK USERS
  5028.  
  5029.         The most up to date version of CATDISK is always available on The
  5030.         Shareware Connection, which may be reached at (519)-888-6924, 24 hrs. a
  5031.         day.  In order to be able to access a new version of CATDISK, you must
  5032.         be a registered user and you must have taken the support BBS option as
  5033.         outlined on the registration form.  This option will allow you to
  5034.         obtain perpetual upgrades to the CATDISK program, or any other
  5035.         shareware offering that may be made in the future.
  5036.  
  5037.         This option involves a $5.00 access fee on the board over and above the
  5038.         base registration fee, and will allow you perpetual access to the
  5039.         software available in the data libraries of this BBS system, including
  5040.         CATDISK itself.
  5041.  
  5042.         You can connect with The Shareware Connection at speeds up to 14400
  5043.         baud, allowing a download of the complete CATDISK package in under 3
  5044.         minutes if you connect at that speed.  At 2400 baud, the complete
  5045.         package can be downloaded in about 19 minutes.
  5046.  
  5047.         Please note that if you are not a regular member of this BBS, or
  5048.         haven't taken advantage of the above upgrade offer, YOU WILL NOT BE
  5049.         ABLE TO ACCESS THE PROGRAM.
  5050.  
  5051.         If you do not wish to have a BBS membership, you can still see
  5052.         what changes and revisions have been made to date by going to the
  5053.         bulletins section of the board.  You do not have to be a registered BBS
  5054.         or CATDISK user to use this feature.
  5055.  
  5056.         All CATDISK documentation, including the revision history, readme file,
  5057.         and registration forms are available to the public on this system.  If
  5058.         you received an incomplete CATDISK package from a vendor or bulletin
  5059.         board system, you can supplement missing documentation directly from
  5060.         the support BBS.
  5061.  
  5062.         The electronic mail feature of the board is also fully accessible for
  5063.         leaving feedback and/or suggestions.
  5064.  
  5065.         -----------------------------------------------------------------------
  5066.  
  5067.         If you do have a question, or a bug report, or whatever, in your
  5068.         correspondence, please indicate the following:
  5069.  
  5070.         1)  The versions of CATDISK and DOS that you are using.
  5071.         2)  Your hardware configuration (Model, memory size, printer, etc.)
  5072.         3)  Any resident software that you have loaded in memory at the time.
  5073.             (i.e. Sidekick, SuperKey, Disk Caches, Print Spoolers, Ramdisks,
  5074.             etc.)
  5075.  
  5076.         This information will help me to track any problems and to suggest
  5077.         reasonable solutions to your problems.
  5078.  
  5079.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5080.  
  5081.                                       Page 76
  5082.  
  5083.  
  5084.  
  5085.                            APPENDIX G - QUESTIONS AND ANSWERS
  5086.  
  5087.         As CATDISK has developed over the past while, we have received many
  5088.         questions regarding the operation of CATDISK.  The most common are
  5089.         addressed in this section of the manual.
  5090.  
  5091.         Q. When I go to catalog a new disk, CATDISK aborts the catalog file
  5092.            update with an error message that the disk is full, even though
  5093.            there is still room on the disk containing the catalog files.
  5094.  
  5095.         A. When CATDISK updates a catalog file, it does so by merging the new
  5096.            information in with the old, building a new file from the old in the
  5097.            process.  The catch here is that, at the end of the catalog file
  5098.            update, BOTH files actually exist, thereby taking up roughly double
  5099.            the size of the original catalog file.  At the end of this
  5100.            procedure, if successful, CATDISK deletes the old file and renames
  5101.            the new temporary file to what the original catalog file was called.
  5102.            The reason this is necessary is that, while re-cataloging a disk,
  5103.            there is a possibility that files were removed from that disk.  This
  5104.            method of updating the catalog provides a convenient mechanism for
  5105.            removing those files from the catalog.
  5106.  
  5107.         Q. Is there a way to set the default settings as found in the settings
  5108.            and toggles menu, such as the printer report type, double sided
  5109.            reports, and the auto comment feature?
  5110.  
  5111.         A. All settings as found in the settings & toggles menu can be
  5112.            initialized the way you would like them by adding command line
  5113.            options after the CATDISK command when you start the program.
  5114.            Additionally, these options can be conveniently stored in a CATDISK
  5115.            environment variable so you don't have to type them in every time
  5116.            you start CATDISK.  See the section "STARTING CATDISK" in this user
  5117.            manual for full details.
  5118.  
  5119.         Q. CATDISK currently supports archive file comments in ZIP, ZOO, ARJ
  5120.            and DWC files.  Would it be possible to extract those from ARC files
  5121.            as well?
  5122.  
  5123.         A. ARC file comments were a non-standard extension provided by PKWare's
  5124.            PKARC/PKPAK series of archivers, and as such are not supported at
  5125.            this time.
  5126.  
  5127.         Q. Would it be possible for CATDISK to support ARCHIVES within
  5128.            ARCHIVES?
  5129.  
  5130.         A. Unfortunately, the answer is no.  In order to read the directory of
  5131.            an archive within another archive file, the original one must first
  5132.            be expanded into its separate files.  Firstly, with the ever
  5133.            evolving compression methods employed with new versions of the
  5134.            archive utilities, this would be beyond the scope of this program.
  5135.            Secondly, there would always be the possibility of overwriting an
  5136.            existing file of the same name.  It's just not feasible.
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5146.  
  5147.                                       Page 77
  5148.  
  5149.  
  5150.  
  5151.         Q. Is it possible for CATDISK to support file categories?
  5152.  
  5153.         A. Indirectly, CATDISK already supports file categories.  When CATDISK
  5154.            searches your catalog by comment via option <F2>, it is really
  5155.            performing a keyword search (i.e. any comment that contains the
  5156.            search item anywhere in its body will show in the report).  In a
  5157.            sample scenario, you could come up with a list of three letter
  5158.            abbreviations for your category list (eg. WIN for Windows, SPR for
  5159.            Spreadsheets, DBS for Database, COM for Communications, etc.) and
  5160.            start each comment with these categories.  By searching for "WIN",
  5161.            you can bring up a list of files in that category.  By sorting on
  5162.            comment, you can bring up a list of filenames sorted by category.
  5163.            Your imagination is the only limiting factor.
  5164.  
  5165.         Q. In the summary report, I see disk entries for which the amount of
  5166.            free space and the amount of space used adds up to more than the
  5167.            capacity of the disk itself.  The % slack factor is also wrong.
  5168.  
  5169.         A. You probably have a corrupted file allocation table on that disk,
  5170.            and could be in for some serious trouble.  Format a fresh disk and
  5171.            transfer the files to it, and re-catalog it from that new disk.
  5172.  
  5173.         Q. After starting the cataloging process on a diskette, I discovered
  5174.            that the label on the diskette was wrong.  Would it be possible to
  5175.            abort the process, change the label and start over?
  5176.  
  5177.         A. Once the cataloging process is started, it cannot be stopped.  If
  5178.            you've run into a situation like that above, let CATDISK finish the
  5179.            task, and use option #4 to change the label on the diskette.
  5180.            CATDISK has a mechanism to automatically change the old volume label
  5181.            to the new one throughout the catalog files.  It's quick and
  5182.            painless.
  5183.  
  5184.         Q. We have file comments for each file entry in the catalog file.
  5185.            Would it be possible to have comments for each disk in the summary
  5186.            file?
  5187.  
  5188.         A. At present, no, although this is not carved in stone.  The main
  5189.            reason for this is that CATDISK keeps the entire disk summary in
  5190.            memory at all times.  A comment on each disk would significantly
  5191.            increase the memory requirements of CATDISK.
  5192.  
  5193.         Q. I have some self-booting games.  Would it be possible to create a
  5194.            dummy entry for that disk in the catalog?
  5195.  
  5196.         A. Doing this would defeat the purpose for which CATDISK was written.
  5197.            Self-booting games (those that CATDISK won't read) do not have a
  5198.            directory in the conventional sense.  As there are no files per se
  5199.            there is nothing to look for on the diskette.  You need only locate
  5200.            the disk itself in order to use it.
  5201.  
  5202.         Q. Is it possible for CATDISK to only catalog the disk itself, and not
  5203.            the files on it.
  5204.  
  5205.         A. Doing so would defeat the purpose of using CATDISK.  The whole idea
  5206.            behind CATDISK is to be able to locate files on your disks.  You can
  5207.            see the physical label on a disk, but the files themselves are
  5208.            invisible until you read it in your disk drive.  If all you need is
  5209.            to find a known disk, a good filing system is the way to go.
  5210.  
  5211.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5212.  
  5213.                                       Page 78
  5214.  
  5215.  
  5216.  
  5217.         Q. I have many disks with numerous insignificant files on them such as
  5218.            printer drivers, etc.  Would it be possible to catalog only selected
  5219.            files from these disks?
  5220.  
  5221.         A. Unfortunately, not at this time.  In order to keep the shareware
  5222.            version of CATDISK as simple to use as possible, all files get
  5223.            cataloged hands free.  You can, however, mask out several file
  5224.            groups by wildcard specification in the CDISKCFG program.  CATDISK
  5225.            PLUS, a commercial release of this program with many enhancements
  5226.            described in more detail in a later appendix, will handle this type
  5227.            of operation with more flexibility.
  5228.  
  5229.         Q. I've noticed that CATDISK seems to have missed some files on my hard
  5230.            disk when I list the catalog entries for that disk.
  5231.  
  5232.         A. CATDISK presently has an internal limitation of being able to
  5233.            remember only the first 5000 files that it sees, either in the
  5234.            directories themselves, or in any archive files whose contents are
  5235.            included in the catalog.  After it reaches this number, it will stop
  5236.            and begin cataloging the files read in.  The limitation of 5000
  5237.            files may, in fact, be lower if you do not have enough memory to
  5238.            accomodate them all.  If this is the case, you should remove some or
  5239.            all of your resident programs to free up valuable system memory for
  5240.            CATDISK to use.
  5241.  
  5242.            Also, adjusting the "disks/files per catalog" setting via the
  5243.            CDISKCFG program to the lowest value that will accomodate your
  5244.            largest catalog file will also free up some memory.
  5245.  
  5246.         A. Another reason that this may occur, especially if your disk has less
  5247.            than 5000 entries is that the missing files may match a filespec set
  5248.            in the EXCLUDE FILES LIST that can be changed in the CDISKCFG
  5249.            utility.  Check that list out to see if this is the case.
  5250.  
  5251.         Q. Why does CATDISK slow down as my catalog files grow larger.
  5252.  
  5253.         A. As CATDISK catalogs each disk, it must make a pass through your data
  5254.            file to determine whether or not any files have been deleted or
  5255.            changed, so that the catalog file can be updated accordingly.  Many
  5256.            other disk catalogers on the market that outperform CATDISK in their
  5257.            cataloging operation retain the entire catalog in RAM.  While this
  5258.            is fast, there are two problems with it.
  5259.  
  5260.            Firstly, this imposes an extreme limitation on their ultimate
  5261.            capacity in terms of how many disks and files you can catalog.  If
  5262.            you are serious at all about maintaining a catalog of all your files
  5263.            and that your library will possibly grow to many files, these types
  5264.            of catalogers are not at all suitable for your usage.
  5265.  
  5266.            Secondly, if you should experience a power outage before you've
  5267.            saved your work, you can kiss that work good-bye.  By manipulating
  5268.            data on-disk, CATDISK does catalog your disks at a slower rate than
  5269.            the above mentioned type of cataloger, but it guarantees the
  5270.            integrity of your work.  We have also developed some very fast
  5271.            catalog updating routines, so any slowdown will be kept to a minimum
  5272.            while guaranteeing the integrity of your catalog file.
  5273.  
  5274.  
  5275.  
  5276.  
  5277.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5278.  
  5279.                                       Page 79
  5280.  
  5281.  
  5282.  
  5283.         Q. In DISKFILL, I have told it to call upon CATDISK to catalog each
  5284.            disk as it is filled, but at the end of each disk, the screen
  5285.            quickly blanks and then I am returned to DISKFILL.
  5286.  
  5287.         A. You probably do not have the directory where the program file
  5288.            CATDISK.EXE resides included in your DOS PATH.  DISKFILL is unable
  5289.            to ascertain whether or not CATDISK.EXE could be found and executed
  5290.            so that an appropriate error message can be displayed.
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.  
  5308.  
  5309.  
  5310.  
  5311.  
  5312.  
  5313.  
  5314.  
  5315.  
  5316.  
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5344.  
  5345.                                       Page 80
  5346.  
  5347.  
  5348.  
  5349.                         APPENDIX H - CATDISK COMPANION PROGRAMS
  5350.  
  5351.         Over the past 5-1/2 years, CATDISK has grown steadily in popularity,
  5352.         and has become one of the leading cataloging programs available, due
  5353.         largely in part that it does not try be an everything-in-one software
  5354.         package.  The philosophy behind CATDISK has always been and always will
  5355.         be to provide a reliable, simple to use cataloging utility that
  5356.         performs the essential tasks of identifying the location(s) of
  5357.         individual files in a collection of disks.
  5358.  
  5359.         We will be the first to admit that there are many new functions and
  5360.         reports that CATDISK could do and does not due to the above mentioned
  5361.         philosophy.
  5362.  
  5363.         Several enterprising individuals have created companion programs to
  5364.         CATDISK that enhance its functionality.  They are briefly described
  5365.         here, along with the authors' names and addresses.
  5366.  
  5367.         All of these programs may be obtained from our support board, The
  5368.         Shareware Connection.  They are located in file area 1 on the main
  5369.         board.  As a service to the authors of these products, we have made
  5370.         them all available to anyone calling in to the system.  You do NOT need
  5371.         to be registered with us under the support BBS option in order to be
  5372.         able to obtain these programs.  You may also be able to find these
  5373.         programs on your local bulletin board systems as well.
  5374.  
  5375.         If your program is already listed in this section of the user manual,
  5376.         we ask that you keep us up to date on your creation by either uploading
  5377.         it to The Shareware Connection, or by sending it to us on disk at our
  5378.         regular address for registrations.  Many CATDISK users (registered and
  5379.         unregistered) call in to the board and check on the latest offerings,
  5380.         and do in fact download all of the programs listed.  If you have
  5381.         created a new program that is not listed here, please feel free to
  5382.         submit it.  If it's good, we'll "advertise" it for you here and on The
  5383.         Shareware Connection.
  5384.  
  5385.  
  5386.         CATCOMP
  5387.  
  5388.         Catcomp is a handy utility that has the capability of taking a text
  5389.         file such as a BBS listing and comparing its contents with a CATDISK
  5390.         catalog file and generating a listing of what files you have in your
  5391.         catalog that are not listed in the text file.  Catcomp can also tell
  5392.         you what files are listed in the text file that you do not have, as
  5393.         well as tell you what files are duplicated.
  5394.  
  5395.         This utility is extremely handy when you are dealing with a bulletin
  5396.         board system that imposes an upload/download ratio on its members.  On
  5397.         such systems, it is commonplace for users to rename the same file or
  5398.         make a small change to it, and upload the duplicate to the board in
  5399.         order to gain more download capability.  Such practices are not in the
  5400.         best interests of either the bulletin board system or its members.
  5401.  
  5402.         That's where Catcomp comes in very handy.  Its reporting capabilities
  5403.         will allow you to determine what files you have that are legitimately
  5404.         not on that board.  I'm sure that the use of this utility in such
  5405.         circumstances will help you develop a good rapport with the sysop(s) of
  5406.         those boards.
  5407.  
  5408.  
  5409.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5410.  
  5411.                                       Page 81
  5412.  
  5413.  
  5414.  
  5415.         Catcomp is menu-driven and very easy to use.
  5416.  
  5417.          Author:  Wayne A. Davis                       Catcomp is shareware,
  5418.         Address:  17617 N. 9th St., #2076              and a $10 registration
  5419.                   Phoenix, AZ                          fee is requested for the
  5420.                   USA  85022-1943                      program if you find it
  5421.           Phone:  (602) 482-8216                       useful.
  5422.  
  5423.  
  5424.         CAT-STAT
  5425.  
  5426.         Cat-stat is a CATDISK-specific program that has two primary functions.
  5427.         It can scan your catalog file and generate some handy statistics on the
  5428.         data in your catalog file.  Ever wondered just how many megabytes worth
  5429.         of floppies you have in your collection?  This program will tell you
  5430.         that.  Its primary function, though, is to compare two CATDISK catalog
  5431.         files and tell you what files are in catalog file "A" that are not in
  5432.         "B" and vice versa.  It's great to have if you are trading files with a
  5433.         friend.
  5434.  
  5435.         Again, this program is menu-driven and very easy to use.
  5436.  
  5437.         Cat-stat is written by George Wilken and Bill Guy, and a $10 shareware
  5438.         registration fee is requested if you decide to use it.
  5439.  
  5440.         Send registrations to:  George Wilken
  5441.                                 702 Deering Drive
  5442.                                 Akron, OH
  5443.                                 USA  44313
  5444.  
  5445.         Questions or comments may be left for the authors on CompuServe at
  5446.         71450,3172.
  5447.  
  5448.  
  5449.         DISK LABEL SYSTEM (DLS)
  5450.  
  5451.         One of the many requests that I have received for CATDISK to include is
  5452.         a facility to print disk labels.  The main reason that CATDISK does not
  5453.         currently have this capability is mainly due to our philosophy of
  5454.         providing a single-purpose utility that does what it does best.
  5455.  
  5456.         The good news is that this program is capable of producing disk labels
  5457.         directly from your CATDISK catalog file(s).  Additionally, it can read
  5458.         the directory information directly from a diskette if inserted in the
  5459.         floppy drive.  DLS can produce labels for 5.25" and 3.5" diskettes, as
  5460.         well as disk inserts for 5.25" diskettes.
  5461.  
  5462.         DLS is quite powerful, but is very easy to use.
  5463.  
  5464.         Several popular printers are supported.
  5465.  
  5466.         DLS is shareware, and a $15 registration fee is requested if you find
  5467.         the program useful.
  5468.  
  5469.          Author: James A. Clark
  5470.         Address: 2130 Knollshire Road
  5471.                  Cedar Rapids, IA
  5472.                  USA  52402
  5473.  
  5474.  
  5475.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5476.  
  5477.                                       Page 82
  5478.  
  5479.  
  5480.  
  5481.         THE CATDISK UTILITIES (CDU)
  5482.  
  5483.         This collection of handy programs expands on some of the functionality
  5484.         of CATDISK.
  5485.  
  5486.         CDC pads the excess characters in the comment field with spaces (newer
  5487.         versions of CATDISK, including this release do the same), resulting in
  5488.         better compression of the data file when using programs like STACKER or
  5489.         other compression programs.
  5490.  
  5491.         CDR allows a search of the database by up to 50 wildcard specs and
  5492.         allows you to delete those files from your diskettes by prompting you
  5493.         to mount each disk as appropriate.  It will then call on CATDISK to
  5494.         update the catalog file when each disk has been cleaned up.
  5495.  
  5496.         CDF is an enhanced reporting facility.
  5497.  
  5498.         CDM assists in offloading files to floppies.
  5499.  
  5500.         CDS assists in finding files on floppies and copies them to a hard disk
  5501.         subdirectory.
  5502.  
  5503.         These utilities are written by:
  5504.  
  5505.         Robert w. Van Hoeven
  5506.         P.O. Box 131
  5507.         1170 AC Badhoevedorp
  5508.         Nederland / Holland
  5509.  
  5510.         Questions or comments may be left to "Rob van.Hoeven" (note the period
  5511.         in the last name - it must be there) at NetMail address 2:512/100, or
  5512.         better, 2:512/100.5, or in the FidoNet DISP echomail area.
  5513.  
  5514.  
  5515.  
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5542.  
  5543.                                       Page 83
  5544.  
  5545.  
  5546.  
  5547.                                APPENDIX I - CATDISK PLUS
  5548.  
  5549.         Since its initial release in October of 1986, CATDISK has gone through
  5550.         many changes and has received tremendous support from the many
  5551.         corporations and individuals who have sent in their registration fees.
  5552.         CATDISK is currently in use world-wide in more applications than I
  5553.         could have possibly dreamed of.  Judging from this response, I can
  5554.         safely say that the SHAREWARE system is alive and flourishing as a
  5555.         viable means of making quality software available at reasonable cost.
  5556.  
  5557.         Along the way, many individuals have requested features in the program
  5558.         that are not feasible in the current design of CATDISK.  In creating
  5559.         this program, I set out to make the operation as simple and automatic
  5560.         as possible.  Those requests that melded in with the current design
  5561.         have been implemented, and those that will compliment same will be
  5562.         implemented in the future.
  5563.  
  5564.         However, there have been numerous requests for features that would
  5565.         complicate the design of the shareware version of CATDISK - good
  5566.         requests.
  5567.  
  5568.         Therefore, it is with great pleasure that we are announcing the
  5569.         development of a new commercial program, CATDISK PLUS, which will be
  5570.         produced by my software company, The DATAMEN Inc.  See the README.1ST
  5571.         file from your CATDISK package for details on its availability.
  5572.  
  5573.         Please keep in mind that this shareware version will continue to be
  5574.         enhanced and supported - it's still "my baby"!
  5575.  
  5576.         Some of the features include:
  5577.  
  5578.          . A windowed desktop environment with pull down menus for ease of use.
  5579.          . Online context-sensitive help.
  5580.          . Support for the 43 line EGA and the 50 line VGA screen modes.
  5581.          . Full color customization.
  5582.          . All the functional features of the current shareware release.
  5583.          . The ability to selectively catalog files from your disks via three
  5584.            methods, all of which can be used at once:  inclusion filespecs,
  5585.            exclusion filespecs, and a point and shoot list of files read.
  5586.          . A greater variety of reporting features will be available as well
  5587.            as a custom report generator where you can design your own reports.
  5588.          . Comment entries for each disk in the catalog.
  5589.          . Longer file comments.
  5590.          . Greater capacity for catalog size (5000 disks, 65000 files).
  5591.          . A full blown disk manager supporting all the archive file formats
  5592.            that CATDISK currently does.
  5593.          . The ability to print user-defined disk labels and jacket inserts.
  5594.          . Plus many more!
  5595.  
  5596.         One major consideration is that CATDISK PLUS will require a hard disk.
  5597.         Suggested retail price for this product is $69.95 US + $8.00 for
  5598.         shipping and handling.  Dealer inquiries are welcome.
  5599.  
  5600.         Please address all inquiries to:
  5601.  
  5602.               The Datamen                    Phone: (519) 570-3523
  5603.               98 Toynbee Crescent              FAX: (519) 884-4887
  5604.               Kitchener, ONTARIO               BBS: (519) 570-4132
  5605.               Canada   N2N 1R9
  5606.  
  5607.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5608.  
  5609.                                       Page 84
  5610.  
  5611.  
  5612.  
  5613.                          APPENDIX J - OTHER PRODUCTS AVAILABLE
  5614.  
  5615.         For all you avid golfers out there, I have released a golf handicap
  5616.         system, called HANDICAP II, that goes way beyond just calculating a
  5617.         simple golf handicap.
  5618.  
  5619.         Among the many features of this program are:
  5620.  
  5621.           . Pull down menus for ease of use.
  5622.           . On line context sensitive help.
  5623.           . Storage capacity for up to 400 different golf courses.
  5624.           . Storage capacity for up to 128000 rounds of golf (if you exceed
  5625.             this number, I want to meet you!).
  5626.             (score and number of putts on each hole can be logged)
  5627.           . Instant retrieval of past played games, and the ability to browse
  5628.             through them.
  5629.           . An expanded handicap card that is more informative than a standard
  5630.             handicap card.
  5631.           . A report showing your average score on each hole on each course.
  5632.             - good for spotting habitual trouble holes.
  5633.           . A report showing your average putts on each green on each course.
  5634.             - good for spotting habitual troublesome greens.
  5635.           . A report showing how often you hit each green in regulation.
  5636.             - good for analyzing your tee-to-green game on each hole.
  5637.           . Many more statistical reports of interest to you.
  5638.           . Full housekeeping routines to correct mistakes (but I'll bet that
  5639.             you never make any, right?!?)
  5640.  
  5641.           . ALL reports may be viewed on the screen or printed on your
  5642.             printer.
  5643.  
  5644.           . Pop up windows are used extensively, adding to the ease of use of
  5645.             the program.
  5646.  
  5647.         We also have a clubhouse version available with all of the above plus:
  5648.  
  5649.           . A simple date-differential entry system for those who do not wish
  5650.             to have all the detail of the enhanced reports.
  5651.           . Capacity to maintain handicaps for up to 128000 members (you are
  5652.             only limited by disk size).
  5653.           . Full system manager functions available only to authorized users.
  5654.           . A handicap listing (in alphabetical order by member name) of the
  5655.             handicaps of all the members in the system.
  5656.  
  5657.                                   Ordering Information
  5658.  
  5659.         The GOLFERS version of HANDICAP II is available as shareware for $35
  5660.         directly from myself (Rick Hillier), and the CLUB HOUSE version is
  5661.         available for $295.00 (which includes a bound, printed manual) from the
  5662.         address below.
  5663.  
  5664.         They may be ordered from:  The Datamen, Inc.
  5665.                                    98 Toynbee Crescent
  5666.                                    Kitchener, Ontario
  5667.                                    Canada   N2N 1R9
  5668.                            Phone:  (519) 570-3523
  5669.                              FAX:  (519) 884-4887
  5670.                              BBS:  (519) 570-4132
  5671.  
  5672.  
  5673.      Disk Catalog System (CATDISK) V6.37  Copr (C) 1986, 1993 by Rick Hillier
  5674.  
  5675.                                       Page 85
  5676.  
  5677.