home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 02a / pmcat56.zip / PMCAT.DOC < prev    next >
Text File  |  1990-07-08  |  47KB  |  1,099 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                     PMCAT+
  25.  
  26.  
  27.  
  28.                         A Disk File Cataloging Program
  29.  
  30.                                       by
  31.  
  32.                                 Patrick Michaud
  33.                                        &
  34.                                William C. Scott
  35.  
  36.  
  37.  
  38.                                 8 July , 1990
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                             _______
  54.                                        ____|__     |               (tm)
  55.                                     --|       |    |-------------------
  56.                                       |   ____|__  |  Association of
  57.                                       |  |       |_|  Shareware
  58.                                       |__|   o   |    Professionals
  59.                                     -----|   |   |---------------------
  60.                                          |___|___|    MEMBER
  61.  
  62.                       Copyright 1989 by William C. Scott
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                                                   Page 1
  69.  
  70.                   About Our Marketing Process ... (Shareware)
  71.  
  72.           The term "shareware" has come to refer to a class of computer
  73.           software that is marketed, basically, on an honor system.
  74.  
  75.           Hopefully you noticed the logo of ASP, the Association of
  76.           Shareware Professionals, on the cover sheet of this
  77.           documentation file.  <ASP> is an organization that was formed
  78.           and is supported by software authors and businesses with an
  79.           interest in seeing shareware remain a viable means of
  80.           marketing high quality software at reasonable prices.
  81.  
  82.           An author's membership in ASP guarantees the end user at least
  83.           some protection from the vagaries of earlier and present
  84.           'public domain' software.  By becoming a member of ASP the
  85.           author has promised his/her intention to support the product
  86.           after licensing has taken place and already demostrated to ASP
  87.           the product does in fact do what it is advertised to do and is
  88.           a fully functional piece of software (not crippled or
  89.           restricted).
  90.  
  91.           (See the file OMBUDSMAN.ASP for further info)
  92.  
  93.           The end user benefits by being able to actually try the
  94.           software before paying for it. This ensures compatibility with
  95.           the system it is intended for use upon as well as the user.
  96.  
  97.           Both the author and the consumer benefit from the fact that
  98.           neither has had to bear the burden of the enormous cost of
  99.           adequate advertising.  The consumer benefits directly from the
  100.           lower cost of the software, the author somewhat more
  101.           indirectly in that he most likely would never have been able
  102.           to make the product widely available because of a lack of
  103.           capital.  In many cases you will find the support offered by
  104.           ASP authors more comprehensive than would ever be possible
  105.           from a large company.
  106.  
  107.           Finally, these ASP authors' products, like PmCat+, are not
  108.           public domain nor intended to be free.  They are offered in
  109.           good faith that they are as good as their commercial
  110.           counterparts and the authors do expect to be paid for their
  111.           efforts.
  112.  
  113.           Frankly, it is a difficult thing to offer one's work to others
  114.           with the understanding you will be compensated *only* when the
  115.           customer is convinced your product is worth purchasing.
  116.  
  117.           Please realize that PmCat+ didn't just "happen".  We have
  118.           spent a great deal of money for compilers, language tools and
  119.           hardware that is specifically dedicated to the development of
  120.           PmCat+.  This does not to even begin considering the many
  121.           hours of sitting at the keyboard, tearing out hair trying to
  122.           figure out why the obviously simple, isn't!  We must, at the
  123.           very least, recover our financial investment so that we can
  124.           continue to develop programs of this quality.
  125.  
  126.  
  127.  
  128.                                                                   Page 2
  129.  
  130.           Strictly speaking, if you do like and use PmCat+, we expect
  131.           you license the program after a reasonable trial period (about
  132.           30 - 45 days).  We also realize there are those to whom the
  133.           $20 license fee would be a burden. For those persons, please
  134.           continue to use PmCat+ for as long as you wish, with our
  135.           blessing.  Obviously, whether or not you can afford to license
  136.           PmCat+ is not a consideration we would be so bold as to
  137.           decide.  We will trust that everyone is being honest with
  138.           themselves and us about that matter and will, to the best of
  139.           our ability,  answer any questions by anyone who wishes to
  140.           inquire.
  141.  
  142.           For $20.00 you will recieve:
  143.             1.  A copy of the very latest version of PmCat PLUS on 360K
  144.                  DS/DD 5.25" floppy disk.
  145.             2.  A copy of PmDelDup, a utility for deleting duplicate or
  146.                  multiple entries of the same filename in a PmCat
  147.                  catalog.
  148.             3.  A copy of PmConvert which will convert older PmCat files
  149.                  to the new format used in release 5.2.
  150.             4.  A copy of Labelle for making diskette labels and
  151.                  inserts.
  152.             5.  Access to the registered user conference on the Coalgate
  153.                  BBS with access to the latest (registered) version of
  154.                  PmCat PLUS
  155.             6.  Placement on our mailing list to be notified of future
  156.                  updates.
  157.  
  158.           PLEASE NOTE:
  159.  
  160.           We can provide PmCat+ on 3.5" inch double density or high
  161.           density disks as well.  There is an additional $1 charge for
  162.           the 720K and $3.00 for the 1.44M because of the higher cost of
  163.           the 3.5" media.
  164.  
  165.           When you wish to register PmCat+, please send check or Money
  166.           Order to the address below:
  167.  
  168.                                William C. Scott
  169.                                  P.O. Box 474
  170.                               Coalgate, OK 74538
  171.                               Ph: (405) 927-3840
  172.  
  173.           See the file PM-ORDER.FRM for an invoice type order form.
  174.  
  175.           I may be reached on Compuserve and GEnie:
  176.  
  177.                      CompuServe ID#:  71406,1251
  178.                      GEnie address :  WILLSCOTT
  179.  
  180.           or:        SYSOP - Coalgate BBS :    (405) 927-2541
  181.                             (USR HST14.4 24hrs)
  182.  
  183.  
  184.  
  185.  
  186.                                                                  Page 3
  187.  
  188.  
  189.  
  190.  
  191.  
  192.     COPYRIGHT NOTICE
  193.  
  194.           PmCat+, copyright 1987-90 by William C. Scott.  PmCat+ is NOT
  195.           public domain software.  You may use, copy and distribute it
  196.           freely, but you MAY NOT RESELL PmCat+.  A modest fee for
  197.           copying may be charged, not to exceed $3.00 exclusive of the
  198.           cost of disk, mailer and postage. (See "About Our Marketing
  199.           Process" for more details)
  200.  
  201.  
  202.  
  203.  
  204.  
  205.     DISCLAIMER:
  206.  
  207.           By using this product, the user agrees that neither William C.
  208.           Scott nor Patrick R. Michaud are severly or jointly liable for
  209.           any damages, direct or consequential, that might arise from
  210.           the use or misuse of PmCat+.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                                                                 Page 4
  247.  
  248.  
  249.                            TABLE OF CONTENTS
  250.  
  251.         About Our Marketing - Shareware and ASP   ...............    2
  252.  
  253.         I.  Introduction   ......................................    5
  254.  
  255.        II.  Getting Started
  256.           A.  System requirements   .............................    6
  257.           B.  Features of PmCat+
  258.             1.  List of features   ..............................    6
  259.             2.  Explanation of features   .......................    7
  260.           C.  Installation   ....................................    8
  261.           D.  THINK about these things ..........................   10
  262.  
  263.       III.  Cataloging functions
  264.           A.  Create a new catalog   ............................   12
  265.           B.  Add to existing catalog   .........................   12
  266.           C.  Update an existing catalog   ......................   12
  267.           D.  Save present catalog   ............................   12
  268.  
  269.        IV.  Browse functions
  270.           A.  File information  (InfoWindow)   ..................   13
  271.           B.  Read contents of cataloged files    ...............   13
  272.           C.  Volumes listing   .................................   13
  273.           D.  Directories   .....................................   13
  274.           E.  Search   ..........................................   14
  275.           F.  Sort   ............................................   14
  276.           G.  Change catalogs   .................................   14
  277.           H.  Masks   ...........................................   14
  278.  
  279.  
  280.         V.  Printing functions
  281.           A.  Formatting output   ...............................   14
  282.           B.  Printing   ........................................   16
  283.           C.  Printer set up string   ...........................   16
  284.           D.  Saving to ASCII disk file   .......................   16
  285.  
  286.        VI.  Misc functions
  287.           A.  Delete volume   ...................................   16
  288.           B.  Erase (delete) file   .............................   16
  289.           C.  Commenting   ......................................   17
  290.           D.  Shell   ...........................................   17
  291.           E.  Change volume label    ............................   17
  292.           F.  Using the .DEF file    ............................   17
  293.           G.  Using disk numbering   ............................   17
  294.           H.  Using categories   ................................   18
  295.           I.  Using Wildcards in PmCat+   .......................   19
  296.           J.  Soundex searches   ................................   19
  297.  
  298.       VII.  BBS Access  .........................................   20
  299.  
  300.  
  301.                                                                 Page 5
  302.  
  303.     INTRODUCTION
  304.  
  305.                 PmCat+ is a floppy and hard disk file cataloging and
  306.             browsing program intended for use on PC/XT/AT and compatible
  307.             systems.
  308.  
  309.                 PmCat+ is a direct descendent of PmCat which was a disk
  310.             file cataloging program intended for use only with floppy
  311.             disk files.  So many users just naturally began using it to
  312.             catalog their hard drive files that many requests were made
  313.             for features that were obviously hard drive oriented. So, we
  314.             decided PmCat+ should accomodate hard drives gracefully.
  315.  
  316.                 The original PmCat was written by Patrick Michaud for my
  317.             personal use.  Like so many others, I couldn't find a
  318.             cataloger that addressed my personal habits adequately
  319.             (simple, fast and useful were some of my prime requisites).
  320.  
  321.                 When Patrick first wrote PmCat, it was so good we
  322.             decided to pat it on the rear and send it out into the 'real
  323.             world' as a shareware product ... "as an experiment" we
  324.             decided ... just to see what happened.
  325.  
  326.                 Well, about three months later a phone call came to me
  327.             from Alfred Glossbrenner who was writing a book about PC
  328.             shareware products and wanted to include PmCat in his book
  329.             ... which did occur when it was published.  My thought at
  330.             this point was ... "here's a professional in the PC world
  331.             who thinks highly enough of PmCat to choose it over all
  332.             those others...gee whiz!"  Both Patrick and I were deeply
  333.             flattered.
  334.  
  335.                 We soon realized our experiment had told us we had
  336.             something in PmCat.  So we set about making the necessary
  337.             improvements to make it palatable and useful to as many
  338.             people as possible.
  339.  
  340.                 As it turned out, Patrick's studies kept him from doing
  341.             much more with PmCat except correcting and cleaning up my
  342.             early code as I learned to program in Turbo Pascal in order
  343.             to support PmCat.
  344.  
  345.                 Since late 1987, most of the changes made to PmCat have
  346.             been a result of my meanderings through Turbo Pascal and the
  347.             PmCat code in response to users requests for changes/fixes
  348.             and improvements.
  349.  
  350.                 So here it is, PmCat PLUS. I am calling it version 5.0
  351.             in deference to its PmCat heritage, but it has been
  352.             substantially rewritten in many ways, including the use of
  353.             overlays, but retains the familiar look of the original
  354.             PmCat.
  355.  
  356.  
  357.  
  358.                                                                 Page 6
  359.  
  360.  
  361.         Minimum System Requirements:
  362.  
  363.             IBM PC/XT/AT or compatible, 384K RAM, one floppy disk
  364.             drive.  Hard drives and subdirectories are supported.
  365.  
  366.         Suggested extra system features:
  367.  
  368.             More Memory! - PmCat+ *will* run in only 384K but 512K or
  369.                            640K is strongly recommended.
  370.  
  371.             Color monitor - either CGA, EGA or VGA makes fuller use of
  372.                             the different menu options easier.
  373.  
  374.             Mouse - these rodents are down in price to about $30 on
  375.                     the bottom line of pricing and make a lazy man's
  376.                     use of a computer much more palatable.
  377.  
  378.             Disk caching - these programs are fairly common and many are
  379.                            either public domain or shareware. This can
  380.                            speed up PmCat+ because of its use of
  381.                            overlays.
  382.  
  383.  
  384.         FEATURES
  385.              * Use categories to group your files
  386.              * Use numbering of disks through volume labels or a separate
  387.                 disk number ... or both!
  388.              * Catalog contents of archived files
  389.              * View files, archived or not while in PmCat+!
  390.              * Context sensitive help
  391.              * Mouse support
  392.              * Include and/or exclude files (read/view/print)
  393.              * Delete individual files from catalog
  394.              * Delete volumes from catalog
  395.              * Find Free Space on cataloged diskettes
  396.              * Assign a DRIVE:\PATHNAME to be a VOLUME
  397.              * Read subdirectories and labels, too
  398.              * Comment each file with up to 80 characters
  399.              * "Rubber-stamp" for comments for duplicate files
  400.              * Sort catalog by filename, ext, size, path or date
  401.              * Supports WILDCARD ("*" and "?") searches files
  402.                and comments
  403.              * User configurable printer formatting
  404.              * Automatic update of catalog when disks are reread
  405.              * User customizing of color, catalog name, ASCII filename
  406.              * Relabel diskette if desired
  407.              * Create ASCII disk file with user-assigned name
  408.              * Multiple catalogs with your specified names
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                                                                 Page 7
  415.  
  416.  
  417.  
  418.         Explanation of features:
  419.  
  420.                 The detailed explanation of each menu function is listed
  421.                 in the later part of the catalog.  This portion explains
  422.                 the general use of the keyboard and/or mouse to access
  423.                 those options.
  424.  
  425.                 The HELP function is toggled ON/OFF by pressing the 'H'
  426.                 key on the keyboard or the right AND left buttons of the
  427.                 mouse at the same time or <F1>. This function does not
  428.                 toggle in the shareware distribution copy.
  429.  
  430.                 Each menu can be accessed through three functions, the
  431.                 HOT KEY, the MENU BAR or the mouse.
  432.  
  433.                 On each menu item, one letter is capitalized. Pressing
  434.                 that letter or character on the keyboard will select
  435.                 that menu item and cause it to be executed.
  436.  
  437.                 On each menu, one item is indicated at a time by the bar
  438.                 selector or MENU BAR.  The MENU BAR is moved using the
  439.                 RIGHT and LEFT keyboard arrow keys. When the bar is on a
  440.                 item, pressing <ENTER> on the keyboard will select that
  441.                 item and cause it to be executed.
  442.  
  443.                 Where appropriate the RT/LT, UP/DN arrows, PgUp/PgDn and
  444.                 Home and End keys are active for the screen instead of in
  445.                 the menu area, as well as functions available to do the
  446.                 same things on the menu with the mouse.
  447.  
  448.                 The cursor within the menu area (which you will see if a
  449.                 mouse is present) is the mouse cursor.  Use your mouse
  450.                 to select an item by placing the cursor on the item name
  451.                 or within 1 space on either side and pressing the left
  452.                 mouse button.  If HELP is turned on, another click of
  453.                 the left button is necessary to execute the function.
  454.                 This was done to allow you to see what the operation
  455.                 does before you execute it.  When HELP is turned off,
  456.                 the second click is not necessary.
  457.  
  458.                 Pressing the RIGHT mouse button is the same as pressing
  459.                 the <ESC> key on the keyboard.
  460.  
  461.                                                                 Page 8
  462.  
  463.  
  464.  
  465.         INSTALLING PmCat+
  466.  
  467.                 Two files are required for PmCat+ to run, the
  468.             PMCP54DS.EXE file and the PMCP54DS.OVR file.  The overlay
  469.             file, (.OVR extension) must be either in the same directory
  470.             from which PmCat+ is run or in a directory which is in your
  471.             DOS path definition.
  472.  
  473.                 You MUST retain the overlay filename of PMCP54DS.OVR.
  474.             The executable file of PMCP54DS.exe may be renamed as you
  475.             wish.
  476.  
  477.         The following items are essential only to the browsing and
  478.         archive extraction functions of PmCat+.
  479.  
  480.             The defaults installed in PmCat+ will look for the other
  481.              files it may require, in the current directory. (The
  482.              directory you are in when you run PmCat+).  The defaults
  483.              referred to involve the following programs and locations.
  484.  
  485.                 1. Text viewer/editor - PMLIST.COM (which is really a
  486.                                    public domain program called R.COM)
  487.        ( Note use of R.COM -> )    is included for simple viewing of
  488.                                    text files.  You may be able to use
  489.                                    your favorite text viewer/editor in
  490.                                    place of this (such as LIST or ML)
  491.                 2. ARC extractor - program for extracting the contents
  492.                                    of .ARC files. ARCE.COM is default.
  493.                 3. ZIP extractor - program for extracting the contents
  494.                                    of .ZIP files. PKZIP.EXE is default.
  495.                 4. ZOO extractor - program for extracting the contents
  496.                                    of .ZOO files. ZOO.EXE is default
  497.                 5. PAK extractor - program for extracting the contents
  498.                                    of .PAK files. PAK.EXE is default
  499.                 6. LZH extractor - program for extracting the contents
  500.                                    of .LZH files. LHARC.EXE is default.
  501.                 7. Scratch path -  a drive/directory path where the
  502.                                    files extracted from an archive will
  503.      (Choose carefully! .. the     be written while you view them. You
  504.       extracted file will be       cannot edit files from within an
  505.       deleted later..suggest a     archive and update the archive with
  506.       'SCRATCH' directory)         the changed file from PmCat+.
  507.                 8. Target drive - This is the drive on which PmCat+ will
  508.                                    try to find the file chosen, using
  509.                                    the pathname information stored in
  510.                                    the PmCat+ catalog. The default is
  511.                                    drive 'A'.
  512.  
  513.  
  514.  
  515.  
  516.                                                                 Page 9
  517.  
  518.  
  519.             NOTE: NO decompressing code is in the PmCat+ program.  It is
  520.                   assumed if you have files stored with a compression
  521.                   program, that program can be excuted from the DOS
  522.                   command line and thereby used to extract files.
  523.                   PmCat+ just acts as a messenger between you and the
  524.                   archiving program by sending the filename to extract
  525.                   to the program you have said will extract it.
  526.  
  527.                 If you don't know how to configure your system using
  528.             PATH and don't want to deal with it (for whatever reason),
  529.             just place copies of the appropriate programs from the
  530.             above list in the same directory as your PmCat+ files and
  531.             catalog.
  532.  
  533.  
  534.  
  535.  
  536.                                                                 Page 10
  537.  
  538.  
  539.         Things to consider BEFORE you start building your catalog:
  540.  
  541.                 The new features added to PmCat have made a great deal
  542.                 of flexibility in structuring your catalog possible.
  543.  
  544.                 These very same features will likely confuse you if you
  545.                 decide to use them without proper consideration. They
  546.                 CAN be ignored and everything done as always with PmCat,
  547.                 but they are there if you want or need them.
  548.  
  549.                 The features most likely to offer confusion are the DISK
  550.                 number and CATEGORY function.
  551.  
  552.                 As of version 5.3, these are NOT written to the disk in
  553.                 any manner.  They are a form of notation to aid you in
  554.                 keeping track of things with your disk collection.
  555.  
  556.         CATEGORIES - these are assigned to the volume when you catalog
  557.                 it. All files on the volume will have the same category
  558.                 in your PmCat data file.  You may Edit the categories of
  559.                 Files or Volumes once cataloged by using the Edit
  560.                 function in PmCat.  Presently, if you update the volume,
  561.                 you will lose those Edited cate- gories and the category
  562.                 will once again be whatever you assign to the volume.
  563.                 This will be fixed in a future release..but be aware it
  564.                 is a limitation of sorts just now.
  565.  
  566.                 Assigning a category - when you Update a volume, there
  567.                 is a menu choice of CATEGORY. Select this and pick one
  568.                 of the existing categories or use the Update key to
  569.                 create a new category.  DON'T FORGET to save the new
  570.                 definitions to your .DEF file if you use CATEGORIES
  571.                 other than the defaults!
  572.  
  573.         DISK NUMBERING - in the early stages of testing, this seemed to
  574.                 create the greatest confusion.  Actually, it is a rather
  575.                 easy and powerful feature once you understand what it
  576.                 does.
  577.  
  578.                 There are three modes for Disk Numbering, OFF, MANual,
  579.                 and AUTOmatic and these are reflected on the Update
  580.                 Screen window. They are changed by selecting Numbering
  581.                 from the menu and using the arrow keys to select the one
  582.                 you want.
  583.  
  584.                 If you select OFF, a number of '0' will be assigned as a
  585.                 placeholder in the data file and otherwise ignored.
  586.  
  587.                 If you select MANual, the number that is shown above the
  588.                 window as Disk # will be assigned to the disk when it is
  589.                 cataloged. You may assign a new or different number just
  590.                 by typing it in.
  591.  
  592.                 If you select AUTOmatic the number you set is
  593.                 automatically incremented each time a disk is cataloged.
  594.                 You may set the starting number in the same way as for
  595.                 MANual ... just type it in.
  596.  
  597.  
  598.  
  599.                                                                 Page 11
  600.  
  601.         There is also an option called Duplicate Disk Numbers Allowed
  602.                 which is a YES/NO choice.  It WILL NOT PREVENT
  603.                 duplicates, it merely checks for them as an aid to you.
  604.                 If this is set to YES, the option is essentially
  605.                 inactive... since YES indicates you want to allow
  606.                 duplicates.
  607.  
  608.                 OK, when YES and when NO?  Let's take, for example, a
  609.                 situation where you want to store your disks in strict
  610.                 numerical order (as many do).  Each disk has a small
  611.                 sticker or other marking indicating its numeric order
  612.                 in your catalog.  In such a case, every number is likely
  613.                 to be unique and you would NOT want to allow duplicate
  614.                 Disk Numbers.
  615.  
  616.                 Alternatively, perhaps you have your disks stored or
  617.                 referenced alphabetically by categories, such as GAMES,
  618.                 BASIC, etc.  In this case you can catalog your disks
  619.                 using CATEGORIES and AUTOmatic numbering with duplicate
  620.                 disk numbers allowed.  You might catalog 5 games disks,
  621.                 as GAMES 1 thru GAMES 5 and your BASIC disks in the same
  622.                 manner.  As the categories grow, it is a simple matter
  623.                 to add GAMES 6, GAMES 7 and so on to your library. PmCat
  624.                 will allow you to view only the GAMES category disks if
  625.                 you like by selecting the <L>imit option in the <V>iew
  626.                 window.  Just place the cursor on a file with the category
  627.                 you want to limit your viewing to, and press <L>.  The
  628.                 catalog will be searched an only the GAMES (?) will be
  629.                 displayed.  (If you print at this point, only the selected
  630.                 category will be printed, as well)
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.                                                                 Page 12
  638.  
  639.     CATALOGING FUNCTIONS
  640.  
  641.         CREATE A NEW CATALOG:  <R>ead, <W>rite  on MENU 1 and MENU 2
  642.  
  643.             Any time PmCat+ <R>eads a catalog from disk, you are shown
  644.              the current catalog name and prompted for a catalog name. If
  645.              you wish to use the catalog name shown, just press <ENTER>.
  646.              If using a mouse, place the mouse cursor on the ENTER menu
  647.              item and press the right button.
  648.  
  649.             To specify a name of your choosing just start typing it in
  650.              and press <ENTER> or press the left mouse button when
  651.              complete. A filename with wildcards is acceptable and will
  652.              place you in the 'pick list' with the appropriate files to
  653.              choose from.
  654.  
  655.             To select a catalog from the files on disk, select or type
  656.              the asterisk ('*') and press <ENTER>.  This will present
  657.              you with a 'pick list' from which to choose.
  658.  
  659.             This sequence of events first occurs when you run PmCat+. It
  660.              also happens each time you <R>ead from or <W>rite to the
  661.              disk.
  662.  
  663.  
  664.         ADD FILES/UPDATE CATALOG:    <U>pdate menu option  on MENU 1
  665.  
  666.             <U>pdate appears only on the first menu (MENU 1) you
  667.              encounter in PmCat+.  Choosing this option takes you to a
  668.              window where you may
  669.  
  670.                 1) Read files from a drive which you specify by pressing
  671.                    the appropriate letter on the keyboard or choosing it
  672.                    from the menu ... or
  673.  
  674.                 2) Change the volume label of a disk drive by using the
  675.                    '#' symbol on the menu or from the keyboard.
  676.  
  677.         SAVE CURRENT CATALOG TO DISK:  <W>rite  on MENU 1 or MENU 2
  678.  
  679.             <W>rite will save the current catalog to disk from
  680.              either MENU 1 or MENU 2.
  681.  
  682.  
  683.  
  684.  
  685.                                                                 Page 13
  686.  
  687.  
  688.  
  689.     BROWSE FUNCTIONS:  <I>nfo, <V>olumes, <D>ir, <SPACE>  on MENU 2
  690.  
  691.     These are the functions you will use to find files and view their
  692.     statistics, comments and contents of the actual file if desired.
  693.  
  694.         <V> menu selection from MENU 2 will cause a list of volumes
  695.          contained within the current catalog to be displayed.  The
  696.          volumes may be sorted just as though they were filenames (which
  697.          really is what a DOS volume label is ... with the appropriate
  698.          attribute set).
  699.  
  700.         <D> on MENU 2 will show the list of files contained within that
  701.          directory-type object.  If it is a directory then the files are
  702.          shown. If it is a compressed file then the contents of the
  703.          archive are shown if you cataloged the disk with archive reading
  704.          turned on.
  705.  
  706.         <SPACE> - pressing the spacebar will allow you to view the
  707.          contents of the file that is currently being pointed to by the
  708.          selector bar in the window.  Check to make sure the file is
  709.          located on the drive indicated on the line just above the menu.
  710.          If it needs to be changed, just press the appropriate key to
  711.          select the right drive and then press <ENTER>.  What happens at
  712.          this point is partly dependent on which program you have chosen
  713.          to run (the text viewer/editor you specified or accepted in the
  714.          Set Defaults area).
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.                                                                 Page 14
  722.  
  723.  
  724.         SEARCH:  <F>ind, <N>ext   on MENU 2
  725.  
  726.         These functions are used to find files by filename, an entry in
  727.         the Comments field and they are also used to find free space on
  728.         a volume when the list of volumes is displayed. SEE NOTE ON PAGE
  729.         16 ABOUT SOUNDEX SEARCHES.
  730.  
  731.             <F>ind will first prompt you to select whether you wish to
  732.              search for a file based on filename, comments or free
  733.              space. The free space choice is an invalid choice if a list
  734.              of volumes is not being displayed.
  735.  
  736.             <N>ext will find the next entry matching the search
  737.              criterion you provided for the <F>ind command.
  738.  
  739.  
  740.         SORT:  <S>ort    on MENU 2
  741.  
  742.             <S>ort can be selected from only MENU 2 while PmCat+ is
  743.              running. However, turning autoSort ON while setting default
  744.              filenames and paths will cause a sort by filename when you
  745.              move from MENU 1 to MENU 2 to occur automatically.
  746.  
  747.             After selecting <S>ort from MENU 2, you will be prompted to
  748.              choose among filename, ext, size, date and path as the
  749.              options on which to sort.  Select one..
  750.  
  751.             Then you will be prompted for sort order - ascending or
  752.              descending. Descending puts the largest value first whick
  753.              would be appropriate for volume free space (that's the Size
  754.              of volumes) but not for alphabetically arranged data.
  755.  
  756.         CHANGE CATALOGS: <R>ead   on MENU 1
  757.  
  758.             This procedure is identical to the initial reading of a
  759.              catalog when you enter PmCat.  It first clears the memory
  760.              of the existing catalog and then prompts you for a new
  761.              catalog name which you may enter using the keybored or pick
  762.              list function.
  763.  
  764.  
  765.         MASKS: <M>ask-set  on MENU 1a3    (arrow keys disabled in menu)
  766.  
  767.             The Mask function consists of two portions, Include and
  768.              Exclude and act as a filter.  It works on those files you
  769.              wish to View, Print or Catalog using PmCat+ when either of
  770.              its actions are turned ON.
  771.  
  772.             Include and Exclude may be toggled ON or OFF independently
  773.              of each other by selecting them from MENU 1a3.
  774.  
  775.  
  776.  
  777.  
  778.                                                                 Page 15
  779.  
  780.  
  781.             If both are selected, Include takes precedence.  Remember,
  782.              if you turn both ON, NOTHING will be INCLUDED, except what
  783.              you specify and the same goes for EXCLUDE.  This can be
  784.              tricky until you get used to it.
  785.  
  786.             The menu (1a3) for changing the MASK functions is buried
  787.              with the set colors, set print formatting and set default
  788.              paths, all of which are accessed thru the <S>et defaults
  789.              option of MENU 1.
  790.  
  791.             At MENU 1a3:
  792.                 Exclude - toggles the exclude list ON/OFF
  793.                 Include - toggles the include list ON/OFF
  794.                 Clear - clears the item pointed to by the bar cursor
  795.                 <ENTER> - allows you to input a new or change the old item.
  796.  
  797.  
  798.     PRINTING: <P>rint on MENU 2, <P>rint on MENU 1a4, <D>isk from print
  799.  
  800.         FORMATTING OUTPUT:   (arrow keys disabled in menu)
  801.  
  802.             <P>rint selected from MENU 1a4 opens a window to allow the
  803.             format parameters for your printed catalog.
  804.  
  805.                 Start-col is the column of the printed page on which the
  806.                  field will begin.
  807.  
  808.                 Width is how many characters the field will occupy on
  809.                  the printed document. This can be any width you desire,
  810.                  but if it is less than required for any field except
  811.                  comments, it will be truncated (chopped off).
  812.  
  813.                 Comments will print on the next line at the same start
  814.                  col for the width you specify and repeat until all
  815.                  actual comments for that file are printed. Then it
  816.                  will begin printing the next entry. Comments are left
  817.                  justified.
  818.  
  819.                 Filename is a 12 character field consisting of the
  820.                  filename, a period and the file extension. It is right
  821.                  justified.
  822.  
  823.                 Size is a number that will occupy 10 spaces. It is right
  824.                  justified.
  825.  
  826.                 Date will occupy 10 spaces, MM/DD/YY format.
  827.  
  828.                 Path can be up to 65 characters and is the path to the
  829.                  file on its particular volume.
  830.  
  831.                 Volume is the volume name from which the file was read.
  832.                  It may be up to 11 chars and is left justified.
  833.  
  834.  
  835.  
  836.  
  837.                                                                 Page 16
  838.  
  839.  
  840.  
  841.         PRINTING:  <P>rint  on MENU 2
  842.  
  843.             PRINTER SET UP STRING: <*>  on Print window menu
  844.  
  845.                 <*> - will prompt you for a new string of characters
  846.                  which will be sent to your printer before printing
  847.                  of the catalog starts.
  848.                     Each character must be in decimal form and
  849.                     preceded by a '#' and followed by a space.
  850.  
  851.                         e.g.,   #27 #15
  852.  
  853.                     Up to 20 characters may be used here.
  854.  
  855.             ASCII DISK FILE: <D>   on Print window menu
  856.  
  857.                 <D> - will cause the output which would normally go to
  858.                  your printer, to be sent to the disk as a file with the
  859.                  name you specify in ASCII format.  It can be easily
  860.                  edited and/or printed at a later time.
  861.  
  862.     MISC FUNCTIONS:
  863.  
  864.         DELETE VOLUME:
  865.  
  866.             <D> - chosen at MENU 1 will open a window with all the
  867.              volumes in your current catalog.  To delete a volume, use
  868.              the UP/DN arrow keys and select it with the bar and press
  869.              <ENTER>.  You will still be given an opportunity to abort
  870.              the operation at this point by answering Y/N on the menu.
  871.              Obviously this operation is not final till you save the
  872.              modified catalog to disk...but at that point, it is
  873.              permanent.
  874.  
  875.         ERASE FILE:
  876.  
  877.             <K>ill a file from MENU 2.  It is the same process as
  878.              deleting a volume from MENU 1.  The difference in the two
  879.              operations is, when you Erase a file, the slot it occupied
  880.              on the screen is shown >>DELETED<< instead of removed
  881.              altogether.  As with volume deletion, the operation is not
  882.              final until you save the modified catalog to disk.
  883.  
  884.  
  885.  
  886.                                                                 Page 17
  887.  
  888.  
  889.         COMMENTING FILE:
  890.  
  891.             <C>omments may be added to files *and* volumes.  To comment a
  892.              volume you just select the <V>olume list from MENU 2 and
  893.              select <C> from the menu.  A small editor aids you in the
  894.              input of your comments.  A 40x2 window accepts your comments.
  895.              The UP/DN arrow keys will move between the lines, the HOME/END
  896.              keys are active and INSERT is the standard mode (there is NO
  897.              overstrike mode). DELETE works as well.  PgUp/PgDn will accept
  898.              your comments and immediately place you in the comments field
  899.              of the preceding or succeeding file, ready to type more
  900.              comments.
  901.  
  902.         OPERATING SYSTEM (Shell):
  903.  
  904.             <O> - from MENU 2 will execute a call to create a temporary
  905.              shell in DOS so you can copy, delete, inspect and otherwise
  906.              wreak havoc on your poor unsuspecting system.  If enough
  907.              memory is not available, this feature will refuse to work.
  908.  
  909.         CHANGING VOLUME LABEL:
  910.  
  911.             <#> - chosen when in the <U>pdate section, will read the
  912.              present disk label, tell you what it is and ask you if you
  913.              wish to change it.  You MUST have a drive selected for this
  914.              feature to function.
  915.  
  916.         USING THE .DEF FILE:
  917.  
  918.             This option, frankly can be tricky if you want a different name
  919.              than PMCAT.DEF.  PmCat+ will *always* look for 'PMCAT.DEF'
  920.              when it is run, if it isn't found the internal defaults are
  921.              used.  The option of providing the alternative .DEF files was
  922.              to cover the possibility that someone might want an
  923.              alternative color set or other defaults on occassion.
  924.              Frankly, I use PMCAT every day and never use this option, but
  925.              it was an option that was so simple to offer and doesn't get
  926.              in the way of anything else, that it was put in.
  927.  
  928.         USING DISK NUMBERING
  929.  
  930.             There are three aspects to using the disk numbering feature of
  931.              PmCat PLUS.  First, what number to assign the disk and second,
  932.              how to assign that number.  Finally, you decide whether to
  933.              allow duplicate disk numbers or not.
  934.  
  935.             Also, the disk numbering feature is separate from the
  936.              sequential numbering of the Volume Labels from within PmCat
  937.              PLUS.  These numbers are part of the catalog record but are
  938.              NOT written to the disk.
  939.  
  940.             When you catalog a disk with disk numbering active and have
  941.              decided NOT to allow duplicates , PmCat PLUS will check for
  942.              the existence of both that disk number and the volume label
  943.              with which it is associated and issue a warning when it finds
  944.              duplication of either.
  945.  
  946.  
  947.  
  948.                                                                 Page 18
  949.  
  950.  
  951.             How To Number:
  952.  
  953.                 OFF - means ignore the function. A number of '0' is assigned
  954.                       in this case.
  955.  
  956.                 MAN - manual entry of the number.  You do this by simply
  957.                       beginning to type the number desired for the disk
  958.                       immediately prior to cataloging that disk.  When you
  959.                       make the first keystroke, a small text line will appear
  960.                       on the screen one line above the menu.  If you wish to
  961.                       abort the process, just press <ESC> and the old number
  962.                       will be left unchanged. Remember, in this mode you
  963.                       MUST ENTER THE NUMBER for it to be assigned.
  964.  
  965.                 AUT - in this mode, each time a disk is read, the number that
  966.                       will be assigned to the next disk is generated auto-
  967.                       matically by incrementing the prior disk number by one.
  968.                       This feature may be overridden by manual entry of the
  969.                       number as described above, for any disk.  Upon entry
  970.                       to PmCat PLUS, the number is set to zero, unless it
  971.                       has been saved in the DEF file.
  972.  
  973.         USING CATEGORIES
  974.  
  975.             A category may be assigned at the same time the disk number
  976.              above is assigned, though neither is dependent on the use
  977.              of the other.
  978.  
  979.             The category list is accessed by choosing either <C>ategory
  980.              from the Update window menu or <E>dit from the View window
  981.              menu.
  982.  
  983.             In either case, to set a category for the item of interest,
  984.              just place the cursor bar on the category you wish and
  985.              press <ENTER>.  The list of CATEGORIES will automatically
  986.              be sorted.  They will be saved to your .DEF file when you
  987.              exit PmCat PLUS.
  988.  
  989.             If you wish to have different categories than those in the
  990.              defaults, just select <U>pdate from the menu while viewing
  991.              the category window and type in the new category.  A
  992.              category name is limited to 10 characters.
  993.  
  994.             When a category is assigned to a volume before it is read,
  995.              all files on that volume are assigned the same category by
  996.              default.
  997.  
  998.             The category of any file or volume may be changed by
  999.              choosing the <E>dit function in the View window menu.
  1000.  
  1001.             In order to limit your viewing or printing of files based on
  1002.              their category, just place the cursor on a file that has
  1003.              the category you want and select <L>imit from the View
  1004.              window menu.
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.                                                                 Page 19
  1011.  
  1012.  
  1013.  
  1014.         USING WILDCARDS:
  1015.  
  1016.              PmCat+'s wildcards are a bit more flexible than DOS's.
  1017.               E.g., if you type *ca*.* with DOS's dir command, it will
  1018.               show ALL files.  It sees the first '*' and then looks for
  1019.               the '.' and extension wildcard.  If you used that same
  1020.               wildcard in PmCat+ it would find all files with 'ca'
  1021.               anywhere in their filename (not extension).
  1022.  
  1023.             When searching for a string in Comments, don't forget to
  1024.              precede it with a '*' unless you are certain the first
  1025.              character of the comments you want will match the first
  1026.              character of the string you search for.
  1027.  
  1028.             Where '*' assumes ALL characters match, '?' assumes the
  1029.              match of only a SINGLE character.
  1030.  
  1031.  
  1032.         SOUNDEX SEARCHES:
  1033.  
  1034.             When you chose the <F>ind option from MENU 2, you will see
  1035.              four options; filename, comments, size and soundex.  The
  1036.              soundex search functions only on filenames and from the
  1037.              first character.  With those limitations in mind, you can
  1038.              type in a key that simply 'sounds' like the one you want,
  1039.              and PmCat PLUS will locate that file for you.
  1040.  
  1041.             To find a string of characters within a string you must
  1042.              use the wildcards as described above.
  1043.  
  1044.             Soundex searches work in a very unique manner. The first
  1045.              character (alphabetic) and a numeric code for the rest of
  1046.              the search string, which is generated by the Soundex routines
  1047.              based upon phonetic approximations, are combined into the
  1048.              patter which is searched for.  You will find it matches
  1049.              things you don't expect and doesn't on some things you
  1050.              expect.  A bit of experience in using it can make it a
  1051.              useful tool, however.
  1052.  
  1053.             Basically, type in the word you wish to find, or the closest
  1054.              spelling you can imagine.  The Soundex search may well
  1055.              suprise you with its effectiveness.
  1056.  
  1057.  
  1058.  
  1059.                                                                 Page 20
  1060.  
  1061.  
  1062.         PmCat PLUS and COALGATE BBS :
  1063.  
  1064.             On the first of February, 1990 the Coalgate BBS will officially go
  1065.              on-line.
  1066.  
  1067.             Purchase of a 9600 baud US Robotics HST modem is under way and
  1068.              should be on-line no later than 15 February.
  1069.  
  1070.             The Coalgate BBS is a free access board, primarily dedicated to
  1071.              providing information to the disabled/handicapped.
  1072.  
  1073.             Approximately 20-25 megabytes will be dedicated to downloadable
  1074.              files for MSDOS computers.  These will be the best of the public
  1075.              domain and shareware programs from my library of about 80 megs.
  1076.  
  1077.             Until the board becomes busy, there is no practical limit on
  1078.              access time (the system won't grant more than 255 minutes a day
  1079.              by design).
  1080.  
  1081.             Once a registered user calls, he/she will be given access to the
  1082.              registered user conference and have access to the latest version
  1083.              of PmCat PLUS (registered).  So, if you plan to get the updates,
  1084.              it would be good planning to call and just leave a quick note to
  1085.              let me know you want to be given access.  I'll do so for you as
  1086.              quickly as possible.
  1087.  
  1088.             Even on your first call, you have unlimited download privileges,
  1089.              so don't hesitate to give a ring.
  1090.  
  1091.             All the files may not be commented, but TPBoard allows the user to
  1092.              look into and read files within archives...even download the docs
  1093.              of a program without getting the whole thing! ... and you *can*
  1094.              browse the contents of any archived file while on line.
  1095.  
  1096.             Registered PmCat users will have other benefits on the Coalgate
  1097.              BBS. Unregistered users are more than welcome, but will come
  1098.              under 'normal' restrictions.
  1099.