home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / CDISK730.ZIP / CATDOCS.EXE / CATDISK.DOC < prev    next >
Text File  |  1994-01-08  |  273KB  |  6,403 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 7.30
  25.  
  26.                                     Jan 8, 1994
  27.  
  28.  
  29.                      Copyright (C) 1986, 1994 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 - CATDISK Program (Standard Version). . . . . . . . .    3
  75.            Features - CATDISK Program (DPMI-Compliant Version)  . . . . .    4
  76.            Features - CATLOOK Utility . . . . . . . . . . . . . . . . . .    4
  77.            Features - CATMGR Utility  . . . . . . . . . . . . . . . . . .    4
  78.            Features - DISKFILL Utility  . . . . . . . . . . . . . . . . .    4
  79.            Features - DUPCLEAN Utility  . . . . . . . . . . . . . . . . .    4
  80.            Licensing And Distribution . . . . . . . . . . . . . . . . . .    5
  81.            ASP . . .  . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  82.  
  83.       2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . . . .    7
  84.            What You Should Have Received  . . . . . . . . . . . . . . . .    7
  85.            System Requirements (Standard Version) . . . . . . . . . . . .    8
  86.            System Requirements (DPMI-compliant Version) . . . . . . . . .    8
  87.            Initial Note On Archive Files  . . . . . . . . . . . . . . . .    8
  88.            Basic Skills: Navigating Report, Entry and File List Screens .    9
  89.            Basic Skills: Entering Keyboard Input  . . . . . . . . . . . .   10
  90.            CATDISK's Enhanced Wildcard Specifications . . . . . . . . . .   11
  91.            Configuring The Programs . . . . . . . . . . . . . . . . . . .   12
  92.              Initial State of CATDISK Settings / Command Line Options . .   15
  93.              Limiting Which Disks DISKFILL Recommends For Backfilling . .   29
  94.              Limiting Which Files Get Cataloged . . . . . . . . . . . . .   30
  95.              Recalling A Previous Configuration . . . . . . . . . . . . .   31
  96.              Color Customization  . . . . . . . . . . . . . . . . . . . .   31
  97.              Saving Your Configuration  . . . . . . . . . . . . . . . . .   32
  98.              Default Settings . . . . . . . . . . . . . . . . . . . . . .   32
  99.              General Considerations When Configuring CATDISK  . . . . . .   32
  100.              Sample Configurations  . . . . . . . . . . . . . . . . . . .   33
  101.            Starting CATDISK . . . . . . . . . . . . . . . . . . . . . . .   35
  102.              If CATDISK/D Cannot Recognize Your Hardware  . . . . . . . .   35
  103.              Saving Parameters So You Don't Have To Type Them Each Time .   36
  104.  
  105.       3. USING CATDISK  . . . . . . . . . . . . . . . . . . . . . . . . .   37
  106.            The Top Screen Status Area . . . . . . . . . . . . . . . . . .   37
  107.            Using The Menus  . . . . . . . . . . . . . . . . . . . . . . .   38
  108.            Selecting A Volume ID From A List  . . . . . . . . . . . . . .   39
  109.            Option 1  - Set Drive For Cataloging . . . . . . . . . . . . .   40
  110.            Option 2  - The Settings & Toggles Screen  . . . . . . . . . .   40
  111.            Option 3  - Labeling A Disk  . . . . . . . . . . . . . . . . .   41
  112.            Option 4  - Cataloging/Re-cataloging A Disk  . . . . . . . . .   42
  113.              Selective Cataloging . . . . . . . . . . . . . . . . . . . .   46
  114.            Option 5  - UnCataloging A Disk  . . . . . . . . . . . . . . .   47
  115.            Option F1 - Add/Edit Summary Comments  . . . . . . . . . . . .   48
  116.            Option 6  - Add/Edit Comments By Volume ID . . . . . . . . . .   49
  117.            Option 7  - Add/Edit Comments By Filespec  . . . . . . . . . .   50
  118.            Option 8  - Add/Edit Comments By Comment . . . . . . . . . . .   50
  119.            Option 9  - Import Comments From A Text File . . . . . . . . .   51
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.     
  128.  
  129.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  130.  
  131.                                       Page 1
  132.  
  133.  
  134.  
  135.        Option 0 - Reports And Inquiries Menu  . . . . . . . . . . . . . .   54
  136.                Screen Based Reports . . . . . . . . . . . . . . . . . . .   54
  137.                Printer Based Reports  . . . . . . . . . . . . . . . . . .   55
  138.                Disk Based Reports . . . . . . . . . . . . . . . . . . . .   55
  139.                 1  - Show Disk Summary  . . . . . . . . . . . . . . . . .   56
  140.                 2  - Files For A Volume   . . . . . . . . . . . . . . . .   57
  141.                 3  - Files For An Archive . . . . . . . . . . . . . . . .   57
  142.                 4  - Files By Filespec  . . . . . . . . . . . . . . . . .   57
  143.                 5  - Files By Subdirectory  . . . . . . . . . . . . . . .   58
  144.                F1  - Files By Comment Text  . . . . . . . . . . . . . . .   59
  145.                F3  - Files By Comment Keywords  . . . . . . . . . . . . .   60
  146.                 6  - Files By Comment/Filename Text . . . . . . . . . . .   61
  147.                 7  - Unique Files Only  . . . . . . . . . . . . . . . . .   61
  148.                 8  - Duplicate Files Only . . . . . . . . . . . . . . . .   61
  149.                 9  - Volume Summary/Contents  . . . . . . . . . . . . . .   62
  150.                 0  - Sorted Full File Listings  . . . . . . . . . . . . .   62
  151.                Esc - Return To Main Menu  . . . . . . . . . . . . . . . .   62
  152.                F2  - Custom Reports . . . . . . . . . . . . . . . . . . .   63
  153.              Option <F4> - Temporary Exit To DOS  . . . . . . . . . . . .   67
  154.              Option <drive_letter> - Show Disk Directory  . . . . . . . .   68
  155.              Option ESC - Exit To DOS . . . . . . . . . . . . . . . . . .   68
  156.  
  157.         Appendix A - Archive Support  . . . . . . . . . . . . . . . . . .   69
  158.         Appendix B - CATLOOK Command Line Lookup Utility  . . . . . . . .   70
  159.         Appendix C - CATMGR - CATDISK Catalog Manager . . . . . . . . . .   71
  160.         Appendix D - DISKFILL - CATDISK's Optimal Disk Fill Utility . . .   75
  161.         Appendix E - DUPCLEAN: CATDISK'S File Cleanup Utility . . . . . .   84
  162.         Appendix F - Registration, Support And Updates  . . . . . . . . .   88
  163.         Appendix G - Questions And Answers  . . . . . . . . . . . . . . .   90
  164.         Appendix H - CATDISK Companion Programs . . . . . . . . . . . . .   93
  165.         Appendix I - Other Products Available . . . . . . . . . . . . . .   96
  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) V7.30  Copr (C) 1986-1994 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.         DEDICATION
  204.  
  205.         This program is dedicated to the memory of my Grandfather, Earl Hillier
  206.         (Jan 1, 1909 - May 2, 1989).
  207.  
  208.         OVERVIEW
  209.  
  210.         Overheard:  "I know I have that file in an archive on a disk SOMEWHERE!
  211.                     If only I could FIND it!"
  212.  
  213.         Sound familiar?  Many people I know are in this predicament.
  214.  
  215.         Enter CATDISK, the disk cataloging system.  CATDISK can help you
  216.         organize your disks in such a way that it is easy to find a file from
  217.         within a large collection by creating a collective directory of all the
  218.         files contained in your collection.  See the FEATURES section below for
  219.         a listing of CATDISK's capabilities.
  220.  
  221.         MAJOR FEATURES - CATDISK PROGRAM (STANDARD VERSION)
  222.  
  223.         - Completely menu-driven and very easy to use.
  224.         - Configuration utility allows customization of the main features.
  225.         - All screen colors may be customized to your liking.
  226.         - Cataloging/Uncataloging/Re-cataloging functions are fully automated.
  227.         - Interactive cataloging allows full control over what gets cataloged.
  228.         - CATDISK can suggest sequential volume labels for you to use.
  229.         - You can catalog a disk under an alias instead of the volume label.
  230.         - Supports up to 65,534 files or 4,000 disks per catalog, which can be
  231.           reduced through the config program to better optimize memory usage.
  232.         - depending on available memory, CATDISK can read in up to 6000 files
  233.           per disk being cataloged.
  234.         - Supports up to 512 sub-directories per disk being cataloged.
  235.         - Supports multiple catalog files.
  236.         - Can read the directory contents of all popular archive file formats.
  237.         - You can attach a 43 character comment to each file in the catalog,
  238.           which can be done either while cataloging a disk, or at a later time.
  239.         - You can attach a 40 character comment to each disk in the catalog,
  240.           which can be done either while cataloging it, or at a later time.
  241.         - Can import comments from an ASCII text file, such as a BBS listing.
  242.         - Can read comments from ZIP, ZOO and DWC files.
  243.         - Can extract resolution/color information from GIF (Graphics
  244.           Interchange Format) files and include it as the default comment.
  245.         - Can read 4DOS/NDOS directory comments and add them to your catalog.
  246.         - Can extract and read comments from FILE_ID.DIZ and DESC.SDI files.
  247.         - Summary report shows disk capacity, space used and space free on
  248.           each disk in the catalog to aid in optimization of disk usage.
  249.         - Full range of file reports, including custom reports for full
  250.           flexibility.
  251.         - Reports can be sent to screen, printer, or disk file.
  252.         - Printer reports can be printed in a two-sided format to conserve
  253.           paper (this is, quite possibly, the first environmentally friendly
  254.           software product in terms of built-in reporting facilities).
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  262.  
  263.                                       Page 3
  264.  
  265.  
  266.  
  267.         FEATURES (DPMI-COMPLIANT VERSION)
  268.  
  269.         - operates in exactly the same manner as the standard version of
  270.           CATDISK.
  271.         - Increased support to 999,363 files or 4,000 disks per catalog.
  272.         - can read up to 65500 files per disk being cataloged.
  273.         - supports up to 2048 sub-directories per disk being cataloged.
  274.  
  275.  
  276.         FEATURES - "CATLOOK" UTILITY
  277.  
  278.         - small size allows it to be used when available memory is restricted.
  279.         - command line parameters allow any of CATDISK's reports to be created.
  280.         - output may be re-directed to a file or printer.
  281.         - can handle the upper limitations addressed by the DPMI-compliant
  282.           version of CATDISK.
  283.  
  284.         FEATURES - "CATMGR" UTILITY
  285.  
  286.         - can be used to split/merge complete or partial catalog files.
  287.         - menu driven for ease of use.
  288.         - point and shoot selection of individual cataloged volumes to move,
  289.           copy or delete
  290.         - can handle the upper limitations addressed by the DPMI-compliant
  291.           version of CATDISK.
  292.  
  293.         FEATURES - "DISKFILL" UTILITY
  294.  
  295.         - CATDISK's Optimal Disk Fill Utility automates offloading of files to
  296.           floppies using point and shoot file selection, and uses a "best-fit"
  297.           arrangement to minimize wasted disk space.  As disks are filled with
  298.           files, those disks can be cataloged as you go.  This program can also
  299.           recommend disks to use that have already been cataloged for
  300.           "backfilling" of free space.
  301.  
  302.         - DISKFILL fully supports 4DOS/NDOS file descriptions.
  303.  
  304.         - can handle the upper limitations addressed by the DPMI-compliant
  305.           version of CATDISK.
  306.  
  307.  
  308.         FEATURES - "DUPCLEAN" UTILITY
  309.  
  310.         - automates elimination of duplicate or redundant files through a point
  311.           & shoot file selection and through a flexible selection criteria
  312.           based on your disk catalog as maintained by CATDISK.
  313.  
  314.         - can handle the upper limitations addressed by the DPMI-compliant
  315.           version of CATDISK.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 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 $29.  This will entitle you to continue to
  343.         use your copy of CATDISK beyond a reasonable trial period as well as
  344.         entitle you to program support.  With registration, we will give you a
  345.         simple procedure to follow, which will eliminate the shareware
  346.         introductory screen and the random keypress which accompanies it.
  347.  
  348.         The registration form, which should be included in the distribution
  349.         package that you received outlines the procedures for registering your
  350.         copy of the program.  Should you decide that you would like the latest
  351.         release on disk from us or would like to be able to obtain new releases
  352.         from our support BBS, The Shareware Connection, details on pricing may
  353.         be found on the registration form or in the appendix dealing with
  354.         support and upgrades that occurs later on in this user manual.
  355.  
  356.         Please keep in mind that we must have a registration form on file for
  357.         you before we can offer product support.
  358.  
  359.         Operators of electronic bulletin boards (Sysops) are encouraged to post
  360.         CATDISK for downloading by their users.
  361.  
  362.         CATDISK may be uploaded to and downloaded from commercial systems such
  363.         as CompuServe, the Source, and BIX, so long as the only charge paid by
  364.         the subscriber is for on-line time and there is no charge for the
  365.         program.  Those copying, sharing, and/or electronically transmitting
  366.         the program are required not to delete or modify the copyright notice
  367.         and restrictive notices from the program or documentation; anyone doing
  368.         so will be treated as a contributory copyright violator.
  369.  
  370.         If you are passing this program on to others, uploading it to a
  371.         bulletin board system, or including it in a users group library, do not
  372.         separate the files contained in the distribution archive - pass the
  373.         entire archive on to the intended party.  This ensures that those who
  374.         receive the program will have all the correct configuration utilities
  375.         and documentation necessary to get CATDISK up and running quickly.  A
  376.         listing of what files you should have and the purpose of each is listed
  377.         later in this manual.
  378.  
  379.         The CATDISK documentation may not be modified by users. The program may
  380.         not be separated from the documentation when distributed.  Printed or
  381.         Photocopies ("Xeroxed") copies of the CATDISK documentation (i.e., this
  382.         manual) may not be distributed or sold without the written permission
  383.         of the author.
  384.  
  385.         No other person other than the author, Rick Hillier, may accept payment
  386.         or royalties for this program.
  387.  
  388.         This license to use CATDISK does NOT include the right to distribute or
  389.         sell CATDISK.  Distribution terms are detailed in the file VENDOR.DOC
  390.         which is included with this package.
  391.  
  392.  
  393.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 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) V7.30  Copr (C) 1986-1994 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 LHA archive
  470.         containing five files as follows:
  471.  
  472.         README.1ST   - Urgent program notes - IMPORTANT -- READ THIS FILE!
  473.         WHAT'S.NEW   - Changes made to CATDISK since the last release.
  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.            CDISKCFG.EXE - The CATDISK configuration program.
  480.            CDISKCVT.EXE - Conversion utility for converting old CATDISK files
  481.                           to the newest format - See README.1ST before running.
  482.  
  483.         CATUTILS.EXE - A self-extracting archive containing the following
  484.                        CATDISK utility programs:
  485.  
  486.            CATLOOK.EXE  - The CATDISK command line utility (lookup program).
  487.            CATMGR.EXE   - The CATDISK catalog file manager (split/merge/delete/
  488.                           copy utility).
  489.            DISKFILL.EXE - Optimal disk fill utility with MANY handy features.
  490.            DUPCLEAN.EXE - Duplicate file cleanup utility.
  491.  
  492.         CATDOCS.EXE  - A self-extracting archive containing the CATDISK
  493.                        documentation files as follows:
  494.  
  495.            PRINTDOC.EXE - A utility program to print the various CATDISK
  496.                           documentation files.  See README.1ST for details.
  497.            CATDISK.DOC  - The manual you are now reading.
  498.            CATDISK.HST  - Revision history for CATDISK since its initial
  499.                           release in October 1986.
  500.            REGISTER.FRM - The registration form for this product.
  501.            SITE.LIC     - The site license registration form for this product.
  502.            VENDOR.DOC   - Vendor distribution agreement form.
  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.         We also distribute a DPMI-compliant version of the CATDISK program
  508.         itself (we'll call it CATDISK/D), supporting higher capacities than the
  509.         standard version of CATDISK.  The naming convention for version 7.30,
  510.         for example, would be either CDSK730D.EXE or CD730D.EXE, depending on
  511.         the location from which you download CATDISK. The archive is unpacked
  512.         in the same manner as above.  The four files listed below should be
  513.         copied to the same directory as the other CATDISK program files.
  514.  
  515.         This archive will contain:
  516.  
  517.           CATDISKD.EXE - the DPMI-compliant version of the CATDISK program.
  518.           RTM.EXE      - the Borland International DPMI Run-Time Manager.
  519.           DPMI16BI.OVL - The Borland International DPMI Overlay File.
  520.           DPMIINST.EXE - Configures RTM.EXE to your system specifications.
  521.  
  522.  
  523.  
  524.  
  525.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  526.  
  527.                                       Page 7
  528.  
  529.  
  530.  
  531.         SYSTEM REQUIREMENTS (STANDARD VERSION)
  532.  
  533.         . True IBM-compatible computer with an 8088 processor or above.
  534.         . DOS v2.00 or above.
  535.         . At least one floppy disk drive (Hard Drive Highly Recommended).
  536.         . 320K RAM - if more is available, CATDISK will have greater internal
  537.                      capacity for reading new files off of the disks being
  538.                      cataloged and will run more efficiently.
  539.  
  540.         SYSTEM REQUIREMENTS (CATDISK/D - DPMI-COMPLIANT VERSION)
  541.  
  542.         . True IBM-compatible computer with an 80286 processor or above.
  543.         . DOS v3.00 or above.
  544.         . Hard disk with sufficient capacity to hold your data.
  545.         . 640K Base Memory and 512K Extended Memory or higher (more is better!)
  546.  
  547.  
  548.         INITIAL NOTE ON ARCHIVE FILES
  549.  
  550.         At various points in this user manual, references to ARCHIVE files are
  551.         made.  This is a collective term describing a file that actually
  552.         contains more than one file.  The contained files may or may not be
  553.         compressed.  Currently, this refers to ARC, ARJ, DWC, HYP, LBR, LZH,
  554.         LZS, PAK, SQZ, ZIP and ZOO files.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  592.  
  593.                                       Page 8
  594.  
  595.  
  596.  
  597.         BASIC SKILLS: NAVIGATING REPORT, ENTRY AND FILE LIST SCREENS
  598.  
  599.         In the various programs and utilities that make up the CATDISK family
  600.         of programs, many screens require you to move a highlight bar up and
  601.         down the screen, or move up and down through a report.  Here are the
  602.         various keyboard commands that will allow you to navigate these
  603.         screens.
  604.  
  605.         <Up Arrow>   - moves the highlight bar up one line.  In a report, this
  606.                        key will move the report up one line.
  607.  
  608.         <Down Arrow> - moves the highlight bar down one line.  In a report,
  609.                        this key will move the report down one line.
  610.  
  611.         <PgUp>       - moves the current position up one screenful, which can
  612.                        vary according to what section of what program you are
  613.                        currently using.
  614.  
  615.         <PgDn>       - moves the current position down one screenful.
  616.  
  617.         <Home>       - moves to the top of the list.
  618.  
  619.         <End>        - moves to the bottom (or end) of the list.
  620.  
  621.  
  622.         Some of these screens in CATDISK itself have a scroll bar on them for
  623.         quick navigation.  The positioning of the scroll bar indicates your
  624.         relative position in the list as a whole.  This tool is meant to
  625.         facilitate an approximate placement in a report.  Here are the keys
  626.         that move you around the scroll bar:
  627.  
  628.         <+> - pressing the grey "plus" key will advance the scroll bar position
  629.               one space.  If already at the bottom, you will be placed at the
  630.               top of the scroll bar.  You will then be positioned in the list
  631.               at a place relative to the position of the marker on the scroll
  632.               bar.
  633.  
  634.         <-> - similar to plus, the grey "minus" key will move you in the
  635.               opposite direction.
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  658.  
  659.                                       Page 9
  660.  
  661.  
  662.  
  663.         BASIC SKILLS: ENTERING KEYBOARD INPUT
  664.  
  665.         When entering keyboard input into CATDISK, you will find two possible
  666.         scenarios.  In some cases, CATDISK will require a single keystroke,
  667.         such as when selecting an item from a menu, a response to a YES or NO
  668.         prompt or something like that.  In the latter case, you will see a
  669.         prompt containing the possible responses enclosed in angle brackets
  670.         with each valid keystroke separated by a slash.
  671.  
  672.        - eg.   Are You Sure? <Y/N>
  673.  
  674.        In the above example, you would hit "Y" for YES or "N" for NO.  You do
  675.        not need to hit <Enter> after the response.
  676.  
  677.        In many other cases, multiple keystrokes are required.  In such a
  678.        scenario, you will see the screen cursor activated and positioned at the
  679.        leftmost position of the input area.  Simply type in the appropriate
  680.        input and press the <Enter> key.
  681.  
  682.        Here are all of the keystrokes available to enhance your ability to
  683.        enter/edit the input:
  684.  
  685.        <LeftArrow>    - Move the cursor left one character if possible.
  686.        <RightArrow>   - Move the cursor right one character if possible.
  687.        <Ctrl>-<Left>  - Move the cursor left one word if possible.
  688.        <Ctrl>-<Right> - Move the cursor right one word if possible.
  689.        <Home>         - Move the cursor to the leftmost position of the input
  690.                         area.
  691.        <End>          - Move the cursor to the end of the entered input.
  692.        <BackSpace>    - Delete the character to the left of the cursor, move
  693.                         all characters to the right of that character one space
  694.                         to the left and then move the cursor left one character
  695.                         if possible.
  696.        <Del>          - Delete the character under the cursor and move all
  697.                         characters to the right of that character one space to
  698.                         the left.  The cursor does NOT move.
  699.        <Ins>          - Toggles "Insert" mode on and off.  When "Insert" mode
  700.                         is on, the cursor will appear thicker than normal.  Any
  701.                         characters typed will be "inserted" before the
  702.                         character at the cursor position and all characters at
  703.                         and to the right of the cursor position will be shifted
  704.                         one character to the right.  When "Insert" mode is off,
  705.                         the cursor will as a normal underscore.  Any characters
  706.                         entered will overwrite those already present.
  707.        <Enter>        - Enter the data in the input area into CATDISK.
  708.        <Esc>          - Restore the data that was previously in the input area
  709.                         and indicate to CATDISK that the <Esc> key was pressed.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  724.  
  725.                                       Page 10
  726.  
  727.  
  728.  
  729.         CATDISK'S ENHANCED WILDCARD SPECIFICATIONS
  730.  
  731.         When specifying groups of files, DOS has standardized a method of
  732.         "describing" a group of files by using wildcards.
  733.  
  734.         Examples:
  735.  
  736.                *.*        - search for everything
  737.                *          - same as *.*
  738.                *.         - search for files with no extension
  739.         CATDISK*.*        - search for files starting with CATDISK and having
  740.                             any file extension
  741.         CATDISK*          - same as CATDISK*.*
  742.         CATDISK*.         - search for files starting with CATDISK and having
  743.                             no file extension
  744.                *.COM      - search for files ending in .COM
  745.               A*.EXE      - search for files starting with A and ending in .EXE
  746.          CATDISK.EXE      - search specifically for CATDISK.EXE
  747.                *.?Q?      - search for files with an extension containing Q as
  748.                             its second character
  749.               ??.DOC      - search for files with two letters as it filename
  750.                             and .DOC as its extension
  751.  
  752.         Please refer to the DOS manual for further information on file
  753.         searching patterns.
  754.  
  755.         CATDISK, in addition to supporting the DOS standard pattern matching
  756.         conventions, enhances these capabilities for greater flexibility.  The
  757.         following examples will illustrate these new capabilities.
  758.  
  759.             *D.*   - match any filename whose name ends in "D" and has any
  760.                      extension.
  761.           C?T*.EXE - match any filename whose name has a "C" in the first
  762.                      position, any character in the second position, a "T" in
  763.                      the third position, and has an extension of ".EXE".
  764.              *.*M  - match any file with any extension that ends in "M".
  765.            C*K.*   - match any file with any extension whose name starts with
  766.                      "C" and ends with "K".
  767.          *DISK*.*  - match any file whose name contains the characters "DISK".
  768.  
  769.         Note that in the last example, the presence of a leading and trailing
  770.         asterisk will cause CATDISK to search for the characters enclosed
  771.         between them as they appear literally.  Wildcard characters must not
  772.         appear between these delimiters, as they cannot exist in a valid DOS
  773.         filename and therefore will not be matched.  For example," *DI?K*.*"
  774.         will cause CATDISK to search for "DI?K" in the filename.  The question
  775.         mark is not a valid character in a DOS filename, therefore no matches
  776.         will be found.
  777.  
  778.         Although this is a slight departure from the DOS standard for file
  779.         pattern matching, you will probably find that these extensions add a
  780.         little more flexibility and power to CATDISK's reporting capabilities.
  781.  
  782.         These wildcard conventions may also be applied to a search for an
  783.         archive name or a volume label at any applicable prompt.  The main
  784.         difference between the above examples and the archive or volume names
  785.         is that there is no extension part to the latter.  If you treat the
  786.         volume as an 11 character filename with no extension and the archive
  787.         name likewise with 8 characters, you'll get the idea.
  788.  
  789.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  790.  
  791.                                       Page 11
  792.  
  793.  
  794.  
  795.         CONFIGURING THE PROGRAMS
  796.  
  797.         Many features of CATDISK may be permanently set from the configuration
  798.         program, CDISKCFG.EXE.  When you start this program, please make sure
  799.         that the correct versions of the program files CATDISK.EXE,
  800.         CATLOOK.EXE, CATMGR.EXE and DISKFILL.EXE are in the current drive and
  801.         directory, otherwise you will get an error message.
  802.  
  803.         There are several utilities available that allow you to compress an
  804.         executable file such that it remains executable, but takes up less room
  805.         on your disk.  Examples of such programs are PKLITE and LZEXE.  If you
  806.         use such programs on any of the CATDISK program files, CDISKCFG will
  807.         not be able to find the configuration information in those two files.
  808.         Once you've configured CATDISK and its companion programs to your
  809.         liking, it's okay to compress them after making copies of the
  810.         originals.
  811.  
  812.         Upon startup, the configuration program will read the current settings
  813.         defined in "CATDISK.EXE", after which, the configuration screen will be
  814.         presented.  You may change any given item on this screen by using the
  815.         <Cursor UP> and <Cursor DOWN> keys to highlight the title of the
  816.         desired field.  The bottom portion of the screen will contain any
  817.         additional information as well as any instructions on how to change the
  818.         selected item.
  819.  
  820.         A discussion of the 9 items on this list follows:
  821.  
  822.          1) SCREEN UPDATE METHOD
  823.  
  824.             BIOS   - this method of writing to the screen uses the built-in
  825.                      procedures in your computer.  This method is slow, but
  826.                      maintains compatibility with windowing or multi-tasking
  827.                      operating environments such as Desqview or Windows.
  828.  
  829.             DIRECT - CATDISK will update the screen directly using its built-in
  830.                      methods, which are much faster than using the BIOS
  831.                      setting.  If you choose this setting, and you have a
  832.                      graphics display, a second test will be made to determine
  833.                      if you have an older CGA graphics card which has a side
  834.                      effect where you will see static (or "snow") during screen
  835.                      updates.  If you see this "snow" during the test, answer
  836.                      yes after the test is complete and CATDISK will take steps
  837.                      to prevent it (screen updates will be slightly slower, but
  838.                      still better than using the BIOS setting).
  839.  
  840.          2) COLOR OR B & W
  841.  
  842.             This option is self-explanatory.  The appearance of the setup
  843.             screen will depend on the setting of this field.
  844.  
  845.          3) NUMBER OF REPORT LINES PER PAGE
  846.  
  847.             This setting will enable you to tell CATDISK the number of lines of
  848.             output that it should place on each page of printer or disk output,
  849.             including titles and headings, which always occupy 4 lines.  This
  850.             may be either ZERO or any number between 5 and 255.  Entering zero
  851.             will disable page breaking and the output will be presented in a
  852.             continuous stream with one title at the top.
  853.  
  854.  
  855.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  856.  
  857.                                       Page 12
  858.  
  859.  
  860.  
  861.          4) PRINTER STARTUP STRING
  862.  
  863.             The printer start up string is a series of ASCII codes (entered
  864.             here as their ASCII VALUES) that will tailor your reports to the
  865.             format you desire.  For example, for an Epson printer, a good
  866.             setting is 1/8" spacing to get 80 report lines per page.  To do
  867.             this, send a startup string of "<Esc> <0>" to set this print mode.
  868.             To enter this string in the configuration program, you would enter
  869.             it as "027 048" without the quotes.  The numbers are simply the
  870.             ASCII values of the characters you wish to send.  If you have a
  871.             setup string entered here and wish to clear it, simply hit <Return>
  872.             in response to the prompt in the bottom area of the screen.
  873.  
  874.          5) PRINTER FINISHING STRING
  875.  
  876.             The printer finishing string is commonly used to reverse the
  877.             startup string entered above and is entered in exactly the same
  878.             way.  In the example above, I would use "<Esc> <2>", which would be
  879.             entered as "027 050" without the quotes.  If you have a setup
  880.             string entered here and wish to clear it, simple hit <Return> in
  881.             response to the prompt in the bottom area of the screen.
  882.  
  883.          6) DEFAULT ARCHIVE EXTRACT STATE
  884.  
  885.             This will control the way CATDISK handles any ARCHIVE files that
  886.             it might encounter when cataloging your disks as well as whether
  887.             or not files contained within archives will be included in a
  888.             report.
  889.  
  890.             If you set it to OFF, CATDISK will NOT extract any archive files
  891.             that it finds on your disks or include files in the catalog
  892.             contained within archives in any of your reports.
  893.  
  894.             If you set it to ON, CATDISK will expand EVERY ARCHIVE file that it
  895.             finds on your disks.  Any files already cataloged that are
  896.             contained within archive files will be included in any reports.
  897.  
  898.             If you set it to QUERY, CATDISK will ask you for permission to
  899.             expand an ARCHIVE file each time it encounters one.  Any files
  900.             already cataloged that are contained within archive files will be
  901.             included in any reports.
  902.  
  903.             This can be changed temporarily while running CATDISK.
  904.  
  905.  
  906.           7) DEFAULT CATALOG DRIVE
  907.  
  908.             The default catalog drive is the drive that CATDISK will assume you
  909.             wish to use for labeling disks and reading them for cataloging
  910.             purposes.  This drive may still be changed at startup time (see
  911.             STARTING CATDISK), or from the menu when CATDISK is running.
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  922.  
  923.                                       Page 13
  924.  
  925.  
  926.  
  927.          8) CATALOG FILE DIRECTORY
  928.  
  929.             The catalog file directory is the location in your system that
  930.             CATDISK will look for and create its catalog files.  This path may
  931.             contain a drive designator, so that the catalog files may reside on
  932.             a different drive than CATDISK itself, such as a ramdisk (in this
  933.             case don't forget to copy the files to a real disk before you turn
  934.             off or reboot your machine).
  935.  
  936.             If this field is blank, the default drive and directory will be
  937.             used.
  938.  
  939.          9) DISKS/FILES PER CATALOG
  940.  
  941.             The maximum number of disks and files per catalog is simply that.
  942.             When CATDISK starts, it allocates its work space according to this
  943.             setting.  The higher the setting, the more memory will be used,
  944.             making less memory available for tasks such as reading in file
  945.             entries from a disk being cataloged and sorting operations.
  946.  
  947.             The current limitations for CATDISK are 4000 disks or 65534 files
  948.             per catalog, whichever comes first.  CATDISK/D can handle 999363
  949.             files per catalog.
  950.  
  951.             You can change these settings by either typing in the desired
  952.             numbers directly or use the cursor keypad to change the settings as
  953.             per the instructions that will show on your screen.  The direction
  954.             of the arrow (either before or after the slash between the two
  955.             settings) will indicate which setting you are affecting when you
  956.             use the cursor keypad.
  957.  
  958.  
  959.     
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  988.  
  989.                                       Page 14
  990.  
  991.  
  992.  
  993.         INITIAL STATE OF CATDISK SETTINGS / COMMAND LINE OPTIONS
  994.  
  995.         There are a number of options available that customize the way that
  996.         CATDISK and DISKFILL perform their respective functions.  Many of the
  997.         options that pertain to CATDISK itself can be set through the Settings
  998.         & Toggles menu (discussed later in this manual).
  999.  
  1000.         All of these settings have defaults, which can be overridden in this
  1001.         section of the configuration utility or by command line options.  We
  1002.         will discuss the command line options pertinent to CATDISK in this
  1003.         section as well, as they go hand in hand with what will be discussed
  1004.         here.
  1005.  
  1006.         Although there are several settings that apply to the DISKFILL utility
  1007.         here, the command line options for DISKFILL will be discussed in the
  1008.         appendix of this manual that deals with that program as well as this
  1009.         section.
  1010.  
  1011.         To bring up the settings screen, hit <F4> from the main screen of the
  1012.         CDISKCFG utility.  You will then see a screen that contains various
  1013.         settings, all (with the exception of the first item) of which contain a
  1014.         setting heading and two or more sets of square brackets followed by
  1015.         text indicating each item for each setting.  One of the sets of square
  1016.         brackets will contain a small block indicating that that particular
  1017.         option is turned on.
  1018.  
  1019.         To select a setting, use the <Up Arrow> and <Down Arrow> keys.  To
  1020.         change a setting, use the <Left Arrow> and <Right Arrow> keys. The
  1021.         exception to this is the first setting, the starting catalog file,
  1022.         which will be discussed with that setting a little later.
  1023.  
  1024.         When you have all settings the way you want them, hit <Esc> to return
  1025.         to the main options screen.
  1026.  
  1027.         SETTINGS
  1028.  
  1029.          1) Starting Catalog
  1030.  
  1031.             CATDISK keeps its catalogs in a system of two files and ties them
  1032.             together by using a common base catalog name followed by an
  1033.             extension of .SUM for the disk summary info or an extension of .DTA
  1034.             for the catalog data itself.  By default, the name "CATDISK" will
  1035.             be used at program startup.  Even though you can change the active
  1036.             catalog file at any time, it can be desirable to have CATDISK use a
  1037.             different catalog set right off the bat.  By placing the name of
  1038.             the catalog set that you wish to use when CATDISK is started, you
  1039.             can override the default name of CATDISK.  If the catalog name that
  1040.             you specify does not exist, a new, empty set will be created.
  1041.  
  1042.             Note: Only enter the base name for the catalog.  Do not add .DTA or
  1043.             .SUM to the name, as CATDISK will do this for you automatically.
  1044.  
  1045.             If you use a single question mark "?" for the catalog name, CATDISK
  1046.             will bring up a point and shoot list of available catalogs for you
  1047.             to use.  If you hit <Esc> from this list, CATDISK will exit to DOS.
  1048.  
  1049.             This option also applies to DISKFILL with the exception that making
  1050.             the catalog name "?" will cause DISKFILL to ignore it.
  1051.  
  1052.  
  1053.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1054.  
  1055.                                       Page 15
  1056.  
  1057.  
  1058.  
  1059.             The same thing applies to DUPCLEAN.
  1060.  
  1061.             Change this setting by typing in the name of the catalog set that
  1062.             you wish to use.
  1063.  
  1064.             Command line parameter:  /Fcatalogname  (CATDISK and DISKFILL)
  1065.  
  1066.               Note that there is no space between the /F and the filename.
  1067.               Using this at startup will override the setting made in the
  1068.               CDISKCFG program.  /F? will activate the point and shoot list
  1069.               described above.
  1070.  
  1071.          2) Report Location
  1072.  
  1073.             Setting  Description                                    Parameter
  1074.  
  1075.             Scrn     Sends report output to the screen.                /R1
  1076.             LPT1     Sends report output to parallel printer #1.       /R2
  1077.             LPT2     Sends report output to parallel printer #2.       /R3
  1078.             DISK     Sends report output to a disk file that you       /R4
  1079.                      specify at the time that the report is created.
  1080.             ASK ME   CATDISK will prompt you for a report              /R5
  1081.                      destination before the report is created.
  1082.  
  1083.          3) Catalog Report Format
  1084.  
  1085.             Controls the screen-based report format for the catalog entries.
  1086.  
  1087.             Setting           Items Included In Report                Parameter
  1088.  
  1089.             Stat              Filename, Volume ID, Archive ID, size,     /L0
  1090.                               date, time and file attributes.
  1091.  
  1092.             Sdir              Subdirectory,Filename, Volume ID, Archive  /L1
  1093.                               ID, size, date and time.
  1094.  
  1095.             File Cmts         Filename, Volume ID, Archive ID and full   /L2
  1096.                               file comment (all 43 characters).
  1097.  
  1098.             Sdir + File Cmts  Subdirectory, Filename, Volume ID,         /L3
  1099.                               Archive ID and short file comment (first
  1100.                               30 characters).
  1101.  
  1102.          4) Summary Report Format
  1103.  
  1104.             Controls the screen-based report format for the disk summary.
  1105.  
  1106.             Setting        Items Included In Report                   Parameter
  1107.  
  1108.             Statistics     Disk volume, disk capacity, number of        /SL0
  1109.                            files on the disk, space used, free
  1110.                            space, slack % and date last cataloged.
  1111.  
  1112.             Comments       Disk volume, disk capacity, free space       /SL1
  1113.                            and disk comment.
  1114.  
  1115.         
  1116.  
  1117.  
  1118.  
  1119.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1120.  
  1121.                                       Page 16
  1122.  
  1123.  
  1124.  
  1125.          5) Printed Report Format
  1126.  
  1127.             Controls the printer and disk-based formats for all reports.
  1128.  
  1129.             Setting     Items Included In Report                      Parameter
  1130.  
  1131.             Stat        Subdirectory, Filename, Volume ID, Archive,      /P0
  1132.                         File Size, File Date, File Time, and File
  1133.                         Attribute in the file reports; All summary
  1134.                         information EXCEPT comments in summary report.
  1135.  
  1136.             Cmts        Filename, Volume ID, Archive And Full Comment    /P1
  1137.                         (43 chars) in the file reports; Volume ID,
  1138.                         Disk Capacity, Free Space and Comment in the
  1139.                         summary report.
  1140.  
  1141.             Sdirs+Cmts  Subdirectory, Filename, Volume ID, Archive and   /P2
  1142.                         truncated file comment (30 characters) in file
  1143.                         reports; Volume ID, Disk Capacity, Free Space
  1144.                         and Comment in the summary report.
  1145.  
  1146.             All Info    All information (Subdirectory, Filename, Volume  /P3
  1147.                         ID, Archive, File Size, File Date, File Time,
  1148.                         File Attribute and Comment in file reports;
  1149.                         All details in the summary report.  It is
  1150.                         assumed that your printer is set up to product 132
  1151.                         column reports (possibly set up via the printer
  1152.                         starting string that can be set on the main
  1153.                         configuration screen).
  1154.  
  1155.          6) Two Sided Reports
  1156.  
  1157.             Off - CATDISK paginates printed reports continuously with pages in
  1158.                   sequential order.
  1159.  
  1160.             On  - CATDISK produces odd numbered pages of a printed report
  1161.                   first, then pauses to allow you to remove the paper and
  1162.                   re-insert it back in the printer such that the even numbered
  1163.                   pages will be printed on the back of the previously printed
  1164.                   odd pages, thus conserving paper.
  1165.  
  1166.             Command line parameter:  /2
  1167.  
  1168.               By default, this feature is turned off.  Adding /2 to the command
  1169.               line will force it on.
  1170.  
  1171.          7) Report Totals
  1172.  
  1173.             Off - CATDISK will not show any report totals at the bottom of
  1174.                   screen, printer and disk-based reports.
  1175.  
  1176.             On  - CATDISK will add up columns such as total files, bytes, free
  1177.                   space, etc. and report those totals at the end of a report or
  1178.                   at the bottom of a screen-based report.
  1179.  
  1180.             Command line parameter:  /NT
  1181.  
  1182.               By default, the report totals are turned on.  Adding /NT on the
  1183.               command line will turn it off.
  1184.  
  1185.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1186.  
  1187.                                       Page 17
  1188.  
  1189.  
  1190.  
  1191.          8) Archive Extract Setting (In Reports)
  1192.  
  1193.             Affects Reports -   The Archive Extract setting (changeable from
  1194.                                 the main configuration screen or from CATDISK's
  1195.                                 Settings & Toggles menu) will affect whether or
  1196.                                 not files contained inside archive files in
  1197.                                 your catalog will be included in a report.  If
  1198.                                 set to OFF, they will not be included; setting
  1199.                                 it to ON or QUERY will cause CATDISK to include
  1200.                                 them.
  1201.  
  1202.             Ignore In Reports - ALL Files will be included in a report
  1203.                                 regardless of the Archive Extract setting.
  1204.  
  1205.             Command line parameter:  /ALLFILES
  1206.  
  1207.               Forces this setting to "Ignore In Reports"
  1208.  
  1209.          9) Sort Summary Report By
  1210.  
  1211.             Disk Volume Label - Summary report to screen is sorted this way.
  1212.  
  1213.             Free Disk Space   - Summary report to screen is sorted by ascending
  1214.                                 free disk space.
  1215.  
  1216.             Command line parameter:  /SF
  1217.  
  1218.               This will force this setting to be sorted by free disk space.
  1219.               You can still toggle between the two settings from within the
  1220.               summary report by pressing the <Space Bar>.  This setting just
  1221.               defines the starting order.
  1222.  
  1223.         10) Main Archive Comment Extract
  1224.  
  1225.             Off - Disables the feature mentioned below this line.
  1226.  
  1227.             On  - When not instructed to read the directory contents of ZIP or
  1228.                   ARJ files, CATDISK will attempt to read in the main comment
  1229.                   from any ZIP or ARJ file that it encounters.  Additionally,
  1230.                   when CATDISK encounters a GIF file, it will attempt to read
  1231.                   in the resolution/color information from it and place it in
  1232.                   the comment field.
  1233.  
  1234.             Command line parameter:  /NC
  1235.  
  1236.               Forces this setting to OFF.
  1237.  
  1238.         11) Main Archive Comment Copy
  1239.  
  1240.             Off - Disables the feature mentioned below this line.
  1241.  
  1242.             On  - CATDISK has a feature whereby any ZIP or ARJ files containing
  1243.                   a main comment that get expanded will have that main comment
  1244.                   inserted into the comment area of any file entry extracted
  1245.                   from that ZIP/ARJ file that does not already have a comment.
  1246.  
  1247.             Command line parameter:  /NCC
  1248.  
  1249.               Forces this setting to OFF.
  1250.  
  1251.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1252.  
  1253.                                       Page 18
  1254.  
  1255.  
  1256.  
  1257.         12) 4DOS/NDOS Comments
  1258.  
  1259.             Off - Disables the feature mentioned below this line.  You might
  1260.                   need to do so if this feature is causing you any problems
  1261.                   (such as having a file called DESCRIPT.ION from another
  1262.                   application).
  1263.  
  1264.             On  - This setting should normally be left on. 4DOS and Norton DOS
  1265.                   (NDOS), are command interpreter (i.e. COMMAND.COM)
  1266.                   replacements which greatly enhance the functionality of DOS.
  1267.                   One feature that is particularly handy is their ability to
  1268.                   add comments to your directory entries at the DOS level using
  1269.                   a command called DESCRIBE.
  1270.  
  1271.                   If you copy or move a file from the command prompt, that
  1272.                   comment goes right along with the file (the DISKFILL utility,
  1273.                   discussed later in this user manual, can also do this).
  1274.                   These comments are stored in a hidden file, DESCRIPT.ION in
  1275.                   each subdirectory where file comments are contained.
  1276.  
  1277.                   When CATDISK encounters such a file, the comments are
  1278.                   automatically read into your catalog where applicable and the
  1279.                   hidden file is cataloged with the comment "4DOS/NDOS File
  1280.                   Descriptions."  If you do not want this file cataloged at
  1281.                   all, you can do so by adding "DESCRIPT.ION" to the file
  1282.                   exclude specs screen.
  1283.  
  1284.             Command line parameter:  /N4  (CATDISK and DISKFILL)
  1285.  
  1286.               Forces this setting off.
  1287.  
  1288.         13) FILE_ID.DIZ/DESC.SDI Descriptions
  1289.  
  1290.             Use For Comments If Applicable - Turns this feature on.  See notes
  1291.                                              below.
  1292.  
  1293.             Do Not Use                     - Turns this feature off.
  1294.  
  1295.             The standardization of the filenames FILE_ID.DIZ and DESC.SDI has
  1296.             become increasingly popular in the BBS (Bulletin Board System)
  1297.             community as a means of automatically placing proper descriptions
  1298.             in the file listings found on these systems.  The author of a
  1299.             particular file can place a file with one of these two names,
  1300.             containing the desired description in that file and have the
  1301.             description automatically be used on the BBS, if the SYSOP has so
  1302.             configured his/her system.  This description may consist of more
  1303.             than one line of text.
  1304.  
  1305.             When this feature is turned on, CATDISK is capable of looking
  1306.             inside ZIP and ARJ files for this file and, if the proper
  1307.             dearchiving utility is available, extract the description from the
  1308.             archive and insert it in the comment field for that particular
  1309.             file.  There are several requirements for this feature to work
  1310.             properly.
  1311.  
  1312.             1) The appropriate dearchiving utility must be present in either
  1313.                the current directory or must be in a directory present in your
  1314.                DOS PATH statement.  PKUNZIP.EXE v2.04 or later is required for
  1315.                ZIP files and ARJ.EXE v2.30 or later is required for ARJ files.
  1316.  
  1317.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1318.  
  1319.                                       Page 19
  1320.  
  1321.  
  1322.  
  1323.             2) CATDISK must be able to free up enough memory for the
  1324.                dearchiving program to run.  If you have TSR (resident) programs
  1325.                present, a high number of disks/files per catalog configured or
  1326.                many files being read from the current disk being cataloged,
  1327.                there may not be sufficient memory left over for the operation.
  1328.  
  1329.                If you run into this problem, free up conventional memory by
  1330.                removing one or more resident programs, configure CATDISK for a
  1331.                smaller number of disks/files per catalog or, if you have
  1332.                sufficient available extended memory, use CATDISK/D.
  1333.  
  1334.             Note that this feature, if turned on, significantly adds to the
  1335.             length of time that it takes to catalog a disk.
  1336.  
  1337.             Some authors of these files use IBM line graphic characters in
  1338.             their descriptions.  For example, the text around the description
  1339.             may be surrounded by a box, making the first one or two lines
  1340.             useless as far as a description is concerned.  CATDISK will not
  1341.             accept anything from these files and will keep reading to the end
  1342.             unless it encounters a line where there are at least five
  1343.             alphanumeric or punctuation characters present.  Additionally,
  1344.             there must be four unique alphanumeric or punctuation characters
  1345.             present in the line.
  1346.  
  1347.             Command line parameter:  /DIZ
  1348.  
  1349.               Turns this feature on.
  1350.  
  1351.         14) FILE_ID.DIZ Override
  1352.  
  1353.             Off - If an archive comment is already present, CATDISK will not
  1354.                   look for FILE_ID.DIZ or DESC.SDI comments.
  1355.  
  1356.             On  - CATDISK will use the comment found in FILE_ID.DIZ or DESC.SDI
  1357.                   if one is present, even though a comment may already be
  1358.                   present in the archive file itself.  This is handy when
  1359.                   cataloging files downloaded from bulletin board systems, as
  1360.                   many BBS operators use the archive comment to display an
  1361.                   advertisement for their system.  The FILE_ID.DIZ/DESC.SDI
  1362.                   comment is usually placed there by the creator of the file.
  1363.  
  1364.             Command line parameter: /DIZOVER
  1365.  
  1366.               Turns this feature on.
  1367.  
  1368.         15) Volume Label Aliases
  1369.  
  1370.             Off - Disables the feature mentioned below this line.
  1371.  
  1372.             On  - Activates the "ALIAS" feature whereby you will be able to
  1373.                   override the name under which a disk will be cataloged.
  1374.                   Normally, CATDISK will catalog a disk under the volume label.
  1375.                   This will enable you to optionally catalog the disk under a
  1376.                   different name without changing the actual volume label on
  1377.                   the disk being cataloged.
  1378.  
  1379.             Command line parameter:  /ALIAS
  1380.  
  1381.               Turns the above feature on.
  1382.  
  1383.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1384.  
  1385.                                       Page 20
  1386.  
  1387.  
  1388.  
  1389.         16) Volume Label Suggest
  1390.  
  1391.             Off - No suggestions for volume labels are made.
  1392.  
  1393.             On  - Have CATDISK suggest sequential volume labels for you to use
  1394.                   when adding a NEW volume label to a disk based on your last
  1395.                   entry or the contents of your catalog file.  You may still
  1396.                   override the suggestion with a label of your own choice.  See
  1397.                   the section "Labeling A Disk" for further details.
  1398.  
  1399.             Command line parameter:  /SV
  1400.  
  1401.               Turns this feature on.
  1402.  
  1403.         17) Add/Edit File Comments
  1404.  
  1405.             On Demand Only         - Return to menu immediately after
  1406.                                      cataloging a disk.  Comments may only be
  1407.                                      edited on demand via the comment editing
  1408.                                      facilities available from the menus.
  1409.  
  1410.             As Disks Are Cataloged - After cataloging a disk, CATDISK will
  1411.                                      proceed to sections of the program where
  1412.                                      you may add/modify the disk and file
  1413.                                      comments for the volume that you just
  1414.                                      cataloged.
  1415.  
  1416.             Command line parameter:  /AC
  1417.  
  1418.               Sets the above feature to "As Disks Are Cataloged"
  1419.  
  1420.  
  1421.         18) Add/Edit Disk Comments
  1422.  
  1423.             On Demand Only         - Continue with cataloging operations. Disk
  1424.                                      comments may only be edited on demand via
  1425.                                      the comment editing facilities available
  1426.                                      from the menus.
  1427.  
  1428.             As Disks Are Cataloged - After cataloging each disk, CATDISK will
  1429.                                      ask you for a disk comment before it
  1430.                                      updates the summary file.
  1431.  
  1432.             Command line parameter:  /ADC
  1433.  
  1434.               Sets the above feature to "As Disks Are Cataloged"
  1435.  
  1436.  
  1437.         19) Comments In Catalog
  1438.  
  1439.             Retain If In Catalog - CATDISK will not override a file comment
  1440.                                    that already exists in the catalog file with
  1441.                                    one found on disk (eg. in a ZIP file, or in
  1442.                                    a 4DOS description).  This is to protect any
  1443.                                    comment "massaging" that you may have done
  1444.                                    when that disk was previously cataloged.
  1445.                                    Overriding that comment would undo any
  1446.                                    editing that you may have done.
  1447.  
  1448.  
  1449.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1450.  
  1451.                                       Page 21
  1452.  
  1453.  
  1454.  
  1455.             Override From Disk   - CATDISK overrides any file comments in the
  1456.                                    catalog with those read from the disk during
  1457.                                    the process of cataloging it.  If you are
  1458.                                    re-cataloging a disk, any comments that you
  1459.                                    may have "massaged" will be overridden with
  1460.                                    those found on disk.
  1461.  
  1462.             This option may only be set at program startup - there is no option
  1463.             in the settings & toggles menu to change it.  This option should be
  1464.             used with caution.
  1465.  
  1466.             Command line parameter:  /DISKCOM
  1467.  
  1468.               Forces the "Override From Disk" setting.
  1469.  
  1470.  
  1471.         20) Status Indicators
  1472.  
  1473.             Off - Suppress status indicators during processing.  This speeds up
  1474.                   processing time slightly.
  1475.  
  1476.             On  - Show status indicators during processing.  Status indicators
  1477.                   are there simply to indicate that the computer is actually
  1478.                   doing something useful.
  1479.  
  1480.             Command line parameter:  /NS
  1481.  
  1482.               Turns the above feature off.
  1483.  
  1484.  
  1485.         21) Cataloging File Status
  1486.  
  1487.             Off - CATDISK will only show the summary information when updating
  1488.                   a catalog file.  This will speed up processing somewhat,
  1489.                   particularly if the disk being processed has many files.
  1490.  
  1491.             On -  CATDISK will show each file entry in the catalog that is
  1492.                   affected by the current catalog/re-catalog/un-catalog
  1493.                   operation in addition to a summary of the changes.
  1494.  
  1495.             Command line parameter:  /NOLIST
  1496.  
  1497.               Turns the above feature off.
  1498.  
  1499.  
  1500.         22) Optional Pauses
  1501.  
  1502.             Off - CATDISK will not pause after cataloging/un-cataloging a disk.
  1503.                   CATDISK will not prompt for a disk in drive X: before
  1504.                   cataloging or reading a disk directory unless absolutely
  1505.                   necessary.
  1506.  
  1507.             On  - CATDISK will pause after cataloging/un-cataloging a disk.
  1508.                   CATDISK will always prompt for a disk in drive X: before
  1509.                   cataloging or reading a disk directory.
  1510.  
  1511.             Command line parameter:  /NP
  1512.  
  1513.               Turns the above feature off.
  1514.  
  1515.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1516.  
  1517.                                       Page 22
  1518.  
  1519.  
  1520.  
  1521.         23) Initial Pause At Start
  1522.  
  1523.             Off - When CATDISK loads, it will go right to the main menu after
  1524.                   the shareware introductory screen is viewed (registered users
  1525.                   do not see the intro screen).  This is the recommended
  1526.                   setting for those with hard drives where the catalog files
  1527.                   are available right away.
  1528.  
  1529.             On  - CATDISK will pause after it is loaded so that you may remove
  1530.                   the program disk (not needed during the session) and insert
  1531.                   the data disk. This setting is only needed if you are running
  1532.                   on a single drive system where the CATDISK program must first
  1533.                   be loaded and then the disk with the catalog files gets
  1534.                   inserted in the drive.
  1535.  
  1536.             Command line parameter:  /IP
  1537.  
  1538.               Turns the above setting on.
  1539.  
  1540.  
  1541.         24) Volume Exists Warning
  1542.  
  1543.             Off - CATDISK will not warn you if you are about to catalog a disk
  1544.                   that already exists in the catalog (see discussion for "on"
  1545.                   below).  CATDISK will create new catalog files when you
  1546.                   change the active catalog from the Setting & Toggles menu
  1547.                   without warning you that it is about to do so.
  1548.  
  1549.             On  - When you catalog a disk containing a Volume ID that already
  1550.                   exists in the current catalog, CATDISK will warn you to that
  1551.                   effect, and will ask you for verification before proceeding
  1552.                   to catalog that disk.  The reason behind this is that there
  1553.                   is always the possibility of two different disks having the
  1554.                   same Volume ID.  Cataloging one would mean that the files
  1555.                   from the other would be un-cataloged in the same process.
  1556.  
  1557.                   CATDISK will also warn you that it is about to create new
  1558.                   catalog files when you change the active catalog from the
  1559.                   Settings & Toggles menu.
  1560.  
  1561.             Command line parameter:  /NW
  1562.  
  1563.               Turns the above option off.
  1564.  
  1565.  
  1566.         25) Sound Control
  1567.  
  1568.             Off - CATDISK will operate silently.
  1569.  
  1570.             On  - CATDISK will make sounds at appropriate points in the program
  1571.                   (eg. error messages or warnings).
  1572.  
  1573.             Command line parameter:  /QUIET    (CATDISK, DISKFILL and DUPCLEAN)
  1574.  
  1575.               Turns the above option off.
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1582.  
  1583.                                       Page 23
  1584.  
  1585.  
  1586.  
  1587.         26) Date Format
  1588.  
  1589.             MMM DD,YYYY - eg. MAR 13, 1994.  Easier to read and avoids
  1590.                           ambiguous dates.
  1591.  
  1592.             YYYY-MM-DD  - eg. 1994-03-13.  Useful for producing an external
  1593.                           listing on which you will be using an external sort
  1594.                           program to sort the file by date.
  1595.  
  1596.             Command line parameter:  /ND       (CATDISK, DISKFILL and DUPCLEAN)
  1597.  
  1598.               Forces the YYYY-MM-DD date format.
  1599.  
  1600.  
  1601.         27) Allow Shell To DOS
  1602.  
  1603.             Off - CATDISK will ignore the <F4> - Shell To DOS key.  Useful
  1604.                   when running CATDISK from a menu program in restricted
  1605.                   circumstances where it may not be desirable to allow users
  1606.                   access to the DOS prompt via this function.  If <F4> is
  1607.                   pressed from a menu, a short beep will sound (if sound is
  1608.                   turned on).
  1609.  
  1610.             On  - CATDISK will allow the <F4> - Shell To DOS key.
  1611.  
  1612.             Command line parameter:  /NOSHELL
  1613.  
  1614.               Turns the above feature off.
  1615.  
  1616.         28) Verify Exit From Program
  1617.  
  1618.             Off - When you press the <Esc> key from the main menu, CATDISK will
  1619.                   promptly exit to DOS.
  1620.  
  1621.             On  - When you press the <Esc> key from the main menu, CATDISK will
  1622.                   give you a YES/NO prompt asking if you really want to leave
  1623.                   the program.
  1624.  
  1625.             Command line parameter:  /EXITV
  1626.  
  1627.               Turns the above feature on.
  1628.  
  1629.  
  1630.         29) Menu Arrow Pointers
  1631.  
  1632.             Static   - Menu arrow pointers used for point and shoot selection
  1633.                        of options will be solid on the screen.
  1634.  
  1635.             Blinking - Menu arrow pointers will blink to stand out more.
  1636.  
  1637.             Command line parameter:  /NOBLINK
  1638.  
  1639.               Forces this setting to STATIC
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1648.  
  1649.                                       Page 24
  1650.  
  1651.  
  1652.  
  1653.         30) Files/Disk Only Prompt
  1654.  
  1655.             Off - CATDISK will automatically catalog all files that it reads
  1656.                   from the disk being cataloged that pass the include/exclude
  1657.                   filespecs (which can be set from within the configuration
  1658.                   utility, CDISKCFG).
  1659.  
  1660.             On  - After updating the summary file, CATDISK will ask you if you
  1661.                   want to catalog just the disk only, or catalog all files read
  1662.                   from the disk being cataloged that pass the include/exclude
  1663.                   filespecs.
  1664.  
  1665.             Command line parameter: /ALLORNONE
  1666.  
  1667.               Turns this setting ON.
  1668.  
  1669.  
  1670.         31) Selective Cataloging
  1671.  
  1672.             On  - Activates CATDISK's "Selective Cataloging" feature.  After
  1673.                   reading a disk, CATDISK will bring up the file list for the
  1674.                   disk just read, so that you can tag the files you wish to be
  1675.                   cataloged.  If this feature is turned on, the Files/Disk Only
  1676.                   prompt setting will be ignored, even if it is turned on.
  1677.  
  1678.                   This feature is described in more detail in the section of
  1679.                   the user manual describing the "Cataloging/Uncataloging A
  1680.                   Disk" option.
  1681.  
  1682.             Off - Disables the above feature.
  1683.  
  1684.             Command Line Option: /SELECTIVE
  1685.  
  1686.               Turns the above feature ON.
  1687.  
  1688.  
  1689.         32) DISKFILL Autotag Files
  1690.  
  1691.             Off - DISKFILL will not automatically tag all files when reading in
  1692.                   a new subdirectory
  1693.  
  1694.             On  - DISKFILL will automatically tag all files when reading in a
  1695.                   new subdirectory, as offloading all files is the most common
  1696.                   operation to perform.
  1697.  
  1698.             Command line parameter:  /NOTAGALL     (In DISKFILL Only)
  1699.  
  1700.               Turns the above feature off.
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1714.  
  1715.                                       Page 25
  1716.  
  1717.  
  1718.  
  1719.         33) DISKFILL Sort Order
  1720.  
  1721.             Setting         Description                           Parameter
  1722.  
  1723.             None            Show file list in the order of
  1724.                             appearance in the DOS directory.
  1725.  
  1726.             Filename        Show file list with subdirectories       /SF
  1727.                             at the top, followed by the files in
  1728.                             ascending order by filename.
  1729.  
  1730.             File Extension  Show file list with subdirectories       /SE
  1731.                             at the top, followed by the files in
  1732.                             ascending order by file extension.
  1733.  
  1734.             File Size       Show file list with subdirectories       /SS
  1735.                             at the top, followed by the files in
  1736.                             ascending order by file size.
  1737.  
  1738.             File Date/Time  Show file list with subdirectories       /SD
  1739.                             at the top, followed by the files in
  1740.                             ascending order by file date/time.
  1741.  
  1742.  
  1743.         34) DISKFILL Reverse Sort
  1744.  
  1745.             No  - If a sorting order (above) is specified, the list will be
  1746.                   sorted in ascending order.
  1747.  
  1748.             Yes - If a sorting option above is specified, the sort will be in
  1749.                   descending order instead of the normal order.
  1750.  
  1751.             Command line parameter:  /RS
  1752.  
  1753.               Turns the above feature on.
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1780.  
  1781.                                       Page 26
  1782.  
  1783.  
  1784.  
  1785.         35) DISKFILL/DUPCLEAN Uses CATDISK
  1786.  
  1787.             Standard Version            - When DISKFILL finishes copying or
  1788.                                           moving files to the target floppy
  1789.                                           disk, it will, if requested, load
  1790.                                           the standard version of CATDISK
  1791.                                           (CATDISK.EXE) to automatically
  1792.                                           catalog the target floppy disk.
  1793.                                           Control then returns to DISKFILL
  1794.                                           when the task is completed.
  1795.                                           Likewise, DUPCLEAN, after erasing
  1796.                                           files from a floppy disk will perform
  1797.                                           the same type of function.
  1798.  
  1799.             DPMI Protected Mode Version - DISKFILL and DUPCLEAN will load the
  1800.                                           DPMI protected mode version of
  1801.                                           CATDISK, CATDISKD.EXE instead of the
  1802.                                           standard one.  Use this option if the
  1803.                                           catalog file being used exceeds the
  1804.                                           capacity of the standard version of
  1805.                                           CATDISK.
  1806.  
  1807.             Command Line Option:  /CATDISKD   (In DISKFILL and DUPCLEAN Only)
  1808.  
  1809.               Activates the DPMI option above.
  1810.  
  1811.  
  1812.         36) DISKFILL/DUPCLEAN Exec
  1813.  
  1814.             Swap When Shelling To DOS - When DISKFILL or DUPCLEAN are requested
  1815.                                         to update the catalog file, they will
  1816.                                         "shell out" to the CATDISK program
  1817.                                         itself (or CATDISK/D if applicable). To
  1818.                                         free up more memory for CATDISK, these
  1819.                                         two programs can swap most of their
  1820.                                         code and data to expanded memory (EMS)
  1821.                                         or a disk file.  Note that if swapping
  1822.                                         to a disk file, this option will slow
  1823.                                         down the loading of CATDISK to perform
  1824.                                         the cataloging functions.
  1825.  
  1826.                                         Likewise, on any "Shell To DOS"
  1827.                                         function, the swapping will make more
  1828.                                         memory available to you during the
  1829.                                         "Shell."
  1830.  
  1831.             Do Not Swap               - Leave the entire DISKFILL or DUPCLEAN
  1832.                                         program in memory when calling on
  1833.                                         CATDISK to catalog a disk or while
  1834.                                         shelling out to DOS.
  1835.  
  1836.             Command Line Option: /SWAP      (In DISKFILL and DUPCLEAN Only)
  1837.  
  1838.               Activates the swapping feature above.
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1846.  
  1847.                                       Page 27
  1848.  
  1849.  
  1850.  
  1851.         37) DUPCLEAN Uses Versions
  1852.  
  1853.             Off - DUPCLEAN will not pay attention to any characters after the
  1854.                   base characters as per the setting in the program.  See the
  1855.                   appendix covering DUPCLEAN for further details.
  1856.  
  1857.             On -  Specifies that characters after base characters used must be
  1858.                   numeric.  This is handy to limit the list to older versions
  1859.                   of the same program.
  1860.  
  1861.             Command Line Option: /VERSIONS         (In DUPCLEAN Only)
  1862.  
  1863.               Turns the above feature on.
  1864.  
  1865.  
  1866.         38) High ASCII On Screen
  1867.  
  1868.             Off - All programs will use a series of dashes (-), or-bars (|) and
  1869.                   pluses (+) to assimilate the IBM upper ASCII line graphic
  1870.                   characters in the screen displays.  This is useful on some
  1871.                   systems (eg. those supporting oriental languages) where
  1872.                   foreign character sets have been substituted for the line
  1873.                   graphic characters.  In this case, CATDISK's screen displays,
  1874.                   particularly the borders may look strange unless this feature
  1875.                   is turned off.
  1876.  
  1877.             On  - All programs will use the upper ASCII line graphic characters
  1878.                   on screen displays.
  1879.  
  1880.             Command Line Option: /NOHIGH
  1881.  
  1882.               Turns the above feature off.
  1883.     
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1912.  
  1913.                                       Page 28
  1914.  
  1915.  
  1916.  
  1917.         LIMITING WHICH DISKS DISKFILL RECOMMENDS FOR BACKFILLING
  1918.  
  1919.         The Optimal Disk Fill utility, DISKFILL, has a feature while filling
  1920.         disks with files whereby, at the disk change prompt, it can recommend
  1921.         disks already cataloged that have sufficient free space on them to
  1922.         accommodate one or more of the files from the list of files to be
  1923.         offloaded.  We refer to this process as backfilling.
  1924.  
  1925.         Normally, DISKFILL will base select its recommendations from ALL
  1926.         entries in the currently loaded catalog summary.  There may be times,
  1927.         however, when you have certain disks in your catalog to which you do
  1928.         not wish to add files (such as commercial distribution disks), or for
  1929.         that matter, disks to which you cannot add files (such as CD-ROM
  1930.         disks).
  1931.  
  1932.         By pressing <F5>, you will bring up a list of 20 "volumespecs" that
  1933.         DISKFILL will exclude from the list of disks to be recommended.  These
  1934.         entries may follow CATDISK's wildcard matching conventions.  Any disk
  1935.         matching one of these "volumespecs" will be excluded from the list of
  1936.         disks that might be recommended for backfilling operations.
  1937.  
  1938.         Because of the fact that this list is limited to 20 specifications, you
  1939.         might want to have all of your commercial disks and CD-ROMS labeled in
  1940.         a similar manner.  If they already have volume labels on them, use
  1941.         CATDISK's "ALIAS" feature to override the volume label without writing
  1942.         a new volume label on the disk.  This way, you can stretch the list out
  1943.         further and cover more disks this way.
  1944.  
  1945.         Moving around this screen and changing the entries is simple:
  1946.  
  1947.         To change a volumespec, simply use the cursor keys to move to the
  1948.         desired filespec and type in the new information for that area.  To
  1949.         clear out an existing spec, just fill the area with spaces.
  1950.  
  1951.         When you are finished modifying the list, press <Esc> to return to the
  1952.         main configuration screen.  Any changes made to the list will be saved
  1953.         when you press <F10> to save the entire configuration.
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  1978.  
  1979.                                       Page 29
  1980.  
  1981.  
  1982.  
  1983.         LIMITING WHICH FILES GET CATALOGED
  1984.  
  1985.         There are certain circumstances where it is desirable to set
  1986.         limitations on which files get cataloged and which ones do not.   For
  1987.         example, you may only want CATDISK to catalog program files (.EXE,
  1988.         .COM, .SYS or .BAT) and archives (i.e. .ZIP, .ARJ, .LZH, etc.).
  1989.  
  1990.         Likewise, you may have many bootable system disks in your collection
  1991.         that contain the files IO.SYS, MSDOS.SYS and COMMAND.COM which you do
  1992.         not want listed many times in your catalog file. We provide two
  1993.         complimentary functions that can be controlled from  within the
  1994.         configuration utility, a screen containing "file include" specs and
  1995.         "file exclude" specs.  Each screen contains 20 spaces in which you can
  1996.         place wildcard filespecs (CATDISK's extended wildcard specifications
  1997.         are valid here as well) that CATDISK will use to determine whether or
  1998.         not a given file being scanned will be included in your catalog file.
  1999.  
  2000.         <F6> will bring up the "file include" specs.  By default, the list is
  2001.         blank, which indicates to CATDISK that all files (*.*) will be included
  2002.         in any cataloging operations unless a given file matches one of the
  2003.         specifications in the "file exclude" list, discussed later.  These
  2004.         wildcard specifications may follow the extended pattern matching that
  2005.         CATDISK supports.
  2006.  
  2007.         <F7> bring up a list of up to 20 wildcard specifications for files that
  2008.         you do not want included in cataloging operations.  When CATDISK scans
  2009.         a disk to be cataloged, any files matching one of the specifications in
  2010.         the list will be ignored.
  2011.  
  2012.         One thing to note, though.  If you instruct CATDISK to skip archive
  2013.         files, the directory information of those archives will still be
  2014.         examined and included in the cataloging operation if appropriate.
  2015.  
  2016.         Both of these screens operate in the same manner.
  2017.  
  2018.         To change a filespec, simply use the cursor keys to move to the desired
  2019.         filespec and type in the new information for that area.  To clear out
  2020.         an existing spec, just fill the area with spaces.
  2021.  
  2022.         When you are finished modifying the list, press <Esc> to return to the
  2023.         main configuration screen.
  2024.  
  2025.         The range of functionality of these two screens combined can be quite
  2026.         flexible.  For example, using the scenario above, you might want to
  2027.         catalog program files (.COM, .EXE, .SYS, .BAT) and archive files (.ZIP,
  2028.         .ARJ, .LZH, .ARC) but do not want files such as COMMAND.COM, IO.SYS,
  2029.         MSDOS.SYS, CONFIG.SYS and AUTOEXEC.BAT included in the catalog.
  2030.  
  2031.         You would set up the two lists as follows (listed side by side here to
  2032.         conserve space):
  2033.  
  2034.         Include Filespec  1  *.COM           Exclude Filespec  1  COMMAND.COM
  2035.         Include Filespec  2  *.EXE           Exclude Filespec  2  IO.SYS
  2036.         Include Filespec  3  *.SYS           Exclude Filespec  3  MSDOS.SYS
  2037.         Include Filespec  4  *.BAT           Exclude Filespec  4  CONFIG.SYS
  2038.         Include Filespec  5  *.ZIP           Exclude Filespec  5  AUTOEXEC.BAT
  2039.         Include Filespec  6  *.ARJ
  2040.         Include Filespec  7  *.LZH
  2041.         Include Filespec  8  *.ARC
  2042.  
  2043.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2044.  
  2045.                                       Page 30
  2046.  
  2047.  
  2048.  
  2049.         RECALLING A PREVIOUS CONFIGURATION
  2050.  
  2051.         If you were using CATDISK v3.61 or later, you can quickly recall any
  2052.         configuration information that you had stored in that release.  This
  2053.         can save you some time in setting the program up for your preferences.
  2054.         Before copying the new program files to your work disk, you might want
  2055.         to rename the executable file from the previous installation
  2056.         (CATDISK.COM in older releases or CATDISK.EXE in more recent versions)
  2057.         to another name.
  2058.  
  2059.         Example - Upgrading from V7.00 to this release:
  2060.  
  2061.         Procedure:
  2062.  
  2063.           1) Rename your old CATDISK.EXE to CAT700.EXE (this file holds the
  2064.              configuration information from the last installation.
  2065.  
  2066.           2)  Run the configuration utility, CDISKCFG.EXE.
  2067.  
  2068.           3)  Hit <F8>.  CDISKCFG will ask you for the file name of the old
  2069.               program file.  Answer "CAT700.EXE" (without the quotes).
  2070.               CDISKCFG will search the given file for the appropriate
  2071.               configuration information.  If successful, this information will
  2072.               be reflected in the configuration options as displayed on the
  2073.               screen.  If you've selected the wrong file, you will get an error
  2074.               message, and the old settings will remain intact on the screen.
  2075.  
  2076.           4)  If successful, press <F10>, and the settings will be saved in
  2077.               the current CATDISK release.
  2078.  
  2079.           5)  Delete CAT700.EXE - it's no longer needed.
  2080.  
  2081.  
  2082.         COLOR CUSTOMIZATION
  2083.  
  2084.         If you would like to change CATDISK's screen colors, you may create
  2085.         your own color scheme from within the configuration program.  To do so,
  2086.         simply hit <F9> from the configuration screen and follow the menus.
  2087.         Once you have selected this option, you will see a menu that will allow
  2088.         you to select some general colors such as screen background and border
  2089.         color (CGA type displays only - EGA and VGA have no effect), as well as
  2090.         an option to reset the author's (that's me!) colors should you really
  2091.         make a mess of the color scheme and wish to start over.
  2092.  
  2093.         The other options will bring up menus that pertain to the various
  2094.         screens that you might encounter in your usage of CATDISK.  When you
  2095.         reach these, there will be an option available for each item that will
  2096.         change its foreground or background color.  The number for each
  2097.         currently selected color will show in brackets beside each menu item
  2098.         describing it.  Selecting an option will step you through the possible
  2099.         color range for that particular item.
  2100.  
  2101.         On monochrome or black & white systems, you may have to press an option
  2102.         key several times to cycle through the available colors, as many of
  2103.         these colors may appear the same on these systems.
  2104.  
  2105.         Does this sound confusing?  Try it for yourself... it's really quite
  2106.         easy.  For starters, try setting everything to green on cyan <grin> (if
  2107.         you don't have a strong stomach, don't bother).
  2108.  
  2109.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2110.  
  2111.                                       Page 31
  2112.  
  2113.  
  2114.  
  2115.         SAVING YOUR CONFIGURATION
  2116.  
  2117.         Once you have set all the fields to your desired settings, you may
  2118.         instruct CDISKCFG to save the current settings by pressing <F10>.
  2119.         CATDISK will save the appropriate information in the CATDISK.EXE and
  2120.         its companion programs and then return to DOS.
  2121.  
  2122.         If you do not wish to save the changes you made, simply hit <Esc>, and
  2123.         you will be returned to DOS, while the previous configuration will
  2124.         remain unscathed.
  2125.  
  2126.  
  2127.         DEFAULT SETTINGS
  2128.  
  2129.         CATDISK is shipped with the following default settings:
  2130.  
  2131.          1) Screen Update Method:              BIOS
  2132.          2) Color or B & W:                    B & W
  2133.          3) Output Lines Per Page:             62
  2134.          4) Printer Startup String:            Nothing
  2135.          5) Printer Finishing String:          Nothing
  2136.          6) Default ARCHIVE Extract State:     ON
  2137.          7) Catalog Drive:                     A:
  2138.          8) Catalog File Directory:            Default Drive and Directory
  2139.          9) Maximum Disks/Files per Catalog:   1000/16384
  2140.  
  2141.         10) Color Scheme:                      Authors Colors
  2142.  
  2143.  
  2144.         GENERAL CONSIDERATIONS WHEN CONFIGURING CATDISK
  2145.  
  2146.         When setting CATDISK up, there are a few things you should consider:
  2147.  
  2148.         If you have a hard disk, you should use it for maintaining your catalog
  2149.         files (i.e. set your catalog file directory to somewhere on your hard
  2150.         drive).
  2151.  
  2152.         If possible, set your video update method to DIRECT.  CATDISK runs
  2153.         faster in this mode.
  2154.  
  2155.         When setting your printer up for printing reports, try to set the
  2156.         printer startup string such that the complete catalog listing (i.e.
  2157.         files, stats and comments) can be printed.
  2158.  
  2159.         The best setting for the default ARCHIVE extract state is QUERY.  Many
  2160.         archives do not need to be fully extracted as the name of the archive
  2161.         filename itself is all that is necessary in order to identify what is
  2162.         on that particular disk.  By using some discretion in deciding which
  2163.         archive files need be extracted, you can dramatically reduce the size
  2164.         of your catalog files (as well as the time needed to update and search
  2165.         them).  Some however, need to be extracted (for example, MISC.ARC).
  2166.         This setting gives you the best of both worlds.
  2167.  
  2168.         When setting the default drive and directory for your catalog files, be
  2169.         sure and include it in your DOS PATH as well.  This will enable you to
  2170.         run CATDISK from anywhere in your system without having to change to
  2171.         that directory before running CATDISK.  DISKFILL and DUPCLEAN also
  2172.         require this setting if they are requested to call upon the CATDISK
  2173.         program to update a catalog during their functions.
  2174.  
  2175.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2176.  
  2177.                                       Page 32
  2178.  
  2179.  
  2180.  
  2181.         When setting the maximum number of disks and files that can be
  2182.         maintained in a catalog file, the best setting should be the LOWEST one
  2183.         that will contain your largest catalog file.  This will maximize the
  2184.         amount of free memory left over that CATDISK can use to store file
  2185.         information being read from disks being cataloged, sorting information,
  2186.         caching information, and the like.
  2187.  
  2188.         Keep in mind that, if you should have a catalog file grow to your set
  2189.         maximum, you can always re-configure CATDISK (memory permitting, of
  2190.         course) to accommodate a larger configuration, unless you are already
  2191.         at the highest setting.  When you next run CATDISK after making these
  2192.         changes, your catalog file will then be able to grow to the new
  2193.         setting.
  2194.  
  2195.         If you are running on floppy drives, use setting #4 for the maximum
  2196.         catalog size (512 disks/8192 files per catalog).  Your files will never
  2197.         exceed this limitation.
  2198.  
  2199.  
  2200.         SAMPLE CONFIGURATIONS
  2201.  
  2202.         Scenario:  One Hard Disk (C:) and a floppy drive:
  2203.  
  2204.                    Make a directory "C:\CATDISK" and copy the files CATDISK.EXE
  2205.                    and CDISKCFG.EXE to it.  Set the configuration to:
  2206.  
  2207.                     1) Screen Update Method:              <your option>
  2208.                     2) Color or B & W:                    <your option>
  2209.                     3) Output Lines Per Page:             <your option>
  2210.                     4) Printer Startup String:            <your option>
  2211.                     5) Printer Finishing String:          <your option>
  2212.                     6) Default ARCHIVE Extract State:     <your option>
  2213.                     7) Catalog Drive:                     A:
  2214.                     8) Catalog File Directory:            C:\CATDISK
  2215.                     9) Maximum Disks/Files per Catalog:   <your option>
  2216.     
  2217.                    Add C:\CATDISK to the DOS PATH and you will be all set.
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2242.  
  2243.                                       Page 33
  2244.  
  2245.  
  2246.  
  2247.         Scenario:  Two floppy drives:
  2248.  
  2249.                    Take a blank disk and copy the files CATDISK.EXE and
  2250.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  2251.                    Set the configuration to:
  2252.  
  2253.                    1)  Screen Update Method:              <your option>
  2254.                    2)  Color or B & W:                    <your option>
  2255.                    3)  Output Lines Per Page:             <your option>
  2256.                    4)  Printer Startup String:            <your option>
  2257.                    5)  Printer Finishing String:          <your option>
  2258.                    6)  Default ARCHIVE Extract State:     <your option>
  2259.                    7)  Catalog Drive:                     A:
  2260.                    8)  Catalog File Directory:            B:\
  2261.                    9)  Maximum Disks/Files per Catalog:   500/8192
  2262.  
  2263.                    When starting CATDISK from DOS, insert the program disk in
  2264.                    drive A: and take a blank formatted disk and insert it in
  2265.                    drive B:.  This will be your data disk.  When CATDISK has
  2266.                    loaded and has displayed the title screen, you may remove
  2267.                    the CATDISK program disk from the A: drive.  This will now
  2268.                    be the drive from which disks being cataloged will be read.
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2308.  
  2309.                                       Page 34
  2310.  
  2311.  
  2312.  
  2313.         STARTING CATDISK
  2314.  
  2315.         CATDISK is started from the DOS command line by issuing the following:
  2316.  
  2317.         CATDISK parameters
  2318.  
  2319.         - where parameters may include any of the command line options from the
  2320.           section "Configuring CATDISK" or any of the following options covered
  2321.           here:
  2322.  
  2323.              /D:        - Catalog files from drive D: where D: is one of
  2324.                           [A - {last drive in your system}].
  2325.  
  2326.              /CATALOG   - If this option is added to your command line, CATDISK
  2327.                           will perform a catalog operation on the catalog drive
  2328.                           (the setting from the CDISKCFG program may be
  2329.                           overridden on the command line) and return to DOS
  2330.                           when done.  If you have the autocomments feature in
  2331.                           CATDISK turned on, you will be taken to the comment
  2332.                           entry screen first.  When you exit from this screen,
  2333.                           you will then be returned to DOS.
  2334.  
  2335.                           This option makes it possible to catalog a disk from
  2336.                           a batch file, or from within another application by
  2337.                           shelling out to CATDISK with the correct parameters.
  2338.                           When CATDISK exits, you will be returned to your
  2339.                           application.
  2340.  
  2341.                           NOTE:  It is not advisable to put this option in the
  2342.                           CATDISK environment variable, discussed below, as it
  2343.                           will make it impossible to get into CATDISK's other
  2344.                           functions.
  2345.  
  2346.              /?         - Display a terse list of available command line
  2347.                           options.
  2348.  
  2349.  
  2350.         The slash "/" may be substituted by either a dash "-" or a space " ".
  2351.  
  2352.         Examples:  CATDISK /FGAMES/NS/AC/L2/P3/R5/ALIAS/B:   or  CATDISK A:
  2353.  
  2354.  
  2355.         IF CATDISK/D CANNOT RECOGNIZE YOUR HARDWARE
  2356.  
  2357.         If you are using a memory manager that provides DPMI services, such as
  2358.         386MAX or QEMM, CATDISK/D will automatically detect it and use it.  If
  2359.         not, CATDISK/D will load Borland International's DPMI handler
  2360.         automatically. If you get a message that your hardware is not
  2361.         recognized by the DPMI handler, you will need to run a DPMI
  2362.         installation program called DPMIINST.EXE, which will examine your
  2363.         hardware to best determine how to access it.
  2364.  
  2365.         There are no options necessary when running the installation program,
  2366.         just type "DPMIINST" from within the CATDISK directory and make sure
  2367.         that the file "DPMI16BI.OVL" is present.  Follow the prompts given to
  2368.         you by the DPMIINST program and when it finishes its operation, you
  2369.         will be ready to use CATDISK/D normally as you would use CATDISK
  2370.         itself.
  2371.  
  2372.  
  2373.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2374.  
  2375.                                       Page 35
  2376.  
  2377.  
  2378.  
  2379.         SAVING PARAMETERS SO YOU DON'T HAVE TO TYPE THEM EACH TIME
  2380.  
  2381.         If you find yourself typing in the same set of command line parameters
  2382.         each time you start CATDISK, you can save yourself some time by putting
  2383.         the command line options in a CATDISK environment variable using the
  2384.         DOS "SET" command.  This command (see examples below), may be placed in
  2385.         your AUTOEXEC.BAT file so that you will not need to remember which
  2386.         command line options to use to obtain your favorite setup, or for that
  2387.         matter, to type them!
  2388.  
  2389.         - example:  SET CATDISK=/FGAMES/B:
  2390.  
  2391.         When you start CATDISK under these circumstances, simply type "CATDISK"
  2392.         <Enter> and the above options will automatically be invoked.
  2393.  
  2394.         Any options entered on the command line will be added to those
  2395.         specified in the CATDISK environment variable.  This makes it possible
  2396.         to have a base set of options set in the DOS environment and have an
  2397.         optional set that you can specify at the time you run CATDISK.
  2398.  
  2399.         It is also possible to override some of the options as well (for
  2400.         example, the printed report format, the screen report format, the
  2401.         catalog file, and the catalog drive), as CATDISK will pay attention to
  2402.         the last option of a given type.
  2403.  
  2404.         For example, using the above environment example, entering the command
  2405.  
  2406.         CATDISK /A:/P1
  2407.  
  2408.         will cause CATDISK to set the catalog drive to A: (overrides the B:
  2409.         option), and the printer report format to show comments (format #1)
  2410.         instead of statistics and comments (format #2).
  2411.  
  2412.         Once CATDISK has been successfully started, a title screen will appear.
  2413.         Hit any key to proceed to the main menu.
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2440.  
  2441.                                       Page 36
  2442.  
  2443.  
  2444.  
  2445.                              3.  U S I N G   C A T D I S K
  2446.  
  2447.         THE TOP OF SCREEN STATUS AREA
  2448.  
  2449.         Following is each line from the status area at the top of CATDISK's
  2450.         main screen and an explanation of what each item or character means.
  2451.  
  2452.         The main archive       The main archive comment    CATDISK will read
  2453.          comment will be       will be repeated in file     4DOS/NDOS comments
  2454.         extracted, even if     entries from that archive     if applicable
  2455.         the archive itself       that have no comment                |
  2456.          is not expanded                   |                          ------
  2457.                  |                          ------------------------------- |
  2458.                   -------------------------------------------------------- ||
  2459.                                                                           |||
  2460.         Disks Cataloged:  333 Disks Available:  667        Comments: AUTO CR4ZD
  2461.                            |                     |                    |      ||
  2462.                    The number of disks   The number of disk    Comments will ||
  2463.                    currently cataloged   entries available     be entered as ||
  2464.                                           with the current       disks are   ||
  2465.                                               settings           cataloged   ||
  2466.                             ------------------------------------------------- |
  2467.                            |                                        ----------
  2468.           If no main archive comment exists, CATDISK               |
  2469.           will look for a FILE_ID.DIZ/DESC.SDI inside     Comments read from
  2470.            the archive file for comment information.      disk will override
  2471.           This is indicated by a lowercase "z"; if the    any already existing
  2472.           "Z" is uppercase, the extracted comment will    in the catalog file
  2473.            override the archive comment if present
  2474.  
  2475.  
  2476.              Printed reports will be printed on both sides of the page -----
  2477.                                                                             |
  2478.         Files Cataloged: 2473  Files Available: 1527  Report Location: ASK /2
  2479.                            |                      |                     |
  2480.                   The number of files   The number of file        The current
  2481.                   currently cataloged    entries available      report location
  2482.                                           with the current      - Can be SCRN,
  2483.         "All files or just                    settings            LPT1, LPT2,
  2484.         the disk" prompt     "Selective                           DISK or ASK.
  2485.         activated    |__  --- Cataloging" activated.
  2486.                         ||
  2487.       Catalog Drive: B:/PS  Active File: CATDISK   Archive Extract: QUERY/RPT
  2488.                        |                    |                         |     |
  2489.              The disk drive from    The currently active    Whether or not  |
  2490.              which files will be        catalog set.          to expand     |
  2491.              read for cataloging                            archive files.  |
  2492.                   purposes                                   Can be YES, NO |
  2493.                                                                or QUERY.    |
  2494.                                       This setting will                     |
  2495.                                        affect reports  ---------------------
  2496.  
  2497.          ------[ Pauses: OFF ]--[ Report Type: ALL INFO /T    VLabel: ALS/SV ]-
  2498.                           |                       |      |             |   |
  2499.               Whether or not CATDISK     Printed report  | CATDISK's alias |
  2500.              will pause after certain    style selected  | feature is on   |
  2501.               operations are complete                    |                 |
  2502.                                                 Report totals    CATDISK will
  2503.                                                 are turned on   suggest vlabels
  2504.  
  2505.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2506.  
  2507.                                       Page 37
  2508.  
  2509.  
  2510.  
  2511.         USING THE MENUS
  2512.  
  2513.         The major options available from CATDISK are all accessible by menus.
  2514.         The options on these menus may be selected in two different ways.
  2515.  
  2516.         The first, and easiest is just to hit the indicated key beside the
  2517.         desired option.
  2518.  
  2519.         The second method is by using a "point and shoot" method.
  2520.  
  2521.         Simply use the cursor keys to position the flashing arrows in the
  2522.         inverse box that indicates the keystroke required to activate the
  2523.         desired option and hit <Return> or <Enter>.  This will carry out the
  2524.         same function as if you had struck the key in the inverse box.
  2525.  
  2526.         One advantage of the "point and shoot" method is that once you have
  2527.         activated a function such as cataloging a disk, you need only hit
  2528.         <Return> to re-activate that function as CATDISK will remember the last
  2529.         option you activated (quite handy if you are cataloging multiple
  2530.         disks).
  2531.  
  2532.  
  2533.         HOT-KEYS
  2534.  
  2535.         Normally, to change any of the Settings & Toggles, you have to go to
  2536.         that screen from the main menu and make your changes from there.  We
  2537.         have provided shortcuts to the settings in that screen that are
  2538.         accessible from both the Main Menu and from the Reports & Inquiries
  2539.         Menu.
  2540.  
  2541.         To change any of the settings available in the Settings & Toggles
  2542.         screen directly from either the main menu or the reports & inquiries
  2543.         menu, simply hold down the <Alt> key and press the letter or number key
  2544.         (from the top row only, not the numeric keypad) that appears beside the
  2545.         option itself on the settings & toggles screen.  CATDISK will change
  2546.         the appropriate setting as you had hit the <Right Arrow> key with that
  2547.         item highlighted in that screen.
  2548.  
  2549.  
  2550.         HOT KEY QUICK-EXIT
  2551.  
  2552.         You can quickly exit the CATDISK program entirely and return to DOS by
  2553.         pressing the <Ctrl>-<X> combination from any menu, from the settings &
  2554.         toggles screen, or from any screen-based report.  CATDISK will exit
  2555.         immediately without any prompting.
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2572.  
  2573.                                       Page 38
  2574.  
  2575.  
  2576.  
  2577.         SELECTING A VOLUME NAME FROM A LIST
  2578.  
  2579.         Other than actually labeling a disk, there are three other locations in
  2580.         CATDISK where you will be prompted for a volume label: un-cataloging a
  2581.         disk; generating a report by volume id; and adding file comments by
  2582.         volume.  If you know what volume label is desired at the prompt, you
  2583.         may enter it verbatim.  Leaving it blank, however, will cause CATDISK
  2584.         to come up with a point-and-shoot list of all the volume names in the
  2585.         current catalog file.
  2586.  
  2587.         When this list first appears, you will notice that the first volume is
  2588.         highlighted.  Selecting a volume from this list is merely a matter of
  2589.         moving the highlight bar to the desired volume by using the standard
  2590.         navigation keys discussed earlier and pressing <Enter>.
  2591.  
  2592.         Pressing <Esc> on this screen will return you to the previous screen
  2593.         with no further action taken.
  2594.  
  2595.         To jump quickly to an approximate location in the list, press any
  2596.         letter, number or punctuation key (except PLUS and MINUS, as they are
  2597.         already being used).  You will be quickly moved to the first item in
  2598.         the list that starts with that character.  If nothing in the list
  2599.         starts with the character that you press, a short beep will sound.
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2638.  
  2639.                                       Page 39
  2640.  
  2641.  
  2642.  
  2643.         OPTION 1 - SET DRIVE FOR CATALOGING
  2644.  
  2645.         This function allows you to set the drive from which the files to be
  2646.         cataloged will be read.  Simply select letter from (A - x) to select
  2647.         the drive with that DOS letter designation, where x is the last drive
  2648.         that CATDISK detected in your system configuration.  The change will be
  2649.         noted immediately in the status area at the top of the screen.
  2650.  
  2651.  
  2652.         OPTION 2:  THE SETTINGS AND TOGGLES SCREEN
  2653.  
  2654.         The options available on this screen will allow you to control the
  2655.         behavior of many of the features of CATDISK.  You can get to this
  2656.         screen by selecting option #2 from the main menu.
  2657.  
  2658.         The options shown on this screen are very much similar to the settings
  2659.         in the configuration utility, CDISKCFG.EXE.  Any changes made while in
  2660.         this screen will be lost when you leave the program and return to DOS.
  2661.         If you wish to make the changes permanent, use the configuration
  2662.         utility.
  2663.  
  2664.         Move around this screen by using the standard navigation keys discussed
  2665.         earlier in this manual.
  2666.  
  2667.         To change an item, use the <Left Arrow> and <Right Arrow>, or for
  2668.         quicker access, hold down the <Alt> key and press the letter or number
  2669.         that corresponds to the given item.  Why is the <Alt> key necessary?
  2670.         The reason for this is due to the fact that changing the catalog file
  2671.         may be initiated by simply beginning to type in the new name to use
  2672.         when that line is highlighted.  We use the <Alt> key for quick changes
  2673.         to all fields for consistency, especially with the shortcuts from the
  2674.         other menus.
  2675.  
  2676.         Hit <Esc> to return to the main menu.
  2677.  
  2678.         The only difference in the way that these options work and that way
  2679.         that those in the configuration utility work is when setting the active
  2680.         catalog.  When the catalog file prompt has been brought up from the
  2681.         settings & toggles screen, pressing <Esc> to leave that screen will
  2682.         simply result in the current catalog file being left unchanged and your
  2683.         being returned to the previous screen.
  2684.  
  2685.         Note that several options present in the screen of the configuration
  2686.         utility are not present in this screen.  This is due to the fact that
  2687.         some apply to DISKFILL and DUPCLEAN, and several settings refer to
  2688.         startup options and are not applicable after CATDISK has begun its
  2689.         operation.
  2690.  
  2691.         You will also note that the options shown have either a letter or a
  2692.         digit beside them.  These letters or digits represent menu shortcuts.
  2693.         You may change any of these settings from any other menu in CATDISK by
  2694.         holding down the <Alt> key and then pressing the appropriate letter or
  2695.         digit.  The change will occur as if you had pressed the <Space Bar>
  2696.         with that item highlighted in the Settings & Toggles screen.
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2704.  
  2705.                                       Page 40
  2706.  
  2707.  
  2708.  
  2709.         OPTION 3:  LABELING A DISK
  2710.  
  2711.         Selection of option #3 on the main menu will allow the VOLUME LABEL of
  2712.         a disk to be set or changed.  Upon selection, CATDISK will attempt to
  2713.         read the current label of the disk.  If none is present, you will be
  2714.         notified of this, and will be given the opportunity to create a volume
  2715.         label for that disk.  See the DOS manual on volume labels for more
  2716.         information.  If a label already exists on the disk, its name will be
  2717.         shown as a reminder, and you will be given an opportunity to change the
  2718.         label name.  Just enter the new label name and hit <CR>.
  2719.  
  2720.         Note that if you have the volume label suggestion facility turned on,
  2721.         CATDISK will recommend a sequential volume label for any new disks
  2722.         being labeled.
  2723.  
  2724.            Examples:  DISK001   would become  DISK002
  2725.                       DISK001A  would become  DISK002A
  2726.  
  2727.         If two or more separate numerical sequences are present in the volume
  2728.         label, CATDISK will increment the rightmost one.
  2729.  
  2730.            Example:   A001B002 would become A001B003
  2731.  
  2732.         If there is no numerical part in the previous volume label, the volume
  2733.         label will be suggested verbatim.
  2734.  
  2735.         The recommendation is based upon the last entered label at the
  2736.         keyboard.  If none was yet specified, the last entry in the catalog
  2737.         file will be used as a "starting seed."
  2738.  
  2739.         If the label name entered is valid, the change will be made, otherwise,
  2740.         an error message indicating such will be issued and you will return to
  2741.         the main menu.
  2742.  
  2743.         If you do not wish to enter or change the disk label, simply hit <ESC>
  2744.         at the volume label prompt and you will immediately return to the main
  2745.         menu with no changed made to the disk label.
  2746.  
  2747.         When the volume label has been successfully changed or created, CATDISK
  2748.         will check to see if the old label, if any was present, exists in the
  2749.         current catalog file.  If so, you will be given an opportunity to have
  2750.         CATDISK automatically change the old volume id references to the newly
  2751.         entered one.  If the disk that you re-labeled is one that actually is
  2752.         in the catalog, answer <Y>es to the prompt.  CATDISK will take care of
  2753.         the rest.  This feature can be a great time saver, as it eliminates the
  2754.         need to uncatalog the disk under the old volume id, and re-catalog it
  2755.         under the new name.
  2756.  
  2757.         If the disk is not in the catalog, answer <N>o to the prompt. Answering
  2758.         <Y>es under these circumstances will not damage the catalog file, but
  2759.         will cause confusion as to what disk the altered catalog records reside
  2760.         on.
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2770.  
  2771.                                       Page 41
  2772.  
  2773.  
  2774.  
  2775.         OPTION 4:  CATALOGING/RE-CATALOGING A DISK
  2776.  
  2777.         This selection will initiate cataloging or re-cataloging of the files
  2778.         on the selected catalog disk as shown in the status area at the top of
  2779.         the screen.  The volume label will be read, and if it doesn't exist,
  2780.         you will be given an opportunity to enter a volume label for the disk.
  2781.         If you hit <ESC> at the label prompt, the operation will be aborted and
  2782.         you will be returned to the main menu without cataloging your disk.
  2783.  
  2784.         After entering the label name for that disk, you will be asked if you
  2785.         wish to write that label to disk.  If you answer <Y>es, the disk will
  2786.         be labeled and cataloging will continue.  If you answer <N>o, the label
  2787.         will not be written, but the disk will be cataloged under the name that
  2788.         you gave it.  This will allow easy cataloging of write-protected disks.
  2789.  
  2790.         Please note that volume labels created by other "Volume label"
  2791.         utilities may contain lower case characters.  CATDISK will convert the
  2792.         labels to upper case before adding them to the catalog.  This will
  2793.         enable you to manipulate and uncatalog any of these disks.  The actual
  2794.         volume label on the disk will be left unchanged.
  2795.  
  2796.         There are volume label utilities on the market that allow the entry of
  2797.         illegal characters into the volume label.  CATDISK will change these
  2798.         offending characters into spaces when it encounters them.  This will
  2799.         not affect the actual label on the disk, but rather the way CATDISK
  2800.         stores them in its catalog files.
  2801.  
  2802.         If the label on the disk to be cataloged already exists in the
  2803.         catalog, you will be notified of this situation, and will be given an
  2804.         opportunity to abort the operation.  This feature has been added as a
  2805.         safeguard against a situation where two disks of the same volume id may
  2806.         be overriding each other and clobbering the catalog contents of the
  2807.         other disk.  If you have turned warnings off, this warning will not be
  2808.         issued.
  2809.  
  2810.         If you have activated the ALIAS function, a screen will appear showing
  2811.         you what the current volume label is on the disk you are about to
  2812.         catalog.  A prompt will appear below this asking you for a name under
  2813.         which you would like the disk to be cataloged.  The current volume
  2814.         label will be displayed in this area, and you will be allowed to change
  2815.         it before the cataloging process takes place.  This can be very handy
  2816.         in certain situations such as vendor disks that insist that the volume
  2817.         label remain unchanged, as the software uses the volume label to
  2818.         identify the disk.  The volume label on the disk may not mean anything
  2819.         to you, and  using an alias may be desirable in this case.
  2820.  
  2821.         As flexible as the ability to catalog under an alias can be, there are
  2822.         a couple of drawbacks that should be considered before you decide to
  2823.         make the name in the catalog different from the volume label on the
  2824.         disk.  Firstly, if you go to re-catalog the disk at a later time and
  2825.         don't provide exactly the same alias that was used initially, you can
  2826.         wind up with duplicate entries in the catalog file, as CATDISK
  2827.         currently has no way of knowing that the disk has already been
  2828.         cataloged.  Secondly, if at a later date, you use option #3 in CATDISK
  2829.         to change the volume label on a disk that has already been cataloged,
  2830.         CATDISK will have no way of knowing that it should give you the
  2831.         opportunity to change the entries in the catalog to reflect the new
  2832.         volume label, as the entries are not cataloged under the old volume
  2833.         label.
  2834.  
  2835.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2836.  
  2837.                                       Page 42
  2838.  
  2839.  
  2840.  
  2841.         The best advice would be that if you never intend to re-catalog a disk
  2842.         in the future, then it would be ok to use an alias, otherwise, it's
  2843.         best to stick with a meaningful volume label.
  2844.  
  2845.         Once the name of the disk has been established for cataloging purposes,
  2846.         the directory and any archive or library entries (if the ARCHIVE auto
  2847.         extract feature option is turned on - it is by default) will be read
  2848.         (if the ARCHIVE auto extract is set to QUERY, you will be asked for
  2849.         verification before a given archive or Library will be read).  This
  2850.         process will be repeated for each sub-directory on the disk as well.
  2851.         All existing levels of sub-directories will be searched.
  2852.  
  2853.         Archives are processed and supported according to the details outlined
  2854.         in the appendix "ARCHIVE SUPPORT."
  2855.  
  2856.         If the 4DOS/NDOS comment extract feature is turned on (it is by
  2857.         default), CATDISK will attempt to find a file (that may be hidden) in
  2858.         each subdirectory called "DESCRIPT.ION".  This file will be present if
  2859.         you have used the 4DOS/NDOS "Describe" command to add file descriptions
  2860.         to your directory entries.  If CATDISK is able to locate this file, it
  2861.         will automatically add any matching comments to your catalog entries
  2862.         where appropriate.
  2863.  
  2864.         If you have CATDISK's support for FILE_ID.DIZ or DESC.SDI descriptions
  2865.         turned on via the configuration utility, CDISKCFG.EXE or via the /DIZ
  2866.         command line option, CATDISK will attempt to extract these files from
  2867.         any ZIP or ARJ files it encounters and include the first usable line in
  2868.         the file description for that file.  Details on this feature may be
  2869.         found earlier in this user manual in the "Configuring CATDISK" section.
  2870.  
  2871.         Users of 4DOS may note that, while CATDISK has called up PKUNZIP.EXE or
  2872.         ARJ.EXE, the cursor will appear in the upper left corner of the boxed
  2873.         area of the screen.  This is normal and we have no control over this.
  2874.         When control returns to CATDISK, the cursor will be turned off again.
  2875.  
  2876.         Once CATDISK has read all the necessary information off of the disk
  2877.         being cataloged, it will proceed on to the next step.  If you have
  2878.         CATDISK's "Selective Cataloging" feature turned on, a screen in which
  2879.         you may select individual files or groups of files from the disk that
  2880.         has just been read to include in the catalog.  A discussion of the
  2881.         functions available on this screen is discussed at the end of this
  2882.         section of the manual.
  2883.  
  2884.         If you do not have "Selective Cataloging" turned on, CATDISK will
  2885.         proceed directly to the next step below.
  2886.  
  2887.         If you have turned on the auto disk comment feature either from the
  2888.         command line or from the toggles menu, you will be prompted for a
  2889.         comment for the disk that will be shown in the disk summary report. If
  2890.         you are cataloging a new disk, the comment field will be blank.  If you
  2891.         are re-cataloging a disk, the previous comment for that disk will be
  2892.         the default.  To edit, just enter the new comment for the disk and hit
  2893.         <Enter>.  Hitting <Esc> will cause CATDISK to continue with no changes
  2894.         made to the existing comment as shown.
  2895.  
  2896.         If you do not have the auto disk comment feature turned on, you may
  2897.         still add/edit comments with the summary file comment editor, which is
  2898.         available from the main menu.
  2899.  
  2900.  
  2901.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2902.  
  2903.                                       Page 43
  2904.  
  2905.  
  2906.  
  2907.         Upon completion of this, the catalog summary file will be updated.  If
  2908.         you have activated the Files/Disk Only prompt in the CDISKCFG.EXE
  2909.         configuration utility or specified the command line option /ALLORNONE
  2910.         when you started CATDISK, AND do not have CATDISK's "Selective
  2911.         Cataloging" feature activated (Discussed a little later), you will be
  2912.         asked if you want to catalog the disk only or include all files read
  2913.         from the disk.
  2914.  
  2915.         If you answer <D> for "disk only", the master catalog will not be
  2916.         updated unless appropriate entries need to be removed from the catalog
  2917.         due to the fact that the disk had been previously cataloged.
  2918.  
  2919.         If you answer <F> or did not activate the prompt in the first place,
  2920.         the master catalog will be updated to reflect the current
  2921.         directory/directories of the disk.  If any files have been added, they
  2922.         will be added to the catalog;  if any files have been changed, they
  2923.         will be updated;  if any files have been deleted, they will be removed
  2924.         from the catalog.
  2925.  
  2926.         If, while reading the disk, CATDISK cannot find any files there, it
  2927.         will ask you if you would like to add that disk to the catalog anyway.
  2928.         Why would you want to add such a disk to the catalog?  The answer to
  2929.         this question can best be explained by an example.
  2930.  
  2931.         You're maintaining a collection of disks for a computer users group.
  2932.         One day, you decide to clean up your collection, eliminating any
  2933.         duplicates that may have crept into the collection.  While you're
  2934.         eliminating the duplicates, several of the disks in the sequence become
  2935.         completely empty.  In this case, it is desirable to have the disk
  2936.         showing in the summary file as having its capacity completely available
  2937.         to accept new files.  Additionally, all the files that were eliminated
  2938.         from that disk will be un-cataloged by CATDISK through its normal
  2939.         function.  If the disk has never been cataloged before, this method
  2940.         represents a way to "pre-allocate" the disks to the collection and
  2941.         initialize their entries in the catalog file.
  2942.  
  2943.         If you would like to have the blank disk included in the catalog,
  2944.         answer YES to the prompt, otherwise, answer NO.  If you elect not to
  2945.         include the disk in the catalog file, and it has already been cataloged
  2946.         before, it would be advisable to remove that volume listing from the
  2947.         catalog file using option #5.
  2948.  
  2949.         Keep in mind, that deletion of an archive file will cause any files
  2950.         existing within that archive file to be uncataloged.  Also, turning the
  2951.         Auto Archive Extraction feature OFF, or answering <No> to a Extract
  2952.         Archive prompt to a cataloged Archive will cause any files in an
  2953.         Archive file on that disk to be uncataloged as well.
  2954.  
  2955.         Should the disk become full when the cataloging process is underway,
  2956.         the process will be aborted with an error message.  The old catalog
  2957.         file will remain intact (i.e. no changes made), but the summary file
  2958.         will reflect either the presence of the new disk, or the current status
  2959.         of that disk if it already existed in the catalog.  This means that the
  2960.         catalog file will not be accurate as to what's on the disk that you
  2961.         attempted to catalog.   If this error is encountered, you should either
  2962.         try to free up some space on disk on which the catalog file exists, or
  2963.         move the .DTA and .SUM files to another disk (see CONFIGURING CATDISK
  2964.         for details on how to access catalog files on other drives and
  2965.         directories) and retry the operation.
  2966.  
  2967.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  2968.  
  2969.                                       Page 44
  2970.  
  2971.  
  2972.  
  2973.         The cataloging operation is completely automatic and does not require
  2974.         any further input from the operator once started, unless, of course,
  2975.         the ARCHIVE extract state is set to QUERY.
  2976.  
  2977.         If you have turned on the auto file comment feature either from the
  2978.         command line or from the toggles menu, you will be taken to a section
  2979.         of the program that will allow you to add/update file comments for the
  2980.         group of files that CATDISK just added to or updated in your catalog.
  2981.  
  2982.         See the discussion on "OPTION 6 - CHANGE COMMENTS BY VOLUME ID" for a
  2983.         discussion on how the comment editor works.
  2984.  
  2985.         Please keep in mind that CATDISK has an internal limitation of being
  2986.         able to read in only the first 6000 files of the disk being cataloged,
  2987.         including those read from within archive files if available memory
  2988.         permits.
  2989.  
  2990.         CATDISK/D can handle up to 65500 files per disk being cataloged.
  2991.  
  2992.         If you find that CATDISK is not able to read in all of your disk for
  2993.         cataloging purposes, it could be that there is not enough free memory
  2994.         to be able to store all of the information.  If this is the case, try
  2995.         one or both of the following suggestions:
  2996.  
  2997.         1) Configure CATDISK's maximum disks/files per catalog setting to the
  2998.            smallest number that will contain your largest catalog file.  If the
  2999.            setting is unnecessarily large, more memory than is really needed
  3000.            will be set aside by CATDISK for internal use.
  3001.  
  3002.         2) Remove one or more resident (TSR) programs from memory to make more
  3003.            available for CATDISK to use.
  3004.  
  3005.         3) If your system is capable of using CATDISK/D, use that version, as
  3006.            its limitations are much higher.
  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) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3034.  
  3035.                                       Page 45
  3036.  
  3037.  
  3038.  
  3039.         Selective Cataloging
  3040.         --------------------
  3041.  
  3042.         When this feature is activated, CATDISK, after reading a disk for
  3043.         cataloging, will display all files that are available for cataloging.
  3044.         The strategy on this screen is to tag the files that you wish included
  3045.         in your catalog.  For example, a game may have hundreds of image files,
  3046.         but you only want the main executables and support files cataloged.
  3047.  
  3048.         To tag a file individually, use the standard navigation keys to move
  3049.         the highlight bar over the desired file and press the <Space Bar>.
  3050.  
  3051.         When a file is tagged, a fat triangle pointing to the right will appear
  3052.         in the left column of the information displayed for that file.
  3053.  
  3054.         The information for the file follows CATDISK's standard screen-based
  3055.         reporting conventions and, like these reports, can be toggled between
  3056.         four standard formats by using the <Tab> key.
  3057.  
  3058.         In a small list of files, tagging each file individually might suffice.
  3059.         In a large list, however, individually tagging each file can be
  3060.         cumbersome.  By pressing <T>, you can bring up a set of 5 tagging
  3061.         options that allow you to "bulk tag/untag" files in a much more
  3062.         efficient manner as described here:
  3063.  
  3064.           <A>   - Tag All:       This will tag every file in the list.
  3065.  
  3066.           <C>   - Clear All:     This will clear the tagged status of every
  3067.                                  file in the list.
  3068.  
  3069.           <S>   - Tag Several:   Will allow you to enter a wildcard filespec
  3070.                                  for which files matching the spec will be
  3071.                                  tagged.  CATDISK's extended wildcards are
  3072.                                  valid here.
  3073.  
  3074.           <U>   - Untag Several: Will allow you to enter a wildcard filespec
  3075.                                  for which files matching the spec will be
  3076.                                  untagged.  CATDISK's extended wildcards are
  3077.                                  valid here.
  3078.  
  3079.           <I>   - Invert Tags:   Will "flip" the tagged status of each file in
  3080.                                  the list.  This is handy in a large list where
  3081.                                  you want to tag everything but a "select few."
  3082.                                  By tagging the "select few", and then using
  3083.                                  this option, you can quickly accomplish this
  3084.                                  feat.
  3085.  
  3086.           <Esc> - Exit:          Will exit the enhanced tagging options with no
  3087.                                  further action taken.
  3088.  
  3089.  
  3090.         Once you have the desired files tagged for cataloging, press <F10> to
  3091.         proceed with the operation.
  3092.  
  3093.         If you want to cancel the entire cataloging operation, press <Esc>.
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3100.  
  3101.                                       Page 46
  3102.  
  3103.  
  3104.  
  3105.         OPTION 5:  UNCATALOGING A DISK
  3106.  
  3107.         There may be times when you will wish to remove a disk's files from the
  3108.         catalog.  Select option <5> from the main menu, and you will be asked
  3109.         to enter the VOLUME NAME of the disk to be uncataloged.  Enter it and
  3110.         hit <Enter>.  If the volume label doesn't exist in the catalog, then
  3111.         you will be notified and returned to the main menu.
  3112.  
  3113.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  3114.         will bring up a point-and-shoot menu from which you can select a volume
  3115.         id from those in your current catalog.  See the section entitled
  3116.         "Selecting A Volume Name From A List" previously discussed in this user
  3117.         manual.
  3118.  
  3119.         If the volume label is found in the catalog, its entry will be deleted
  3120.         along with all the file names under it.
  3121.  
  3122.         If you do not wish to carry out this operation, hit <Esc> at the volume
  3123.         label prompt and no action will be taken.
  3124.  
  3125.         Should the disk become full during the catalog update process, the
  3126.         process will be aborted with an error message, and the old catalog file
  3127.         will remain intact.  Typically, this error should not occur, unless you
  3128.         have added more files to the disk, or another program has used up more
  3129.         disk space (such as a database expanding a file).  Should this error
  3130.         occur, the summary file will no longer contain a reference to the
  3131.         diskette that was uncataloged, but the catalog file will still contain
  3132.         references to that diskette.
  3133.  
  3134.         Should this be the case, you should either free up some space on the
  3135.         disk, or copy the .SUM and .DTA files to another disk (see CONFIGURING
  3136.         CATDISK for details on accessing catalog files on other drives and
  3137.         directories), catalog the diskette in question, and uncatalog it again.
  3138.         This will remove any references to that disk from the catalog file.
  3139.  
  3140.         If you do not have access to that disk any more (you may have erased
  3141.         it), simply take a blank diskette, add one file to it, and label it the
  3142.         same as the diskette you wish to uncatalog.  Carry out the above
  3143.         procedure, and you will obtain the same results.
  3144.  
  3145.         In practice, this should not happen, as you would have needed
  3146.         sufficient disk space to create the catalog file in the first place.
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3166.  
  3167.                                       Page 47
  3168.  
  3169.  
  3170.  
  3171.         OPTION F1: ADD/EDIT SUMMARY COMMENTS
  3172.  
  3173.         Selecting this option will activate the summary file comment editor.
  3174.         This is a very simple screen to operate.  Your disks currently
  3175.         cataloged will be listed on screen where you can scroll through the
  3176.         list and edit any comment as you deem necessary.
  3177.  
  3178.         Here's how the comment editor works:
  3179.  
  3180.         To change a comment, simply move the highlight to the disk entry that
  3181.         you wish to comment using the standard navigation keys, and start
  3182.         typing.
  3183.  
  3184.         While you are in the process of entering/editing the comment, a
  3185.         flashing "Edit" message will appear at right side of the headings.
  3186.         While you are in "edit" mode, the standard editing functions described
  3187.         earlier in "BASIC SKILLS: ENTERING KEYBOARD INPUT" are available.
  3188.  
  3189.         When you are finished editing the comment, hit the <Return> key.
  3190.  
  3191.         Here are some other options available in the comment editor:
  3192.  
  3193.         <F9>            will repeat the last entered comment.  This is handy if
  3194.                         you want to repeat a single comment at different places
  3195.                         in the list where <F10> (below) won't suffice, as  the
  3196.                         comment desired is not directly above the current
  3197.                         position.  If no comment was previously entered, or the
  3198.                         last entered comment was blank, nothing will happen.
  3199.  
  3200.                         NOTE: The "last comment" for disk entries is different
  3201.                               from the one remembered for the file entries
  3202.                               (discussed later on in this document).
  3203.  
  3204.         <F10>           will "Ditto":  Pressing this key will copy the comment
  3205.                         from the entry above.  It is handy if you want to copy
  3206.                         a comment down a consecutive list of disks, or one that
  3207.                         was already previously entered at an earlier time, if
  3208.                         it is directly above the current position.  If the
  3209.                         comment above is blank, or you are at the top of the
  3210.                         list, no action will be taken.
  3211.  
  3212.         <Esc>           Return to the main menu when you are done.
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3232.  
  3233.                                       Page 48
  3234.  
  3235.  
  3236.  
  3237.         OPTION 6:  ADD/EDIT COMMENTS BY VOLUME ID
  3238.  
  3239.         There are two basic places from where CATDISK's comment editor may be
  3240.         invoked:  1) At the end of a cataloging operation when AUTOCOMMENTS is
  3241.         turned on; and 2) As a result of option #6, option #7, option #8 or
  3242.         option #9 from the main menu.
  3243.  
  3244.         The actual functionality of the comment editor will be discussed later
  3245.         on in this section.
  3246.  
  3247.         If you select this option #6 from the main menu, you will be asked to
  3248.         specify a disk volume. Upon entry of such, CATDISK will go through the
  3249.         catalog and bring a group of files into the comment editor that
  3250.         currently reside on that disk volume.
  3251.  
  3252.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  3253.         will bring up a point-and-shoot menu from which you can select a volume
  3254.         id from those in your current catalog.  See the section entitled
  3255.         "Selecting A Volume Name From A List" previously discussed in this user
  3256.         manual.
  3257.  
  3258.         Here's how the comment editor works:
  3259.  
  3260.         To change a comment, simply move the highlight to the file entry that
  3261.         you wish to comment using the standard navigation keys, and start
  3262.         typing.
  3263.  
  3264.         While you are in the process of entering/editing the comment, a flasing
  3265.         "Edit" message will appear at right side of the headings.  While you
  3266.         are in "edit" mode, the standard editing functions described earlier in
  3267.         "BASIC SKILLS: ENTERING KEYBOARD INPUT" are available.
  3268.  
  3269.         When you are finished editing the comment, hit the <Return> key.
  3270.  
  3271.         Here are some other options available in the comment editor:
  3272.  
  3273.         <F2>            will repeat the comment on which the highlight bar
  3274.                         currently rests to all entries in the list of files.
  3275.                         If the currently highlighted comment is blank, a short
  3276.                         beep will sound and no further action will be taken.
  3277.                         This option provides a quick way to enter a single
  3278.                         comment for all files on an entire disk... just enter
  3279.                         the first one, re-highlight it and press <F5> to
  3280.                         duplicate it to each entry for that disk.  This option
  3281.                         is not shown at the bottom of the screen due to lack of
  3282.                         room on the instruction line.
  3283.  
  3284.         <F9>            will repeat the Last Entered Comment.  This is handy if
  3285.                         you want to repeat a single comment at different places
  3286.                         in the list where <F10> (see below) won't suffice, as
  3287.                         the comment desired is not directly above the current
  3288.                         position.  If no comment was previously entered, or
  3289.                         the last entered comment was blank, no action will be
  3290.                         taken.
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3298.  
  3299.                                       Page 49
  3300.  
  3301.  
  3302.  
  3303.         <F10>           will "Ditto":  Pressing this key will copy the comment
  3304.                         from the entry above.  It is handy if you want to copy
  3305.                         a comment down a consecutive list of files, or one that
  3306.                         was already previously entered at an earlier time, if
  3307.                         it is directly above the current position.  If the
  3308.                         comment above is blank, or you are at the top of the
  3309.                         list, no action will be taken.
  3310.  
  3311.         <Tab>           This will toggle the information shown on the left of
  3312.                         the comment area between three different formats, each
  3313.                         of which show different file information that may be
  3314.                         necessary to derive the desired comment.  This option
  3315.                         is not shown at the bottom of the screen due to lack of
  3316.                         room on the instruction line.
  3317.  
  3318.         <Esc>           Return to the main menu when you are done.
  3319.  
  3320.  
  3321.  
  3322.         OPTION 7:  ADD/EDIT COMMENTS BY FILESPEC
  3323.  
  3324.         If you select option #7 from the main menu, you will be asked for a
  3325.         filespec on which to base the search.  This filespec can be a based on
  3326.         CATDISK's enhancements to the DOS wildcard specifications (See option
  3327.         #0 (Reports And Inquiries), sub-option #4 (Show Files By Filespec) for
  3328.         a discussion of wildcard searching.  Once the catalog records are
  3329.         loaded into the comment editor according to your criteria, the same
  3330.         options that apply to option #6 apply here (see it for details).
  3331.  
  3332.  
  3333.         OPTION 8:  ADD/EDIT COMMENTS BY COMMENT
  3334.  
  3335.         If you select option #8 from the main menu, CATDISK will ask you for a
  3336.         comment spec on which to base the search.  Simply enter the sub-string
  3337.         for which you wish to search.  A discussion on how CATDISK matches
  3338.         comments can be found in the discussion on option #0 (Reports And
  3339.         Inquiries), sub-option #5 (Files by comment).  Once the catalog records
  3340.         are loaded into the comment editor according to your criteria, the same
  3341.         options that apply to option #6 apply here (see it for details).
  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) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3364.  
  3365.                                       Page 50
  3366.  
  3367.  
  3368.  
  3369.         OPTION 9:  IMPORT COMMENTS FROM A TEXT FILE
  3370.  
  3371.         Option #9, "Import Comments From A Text File", will allow you to bring
  3372.         in file comments from an external source, be it a BBS listing that
  3373.         you've either downloaded or captured with your communications package,
  3374.         or any file that contains plain text.  This file can contain anything:
  3375.         filesizes, dates, times, etc.  The only limitations are that the file
  3376.         contain no tabs, and that each line be no longer than 255 characters.
  3377.  
  3378.         Once you select option #9, a screen containing the controlling settings
  3379.         for the expected text file will appear. These settings can be stored in
  3380.         a setup file (profile) for later retrieval.  All profiles are stored in
  3381.         the same directory as your catalog files.  The settings eliminate the
  3382.         necessity to remember the settings for, say, several of the BBS systems
  3383.         that you call often.  You can enter the settings once, save them to a
  3384.         profile and be able to recall them later on.
  3385.  
  3386.         The first item on the screen indicates the current setup file being
  3387.         used for settings.  If you want the settings you enter to be saved to a
  3388.         different file than that shown, simply enter the desired filename
  3389.         (without any extension) and CATDISK will save it at the appropriate
  3390.         time.
  3391.  
  3392.         Retrieving and saving profiles is a simple matter of typing in the
  3393.         desired filename on the first line of the screen.  When you do so, you
  3394.         will be asked if you would like to read settings in from that file, or
  3395.         save the current ones to that file.  If you attempt to read in a
  3396.         profile that does not exist, you will be given an error message and no
  3397.         settings will be changed, but the name entered will be used for saving
  3398.         any changes made.  If, however, the file does exist and either a disk
  3399.         read error occurs or it is determined that the file is not a valid
  3400.         profile, the default settings (that which were supplied the first time
  3401.         you used this feature) will be brought in.
  3402.  
  3403.         If you wish to save the current settings to disk, CATDISK will first
  3404.         check to see if the file already exists.  If so, you will be given a
  3405.         warning to enable you to abandon the operation before you accidentally
  3406.         over-write a valuable program or data file.
  3407.  
  3408.         Any changes made in the settings during an import session will
  3409.         automatically be saved to the current profile on exit from the settings
  3410.         modification screen (via <Esc> or <F10>).  Again, if the file named in
  3411.         the first line exists, you will be given an overwrite warning in case
  3412.         you don't actually want to overwrite the current saved settings with
  3413.         the new ones (i.e. the import operation is a one-time shot in this
  3414.         case).
  3415.  
  3416.         The second item is the complete pathname of the textfile from which the
  3417.         comments will be read.
  3418.  
  3419.         The next 8 settings will depend on the characteristics of the file
  3420.         being read.  The pre-filled numbers assume that you are reading
  3421.         comments from CATDISK's own report printed to disk showing both
  3422.         statistics and comments.
  3423.  
  3424.         The first setting is the beginning and ending character positions of
  3425.         the filename as it appears on each line.  These settings are critical
  3426.         for CATDISK to be able to identify where to put each comment, and must
  3427.         contain a value greater than zero.
  3428.  
  3429.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3430.  
  3431.                                       Page 51
  3432.  
  3433.  
  3434.  
  3435.         The second setting is the beginning and ending character positions of
  3436.         the subdirectory, if it exists in the text file.  If the text file
  3437.         contains the subdirectory in which each file resides, you may include
  3438.         it with these settings, or if either the file does not contain
  3439.         subdirectory information, or you do not wish to use it, you may set the
  3440.         beginning and ending positions to zero.  CATDISK will then ignore them.
  3441.  
  3442.         The third setting is the beginning and ending character positions of
  3443.         the volume id, if it exists in the text file.  If the text file
  3444.         contains the volume id for the disk on which each file resides, you may
  3445.         include it with these settings, or if either the file does not contain
  3446.         this information, or you do not wish to use it, you may set the
  3447.         beginning and ending positions to zero.  CATDISK will then ignore them.
  3448.  
  3449.         Finally, the last setting is the starting and ending character
  3450.         positions of the file comment.  These values must also be set to
  3451.         something that is greater than zero, as CATDISK needs a comment to
  3452.         insert for each file that it finds in your catalog file.
  3453.  
  3454.         The easiest way to determine the appropriate settings for the text file
  3455.         you will be importing is to first load it into your favorite text
  3456.         editor.  Place the cursor on the beginning and ending characters of the
  3457.         various items discussed above, and note what column the editor
  3458.         indicates that the current cursor position is.  These will be the
  3459.         values that you will fill in to the control screen.
  3460.  
  3461.         Here are a few important notes regarding the text file.  There is
  3462.         really no need to edit blank lines and headings out of the file before
  3463.         processing, as the chances of CATDISK matching a filename, subdirectory
  3464.         and volume id found in the appropriate character positions in a heading
  3465.         with a file entry in the catalog file are quite slim.  It is important
  3466.         that each data line (not the headings) in the file be structured the
  3467.         same way (i.e. all the columns line up as in a report).  If this is not
  3468.         the case, chaos in the comments fields in the affected files will
  3469.         result.  Lastly, CATDISK has an internal limitation of being able to
  3470.         read in only the first 32,767 non-blank lines in the file.  The rest
  3471.         will be ignored.
  3472.  
  3473.         All this said, changing the settings is a matter of using the <Up> and
  3474.         <Down> arrow keys to highlight the desired setting, typing the new
  3475.         information for that setting and hitting <Enter>.  Pressing <Esc> when
  3476.         not editing a setting will return you to the menu with no further
  3477.         action taken.
  3478.  
  3479.         Once you have all the desired settings ready, press <F10> to initiate
  3480.         the insertion of comments in the catalog file.  CATDISK will then
  3481.         present you with a small menu outlining three possible courses of
  3482.         action to take when it finds a matching file:
  3483.  
  3484.         1) Do not overwrite existing comments.
  3485.         2) Overwrite existing comments.
  3486.         3) Append to existing comments.
  3487.  
  3488.         These options should be self-explanatory.
  3489.  
  3490.         You may also press <Esc> at this menu to abandon the procedure and
  3491.         return to the settings screen.
  3492.  
  3493.  
  3494.  
  3495.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3496.  
  3497.                                       Page 52
  3498.  
  3499.  
  3500.  
  3501.         Here's how CATDISK goes about importing comments.  First, it will read
  3502.         and sort all the entries in the text file.  If CATDISK cannot find the
  3503.         text file, if there is an error in reading the text file, or there is
  3504.         an error in sorting the entries, the process will be aborted.  If the
  3505.         sort is successful, CATDISK will scan your current catalog file for
  3506.         matching entries from the text file.
  3507.  
  3508.         For each match that CATDISK finds, it will look at the existing comment
  3509.         attached to the file entry.  Depending on your choice from the comment
  3510.         override selections mentioned above, CATDISK will take appropriate
  3511.         action.  If the existing comment is blank or you have indicated that
  3512.         CATDISK should overwrite existing comments (selection #2), CATDISK will
  3513.         place the comment found in the text file into the comment field of the
  3514.         catalog entry.  If you chose to append to existing comments, CATDISK
  3515.         will add the comment from the text file to the one that already exists
  3516.         in the catalog file and will separate the new material from the old
  3517.         with a space.  Note in all cases, CATDISK will not put more than 43
  3518.         characters into the comment in the catalog.
  3519.  
  3520.         Once this process has completed, a list of the modified entries will be
  3521.         brought into the comment editor for "massaging" so that you may clean
  3522.         up any entries.  It is highly recommended that you at least go through
  3523.         the list just to make sure that everything went ok.  See the discussion
  3524.         for option #7 - ADD/UPDATE COMMENTS BY FILESPEC for details on how the
  3525.         comment editor works.
  3526.         
  3527.         
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3562.  
  3563.                                       Page 53
  3564.  
  3565.  
  3566.  
  3567.         OPTION 0: REPORTS & INQUIRIES MENU
  3568.  
  3569.         This menu outlines the complete range of screen or printer-based
  3570.         reports that CATDISK is capable of generating.  Selection of an option
  3571.         from this menu is by conventional means as outlined in the section
  3572.         "Using The Menus" earlier on in this user manual.
  3573.  
  3574.         Note that if you have the Report Totals setting turned on, CATDISK will
  3575.         show totals for various items on screen reports, and at the end of
  3576.         disk-based and printer-based reports.
  3577.  
  3578.  
  3579.         Screen-based reports
  3580.         --------------------
  3581.  
  3582.         When viewing a report on your screen, you can move up and down through
  3583.         the report by using the standard navigation keys discussed earlier in
  3584.         this manual.
  3585.  
  3586.         The following features are also available in ALL screen based reports:
  3587.  
  3588.           <Esc>         - return to the menu.
  3589.  
  3590.           <Tab>         - switch between four different screen report formats
  3591.                           as follows:
  3592.  
  3593.                           1) The default format shows Filename, Volume ID,
  3594.                              Archive ID, Size, Date, Time and Dos File
  3595.                              Attributes.
  3596.                           2) Shows Subdirectory, Filename, Volume ID, Archive
  3597.                              ID, Size, Date, and Time.  This corresponds to the
  3598.                              /L1 option when starting CATDISK.
  3599.                           3) Shows Filename, Volume ID, Archive ID and File
  3600.                              comments.  This corresponds to the /L2 option.
  3601.                           4) Shows Subdirectory, Filename, Volume ID, Archive
  3602.                              ID and a slightly truncated file comment.  This
  3603.                              corresponds to the /L3 option.
  3604.  
  3605.           <Ctrl>-<X>    - Immediately exit from CATDISK and return to DOS.
  3606.  
  3607.         To jump quickly to a section in a file-based report, you may press any
  3608.         letter, number or punctuation key (except PLUS and MINUS, as they are
  3609.         already used elsewhere).  You will be immediately positioned in the
  3610.         report at the point where the primary item on which the report is
  3611.         sorted begins with that letter.
  3612.  
  3613.         With the following exceptions, all reports are primarily sorted on
  3614.         filename:
  3615.  
  3616.         1) Sorted Full File Listings.  The primary sort key will be the item
  3617.            listed beside the option in the Sorted Full File Listings menu.
  3618.            Reports sorted on items such as date/time, filesize or subdirectory
  3619.            will not have the ability to jump quickly in this manner, although
  3620.            all other options will.
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3628.  
  3629.                                       Page 54
  3630.  
  3631.  
  3632.  
  3633.         2) Custom reports.  The item with the lowest numbered column spec that
  3634.            also has a sort key specified will be the primary sort key.  Reports
  3635.            sorted on items such as date/time, file size, file attribute or
  3636.            subdirectory will not have the ability to jump quickly in this
  3637.            manner, although all other types of reports will have this ability.
  3638.  
  3639.         3) Disk Summary Report.  When sorted on volume label, the capability
  3640.            will exist.  When sorted on descending free space, the capability
  3641.            will not exist.
  3642.  
  3643.  
  3644.         Printer-Based Reports
  3645.         ---------------------
  3646.  
  3647.         Before any printing takes place, you will be asked for the page number
  3648.         from which you wish CATDISK to start printing the report.  This prompt
  3649.         is provided to allow you to resume printing a report that was
  3650.         interrupted for any reason at the point of interruption (or at least at
  3651.         a page break).  To start printing at the beginning of the report, just
  3652.         accept the default of "Page 1."
  3653.  
  3654.         If you have activated the two-sided report feature of CATDISK, the odd
  3655.         numbered pages will be printed first, followed by a pause enabling you
  3656.         to reload the paper such that the even numbered pages will print on the
  3657.         back side of the odd numbered pages, followed by the even numbered
  3658.         pages.
  3659.  
  3660.         One consideration when entering the page numbers above.  If you have
  3661.         the two-sided report feature activated and you enter an odd number for
  3662.         the page, the odd-numbered pages will follow in suit, followed by ALL
  3663.         even numbered pages, as it is assumed that none of them were yet
  3664.         printed.  If you enter an even page number with two-sided reports
  3665.         active, none of the odd-numbered pages will be printed at all, as it is
  3666.         assumed that they were already printed.
  3667.  
  3668.         As the report is printed, the filenames or disk volumes (as appropriate
  3669.         for the report) will be echoed to your screen to keep you informed as
  3670.         to CATDISK's progress.
  3671.  
  3672.         While a report is being printed, you may press <Esc> to abandon it.
  3673.  
  3674.  
  3675.         Disk-Based Reports
  3676.         ------------------
  3677.  
  3678.         Disk reports are treated the same as printer reports, with the
  3679.         exception that the two-sided report feature does not apply.
  3680.  
  3681.         A listing in the same format as the hardcopy report will be produced in
  3682.         a diskette file.  The default name for this file is one with the same
  3683.         name as the current catalog filename with an extension of ".LST".  This
  3684.         may be overridden at the time that the report is generated.  Hitting
  3685.         <Esc> at any time during the generation of the report will abort it and
  3686.         return to the previous menu.
  3687.  
  3688.         Page breaks are normally denoted in the disk file by a row of dashes.
  3689.         When a report to disk is selected, and your page length is set to a
  3690.         non-zero value in the CDISKCFG utility, you will be asked if you would
  3691.         like page breaks to be denoted by a formfeed character instead.
  3692.  
  3693.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3694.  
  3695.                                       Page 55
  3696.  
  3697.  
  3698.  
  3699.         Sub-Option #1: Disk Summary
  3700.         ---------------------------
  3701.  
  3702.         Selection of sub-option #1 from the reports menu will cause CATDISK to
  3703.         display an alphabetical list of VOLUME NAMES and some pertinent
  3704.         statistical information  for each.  This option is handy if, say, you
  3705.         have a bunch of utility disks and want to add a 14K utility program to
  3706.         one of them.  This report can be quite useful in making efficient use
  3707.         of existing working diskettes.
  3708.  
  3709.         All the statistical items shown should be self-explanatory, except one;
  3710.         that is, the Slack % factor.  The disks on which DOS stores it files
  3711.         are divided into allocation units called clusters.  The size of each
  3712.         cluster varies with the type and size of disk.  When DOS allocates
  3713.         space on a disk for a file, it is allotted in one cluster units to the
  3714.         file.  Some common cluster sizes are 512 bytes on 160-180K diskettes,
  3715.         and 1024 bytes on 320-360K diskettes.  Some hard disks have larger
  3716.         cluster sizes.
  3717.  
  3718.         Anyway, let's say, for example, that you have a file of 256 bytes.  On
  3719.         a 360K diskette, DOS will allocate 1024 bytes to the file, even though
  3720.         it is only 256 bytes long.  This means that three-quarters of that
  3721.         cluster is unused, or that you have 75% slack for that file.  The
  3722.         figure that you see on the summary report is the overall slack
  3723.         percentage of all the files on the disk.
  3724.  
  3725.         Depending on where you have set your output destination, the following
  3726.         options are applicable:
  3727.  
  3728.         NOTE:   If you select a printer or disk-based report from CATDISK,
  3729.                 you will be asked if you would like the report to be sorted on
  3730.                 volume ID or by descending free disk space.  Simply hit <V> for
  3731.                 the volume ID sort, or hit <F> for the descending free disk
  3732.                 space report.  Hitting <Esc> at this prompt will cause the
  3733.                 report to be aborted.
  3734.  
  3735.         NOTE:   You can have the screen-based report sorted by either volume
  3736.                 label or by descending free disk space.  You can toggle between
  3737.                 the two by pressing the <Space Bar>.  The starting order in
  3738.                 which the report will appear can be controlled with the /SL
  3739.                 command line option at startup.
  3740.  
  3741.     
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3760.  
  3761.                                       Page 56
  3762.  
  3763.  
  3764.  
  3765.         Sub-option #2: Files For A Volume
  3766.         ---------------------------------
  3767.  
  3768.         Selecting sub-option #2 will cause CATDISK to display an alphabetical
  3769.         list of files for a particular disk.  If you have the report
  3770.         destination set to "ASK", you will be asked for a report location.
  3771.  
  3772.         After the report destination is established, you will be asked for a
  3773.         volume ID upon which to base the report.  The default is "*", which
  3774.         will include files from all volumes.
  3775.  
  3776.         Simply enter the desired volume specification (you may enter a specific
  3777.         volume name or use CATDISK's enhanced wildcard specifications) and hit
  3778.         <Return>. Hit <Esc> to return to the menu without producing a report.
  3779.  
  3780.         If you enter an exact entry, CATDISK will first find it in the summary
  3781.         file.  If it does not exist, you will be notified, and the catalog scan
  3782.         will not even take place.
  3783.  
  3784.         Optionally, you can leave the volume ID blank (just erase anything
  3785.         showing in the prompt).  CATDISK will bring up a point-and-shoot menu
  3786.         from which you can select a volume id from those in your current
  3787.         catalog.  See the section entitled "Selecting A Volume Name From A
  3788.         List" previously discussed in this user manual.
  3789.  
  3790.  
  3791.         Sub-option #3: Files For An Archive
  3792.         -----------------------------------
  3793.  
  3794.         Selecting this report will cause CATDISK to display an alphabetical
  3795.         list of files for a particular archive.  If you have the report
  3796.         destination set to "ASK", you will be asked for a report location.
  3797.         After the report destination is established, you will be asked for a
  3798.         Archive to list.
  3799.  
  3800.         The default is "*", which will include all files occurring in archives.
  3801.         Simply enter the desired archive spec (exact name or CATDISK's enhanced
  3802.         wildcard specification) and hit <Return>, or hit <Esc> to return to the
  3803.         menu without producing a report.
  3804.  
  3805.         Under normal circumstances, any files that are not contained in archive
  3806.         files will not appear in this report.  You must specifically ask for
  3807.         "........" (without the quotes) to get a listing of files that did not
  3808.         come from archives (i.e. Archive ID is "........" in the listing).
  3809.  
  3810.  
  3811.         Sub-option #4: Files By Filespec
  3812.         --------------------------------
  3813.  
  3814.         Selecting sub-option #4 will cause CATDISK to display an alphabetical
  3815.         list of files for a DOS or a CATDISK enhanced wildcard spec.  If you
  3816.         have the report destination set to "ASK", you will be asked for a
  3817.         report location.  After the report destination is established, you will
  3818.         be asked for a filespec.
  3819.  
  3820.         The default is "*.*", which will include all files.  You may enter an
  3821.         exact filename, or a CATDISK enhanced wildcard specification.
  3822.  
  3823.         Hit <Esc> to return to the menus without generating a report.
  3824.  
  3825.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3826.  
  3827.                                       Page 57
  3828.  
  3829.  
  3830.  
  3831.         Sub-option #5: Files By Subdirectory
  3832.         ------------------------------------
  3833.  
  3834.         Selecting sub-option #5 will bring up an alphabetical list of files for
  3835.         a DOS or a CATDISK enhanced wildcard subdirectory specification. When
  3836.         specifying the desired directory to list, NO NOT INCLUDE THE "\" or "~"
  3837.         in the name - CATDISK only processes the name portion of the
  3838.         subdirectory entry in the catalog.
  3839.  
  3840.         If you have the report destination set to "ASK", you will be asked for
  3841.         a report location.  After the report destination is established, you
  3842.         will be asked for the desired subdirectory.  This specification follows
  3843.         the conventional DOS filespec search conventions including wildcard
  3844.         searches as well as the enhanced features that CATDISK offers.  Details
  3845.         on wildcard searches may be found in the section of this manual dealing
  3846.         with the "Files by Filespec" report.
  3847.  
  3848.         Hit <Esc> to return to the menus without generating a report.
  3849.  
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3892.  
  3893.                                       Page 58
  3894.  
  3895.  
  3896.  
  3897.         Sub-option F1: Files By Comment Text
  3898.         ------------------------------------
  3899.  
  3900.         Selecting sub-option #5 will cause CATDISK to display a list of files
  3901.         in accordance with a comment search spec that you supply.  Although
  3902.         CATDISK supports comments of 43 characters in length, the search spec
  3903.         is currently limited to 35 characters, which should suffice for all
  3904.         options.  After selecting a report destination, you will be asked for a
  3905.         comment search spec that you wish the report to be based on.
  3906.  
  3907.         Just enter the string that you want to search for in the catalog's
  3908.         comments section and hit <Enter>, or hit <Esc> to abort the process
  3909.         without generating a report.
  3910.  
  3911.         Here's how the comments are sourced for your search spec.  You enter a
  3912.         "phrase" or "substring" that you want to search for in the file
  3913.         comments.
  3914.  
  3915.         The "phrase" may be an entire comment that you want, it can be just one
  3916.         word, or even just one letter.  When CATDISK compares your "phrase" to
  3917.         a comment, it checks to see if that "phrase" is contained anywhere in
  3918.         that comment.  If it does, that file will appear in your report.
  3919.  
  3920.         Example:   "SOURCE" would match:    CATDISK V4.13 source code
  3921.                                             CATDISK V4.13 Source code
  3922.                                             CATDISK V4.13 SOURCE CODE
  3923.                                             Source
  3924.                                                      ... etc ...
  3925.  
  3926.         Leaving the comment entry blank will produce a report containing only
  3927.         the catalog entries that have no comment.
  3928.  
  3929.         Please note:  Several users have asked for wild cards in the comment
  3930.         search (eg.  they might not know whether they had "Word Processor" or
  3931.         "Word Proc" for a comment).  This is not really necessary in this case,
  3932.         as, in the above case, entering "PROC" would match both comments.
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  3958.  
  3959.                                       Page 59
  3960.  
  3961.  
  3962.  
  3963.         Sub-option F3:  Files By Comment Keywords
  3964.         -----------------------------------------
  3965.  
  3966.         Upon selecting <F1> from the reports menu, CATDISK will ask you for one
  3967.         or more keywords to match when generating the report.  All keywords are
  3968.         entered on one line, each separated by a space.  The maximum length of
  3969.         this line is 35 characters.
  3970.  
  3971.         Unlike the "Files By Comment Text" report mentioned earlier in this
  3972.         manual, the keyword report will scan through your file comments and
  3973.         look for whole words instead of looking for the text anywhere in the
  3974.         comment.
  3975.  
  3976.         For example, entering "PROCESS" for a keyword would cause a match in
  3977.         the comment "PROCESS CONTROL", but would not cause a match in the
  3978.         comment "WORD PROCESSOR" due to the fact that the "PROCESS" in
  3979.         "PROCESSOR" is not a stand alone word.
  3980.  
  3981.         You can have CATDISK perform the matching operations on multiple
  3982.         keywords by entering them all on the specification line, each separated
  3983.         by a space.  If CATDISK detects that you are looking for more than one
  3984.         keyword, you have two choices on how those keywords will be processed
  3985.         when evaluating a match with a file comment.
  3986.  
  3987.         You will see the prompt:
  3988.  
  3989.             Match Just <O>ne of These Keywords or <A>ll of Them? <O/A>
  3990.  
  3991.         By answering:
  3992.  
  3993.         O) You can have CATDISK assume a match if any one of the keywords are
  3994.            found in the comment.  You may also press the <1> key (instead of
  3995.            the first letter of the word ONE).
  3996.  
  3997.            eg. Keywords:  CATDISK SUMMARY
  3998.                Comment :  CATDISK Summary File For Games   - Match!
  3999.                Comment :  Summary of Monthly Sales         - Match!
  4000.                Comment :  3.. 2.. 1.. Blastoff!            - No Match
  4001.  
  4002.         A)  You can tell CATDISK to include a file in the report only if ALL
  4003.             keywords are found in the comment.  If one or more keywords are not
  4004.             present in the comment, the file will not appear in the report.
  4005.  
  4006.             Using the examples from the previous choice will show the
  4007.             difference in how the comments are evaluated.
  4008.         
  4009.            eg. Keywords:  CATDISK SUMMARY
  4010.                Comment :  CATDISK Summary File For Games   - Match!
  4011.                Comment :  Summary of Monthly Sales         - No Match
  4012.                Comment :  3.. 2.. 1.. Blastoff!            - No Match
  4013.  
  4014.            The second comment does not match under the second criteria due to
  4015.            the fact that the word Summary is present, but the word CATDISK is
  4016.            not.
  4017.  
  4018.  
  4019.         Having both a comment text report and a separate keyword-based report
  4020.         gives you full flexibility in searching for files by comment.
  4021.  
  4022.  
  4023.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4024.  
  4025.                                       Page 60
  4026.  
  4027.  
  4028.  
  4029.         Sub-option #6:  Files By Comment/Filename Text
  4030.         ----------------------------------------------
  4031.  
  4032.         This report is very similar to the Files By Comment Text report except
  4033.         that the filename is also searched for any occurrences of the search
  4034.         spec.  See details on the "Files By Comment Text" report in this user
  4035.         manual for details on how text is compared to determine whether or not
  4036.         a given file should appear in the report.
  4037.  
  4038.  
  4039.         Sub-option #7: Unique Files Only & Sub-option #8: Duplicate Files Only
  4040.         ----------------------------------------------------------------------
  4041.  
  4042.         Selecting sub-option #8 will cause CATDISK to display a listing of
  4043.         files in your catalog that exist only once.  Selecting sub-option #9
  4044.         will cause CATDISK to display a listing of files that occur more than
  4045.         once in your catalog.
  4046.  
  4047.         The criteria for these two reports is based solely on the filename, and
  4048.         optionally, on the file size (you will be asked whether or not you want
  4049.         it to be included before the catalog scan takes place), and not other
  4050.         items such as subdirectory, file date or file size.  you will be given
  4051.         the option to include or not to include the file size as a criteria in
  4052.         determining a file's uniqueness when you initiate one of these two
  4053.         sub-options.
  4054.  
  4055.         When either of these reports is generated, a full scan will be made
  4056.         through the catalog file to determine which files should be included in
  4057.         the report.  The reason for this is due to the method that CATDISK uses
  4058.         in comparing filenames to determine whether they are duplicate or
  4059.         unique.
  4060.  
  4061.         If, during the scanning process, CATDISK runs into a disk problem, the
  4062.         report will be aborted.
  4063.  
  4064.         Due to the method by which CATDISK scans the catalog, there is a
  4065.         possibility that duplicate files may appear in the unique file reports
  4066.         and vice versa when file size is used as a criteria if the given
  4067.         entries being compared are not right together in the catalog file.  An
  4068.         example may make this clearer:
  4069.  
  4070.         Filename.Ext  Volume ID    File Size
  4071.  
  4072.         TEST    .GIF  GIF0001        123,456
  4073.         TEST    .GIF  GIF0002        123,789
  4074.         TEST    .GIF  GIF0003        123,456
  4075.  
  4076.         In the unique file report, for example, if the file size is omitted
  4077.         from the search criteria, the report will show none of the above three
  4078.         files, which would be correct.
  4079.  
  4080.         If, however, the file size is included, all three of the files will
  4081.         show up due to the fact that the second entry in the file list has a
  4082.         different file size.  The first file is compared to the second one, and
  4083.         the second one is compared to the third during the sequential search of
  4084.         the catalog.  Due to the possibility that there can be many files of
  4085.         the same name occurring in the catalog file, this cannot be currently
  4086.         circumvented.
  4087.  
  4088.  
  4089.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4090.  
  4091.                                       Page 61
  4092.  
  4093.  
  4094.  
  4095.         A similar situation can happen in the duplicate files report.  Leaving
  4096.         the file size out of the criteria will yield the correct results.
  4097.         Including it may cause all three files to be left out of the report for
  4098.         the same reasons as in the unique file report.
  4099.  
  4100.  
  4101.  
  4102.         Sub-option #9: Volume Summary/Contents
  4103.         --------------------------------------
  4104.  
  4105.         This report is like combining the summary report with a full file
  4106.         listing.  CATDISK will print each line from your summary report,
  4107.         followed by a complete listing of files contained on that disk.
  4108.  
  4109.         Due to the nature of this report and the methodology that CATDISK uses
  4110.         to generate it, it is not possible to view this report on your screen.
  4111.         A printer location or a disk file must be selected in order to produce
  4112.         this report.
  4113.  
  4114.         If you instruct CATDISK to send this report to the screen, you will get
  4115.         an error message informing you of the above requirements.
  4116.  
  4117.  
  4118.         Sub-option #0:  Sorted Full File Listings
  4119.         -----------------------------------------
  4120.  
  4121.         This option, if viewed on the screen will product a report in the same
  4122.         manner as sub-option #4, except that ALL files in the catalog will be
  4123.         included in the list.  It is similar to choosing sub-option #4 and
  4124.         searching for "*.*".
  4125.  
  4126.         If you have the report destination set to "ASK", you will be asked for
  4127.         a report location before any further action takes place.
  4128.  
  4129.         You may sort the full list on various criteria.  Currently, you can
  4130.         sort by filename, file extension, subdirectory, volume id, archive id,
  4131.         comment, file date/time (descending order), or file size (descending or
  4132.         ascending order).
  4133.  
  4134.         To select a criteria, simply hit the number beside it, or select it
  4135.         from the menu using CATDISK's menu selection methods.  The rest is
  4136.         automatic.
  4137.  
  4138.         If, during the sorting phase, which occurs for each option, with the
  4139.         exception of option #1, an error occurs, the process will be aborted
  4140.         and no report will be generated.
  4141.  
  4142.  
  4143.         Sub-option <Esc>: Return To Main Menu
  4144.         -------------------------------------
  4145.  
  4146.         Hitting <Esc> will return you to CATDISK's main menu.
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4156.  
  4157.                                       Page 62
  4158.  
  4159.  
  4160.  
  4161.         Sub-option F2: Custom Reports
  4162.         -----------------------------
  4163.  
  4164.         The Report Selection Screen
  4165.         ---------------------------
  4166.  
  4167.         The first screen that you will see upon selecting this option (after
  4168.         selecting a report location) is the list of available reports with the
  4169.         first line being an option to define a new report.  It is from this
  4170.         screen that you may create new reports, re-define any existing ones,
  4171.         delete reports from the list or select a report to create.
  4172.  
  4173.         You may define any number of reports, the only limitation being
  4174.         available disk space.  They will be kept in a file called
  4175.         "CATDISK.RPT", which is stored in the catalog file directory (the same
  4176.         directory in which your catalog files are stored).
  4177.  
  4178.         You can move through the list by using the standard navigation keys.
  4179.  
  4180.         To define a new report, move the highlight bar up to the top of the
  4181.         list so that the entry <Create New Report> is highlighted.  Now, hit
  4182.         either <F2> or the <Enter> key.  You will be brought into the report
  4183.         criteria editor, which will be discussed a bit later.
  4184.  
  4185.         To modify an existing report, highlight that report and hit the <F2>
  4186.         key.  The report specification will be brought into the report criteria
  4187.         editor, which is discussed a bit later.
  4188.  
  4189.         To delete a report, highlight that report and hit <Alt>-<D>.  The
  4190.         report will be immediately deleted, so use this option with caution.
  4191.  
  4192.         To generate a previously defined report, highlight that report and
  4193.         press the <Enter> key.  You will be asked if you wish to make any
  4194.         temporary changes to the report.  If you wish to produce the report as
  4195.         defined, answer "NO" to the question.  If you answer YES, the report
  4196.         definition screen will appear from which you may make any one-time
  4197.         changes for the current run of the report.  These changes will not be
  4198.         permanently saved.
  4199.  
  4200.         To return to the reports menu, hit the <Esc> key.
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4222.  
  4223.                                       Page 63
  4224.  
  4225.  
  4226.  
  4227.         Defining A Report
  4228.         -----------------
  4229.  
  4230.         The report definition screen is divided into five areas:
  4231.  
  4232.         1) The report title.
  4233.         2) The selection specifications.
  4234.         3) The selection criteria.
  4235.         4) The column specifications.
  4236.         5) The sort specifications.
  4237.  
  4238.         Items 2 and 3 work together in tandem, as do items 4 and 5.  Note that
  4239.         selection criteria for the file time and attribute are not available,
  4240.         nor is a criteria for the comment (as denoted by the fine periods
  4241.         filling the item.  The former two are present to accommodate inclusion
  4242.         in the report columns.
  4243.  
  4244.         To change an entry, use the cursor keypad to move the highlight around
  4245.         the screen.  Detailed editing instructions for each field will appear
  4246.         in the instruction area at the bottom of the screen.
  4247.  
  4248.         We will now discuss the five areas of this screen and how they affect
  4249.         the output and appearance of the report.
  4250.  
  4251.         1) Title
  4252.  
  4253.            The entered title will appear at the top of each page of the
  4254.            generated report when sent to disk or printer.
  4255.  
  4256.         2) Selection Specifications
  4257.  
  4258.            By default, all specifications are blank.  As such, CATDISK will not
  4259.            check to see if a catalog entry "fits" that description.  The entry
  4260.            will automatically "pass" that check.  If, however, you fill in a
  4261.            spec for a particular item, it will be checked in accordance with
  4262.            its corresponding selection criteria, which will appear immediately
  4263.            beside it.  If the catalog entry "passes" all tests which have
  4264.            criteria filled in it will be included in the report.
  4265.  
  4266.            When filling out filespecs, subdirectories, volume labels and
  4267.            archive specs, you may use CATDISK's wildcard matching conventions.
  4268.            Other specifications are entered verbatim.  When entering a comment
  4269.            specification, you should be aware that comments are evaluated in
  4270.            the same manner as that of the "Files By Comment" report.
  4271.  
  4272.            To clear out a specification, just fill it with spaces.
  4273.  
  4274.         3) Selection Criteria
  4275.  
  4276.            For each non-blank selection specification entered, a selection
  4277.            criteria will appear beside it.  Possible "values" for the selection
  4278.            criteria (which are self-explanatory) may be as follows:
  4279.  
  4280.            Equal To
  4281.            Not Equal To
  4282.            Less Than
  4283.            Less Than or Equal To
  4284.            Greater Than
  4285.            Greater Than or Equal To
  4286.  
  4287.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4288.  
  4289.                                       Page 64
  4290.  
  4291.  
  4292.  
  4293.            If a selection specification contains wildcard specifications (i.e.
  4294.            contains the characters "?" or "*"), only the first two "values"
  4295.            will be applicable.  If the selection specification is exact, all 6
  4296.            may be possible.
  4297.  
  4298.            To change the selection criteria, hit the <Space Bar> when it is
  4299.            highlighted.  CATDISK will cycle through the possible choices, based
  4300.            on the above discussion.
  4301.  
  4302.         4) Column Specifications
  4303.  
  4304.            The column specifications will allow you to control which items from
  4305.            each catalog entry will appear in your report, and in which order.
  4306.  
  4307.            Fill in a number from 1 to 9 for each item that you wish to appear
  4308.            in the report.  The lowest numbered item will comprise the leftmost
  4309.            column, the second lowest numbered item will be next, and so on to
  4310.            the highest numbered item, which will be the rightmost item.
  4311.  
  4312.            Any item that is blank will be omitted from the report.
  4313.  
  4314.            To change the column spec, just hit the key of the number which you
  4315.            wish to assign to the spec.  If you try to duplicate a number that
  4316.            has already been assigned, the duplicate will be rejected with a
  4317.            beep.  To clear out a spec, enter <0> for it or hit the <Space Bar>.
  4318.  
  4319.            Note that it is possible to define a report that will be wider than
  4320.            the screen's width.  A screen-based report may be up to 78
  4321.            characters wide.  Any excess characters will be trimmed.
  4322.  
  4323.            When sending a report to your printer, CATDISK will assume that you
  4324.            have your printer appropriately set up (either via the printer setup
  4325.            codes) or via the control panel on the printer itself.
  4326.  
  4327.         5) Sort Specifications
  4328.  
  4329.            These settings determine the order in which the catalog entries will
  4330.            appear in your report.  Possible settings for the sort specs are:
  4331.  
  4332.            Blank            - don't bother sorting on this item
  4333.            Ascending Order  - sort this item in order from lowest to highest.
  4334.            Descending Order - sort this item in order from highest to lowest.
  4335.  
  4336.            You may specify more than one item as a sort spec, as long as it has
  4337.            a column spec assigned to it.  The lowest numbered sort
  4338.            specification will be the primary key, the next lowest specification
  4339.            will be the next key, and so on.  The second key will only be used
  4340.            if the first item of catalog items being compared are the same.  A
  4341.            third key would be used (if specified) only if the first two items
  4342.            are the same.
  4343.  
  4344.            Note that there is no sort criteria for file attribute or file time.
  4345.            In the case of file time, a sort criteria set on the file date will
  4346.            also result in all files from that date also being sorted in the
  4347.            appropriate order by file time.
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4354.  
  4355.                                       Page 65
  4356.  
  4357.  
  4358.  
  4359.            To illustrate an example, suppose you have the setup:
  4360.  
  4361.            Item        Col  Sort Spec
  4362.  
  4363.            Filename:    2   Descending Sort
  4364.  
  4365.            Volume ID:   1   Ascending Sort
  4366.  
  4367.            A snippet of a report might show up as:
  4368.  
  4369.            Volume ID   Filename.ext
  4370.  
  4371.            DISK00001   BBBBB   .ZIP
  4372.            DISK00002   DDDDD   .ZIP
  4373.            DISK00003   CCCCC   .ZIP
  4374.            DISK00003   AAAAB   .ZIP
  4375.            DISK00003   AAAAA   .ZIP
  4376.            DISK00004   HHHHH   .ZIP
  4377.            DISK00004   GGGGG   .ZIP
  4378.  
  4379.            Note that where the volume id is the same in DISK00003 and
  4380.            DISK00004, the filenames within that item are then sorted in
  4381.            descending order as per the column sort specs.
  4382.  
  4383.  
  4384.         The best way to familiarize yourself with CATDISK's custom reporting
  4385.         facility is to experiment with it.  You will do no harm to your data
  4386.         files, and you can always delete any erroneous reports from the list or
  4387.         correct them at a later time.  The flexibility of this custom reporting
  4388.         facility is almost unlimited in its capability.  About the only thing
  4389.         that cannot be evaluated here is whether or not a file is a duplicate.
  4390.         We provide the "canned" reports to handle this special case.
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4420.  
  4421.                                       Page 66
  4422.  
  4423.  
  4424.  
  4425.         OPTION <F4> - TEMPORARILY EXIT TO DOS
  4426.         -------------------------------------
  4427.  
  4428.         This option, although not really necessary, has been added in response
  4429.         to the numerous requests that we have had for this feature.  By
  4430.         selecting this option, CATDISK will be temporarily suspended and you
  4431.         will be returned to the DOS prompt.  You may carry out any normal
  4432.         function that you would ordinarily be able to carry out from DOS,
  4433.         provided that there is enough memory remaining in which to run your
  4434.         desired program.
  4435.  
  4436.         When you are finished with DOS, and wish to return to CATDISK, simply
  4437.         type "EXIT" and hit <Return> to return to CATDISK.  Please be sure and
  4438.         replace any disks that you had in your drives before returning to
  4439.         CATDISK.
  4440.  
  4441.         Note that although the <F4> option does not appear on any of CATDISK's
  4442.         other menus (settings & toggles, reports & inquiries, or the report
  4443.         destination selection menu), you may press <F4> from any of these menus
  4444.         to temporarily exit to DOS.  When you return from DOS, you will be
  4445.         returned to the particular menu from which you shelled out to DOS.
  4446.  
  4447.         Possible errors that you may encounter when you use can vary greatly.
  4448.  
  4449.         Possibilities are:  1) There is not enough memory to load a second copy
  4450.                                of the command interpreter (usually
  4451.                                COMMAND.COM), or that memory has been corrupted
  4452.                                by a resident program.
  4453.  
  4454.                             2) If you get an error after returning from DOS, it
  4455.                                usually means that you've loaded a resident
  4456.                                program while out in DOS.  You should refrain
  4457.                                from doing so.
  4458.  
  4459.                             3) Another possibility is that CATDISK was unable
  4460.                                to find the command interpreter (usually
  4461.                                COMMAND.COM) on the drive and directory defined
  4462.                                by the COMSPEC environment string (see the DOS
  4463.                                manual for details on the SET command).  This is
  4464.                                usually set to the location from which
  4465.                                COMMAND.COM was loaded when the system was
  4466.                                booted. If COMMAND.COM was not found at the boot
  4467.                                location, the root directory of the current
  4468.                                drive is attempted.
  4469.  
  4470.         For those who are technically oriented, here are the error codes that
  4471.         may be returned.
  4472.  
  4473.           1 - Insufficient memory to store CATDISK's free list (internal).
  4474.           2 - DOS setblock error before shell to DOS was attempted.
  4475.           3 - DOS setblock error after the shell to DOS was executed (critical
  4476.               error).
  4477.           4 - Insufficient memory available to run the DOS command.
  4478.  
  4479.           otherwise a DOS error code is returned.
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4486.  
  4487.                                       Page 67
  4488.  
  4489.  
  4490.  
  4491.         OPTION <drive_letter>: SHOW DISK DIRECTORY
  4492.  
  4493.         To activate this feature, simply type the drive letter of the disk
  4494.         whose directory you wish to view.  If you haven't included the /NW
  4495.         option in your command line when you started CATDISK, you will be
  4496.         prompted to insert a disk for drive D where D is the drive letter that
  4497.         you typed.
  4498.  
  4499.         You will then be asked for a filespec to match.  This is the same as
  4500.         the filespec prompt in OPTION #0, Sub-option #4 - SHOW SELECTED FILES.
  4501.         Upon doing this, the label and directory contents will be read just
  4502.         like they would if they were about to be cataloged, but instead of
  4503.         adding them to your catalog, they will be shown directly on the screen
  4504.         in the same format as option #0, Sub-option #2 - Show Files For A
  4505.         Volume.  The archive scanning feature functions as normal throughout
  4506.         the program.
  4507.  
  4508.         Upon entering the search spec, scanning of the catalog will
  4509.         commence.  If you have status indicators turned on, a counter  will
  4510.         increment each time a matching file is found.  If at the and of the
  4511.         search, no files were found, an error message will be issued and you
  4512.         will be returned to the main menu.
  4513.  
  4514.         When the search has completed successfully, the file names will be
  4515.         shown alphabetically, along with the volume name, archive name, and
  4516.         other directory information for that file.
  4517.  
  4518.         For a list of options available, please see the section entitled
  4519.         "SCREEN REPORT OPTIONS AVAILABLE" in this manual.
  4520.  
  4521.  
  4522.  
  4523.         OPTION ESC:  EXIT TO DOS
  4524.  
  4525.         Select this option when you are finished with CATDISK to terminate its
  4526.         operation.  Upon exit, you will be returned to the DOS prompt.
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4552.  
  4553.                                       Page 68
  4554.  
  4555.  
  4556.  
  4557.                            APPENDIX A - ARCHIVE SUPPORT
  4558.  
  4559.                  Version  File  Catalog
  4560.        Archiver  Tested   Ext.  Attrib.  Comments
  4561.        --------  -------  ----  -------  -------------------------------------
  4562.  
  4563.        PKZIP      2.04g   .ZIP   *ZIP    PKWare's current archiver that
  4564.                                          replaced PKARC and PKPAK.  CATDISK
  4565.                                          can read the file and main ZIP file
  4566.                                          comments and include them in your
  4567.                                          catalog.  Single disk ZIP files are
  4568.                                          supported, but the new disk-spanning
  4569.                                          ZIP files are not supported as yet.
  4570.                                          Maybe in a future release.
  4571.        ARJ        2.41    .ARJ   *ARJ    By Robert K. Jung.  Supported in the
  4572.                                          same manner as ZIP files.
  4573.        LHA        2.13    .LZH   *LZH    By Haruyasu Yoshizaki.
  4574.        LARC       3.33    .LZS   *LZS    By K. Miki.  Same support as for LHA.
  4575.        LU        5th rev  .LBR   *LBR    Any version of the library utility
  4576.                                          supporting the 5th revision of the
  4577.                                          formal definition of this file format.
  4578.        ARC         5.30   .ARC   *ARC    Developed by System Enhancement
  4579.                                          Associates.  The idea was the
  4580.                                          predecessor of the archiving
  4581.                                          utilities that we know today.
  4582.        PKARC       3.50   .ARC   *ARC    PKWare's ARC-compatible archiver with
  4583.                                          several enhancements, including
  4584.                                          comments within the archive.  Because
  4585.                                          this is a non-standard extension of
  4586.                                          ARC's features, CATDISK does not
  4587.                                          support this feature.
  4588.        PKPAK       3.61   .ARC   *ARC    PKWare's PKARC renamed (for legal
  4589.                                          reasons).
  4590.        PAK         2.50   .PAK   *PAK    NoGate Consulting's archive utility
  4591.                                          - file format is compatible with ARC.
  4592.        ZOO         2.01   .ZOO   *ZOO    Comments contained in ZOO files may
  4593.                                          be read and included in your catalog.
  4594.        DWC        A5.01   .DWC   *DWC    By Dean W. Cooper.  Comments
  4595.                                          contained in DWC files may be read
  4596.                                          and included in your catalog.
  4597.        HYPER       2.50   .HYP   *HYP    By P. Sawatzki and K.P. Nischke
  4598.        SQZ         1.08.3 .SQZ   *SQZ    By Jonas I Hammarberg.
  4599.                                          As the archive comment itself is
  4600.                                          compressed inside the archive, CATDISK
  4601.                                          does not currently read it.
  4602.  
  4603.        Although technically not an archive file, a GIF file (stands for
  4604.        Graphics Interchange Format) is a special file format that was developed
  4605.        by CompuServe in order to allow many different types of computers to be
  4606.        able to view a graphics image without having to modify the file itself.
  4607.        GIF viewers are available on a wide variety of hardware platforms to
  4608.        allow you to look at the images contained within a GIF file.  These
  4609.        files can come in a very wide variety of resolutions and color
  4610.        combinations.  CATDISK can look into a GIF file and extract this
  4611.        resolution and color information and include it as a default comment for
  4612.        that GIF file.  For example, a picture that may be 640 by 480 pixels
  4613.        with 256 colors would have a comment entry of "1024 x 768 x 256".
  4614.  
  4615.        Currently, the GIF87a and GIF89a formats are supported.
  4616.  
  4617.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4618.  
  4619.                                       Page 69
  4620.  
  4621.  
  4622.  
  4623.                 APPENDIX B - CATLOOK - COMMAND LINE LOOKUP UTILITY
  4624.  
  4625.        CATLOOK is a stand alone reporting utility provided with CATDISK.  It
  4626.        can come in handy on occasions when you either need to generate a quick
  4627.        and dirty report without having to run CATDISK itself, or when you need
  4628.        to generate a report after shelling out to DOS from within an
  4629.        application and there is not enough free memory left over to run
  4630.        CATDISK itself.  CATLOOK will run in 64K of free memory.
  4631.  
  4632.        A summary of the usage of CATLOOK follows:
  4633.  
  4634.        CATLOOK parameters (each must be separated by a slash or a space)
  4635.  
  4636.           /Ffilename - Use this file for the catalog (Default is CATDISK).
  4637.                        No space is allowed between the filename and the /F.
  4638.  
  4639.           /Rx        - Use report format x, where x is:
  4640.                        0 - Filenames+Statistics        1 - Filenames+Comments
  4641.                        2 - Subdirs+Filenames+Comments  3 - All Catalog Info.
  4642.           /S         - Show a summary report.
  4643.           /Vvolume   - Show files for a volume report for the volume label
  4644.                        specified.
  4645.           /Aarchive  - Show files for an archive report for the archive
  4646.                        specified.
  4647.           /Wpattern  - Show files for a DOS wildcard spec based on the pattern
  4648.                        given.
  4649.           /Ccomment  - Show files containing the comment substring specified.
  4650.           /Psdirpath - Show files residing in the specified subdirectory.  Do
  4651.                        not add the "\" or the "~" in the sdirpath.
  4652.           /U         - Show all files that are unique in the catalog file.
  4653.           /D         - Show all files that have duplicates in the catalog
  4654.                        file.
  4655.           /SIZE      - Use file size as an additional criteria in generating
  4656.                        the unique/duplicate file reports.
  4657.           /NT        - suppress the totals that are normally printed at the
  4658.                        end of CATLOOK's reports.
  4659.           /Ex        - Show everything sorted by x, where x is:
  4660.                        0 - File Name    1 - File Extension  2 - Subdirectory
  4661.                        3 - Volume Name  4 - Archive ID      5 - Comment
  4662.                        6 - Date/Time
  4663.           /M#####    - Make custom report no. ##### (shown beside the report
  4664.                        title).
  4665.           /M?        - List custom reports available.
  4666.  
  4667.        Due to the simplicity of this utility, the reports generated by CATLOOK
  4668.        are not paginated, but rather produced with one heading at the top of
  4669.        the report followed by the appropriate listings.
  4670.  
  4671.        If you are using report format that requires more than 80 columns and
  4672.        are redirecting the output to a printer, you should set your printer set
  4673.        to a mode that will accomodate the width of a the report.
  4674.  
  4675.        The output from CATLOOK can be redirected to a printer or disk file by
  4676.        using the standard DOS method if I/O redirection.  For example:
  4677.  
  4678.          CATLOOK /S >PRN   - will send a summary report to your printer.
  4679.  
  4680.          CATLOOK /S >LISTING.TXT    - will send the summary report to a disk
  4681.                                       file called "LISTING.TXT".
  4682.  
  4683.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4684.  
  4685.                                       Page 70
  4686.  
  4687.  
  4688.  
  4689.                   APPENDIX C - CATMGR: CATDISK'S CATALOG MANAGER
  4690.  
  4691.        Before we even get into discussing this utility, we would like to
  4692.        stress that there is a possibility that a catalog file could get out of
  4693.        synch with the summary file under certain circumstances, particularly
  4694.        if a disk error or a disk-full condition occurs during certain
  4695.        operations.
  4696.  
  4697.        IF YOU USE THIS UTILITY, IT IS A GOOD IDEA TO MAKE A COPY OF YOUR DATA
  4698.        FILES BEFORE PROCEEDING.
  4699.  
  4700.        Also important to note is that ALL files being manipulated with this
  4701.        utility be kept in the SAME directory (if you specified a catalog file
  4702.        directory in the CDISKCFG utility, this is the one that should be used
  4703.        as CATMGR will refer tot his directory).  Do not have catalog set A on
  4704.        one disk or directory and catalog set B on a different disk or
  4705.        directory.
  4706.  
  4707.        In response to requests from the many users of CATDISK, we have
  4708.        developed a simple utility that will allow you to manipulate catalog
  4709.        entries among your various catalog files without having to uncatalog
  4710.        disks from one catalog and re-catalog them in another.  With CATMGR,
  4711.        you can copy records from one catalog to another (including a brand new
  4712.        catalog), move records from one catalog to another, delete multiple
  4713.        disks from a catalog in one pass and to change a disks volume id in the
  4714.        catalog file without affecting the volume label on the disk.
  4715.  
  4716.        CATMGR can have two catalog files loaded at one time.  The startup
  4717.        command for CATMGR is as follows:
  4718.  
  4719.        CATMGR CatalogFile1 CatalogFile2
  4720.  
  4721.        - where CatalogFile1 is the catalog file that you wish to be loaded on
  4722.          the left side of the screen and CatalogFile2 is the catalog file
  4723.         that you wish to be loaded on the right side of the screen. Both of
  4724.         these parameters are optional and you can specify one, both or none
  4725.         of them on the command line.
  4726.  
  4727.        The CATMGR screen is divided into three regions.  The upper left and
  4728.        right portions show information from the summary files from the two
  4729.        active catalog files, and the lower area makes up the instruction and
  4730.        message area.
  4731.  
  4732.        The general strategy with this utility is to tag the entries that you
  4733.        wish to copy, move or delete and then select the appropriate operation
  4734.        to perform.  For copying or moving catalog entries, the side of the
  4735.        screen on which the highlight bar resides is considered the source
  4736.        side, while the other side is considered the destination side.
  4737.  
  4738.        You can tag entries in one of two ways.  The first way is to highlight
  4739.        the desired entries by using the cursor keys and by pressing the
  4740.        <Space Bar>.  CATMGR will indicate that an entry is tagged when there
  4741.        is an arrow to the left of its volume name on the screen.
  4742.  
  4743.        You can move the highlight bar around the screen by using the standard
  4744.        navigation keys.  Additionally, the <Left Arrow> key will move you to
  4745.        the left side if the screen and the <Right Arrow> key will move you to
  4746.        the right side.
  4747.  
  4748.  
  4749.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4750.  
  4751.                                       Page 71
  4752.  
  4753.  
  4754.  
  4755.        The other way to tag entries is to do so in groups.  To bring up a list
  4756.        of tagging functions available, hit the <T> key at the main menu.
  4757.        CATMGR will bring up a list with the following functions that will
  4758.        operate on the side of the screen where the highlight bar currently
  4759.        resides:
  4760.  
  4761.          <A> - This will tag ALL of the entries.
  4762.  
  4763.          <C> - This will clear the tags of ALL of the entries.
  4764.  
  4765.          <S> - You will be prompted for a wildcard specification for all of
  4766.                the entries that you would like to be tagged.
  4767.  
  4768.          <U> - You will be prompted for a wildcard specification for all of
  4769.                the entries that you would like tags cleared.
  4770.  
  4771.          <I> - This will "flip" the tagged status of all entries.  This is
  4772.                useful if, for example, you wish to copy all but five of the
  4773.                entries of a large catalog file to be copied to a new one.
  4774.  
  4775.                Simply tag the five that you do not wish to copy and then
  4776.                select this option to quickly tag the entries that you do wish
  4777.                to copy.
  4778.  
  4779.        <Esc> - Will return you to the main menu with no further action taken.
  4780.  
  4781.        Please note that for any of the tagging operations in any method, you
  4782.        cannot tag a volume name that exists on the other side of the screen
  4783.        because a copy or move operation will result in a duplicate volume
  4784.        showing in the target catalog.  When tagging an individual entry with
  4785.        the <Space Bar>, CATMGR will warn you of this.  When performing a group
  4786.        tagging function with the <T> options, all appropriate entries will be
  4787.        tagged with duplicates ignored.  There is no warning issued in this
  4788.        case.  Given this, it is advisable to load only one catalog file into
  4789.        memory if the only operations to be performed are deletions.
  4790.  
  4791.        To load a different or new catalog file into either half of the screen,
  4792.        move the highlight bar to the desired side and press the <L> (Load New
  4793.        File) key.  CATMGR will ask you for the catalog file to be loaded,
  4794.        at which point you may enter the name portion of the catalog file only.
  4795.        Do not add a file extension; CATMGR will supply the necessary
  4796.        information at the appropriate time.  By hitting the <Esc> key, CATMGR
  4797.        will return you to the main menu with no further action taken.
  4798.  
  4799.        Upon successful entry of a catalog name, CATMGR will attempt to load
  4800.        the summary file for that catalog into memory.  If successful, those
  4801.        entries will immediately be displayed on your screen, and the catalog
  4802.        name will appear in the title area on its particular side of the
  4803.        screen.  Any previous tags that may have been set on that side of the
  4804.        screen will be cleared.
  4805.  
  4806.        If CATMGR is unable to find the catalog file, that side of the screen
  4807.        will be cleared, and it will be indicated that a new catalog file will
  4808.        be created in the event of a copy or move operation with that side as
  4809.        the destination side.  If you do not perform a copy or move operation
  4810.        into that catalog file, no catalog will be created for that name.
  4811.  
  4812.  
  4813.  
  4814.  
  4815.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4816.  
  4817.                                       Page 72
  4818.  
  4819.  
  4820.  
  4821.        Once you have a grouping of catalog entries tagged for an operation,
  4822.        here are the three that you can perform:
  4823.  
  4824.        Option "C" - Copy
  4825.        -----------------
  4826.  
  4827.        All tagged catalog entries will be copied from the source catalog to
  4828.        the destination catalog.  If an error occurs during this phase, you will
  4829.        get an error message and the operation will be aborted.
  4830.  
  4831.        By far, the most common error will occur when your disk becomes full.
  4832.     During the copy process, CATMGR will read information from both catalog
  4833.     files and merge them together in a temporary new file.  At the end of
  4834.     the process, all three files will exist at the same time, after which
  4835.     the old file is deleted and the new one renamed.  The net result of this
  4836.     is that you need free disk space equal to the size of the target catalog
  4837.     file plus the cumulative size of the number of records that will be
  4838.     copied from the source catalog.
  4839.  
  4840.        Once this operation is successful, the summary entries from the source
  4841.        catalog will be copied into the destination summary file.  This
  4842.        operation is done in memory, after which the new summary file is written
  4843.        to disk.  As a general rule, if there was enough room to update the
  4844.        catalog file, there will certainly be enough room to create a new
  4845.        summary file.
  4846.  
  4847.        If an error does occur, it was probably due to a physical disk error.
  4848.     If this does happen, your summary file will be out of synch with its
  4849.     catalog file, and it is probably best that you exit from CATMGR and
  4850.     restore a backup copy of the target catalog set.
  4851.  
  4852.        Option "D" - Delete
  4853.        -------------------
  4854.  
  4855.        This operation will delete tagged entries from the source catalog file
  4856.        in a bulk operation, enabling you to perform an efficient cleanup
  4857.        operation on your catalog file in one pass, rather than the
  4858.        un-cataloging the entries one at a time in the CATDISK program itself.
  4859.  
  4860.        To perform the deletion(s), CATMGR will read through the source file and
  4861.        build a new catalog file, minus the tagged entries, of course.  If an
  4862.        error occurs while the new catalog file is being built, CATMGR will
  4863.        abandon the deletion operation and leave the original catalog file
  4864.        intact.
  4865.  
  4866.        As in the copy operation, the most common error will be a disk full
  4867.        error for the similar reasons as the copy operation.
  4868.  
  4869.        Once the deletion operation on the catalog file is complete, the summary
  4870.        file will be updated to reflect the deletions.  Again, the same
  4871.        considerations to a summary file update apply to the summary update
  4872.        operation for deletions.
  4873.  
  4874.        If you get an error while the summary file is being updated, it is
  4875.        advisable that you restore a backup copy of that catalog file.
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4882.  
  4883.                                       Page 73
  4884.  
  4885.  
  4886.  
  4887.        Option "M" - Move
  4888.        -----------------
  4889.  
  4890.        This operation will move the entries from the source catalog to the
  4891.        destination catalog.  It basically combines a copy operation from source
  4892.        to destination, followed by a deletion of the entries from the source.
  4893.        The move operation is the most convenient way to "split" a large catalog
  4894.        file into two smaller ones, or to "merge" two smaller catalogs into one
  4895.        large one.
  4896.  
  4897.  
  4898.        The last two options available are:
  4899.  
  4900.        Option "V" - Change Volume Label
  4901.        --------------------------------
  4902.  
  4903.        This option will allow you to change the volume id of the highlighted
  4904.        entry to one that you specify without having to insert that disk in a
  4905.        drive and re-catalog it under a different name.
  4906.  
  4907.        Due to the way that the disk list is maintained in CATMGR, you may only
  4908.        perform this operation if none of the files on the current side of the
  4909.        screen have been tagged.  If you have any entries tagged, you will get
  4910.        an error message.
  4911.  
  4912.        Once you have activated this operation, you will be prompted for a new
  4913.        volume id for the current entry.  If you enter a name that already
  4914.        exists in the current catalog file, you will get an error message.  If
  4915.        you enter the same name for the volume id as it had before, no action
  4916.        will take place.
  4917.  
  4918.        Once a valid volume id has been entered, the rest is automatic.
  4919.  
  4920.        If you inadvertently activated this option and do not wish to carry out
  4921.        any operation, hit <Esc> at the prompt and you will be returned to the
  4922.        main menu with no action taken.
  4923.  
  4924.     
  4925.        Option <Esc> - Exit To DOS
  4926.        --------------------------
  4927.  
  4928.        Self-explanatory.
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  4948.  
  4949.                                       Page 74
  4950.  
  4951.  
  4952.  
  4953.             APPENDIX D - DISKFILL: CATDISK'S OPTIMAL DISK FILL UTILITY
  4954.  
  4955.        While CATDISK provides a way to manage the information that you have
  4956.        stored in a disk library, that still doesn't give us the excuse to
  4957.        waste disk space.  Unfortunately, copying files one at a time to a
  4958.        floppy and using our eyes to read the amount of free space left on the
  4959.        target disk and using our minds to scan the list of files to be
  4960.        offloaded and find the best file to fit that "hole" is tedious at best,
  4961.        especially if the list of files to be offloaded is large.
  4962.  
  4963.        We have developed a companion program to CATDISK called DISKFILL, which
  4964.        is included with CATDISK that addresses this problem.
  4965.  
  4966.        In a nutshell, DISKFILL has the ability to offload selected files from
  4967.        a single subdirectory at a time to a collection of disks (DISKFILL is
  4968.        primarily meant for use with floppies), and copying the files to them
  4969.        in such an order that the least amount of target disk space is wasted.
  4970.  
  4971.        DISKFILL also has the ability to move files (as opposed to copy files),
  4972.        and to delete groups of files as well.  Details on all three operations
  4973.        are discussed in their own sections in this appendix.
  4974.  
  4975.        As each disk is filled with files, DISKFILL can optionally call upon
  4976.        the CATDISK program to automatically catalog your disks as you go.
  4977.  
  4978.        DISKFILL can compare the files in your directory to those in an
  4979.        existing catalog to facilitate weeding out duplicate files BEFORE they
  4980.        get copied into your collection of files.
  4981.  
  4982.        4DOS/NDOS file descriptions are copied to the target disk with the
  4983.        files.  We strongly recommend that you use either 4DOS or NDOS to
  4984.        maintain comments right in the directory itself when you create or
  4985.        obtain the files that make up that directory.  That way, when you
  4986.        offload the files to diskettes and catalog them, there will be no
  4987.        guesswork in entering the file comments, as CATDISK will read them in
  4988.        as the disk gets cataloged.
  4989.  
  4990.        DISKFILL can also compare the list of files to be offloaded against a
  4991.        CATDISK catalog to allow intelligent recommendations of previously
  4992.        cataloged disks so that you may fill up those empty "holes" that may
  4993.        exist in your disk collection.
  4994.  
  4995.        DISKFILL can take one or more optional parameters as follows:
  4996.  
  4997.        DISKFILL parameters pattern
  4998.  
  4999.        where parameters may be one or more of the following:
  5000.  
  5001.        /Ffilename - filename is the name of the catalog file that you wish
  5002.                     DISKFILL to use for recommendations of previously
  5003.                     cataloged disks when offloading files to another media.
  5004.  
  5005.                     NOTE that there is no space between the /F and the
  5006.                     filename.  When specifying the filename, do NOT include a
  5007.                     path or file extension - DISKFILL will know where to look.
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5014.  
  5015.                                       Page 75
  5016.  
  5017.  
  5018.  
  5019.        /NOTAGALL  - See discussion of this item in the "Configuring The
  5020.                     Programs" section of the user manual.
  5021.  
  5022.        /QUIET     - Silent operation.  Suppresses sound in DISKFILL.
  5023.  
  5024.        /N4        - Disables support for 4DOS's or NDOS's file descriptions.
  5025.                     If this option is NOT specified, DISKFILL will copy the
  5026.                     4DOS/NDOS file description over to the target diskette for
  5027.                     each file that has one, and any file called DESCRIPT.ION
  5028.                     will not be processed.
  5029.  
  5030.        /CATDISKD  - See discussion of this item in the "Configuring The
  5031.                     Programs" section of the user manual.
  5032.  
  5033.        /SWAP      - See discussion of this item in the "Configuring The
  5034.                     Programs" section of the user manual.
  5035.  
  5036.        By default, the file list will be shown in the order that they appear
  5037.        in the directory.  You may control the order in which files appear with
  5038.        the following options.  If you specify any of these options, all
  5039.        subdirectories will be shown at the top of the file list, followed by
  5040.        the files themselves.
  5041.  
  5042.        /SF        - sorts the list alphabetically by filename.
  5043.        /SE        - sorts the list alphabetically by file extension.
  5044.        /SS        - sorts the list by file size.
  5045.        /SD        - sorts the list by file date/time.
  5046.  
  5047.        /RS        - by default, any specified sorts will be shown in ASCENDING
  5048.                     order.  You can reverse this by adding /RS to the command
  5049.                     line and cause the sort to be done in DESCENDING order.
  5050.  
  5051.        NOTE that with these parameters shown above that, unlike the CATDISK
  5052.        program itself, they MUST be preceded by a slash.  This is due to the
  5053.        fact that the pattern mentioned below may contain a dash in its
  5054.        specification.
  5055.  
  5056.        pattern    - you may specify a wildcard filespec that you wish to be
  5057.                     included in a directory scan.  This filespec may be a
  5058.                     CATDISK enhanced filespec as documented in sub-option #4
  5059.                     of the reports and inquiries section of this user manual.
  5060.                     If no filespec is included on the command line, the
  5061.                     default, "*.*" is used.
  5062.  
  5063.                     NOTE that there is no slash or dash preceding the pattern.
  5064.  
  5065.        You may also put commonly used command line options in a DISKFILL
  5066.        environment variable using the DOS "SET" command.  This command (see
  5067.        examples below), may be placed in your AUTOEXEC.BAT file so that you
  5068.        will not need to remember which command line options to use to obtain
  5069.        your favorite setup, or for that matter, to type them!
  5070.  
  5071.        - example:  SET DISKFILL=/FCATDISK/NOTAGALL/QUIET
  5072.     
  5073.        You may run DISKFILL from any directory on your system.  That directory
  5074.        will be the initial subdirectory scanned on startup.  The subdirectory
  5075.        and filespec to match may be changed from within the program.
  5076.  
  5077.  
  5078.  
  5079.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5080.  
  5081.                                       Page 76
  5082.  
  5083.  
  5084.  
  5085.        DISKFILL has a capacity to hold 8000 files from a subdirectory.
  5086.        Once DISKFILL has loaded, it will scan the current directory and
  5087.        present a list of files that match the filespec given.  The procedure
  5088.        here is to tag the files that you wish to be manipulated and select an
  5089.        operation to perform on them.  As the initial or new directory is
  5090.        scanned, DISKFILL automatically selects ALL files for manipulation,
  5091.        unless you specified /NOTAGALL when you started DISKFILL, as this
  5092.        selection will undoubtedly be the most common.
  5093.  
  5094.        You can tag files in one of two ways.  The first way is to highlight
  5095.        the desired file by using the standard navigation keys and press the
  5096.        <Space Bar>.  DISKFILL will indicate that a file is tagged when there
  5097.        is an arrow to the left of its filename name on the screen.
  5098.  
  5099.        The other way to tag entries is to do so in groups.  To bring up a list
  5100.        of tagging functions available, hit the <T> key at the main menu.
  5101.        DISKFILL will present you with the following functions:
  5102.  
  5103.          <A> - This will tag ALL of the files.
  5104.  
  5105.          <C> - This will clear the tags of ALL of the files.
  5106.  
  5107.          <S> - You will be prompted for a wildcard specification for all of
  5108.                the files that you would like to be tagged.
  5109.  
  5110.          <U> - You will be prompted for a wildcard specification for all of
  5111.                the files that you would like the tags cleared.
  5112.  
  5113.          <I> - This will "flip" the tagged status of all files.  This is
  5114.                useful if, for example, you wish to copy all but five of the
  5115.                files if a long list to be offloaded. Simply tag the five that
  5116.                you do not wish to copy and then select this option to quickly
  5117.                tag the entries that you do wish to copy.
  5118.  
  5119.          <F> - This will flip the tagged status of any files that DISKFILL
  5120.                finds as duplicates in the selected catalog file.  Normally,
  5121.                when offloading files to floppies and then cataloging them, you
  5122.                run a good risk of having duplicate files in your collection.
  5123.                Although CATDISK itself can point them out to you, it is still
  5124.                best to eliminate them before they get into your collection.
  5125.  
  5126.                In order to use this option, you must have selected a catalog
  5127.                file to use either from the command line when you started
  5128.                DISKFILL, or from the main menu by using "<N>ew Catalog File".
  5129.  
  5130.                When determining whether or not a file is a duplicate, DISKFILL
  5131.                will use the filename and filesize.  When you activate this
  5132.                feature, DISKFILL will ask you if it should use the file date as
  5133.                an additional criteria.  You may answer <Y>es or <N>o to the
  5134.                prompt, or you may press <Esc> to abandon the operation.
  5135.  
  5136.                Once you have determined the criteria for DISKFILL to use, it
  5137.                will make a pass through your catalog file and compare the
  5138.                contents of the catalog file to the contents of the currently
  5139.                selected directory.  Each file that it finds as duplicate will
  5140.                have its flagged status flipped.  When the operation is
  5141.                complete, you will be returned to the file list.
  5142.  
  5143.        <Esc> - Will return you to the main menu with no further action taken.
  5144.  
  5145.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5146.  
  5147.                                       Page 77
  5148.  
  5149.  
  5150.  
  5151.        Here are two strategies that you can use to "pre-process" a directory
  5152.        before offloading files with "<M>ove" or "<C>opy":
  5153.  
  5154.          1) Activate the <F>lip option with NO FILES FLAGGED, you can then see
  5155.             which files are indeed duplicates, after which you can activate the
  5156.             <D>elete files option from the main menu.  Presto!  No more
  5157.             duplicate files.
  5158.  
  5159.          2) Activate the <F>lip option with the files that you intend to
  5160.             offload already flagged, you can have DISKFILL "un-tag" the
  5161.             duplicate files that it finds.  You may then offload the remaining
  5162.             files and examine the duplicate files left over.
  5163.  
  5164.  
  5165.        Other options available from the main menu are:
  5166.  
  5167.        Option "P" - Change Pattern
  5168.        ---------------------------
  5169.  
  5170.        DISKFILL will prompt you for a new filespec to match when scanning the
  5171.        directory.  This is handy if you only wish to have a grouping of files
  5172.        from the current subdirectory to be included in the point and shoot
  5173.        list.  Note that after the directory has been re-scanned, ALL files
  5174.        will be tagged for manipulation.
  5175.  
  5176.        Option "S" - Change Subdirectory
  5177.        --------------------------------
  5178.  
  5179.        Change Subdirectory:  DISKFILL will prompt you for a new subdirectory to
  5180.        be scanned (the current pattern as noted at the top of the screen will
  5181.        be used).  Note that after the directory has been scanned, ALL files
  5182.        will be tagged for manipulation.
  5183.  
  5184.        Option "N" - New Catalog File
  5185.        -----------------------------
  5186.  
  5187.        New Catalog File: DISKFILL will prompt you for a new catalog to be used
  5188.        in recommending disks from an existing catalog for backfilling of files.
  5189.        Do not specify a path or file extension - DISKFILL will know where to
  5190.        look.  Hit <Esc> at the prompt to leave the existing (or lack of)
  5191.        catalog unchanged.  If you do enter a name, DISKFILL will attempt to
  5192.        load that catalog.  If a problem occurs (eg. file not found or error
  5193.        reading it), the setting will be cleared (i.e. no catalog will be used).
  5194.        If successful, that catalog will be used in all recommendations and
  5195.        cataloging operations.
  5196.  
  5197.        The <Enter> Key
  5198.        ---------------
  5199.  
  5200.        If the highlight bar is currently pointing to a subdirectory accessible
  5201.        directly from the current directory, you may press <Enter> to switch to
  5202.        that subdirectory.  If you are pointing to <PARENT DIR> and hit <Enter>,
  5203.        you will move down one level in the disk's subdirectory tree.
  5204.  
  5205.        By traversing the directory tree in this manner, it is possible to
  5206.        quickly move from one directory to another in a point and shoot manner.
  5207.        It may be quicker to use the <S> option to move directly to a
  5208.        subdirectory that you enter at a prompt in some circumstances.  If you
  5209.        wish to switch to another disk drive, you must use the <S> option.
  5210.  
  5211.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5212.  
  5213.                                       Page 78
  5214.  
  5215.  
  5216.  
  5217.        DISKFILL currently has three operations that you can perform on the
  5218.        tagged files:
  5219.  
  5220.        Option "C" - Copy
  5221.        -----------------
  5222.  
  5223.        When this option is selected, DISKFILL will ask you for the drive of the
  5224.        target disk(s) that will received the tagged files.  Typically, this
  5225.        will be drive A: or drive B:, but we have allowed any available drive
  5226.        letter in your system due to the fact that there may be an external
  5227.        floppy disk using a device driver that is available.  Hit <Esc> to
  5228.        abandon the operation.
  5229.  
  5230.        While on the topic of the target disk, you may change the target disk at
  5231.        any prompt while in the copy or move function (except at the disk
  5232.        recommendation prompt) by pressing <N> for New Target Disk.
  5233.  
  5234.        Once you have selected the target drive, DISKFILL will ask you if you
  5235.        would like to catalog each disk after it has received more files.  This
  5236.        prompt requires a simple YES or NO answer, which can be indicated by
  5237.        pressing "Y" for YES or "N" for NO.  You may press <Esc> at this prompt
  5238.        to abandon the operation.
  5239.  
  5240.        DISKFILL will then prompt you to insert a disk in the target drive.  If
  5241.        you do not wish to continue with the operation, hit <Esc> to return to
  5242.        the main menu.
  5243.  
  5244.        You may also press the <S> key at the prompt to shell out to DOS.  This
  5245.        is handy if you need to check something outside of the DISKFILL program
  5246.        before proceeding.
  5247.  
  5248.        If you have instructed DISKFILL to use a catalog file for the purposes
  5249.        of recommending disks for "backfilling" previously cataloged disks, you
  5250.        may press <R> at this prompt.
  5251.  
  5252.        DISKFILL will then compare the list of files that need to be copied or
  5253.        moved with the entries in the selected catalog and will recommend a disk
  5254.        to use for accepting more files.  The program will attempt to recommend
  5255.        disks such that the ones with the least amount of free space (those are
  5256.        the most difficult to fill later) are used first.
  5257.  
  5258.        If you have a catalog containing mixed media (hard drives, two different
  5259.        floppy drive sizes on the A: and B: drives, etc.), DISKFILL is currently
  5260.        not able to differentiate between them, so it may be possible for it to
  5261.        suggest a 5-1/4" diskette when you are copying to 3.5" diskettes, or
  5262.        even you hard drive.  You may also have cataloged program disks that you
  5263.        have purchased, to which you do not necessarily want to copy files.  If
  5264.        DISKFILL recommends such a disk, hit the <S> key at the recommendation
  5265.        prompt to "Squelch" that disk and not use it for any further
  5266.        recommendations.  DISKFILL will then recommend another disk for use.
  5267.  
  5268.        To accept the recommended disk for filling, insert it at the
  5269.        recommendation screen and press <A> for ACCEPT.  DISKFILL will then
  5270.        proceed to fill that disk immediately, instead of requiring you to go
  5271.        back to the "Insert Disk" prompt.  DISKFILL will not check to insure
  5272.        that the correct disk has been inserted.  The <A> option is provided for
  5273.        convenience only.
  5274.  
  5275.     
  5276.  
  5277.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5278.  
  5279.                                       Page 79
  5280.  
  5281.  
  5282.  
  5283.        NOTE: If you need to "re-activate" those disks that have been
  5284.        "squelched" for another copy process, simply load that summary file from
  5285.        the main menu before performing any other copy or move operations.
  5286.  
  5287.        NOTE: Any disks whose volume labels match any of the "volumespecs" set
  5288.        via the configuration program, CDISKCFG.EXE, will be automatically
  5289.        "squelched".  If you these disks re-activated, you will need to go back
  5290.        into the configuration program and modify the list.
  5291.  
  5292.        Once you have the desired disk inserted, and are ready to copy files to
  5293.        it, hit any other key to proceed.  The prompt containing all the above
  5294.        mentioned options will appear before each disk necessary to complete the
  5295.        operation is to be inserted.
  5296.  
  5297.        Before DISKFILL begins to copy files to each disk, it will examine the
  5298.        disk to determine capacity and to check to see if any files or
  5299.        sub-directories are present on the disk.  If a disk error occurs at this
  5300.        stage, DISKFILL will assume that the disk is not formatted and will
  5301.        bring up a message indicating that it thinks that the disk is not
  5302.        formatted.
  5303.  
  5304.        You have three options at this point:
  5305.  
  5306.          1) You may hit <S> to shell out to DOS to either examine the disk, or
  5307.             to invoke your favorite program to facilitate formatting that
  5308.             diskette.  We have not built in the facility to load any particular
  5309.             disk formatting software, as there are many alternatives to the DOS
  5310.             format command, and the selection of a given program is a matter of
  5311.             personal preference.  This also leaves open the possibility of
  5312.             using a disk formatting program that has the ability to format more
  5313.             capacity on a disk than normal.
  5314.  
  5315.             When you are ready to continue with the copy operation after
  5316.             shelling out to DOS, type "EXIT" and hit <Enter> to return back to
  5317.             the prompt.
  5318.  
  5319.          2) You may hit <Esc> to abort the copy operation and return to the
  5320.             main menu.
  5321.  
  5322.          3) You may hit any other key to try a new diskette, at which time the
  5323.             disk determination will be repeated.  If the target disk has files
  5324.             on it, you will be presented with another set of options that will
  5325.             allow you to make a decision on what to do next:
  5326.  
  5327.               i) You may hit <V> to view the directory of the target disk to
  5328.                  verify that it is the one that you intended to insert in the
  5329.                  drive.  The DOS "DIR/P" command will be issued.
  5330.  
  5331.              ii) You may hit <S> to shell to DOS.  This option is available to
  5332.                  allow you to examine the situation more closely, perhaps to
  5333.                  examine the directory of the disk and see if you have inserted
  5334.                  the correct diskette.  When you return from the DOS shell, you
  5335.                  will be left at this prompt from which you may take
  5336.                  appropriate action.
  5337.  
  5338.             iii) You may press <E> to have DISKFILL erase all visible files and
  5339.                  subdirectories from that disk before proceeding with the copy
  5340.                  operation.
  5341.  
  5342.  
  5343.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5344.  
  5345.                                       Page 80
  5346.  
  5347.  
  5348.  
  5349.                  IF YOU ARE USING A TARGET DRIVE OTHER THAN A: or B:, EXERCISE
  5350.                  THIS OPTION WITH EXTREME CAUTION.  IF THE TARGET DRIVE HAPPENS
  5351.                  TO BE A HARD DISK, ALL VISIBLE FILES AND SUBDIRECTORIES WILL
  5352.                  BE ERASED.  YOU HAVE BEEN WARNED!
  5353.  
  5354.              iv) You may press <T> to try another diskette.  You will then be
  5355.                  returned to the disk insertion prompt.
  5356.  
  5357.               v) You may press <Esc> to Abort the copy operation altogether and
  5358.                  return to the main menu.
  5359.  
  5360.              vi) You may press any other key to continue on with the copy
  5361.                  operation.  DISKFILL will then add files to those that already
  5362.                  exist on the target diskette as available space allows.
  5363.  
  5364.             Once all is ready, DISKFILL will proceed to copy files to the
  5365.             target diskette.  As each file is copied, it will be highlighted in
  5366.             the list and a progress indicator will appear in the instruction
  5367.             area of the screen keeping you informed of the progress of the
  5368.             copy.  DISKFILL will buffer as much of the source file into memory
  5369.             as it can before writing it out to the target diskette in order to
  5370.             facilitate speed.
  5371.  
  5372.             As DISKFILL copies files, an indicator at the bottom of the screen
  5373.             will indicate how much of the read and write operations are
  5374.             complete.  The indicator beside each status indicator that is
  5375.             flashing will indicate what DISKFILL is currently doing.
  5376.  
  5377.             If you have activated 4DOS/NDOS support, it will, upon copying each
  5378.             file to the target disk, check to see if the file just copied has
  5379.             a 4DOS/NDOS file description.  If so, that file description will be
  5380.             copied over to the target disk if there is enough room to
  5381.             accommodate it.  It is possible that disk space may be completely
  5382.             filled and the hidden file that 4DOS or NDOS maintains cannot be
  5383.             expanded.  If this occurs, the description will not appear in the
  5384.             directory of the target disk, even though the file was successfully
  5385.             copied.  This behavior is consistent with that of 4DOS and NDOS.
  5386.  
  5387.             As each file is successfully copied to the target, it will be
  5388.             "un-tagged" in the file list.  This way, if the copy process is
  5389.             interrupted or aborted for any reason, you can resume at the point
  5390.             where you left off, as the tagged files will be those that were not
  5391.             copied.
  5392.  
  5393.             The capacity left over on the target disk will be updated as each
  5394.             file is copied to it.  Additionally, the statistics on the right
  5395.             side of the screen will indicate how many files have yet to be
  5396.             copied. If a disk error occurs when copying a file to the target,
  5397.             that copy will be aborted.  DISKFILL will attempt to remove that
  5398.             file from the target disk, although this cannot be guaranteed.  The
  5399.             file that was being copied at the time of the error will remain in
  5400.             the "hit list" to be copied to a subsequent disk.  You will then be
  5401.             returned to the "Insert Disk" prompt from which you may continue.
  5402.     
  5403.             It may be advisable to shell out to DOS at this point with the <S>
  5404.             command to check the disk and perhaps run a diagnostic program on
  5405.             the target disk in order to map out any bad areas of the disk.  If
  5406.             this proves to be the cause of the error, you may be able to
  5407.             continue the copy operation with that disk.
  5408.  
  5409.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5410.  
  5411.                                       Page 81
  5412.  
  5413.  
  5414.  
  5415.             When DISKFILL has determined that no more files from the selected
  5416.             list will fit on the target disk, it will do one of two things:
  5417.  
  5418.             1) If you indicated that you would like each disk to be cataloged,
  5419.                DISKFILL will attempt to load CATDISK and tell it to catalog the
  5420.                disk.
  5421.  
  5422.                Any command line parameters in the CATDISK environment variable
  5423.                (see the section on starting CATDISK for details) will also be
  5424.                in effect for this operation.  When the operation is complete,
  5425.                you will be returned to the disk insertion prompt where you may
  5426.                continue on with a new diskette, or abort the operation right
  5427.                there.
  5428.  
  5429.                The catalog used in the operation will be determined in the
  5430.                following order of priority:
  5431.  
  5432.                  i) If you specified a catalog to be used for recommendations
  5433.                     for backfilling disks, that catalog will be used in the
  5434.                     catalog operation.
  5435.  
  5436.                 ii)  If the above is not the case, any catalog name specified
  5437.                      in the CATDISK environment variable (see STARTING CATDISK
  5438.                      in this manual) will be used.
  5439.  
  5440.                iii) If neither of the above two are true, the default catalog
  5441.                     name "CATDISK" will be used.
  5442.  
  5443.  
  5444.                In order for this operation to be successful, two criteria must
  5445.                be met:
  5446.  
  5447.                 i)  The program CATDISK.EXE must be present in either the
  5448.                     current directory or in a subdirectory specified in your
  5449.                     DOS PATH and
  5450.  
  5451.                ii) There must be enough memory available (at least a part of
  5452.                    DISKFILL remains in memory while CATDISK does its thing) to
  5453.                    load CATDISK and complete the function.
  5454.  
  5455.  
  5456.                If one or both of these criteria are not met, the cataloging
  5457.                operation will not take place, and you will be notified of the
  5458.                error.  If the problem is not enough memory, try using the /SWAP
  5459.                option with DISKFILL.
  5460.  
  5461.             2) If you indicated that you would NOT like each disk to be
  5462.                cataloged, you will be returned to the disk insertion prompt
  5463.                where you may continue on with a new diskette, or abort the
  5464.                operation right there.
  5465.  
  5466.     
  5467.                When all selected files have been copied to the target
  5468.                directory, you will automatically be returned to the main menu
  5469.                where the updated file list will be displayed.  If all went
  5470.                well, there should be no more files tagged.
  5471.  
  5472.  
  5473.     
  5474.  
  5475.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5476.  
  5477.                                       Page 82
  5478.  
  5479.  
  5480.  
  5481.                                   IMPORTANT NOTES
  5482.  
  5483.             DISKFILL will work best when there is a mix of large and small
  5484.             files available for copying to the target disk(s), as DISKFILL will
  5485.             be able to use the smaller files to fill in the holes left over by
  5486.             the larger files.
  5487.  
  5488.             It is not necessary to use disks of the same capacity throughout an
  5489.             entire copy operation.  For example, in a high capacity 3.5" drive,
  5490.             you could use a mix of 1.44Mb and 720K floppies.  DISKFILL will
  5491.             copy files to it as the capacity of each inserted disk allows.
  5492.  
  5493.             If you have one or several files that are too big to fit on a
  5494.             target drive, the insert disk prompt will simply be repeated over
  5495.             and over again until you abort, as DISKFILL is a very patient
  5496.             program and will wait until a suitable disk is inserted in the
  5497.             drive.
  5498.  
  5499.             If you have been using low density media, you may need to switch to
  5500.             a higher capacity disk format in order to accommodate the file.
  5501.  
  5502.             If you have a file that will not fit on a disk of any capacity,
  5503.             DISKFILL will not be able to offload it.  If the file is not
  5504.             compressed, you may wish to use one of the many archive utilities
  5505.             supported by CATDISK to compress the file to a size that may fit on
  5506.             a target disk, or alternatively, you may wish to use a file
  5507.             split/merge utility to break the file down into smaller, more
  5508.             manageable sub-files.
  5509.  
  5510.             Option "M" - Move
  5511.             -----------------
  5512.  
  5513.             The MOVE operation works exactly like the copy operation except
  5514.             that each file being offloaded is erased after the copy operation
  5515.             is complete.  If a disk error occurs during the copying part of the
  5516.             operation, the file involved is left intact in the source directory
  5517.             where an attempt can be made to move it to another disk later on in
  5518.             the operation.
  5519.  
  5520.             THE MOVE OPERATION IS THE PREFERRED METHOD OF OFFLOADING FILES TO
  5521.             FLOPPIES.  It is also safe due to the fact that the only time that
  5522.             the source file is erased is when it has been successfully copied
  5523.             to the target disk.
  5524.  
  5525.             Option "D" - Delete
  5526.             -------------------
  5527.  
  5528.             This operation will quickly delete all selected files from the
  5529.             source directory.  Once a file has been deleted, DISKFILL cannot
  5530.             recover it, although it is possible to use one of the many file
  5531.             unerase utilities on the market to get the file back.
  5532.  
  5533.             Due to the potential severity of using this function, you will be
  5534.             asked for verification before continuing.
  5535.  
  5536.             NOTE:  With the move and delete operations, DISKFILL will not be
  5537.                    able to erase a file marked "READ-ONLY".
  5538.  
  5539.  
  5540.  
  5541.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5542.  
  5543.                                       Page 83
  5544.  
  5545.  
  5546.  
  5547.                APPENDIX E - DUPCLEAN: CATDISK'S FILE CLEANUP UTILITY
  5548.  
  5549.        As your software collection grows, you will undoubtedly wind up with
  5550.        many duplicate files in your collection.  It is also common, especially
  5551.        when building a shareware collection from BBS systems, to have many
  5552.        different versions of the same program.  When this is the case, the
  5553.        filename(s) will usually start with the same characters, followed by
  5554.        numeric digits and dashes to indicate the version.  In many cases, it
  5555.        is desirable to have the latest version or two of a program, but not
  5556.        the older versions.
  5557.  
  5558.        DUPCLEAN provides a simple mechanism to enable you to weed out the
  5559.        duplicate files and the redundant old versions based on the contents of
  5560.        your catalog.  The only restrictions are that DUPCLEAN does not have the
  5561.        ability to erase files from within archive files and that any files
  5562.        affected must either reside in the root directory or in the next level
  5563.        (eg. A:\ or A:\CATDISK).
  5564.  
  5565.        A short discussion on some of the various items on the DUPCLEAN screen
  5566.        is in order before we continue.
  5567.  
  5568.        Item                 Description
  5569.        -------------------  --------------------------------------------------
  5570.  
  5571.        Base Chars For Dups  DUPCLEAN will examine this number of characters in
  5572.                             the base part of the filename when determining
  5573.                             what files to include in the list of files for
  5574.                             selection.
  5575.  
  5576.        Pattern              Any files must match this pattern in order to be
  5577.                             considered for inclusion in the list of files for
  5578.                             selection.
  5579.  
  5580.        Catalog              Use this catalog for searching for duplicates.
  5581.  
  5582.  
  5583.        When you start DUPCLEAN, you may specify various command line options
  5584.        that will initialize various settings within the program.  Options may
  5585.        be separated by a slash, dash or a space.
  5586.  
  5587.        They are as follows:
  5588.  
  5589.          /FFilename  - Uses this catalog file for searching.  Note that no
  5590.                        space is permitted between the /F and the catalog
  5591.                        filename.
  5592.  
  5593.          /Bbasechars - initialize the setting for the base chars for dups.
  5594.                        Default is 8.
  5595.  
  5596.          /Ppattern   - initialize the setting for the pattern.  Default is *.*
  5597.  
  5598.          /VERSIONS   - normally, DUPCLEAN only examines the first number of
  5599.                        characters as defined by the basechars setting and
  5600.                        ignores the rest.  If this option is activated (you can
  5601.                        also activate it from within the program), DUPCLEAN
  5602.                        will examine the rest of the characters, which must be
  5603.                        either numeric, a space, dash or underscore.
  5604.  
  5605.          /QUIET      - Quiet operation (eliminate sound in the program)
  5606.  
  5607.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5608.  
  5609.                                       Page 84
  5610.  
  5611.  
  5612.  
  5613.          /ND         - Shows dates as YYYY-MM-DD. Default is MMM DD,YYYY.
  5614.  
  5615.          /CATDISKD   - when DUPCLEAN needs to catalog a disk, use CATDISKD.EXE
  5616.                        instead of CATDISK.EXE (for larger catalog files).
  5617.  
  5618.  
  5619.        Upon startup, DUPCLEAN will scan the catalog file, if specified at
  5620.        startup or through the CDISKCFG program for any files that match the
  5621.        specs as defined at startup.  These files are then shown in a
  5622.        scrollable list below.
  5623.  
  5624.        The strategy is to first get the list showing the desired file list.
  5625.        You may control what gets into the list by changing the three items at
  5626.        the top of the screen to the desired settings.  Here are the three
  5627.        options that control these items:
  5628.  
  5629.        <B> - Change Base Characters For Duplicates
  5630.  
  5631.              Enter the number of characters from the start of the filename that
  5632.              you would like DUPCLEAN to use for comparison.  If, for example,
  5633.              you enter 5 for this setting, DUPCLEAN will match any files whose
  5634.              first 5 characters are the same.
  5635.  
  5636.              When you change this setting to a value less then 8, DUPCLEAN will
  5637.              also ask you if you want to match only numeric characters after
  5638.              the base characters have been analyzed.  If you answer YES,
  5639.              DUPCLEAN will act in the same manner as if you had added the
  5640.              /VERSIONS option to the command line at startup.  If you answer
  5641.              NO, any characters after the number of base characters will be
  5642.              disregarded.
  5643.  
  5644.        <P> - Change Pattern To Match
  5645.  
  5646.              Enter the file pattern that any files MUST match in order to be
  5647.              included in the list.  You may use the CATDISK enhanced wildcard
  5648.              matching specifications supported by all programs in this package.
  5649.  
  5650.              If the base characters to match setting is less then 8, DUPCLEAN
  5651.              will prompt you for the numeric character match as mentioned
  5652.              above.
  5653.  
  5654.        <A> - Change Active Catalog File
  5655.  
  5656.              Enter the name of the catalog file (WITHOUT the subdirectory or
  5657.              file extension included) that you wish DUPCLEAN to use in creating
  5658.              the point & shoot list of duplicates.
  5659.  
  5660.              Again, if the base characters to match setting is less then 8,
  5661.              DUPCLEAN will prompt you for the numeric character match as
  5662.              mentioned above.
  5663.  
  5664.  
  5665.        While these three options give you the ability to get duplicate files
  5666.        showing on your screen for selection, you should realize that there will
  5667.        be many cases that, in order to eliminate ALL duplicate or redundant
  5668.        files, you will have to make multiple passes through your catalog with
  5669.        different settings; in particular, the base characters to match setting.
  5670.  
  5671.  
  5672.  
  5673.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5674.  
  5675.                                       Page 85
  5676.  
  5677.  
  5678.  
  5679.        For example, you may have files such as:
  5680.  
  5681.        ABC100.ZIP, ABC110.ZIP, ABC120.ZIP, ABC200.ZIP, etc.
  5682.  
  5683.        and
  5684.  
  5685.        CDISK700.ZIP, CDISK701.ZIP, CDISK704.ZIP, CDISK710.ZIP, etc.
  5686.  
  5687.        With the base characters set at 5 while matching only numeric characters
  5688.        after that, the second list will (possibly among other files) and with
  5689.        the base characters set at 3 with numeric character matching activated,
  5690.        the first list will show up.
  5691.  
  5692.        Once you have the desired file list showing on the screen, you are now
  5693.        ready to select the files that you would like to be erased from your
  5694.        file collection by tagging them.
  5695.  
  5696.        You can tag files in one of two ways.  The first way is to highlight
  5697.        the desired file by using the standard navigation keys and press the
  5698.        <Space Bar>.  DUPCLEAN will indicate that a file is tagged when there
  5699.        is an arrow to the left of its filename name on the screen.
  5700.  
  5701.        The other way to tag entries is to do so in groups.  To bring up a list
  5702.        of tagging functions available, hit the <T> key at the main menu.
  5703.        DISKFILL will bring up a list with the following functions:
  5704.  
  5705.          <A> - This will tag ALL of the files.
  5706.  
  5707.          <C> - This will clear the tags of ALL of the files.
  5708.  
  5709.          <S> - You will be prompted for a wildcard specification for all of
  5710.                the files that you would like to be tagged.
  5711.  
  5712.          <U> - You will be prompted for a wildcard specification for all of
  5713.                the files that you would like the tags cleared.
  5714.  
  5715.          <I> - This will "flip" the tagged status of all files.  This is
  5716.                useful if, for example, you wish to erase all but five of the
  5717.                files if a long list. Simply tag the five that you do not wish
  5718.                to erase and then select this option to quickly tag the entries
  5719.                that you do wish to erase.
  5720.  
  5721.        <Esc> - Will return you to the main menu with no further action taken.
  5722.     
  5723.        When you have the desired files selected, and are ready to erase them,
  5724.        hit <Alt>-<E> to begin the procedure.
  5725.  
  5726.        The first thing that DUPCLEAN will do is ask you which drive should be
  5727.        used for deletions (commonly A: or B:, but any drive could be used).
  5728.        While the drive that you specify will be the initial drive used for
  5729.        deletions, you may change it at any "Insert Disk xxx" prompt to another
  5730.        disk drive if you so desire (eg. when a mix of files from 3.5" and 5.25"
  5731.        disks are tagged for deletion).
  5732.  
  5733.        You will then be asked if you would like each disk to be cataloged as
  5734.        they are processed.  Answering YES to this prompt is desirable, as it
  5735.        will ensure that your catalog file is consistent with your disk
  5736.        collection.
  5737.  
  5738.  
  5739.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5740.  
  5741.                                       Page 86
  5742.  
  5743.  
  5744.  
  5745.        Note that in order for this option to work, you must have CATDISK.EXE or
  5746.        CATDISKD.EXE (depending on which one you have instructed DUPCLEAN to
  5747.        use) present in either the current directory or somewhere along the DOS
  5748.        path.  There must also be sufficient free memory to load CATDISK with
  5749.        its configured memory settings so that it can read the disk and process
  5750.        your catalog file.
  5751.  
  5752.        While DUPCLEAN doesn't use much memory itself, if you have CATDISK set
  5753.        to the limits of your computer's memory, you may not have sufficient
  5754.        free memory to perform the task.  If this is the case, and you are using
  5755.        CATDISK.EXE and you have sufficient available extended memory, we would
  5756.        recommend that you instruct DUPCLEAN to use CATDISKD.EXE instead.
  5757.  
  5758.        When you have answered the prompts, DUPCLEAN will prompt you for the
  5759.        first disk that it would like inserted in the disk drive.  To the right
  5760.        of the prompt will be the name of the file that will be erased.
  5761.  
  5762.        You have several options available to you at this time:
  5763.  
  5764.        <T>   - Change the target disk to another drive letter.
  5765.  
  5766.        <F>   - Forget this file.  DUPCLEAN will skip the file and continue on
  5767.                to the next one.
  5768.  
  5769.        <D>   - View the target disk's directory.  May be useful to diagnose any
  5770.                problems.
  5771.  
  5772.        <S>   - Shell to DOS.  May also be useful in diagnosing any problems.
  5773.  
  5774.        <Esc> - Stop the erase operation altogether.
  5775.  
  5776.        Hit any other key to continue with the erase operation.  DUPCLEAN will
  5777.        then erase each tagged file that resides on the disk.
  5778.  
  5779.        Note that DUPCLEAN makes a complete pass through the list for each disk
  5780.        involved in the process.  This is to minimize disk swapping on your
  5781.        part.
  5782.  
  5783.        If, for example, you have:
  5784.  
  5785.          FILE A on DISK 1
  5786.          FILE B on DISK 2
  5787.          FILE C on DISK 1
  5788.             and so on
  5789.  
  5790.        DUPCLEAN will prompt you for DISK 1 and erase FILE A and FILE C in the
  5791.        same pass.  It will then continue with DISK 2 and so on until the
  5792.        process is completed.
  5793.  
  5794.        As a new pass begins and a new disk is required, you will be prompted
  5795.        for it as above until all tagged files have been deleted (or skipped).
  5796.  
  5797.  
  5798.        When you are finished using DUPCLEAN, hit <Esc> to leave the program.
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5806.  
  5807.                                       Page 87
  5808.  
  5809.  
  5810.  
  5811.  
  5812.                   APPENDIX F - REGISTRATION, SUPPORT AND UPDATES
  5813.  
  5814.        As said in the introduction, CATDISK is shareware and should be
  5815.        registered if you are using it and/or would like to be able to obtain
  5816.        product support and upgrades.  If you are paying by check (business or
  5817.        personal) or money order, please be sure that it is drawn on either a
  5818.        Canadian or US bank (we can handle either).  If you wish to use your
  5819.        VISA card to register, you may either FAX the registration form to us,
  5820.        register online on our support BBS, The Shareware Connection, or
  5821.        register directly with us by voice on our sales/support line.
  5822.  
  5823.        When new versions of CATDISK are released, we send out notices to
  5824.        registered users informing them of the new release's availability.
  5825.        Once you are registered for one CATDISK release, you are considered to
  5826.        be registered for all future CATDISK releases, whether you receive them
  5827.        directly from us or not.  If you are a registered CATDISK user and
  5828.        would like to order the latest from us on disk, simply select one of
  5829.        the disk-based registration options and DEDUCT THE BASE REGISTRATION
  5830.        FEE FROM THAT.
  5831.  
  5832.        Note that we confirm all registrations in writing and provide a simple
  5833.        procedure to eliminate the shareware intro screens present in the
  5834.        program.
  5835.  
  5836.        When registering CATDISK, by mail or FAX, please use the registration
  5837.        form that is available with this program.  This registration form
  5838.        includes all pricing information for CATDISK.  The pricing on the
  5839.        registration form is guaranteed for a period of one year from the
  5840.        release date of this package (see the title page for the release date).
  5841.        If, for some reason, you do not have a registration form or the one
  5842.        year period has expired, please obtain a current registration form from
  5843.        our support BBS or contact us by phone or FAX (numbers listed below) to
  5844.        obtain the current pricing information.
  5845.  
  5846.        You will note on the registration form that we have broken out the base
  5847.        registration fee from all disk upgrade and BBS support options. This is
  5848.        mainly to accommodate those who are in a situation where they have a
  5849.        reliable source of obtaining new CATDISK releases, or those who are
  5850.        content with the version that they are using and have no desire to
  5851.        upgrade.  By breaking out all options separately, you have the
  5852.        opportunity to put together a registration/upgrade/support package that
  5853.        best suits you.
  5854.  
  5855.        Note that in the case of disk-based upgrades, we ship CATDISK on either
  5856.        one 3.5" 720K diskette, one 1.2Mb 5.25" diskette or on two 360K 5.25"
  5857.        disks.
  5858.  
  5859.        Support Location              Details
  5860.        ----------------------------  -----------------------------------------
  5861.  
  5862.        Sales/Support Voice Line      (519) 570-3523      SEE NOTE #1 BELOW.
  5863.        FAX (Orders & Support)        (519) 884-4887
  5864.        The Shareware Connection BBS  (519) 570-4132 (16,800 USR HST DS Modem).
  5865.                                                     The Home of CATDISK.
  5866.                                                     SEE NOTE #3 BELOW.
  5867.        CompuServe ID - 73307,333
  5868.  
  5869.  
  5870.  
  5871.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5872.  
  5873.                                       Page 88
  5874.  
  5875.  
  5876.  
  5877.  
  5878.        NOTES:
  5879.  
  5880.        1) In the event that no one is available to take a support call, it is
  5881.           our policy to return calls from non-registered users on an
  5882.           as-available basis.  This is necessary to allow us to serve our
  5883.           registered users on a higher priority basis.  This does not apply to
  5884.           those wishing to register CATDISK by phone with a VISA card.
  5885.  
  5886.        2) If you are not a registered user and do have questions, the best
  5887.           place to leave them is in an E-mail message on either on The
  5888.           Shareware Connection or on CompuServe.  In the case of The Shareware
  5889.           Connection, leave your message in a comment to the SYSOP or to Rick
  5890.           Hillier.
  5891.  
  5892.        3) The most up to date version of CATDISK is always available on The
  5893.           Shareware Connection BBS (number listed above).  Please note that to
  5894.           be able to obtain a new version of CATDISK, you must be a registered
  5895.           user and you must have taken the BBS Support option and must have
  5896.           remitted the applicable fee for this option.  This option will allow
  5897.           you to obtain perpetual upgrades to the CATDISK program, or any
  5898.           other shareware offering that may be made in the future.  We also
  5899.           maintain a growing library of excellent shareware products for your
  5900.           downloading pleasure.
  5901.  
  5902.           Please note that if you are not a registered with us under the above
  5903.           support plan, YOU WILL NOT BE ABLE TO ACCESS THE PROGRAM.  You may,
  5904.           however use the electronic mail features of the system to pose any
  5905.           questions you may have about CATDISK and/or obtain any missing
  5906.           documentation files and registration forms.
  5907.  
  5908.        -----------------------------------------------------------------------
  5909.  
  5910.        If you do have a question, or a bug report, or whatever, in your
  5911.        correspondence, please indicate the following:
  5912.  
  5913.        1)  The versions of CATDISK and DOS that you are using.
  5914.        2)  Your hardware configuration (Model, memory size, printer, etc.)
  5915.        3)  Any resident software that you have loaded in memory at the time.
  5916.            (i.e. Sidekick, SuperKey, Disk Caches, Print Spoolers, Ramdisks,
  5917.            etc.)
  5918.  
  5919.        This information will help us to track any problems and to suggest
  5920.        reasonable solutions to your problems.
  5921.  
  5922.  
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  5938.  
  5939.                                       Page 89
  5940.  
  5941.  
  5942.  
  5943.                         APPENDIX G - QUESTIONS AND ANSWERS
  5944.  
  5945.        As CATDISK has developed over the past while, we have received many
  5946.        questions regarding the operation of CATDISK.  The most common are
  5947.        addressed in this section of the manual.
  5948.  
  5949.        Q. When I go to catalog a new disk, CATDISK aborts the catalog file
  5950.           update with an error message that the disk is full, even though
  5951.           there is still room on the disk containing the catalog files.
  5952.  
  5953.        A. When CATDISK updates a catalog file, it does so by merging the new
  5954.           information in with the old, building a new file from the old in the
  5955.           process.  The catch here is that, at the end of the catalog file
  5956.           update, BOTH files actually exist, thereby taking up roughly double
  5957.           the size of the original catalog file.  At the end of this
  5958.           procedure, if successful, CATDISK deletes the old file and renames
  5959.           the new temporary file to what the original catalog file was called.
  5960.           The reason this is necessary is that, while re-cataloging a disk,
  5961.           there is a possibility that files were removed from that disk.  This
  5962.           method of updating the catalog provides a convenient mechanism for
  5963.           removing those files from the catalog.  It also ensures the
  5964.           integrity of your catalog file.  If the power goes out while the
  5965.           update is in progress, you will still have your original catalog
  5966.           (from before the cataloging operation) intact.
  5967.  
  5968.        Q. CATDISK currently supports archive file comments in ZIP, ZOO, ARJ
  5969.           and DWC files.  Would it be possible to extract those from ARC files
  5970.           as well?
  5971.  
  5972.        A. ARC file comments were a non-standard extension provided by PKWare's
  5973.           PKARC/PKPAK series of archivers, and as such are not supported at
  5974.           this time.
  5975.  
  5976.        Q. Would it be possible for CATDISK to support ARCHIVES within
  5977.           ARCHIVES?
  5978.  
  5979.        A. Unfortunately, the answer is no.  In order to read the directory of
  5980.           an archive within another archive file, the original one must first
  5981.           be expanded into its separate files.  Firstly, with the ever
  5982.           evolving compression methods employed with new versions of the
  5983.           archive utilities, this would be beyond the scope of CATDISK.
  5984.  
  5985.           Secondly, there would always be the possibility of overwriting an
  5986.           existing file of the same name.  It's just not feasible.
  5987.  
  5988.        Q. Is it possible for CATDISK to support file categories?
  5989.  
  5990.        A. Indirectly, CATDISK already supports file categories.  By searching
  5991.           your catalog file by keywords from the reports menu, and by starting
  5992.           each file comment with a category code, you can effectively
  5993.           implement file categories.
  5994.  
  5995.           In a sample scenario, you could come up with a list of three letter
  5996.           abbreviations for your category list (eg. WIN for Windows, SPR for
  5997.           Spreadsheets, DBS for Database, COM for Communications, etc.) and
  5998.           start each comment with these categories.  By searching for "WIN",
  5999.           you can bring up a list of files in that category.  By sorting on
  6000.           comment, you can bring up a list of filenames sorted by category.
  6001.           Your imagination is the only limiting factor.
  6002.  
  6003.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6004.  
  6005.                                       Page 90
  6006.  
  6007.  
  6008.  
  6009.        Q. In the summary report, I see disk entries for which the amount of
  6010.           free space and the amount of space used adds up to more than the
  6011.           capacity of the disk itself.  The % slack factor is also wrong.
  6012.  
  6013.        A. You probably have a corrupted file allocation table on that disk,
  6014.           and could be in for some serious trouble.  Format a fresh disk and
  6015.           transfer the files to it, and re-catalog it from that new disk.
  6016.  
  6017.        Q. After starting the cataloging process on a diskette, I discovered
  6018.           that the label on the diskette was wrong.  Would it be possible to
  6019.           abort the process, change the label and start over?
  6020.  
  6021.        A. Once the cataloging process is started, it cannot be stopped.  If
  6022.           you've run into a situation like that above, let CATDISK finish the
  6023.           task, and use option #3 to change the label on the diskette.
  6024.           CATDISK has a mechanism to automatically change the old volume label
  6025.           to the new one throughout the catalog files.  It's quick and
  6026.           painless.
  6027.  
  6028.        Q. DISKFILL seems to be missing certain disks in my catalog when
  6029.           recommending disks for backfilling.  I know that these disks have
  6030.           enough room to take one or more of the files I have tagged.  What's
  6031.           wrong?
  6032.  
  6033.        A. Check the "Squelch Specs" list in the configuration utility,
  6034.           DISKFILL.  The disks to which you are referring probably match one
  6035.           of the specifications contained in that list, in which case, they
  6036.           will be excluded from the list of disks to recommend for
  6037.           backfilling.
  6038.  
  6039.        Q. I've noticed that CATDISK seems to have missed some files on my hard
  6040.           disk when I list the catalog entries for that disk.
  6041.  
  6042.        A. CATDISK presently has an internal limitation of being able to
  6043.           remember only the first 6000 files that it sees (either in the
  6044.           directories themselves, or in any archive files whose contents are
  6045.           included in the catalog.  After it reaches this number, it will stop
  6046.           and begin cataloging the files read in.  The limitation of 6000
  6047.           files may, in fact, be lower if you do not have enough memory to
  6048.           accommodate them all.  If this is the case, you should remove some
  6049.           or all of your resident programs to free up valuable system memory
  6050.           for CATDISK to use.
  6051.  
  6052.           Also, adjusting the "disks/files per catalog" setting via the
  6053.           CDISKCFG program to the lowest value that will accommodate your
  6054.           largest catalog file will also free up some memory.
  6055.  
  6056.           If you have an 80286 computer or higher with sufficient extended
  6057.           memory, you can also use CATDISK/D (also available as shareware).
  6058.           This version can use your extended memory to attain much higher
  6059.           capacities than are possible with the standard version of CATDISK
  6060.           (up to 65500 files on the disk being cataloged).
  6061.  
  6062.        A. Another reason that this may occur, especially if your disk has less
  6063.           than 6000 entries is that the missing files may match a filespec set
  6064.           in the EXCLUDE FILES LIST that can be changed in the CDISKCFG
  6065.           utility.  Check that list out to see if this is the case.
  6066.  
  6067.     
  6068.  
  6069.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6070.  
  6071.                                       Page 91
  6072.  
  6073.  
  6074.  
  6075.        Q. Why does CATDISK slow down as my catalog files grow larger.
  6076.  
  6077.        A. As CATDISK catalogs each disk, it must make a pass through your data
  6078.           file to determine whether or not any files have been deleted or
  6079.           changed, so that the catalog file can be updated accordingly.  Many
  6080.           other disk catalogers on the market that outperform CATDISK in their
  6081.           cataloging operation retain the entire catalog in RAM.  While this
  6082.           is fast, there are two problems with it.
  6083.  
  6084.           Firstly, this imposes an extreme limitation on their ultimate
  6085.           capacity in terms of how many disks and files you can catalog.  If
  6086.           you are serious at all about maintaining a catalog of all your files
  6087.           and that your library will possibly grow to many files, these types
  6088.           of catalogers are not at all suitable for your usage.
  6089.  
  6090.           Secondly, if you should experience a power outage before you've
  6091.           saved your work, you can kiss that work good-bye.  By manipulating
  6092.           data on-disk, CATDISK does catalog your disks at a slower rate than
  6093.           the above mentioned type of cataloger, but it guarantees the
  6094.           integrity of your work.  We have also developed some very fast
  6095.           catalog updating routines, so any slowdown will be kept to a minimum
  6096.           while guaranteeing the integrity of your catalog file.
  6097.  
  6098.        Q. In DISKFILL, I have told it to call upon CATDISK to catalog each
  6099.           disk as it is filled, but at the end of each disk, the screen
  6100.           quickly blanks and then I am returned to DISKFILL.
  6101.  
  6102.        A. You probably do not have the directory where the program file
  6103.           CATDISK.EXE resides included in your DOS PATH.  DISKFILL is unable
  6104.           to ascertain whether or not CATDISK.EXE could be found and executed
  6105.           so that an appropriate error message can be displayed.
  6106.  
  6107.  
  6108.  
  6109.  
  6110.  
  6111.  
  6112.  
  6113.  
  6114.  
  6115.  
  6116.  
  6117.  
  6118.  
  6119.  
  6120.  
  6121.  
  6122.  
  6123.  
  6124.  
  6125.  
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.  
  6132.  
  6133.  
  6134.  
  6135.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6136.  
  6137.                                       Page 92
  6138.  
  6139.  
  6140.  
  6141.                       APPENDIX H - CATDISK COMPANION PROGRAMS
  6142.  
  6143.        Since its initial release in October 1986, CATDISK has grown steadily
  6144.        in popularity, and has become one of the leading cataloging programs
  6145.        available, due largely in part that it does not try be an
  6146.        everything-in-one software package.  The philosophy behind CATDISK has
  6147.        always been and always will be to provide a reliable, simple to use
  6148.        cataloging utility that performs the essential tasks of identifying the
  6149.        location(s) of individual files in a collection of disks.
  6150.  
  6151.        We will be the first to admit that there are many new functions and
  6152.        reports that CATDISK could do and does not due to the above mentioned
  6153.        philosophy.
  6154.  
  6155.        Several enterprising individuals have created companion programs to
  6156.        CATDISK that enhance its functionality.  They are briefly described
  6157.        here, along with the authors' names and addresses.
  6158.  
  6159.        All of these programs may be obtained from our support board, The
  6160.        Shareware Connection.  They are located in file area 1 on the main
  6161.        board.  As a service to the authors of these products, we have made
  6162.        them all available to ANYONE calling in to the system.  You do NOT need
  6163.        to be registered with us under the support BBS option in order to be
  6164.        able to obtain these programs.  You may also be able to find these
  6165.        programs on your local bulletin board systems as well.
  6166.  
  6167.        If your program is already listed in this section of the user manual,
  6168.        we ask that you keep us up to date on your creation by either uploading
  6169.        it to The Shareware Connection, or by sending it to us on disk at our
  6170.        regular address for registrations.  Many CATDISK users (registered and
  6171.        unregistered) call in to the board and check on the latest offerings,
  6172.        and do in fact download all of the programs listed.  If you have
  6173.        created a new program that is not listed here, please feel free to
  6174.        submit it.  If it's good, we'll "advertise" it for you here and on The
  6175.        Shareware Connection.
  6176.  
  6177.        CAT-STAT
  6178.  
  6179.        Cat-stat is a CATDISK-specific program that has two primary functions.
  6180.        It can scan your catalog file and generate some handy statistics on the
  6181.        data in your catalog file.  Ever wondered just how many megabytes worth
  6182.        of floppies you have in your collection?  This program will tell you
  6183.        that.  Its primary function, though, is to compare two CATDISK catalog
  6184.        files and tell you what files are in catalog file "A" that are not in
  6185.        "B" and vice versa.  It's great to have if you are trading files with a
  6186.        friend.
  6187.  
  6188.        Again, this program is menu-driven and very easy to use.
  6189.  
  6190.        Cat-stat is written by George Wilken and Bill Guy, and a $10 shareware
  6191.        registration fee is requested if you decide to use it.
  6192.  
  6193.        Send registrations to:  George Wilken
  6194.                                702 Deering Drive
  6195.                                Akron, OH
  6196.                                USA  44313
  6197.  
  6198.        Questions or comments may be left for the authors on CompuServe at
  6199.        71450,3172.
  6200.  
  6201.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6202.  
  6203.                                       Page 93
  6204.  
  6205.  
  6206.  
  6207.        DISK LABEL SYSTEM (DLS)
  6208.  
  6209.        One of the many requests that I have received for CATDISK to include is
  6210.        a facility to print disk labels.  The main reason that CATDISK does not
  6211.        currently have this capability is mainly due to our philosophy of
  6212.        providing a single-purpose utility that does what it does best.
  6213.  
  6214.        The good news is that this program is capable of producing disk labels
  6215.        directly from your CATDISK catalog file(s).  Additionally, it can read
  6216.        the directory information directly from a diskette if inserted in the
  6217.        floppy drive.  DLS can produce labels for 5.25" and 3.5" diskettes, as
  6218.        well as disk inserts for 5.25" diskettes.
  6219.  
  6220.        DLS is quite powerful, but is very easy to use.
  6221.  
  6222.        Several popular printers are supported.
  6223.  
  6224.        DLS is shareware, and a $15 registration fee is requested if you find
  6225.        the program useful.
  6226.  
  6227.         Author: James A. Clark
  6228.        Address: 2015 Pleasantview Drive
  6229.                 Marion, IA
  6230.                 USA  52302
  6231.          Phone: (319) 373-8896
  6232.  
  6233.        THE CATDISK UTILITIES (CDU)
  6234.  
  6235.        This collection of handy programs expands on some of the functionality
  6236.        of CATDISK.
  6237.  
  6238.        CDC pads the excess characters in the comment field with spaces (newer
  6239.        versions of CATDISK, including this release do the same), resulting in
  6240.        better compression of the data file when using programs like STACKER or
  6241.        other compression programs.
  6242.  
  6243.        CDR allows a search of the database by up to 50 wildcard specs and
  6244.        allows you to delete those files from your diskettes by prompting you
  6245.        to mount each disk as appropriate.  It will then call on CATDISK to
  6246.        update the catalog file when each disk has been cleaned up.
  6247.  
  6248.        CDF is an enhanced reporting facility.
  6249.  
  6250.        CDM assists in offloading files to floppies.
  6251.  
  6252.        CDS assists in finding files on floppies and copies them to a hard disk
  6253.        subdirectory.
  6254.  
  6255.        These utilities are written by:
  6256.  
  6257.        Robert w. Van Hoeven
  6258.        P.O. Box 131
  6259.        1170 AC Badhoevedorp
  6260.  
  6261.        Nederland / Holland
  6262.  
  6263.        Questions or comments may be left to "Rob van.Hoeven" (note the period
  6264.        in the last name - it must be there) at NetMail address 2:512/100, or
  6265.        better, 2:512/100.5, or in the FidoNet DISP echomail area.
  6266.  
  6267.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6268.  
  6269.                                       Page 94
  6270.  
  6271.  
  6272.  
  6273.        CAT2DIR v2.0
  6274.  
  6275.        Makes an ASCII file of the CATDISK.DTA file and optionally, a 0 byte
  6276.        file for each file listed in the catalog file.  Useful for PC Board
  6277.        sysops who list off-line files that were never online, so are not in any
  6278.        BBS file directory.  Can block duplicate uploads.
  6279.  
  6280.        This program is released as FREEWARE by:
  6281.  
  6282.        Scott Johnson
  6283.        4205 Long Key Lane #1526
  6284.        Winter Park, FL
  6285.        USA  32792
  6286.  
  6287.        BBS: The Freeware Hall of Fame (Rey Barry, SYSOP)
  6288.             (804) 293-4710  (USR DS 2400-14,400 BPS
  6289.  
  6290.  
  6291.  
  6292.  
  6293.  
  6294.  
  6295.  
  6296.  
  6297.  
  6298.  
  6299.  
  6300.  
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6334.  
  6335.                                       Page 95
  6336.  
  6337.  
  6338.  
  6339.                        APPENDIX I - OTHER PRODUCTS AVAILABLE
  6340.  
  6341.        For all you avid golfers out there, we have released a golf handicap
  6342.        system, called HANDICAP II, that goes way beyond just calculating a
  6343.        simple golf handicap.
  6344.  
  6345.        Among the many features of this program are:
  6346.  
  6347.          . Pull down menus for ease of use.
  6348.          . On line context sensitive help.
  6349.          . Storage capacity for up to 400 different golf courses.
  6350.          . Storage capacity for up to 128000 rounds of golf (if you exceed
  6351.            this number, I want to meet you!).
  6352.            (score and number of putts on each hole can be logged)
  6353.          . Instant retrieval of past played games, and the ability to browse
  6354.            through them.
  6355.          . An expanded handicap card that is more informative than a standard
  6356.            handicap card.
  6357.          . A report showing your average score on each hole on each course.
  6358.            - good for spotting habitual trouble holes.
  6359.          . A report showing your average putts on each green on each course.
  6360.            - good for spotting habitual troublesome greens.
  6361.          . A report showing how often you hit each green in regulation.
  6362.            - good for analyzing your tee-to-green game on each hole.
  6363.          . Many more statistical reports of interest to you.
  6364.          . Full housekeeping routines to correct mistakes (but I'll bet that
  6365.            you never make any, right?!?)
  6366.  
  6367.          . ALL reports may be viewed on the screen or printed on your
  6368.            printer.
  6369.  
  6370.          . Pop up windows are used extensively, adding to the ease of use of
  6371.            the program.
  6372.  
  6373.        We also have a clubhouse version available with all of the above plus:
  6374.  
  6375.          . A simple date-differential entry system for those who do not wish
  6376.            to have all the detail of the enhanced reports.
  6377.          . Capacity to maintain handicaps for up to 128000 members (you are
  6378.            only limited by disk size).
  6379.          . Full system manager functions available only to authorized users.
  6380.          . A handicap listing (in alphabetical order by member name) of the
  6381.            handicaps of all the members in the system.
  6382.  
  6383.                                  Ordering Information
  6384.  
  6385.        The GOLFERS version of HANDICAP II is available as shareware for $35
  6386.        directly from myself (Rick Hillier), and the CLUB HOUSE version is
  6387.        available for $295.00 (which includes a bound, printed manual) from the
  6388.        address below.
  6389.  
  6390.        They may be ordered from:  Rick Hillier
  6391.                                   98 Toynbee Crescent
  6392.                                   Kitchener, Ontario
  6393.                                   Canada   N2N 1R9
  6394.                           Phone:  (519) 570-3523
  6395.                             FAX:  (519) 884-4887
  6396.                             BBS:  (519) 570-4132
  6397.  
  6398.  
  6399.       Disk Catalog System (CATDISK) V7.30  Copr (C) 1986-1994 by Rick Hillier
  6400.  
  6401.                                       Page 96
  6402.  
  6403.