home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DISK / PMCAT56.ZIP / PMCAT.DOC < prev    next >
Encoding:
Text File  |  1990-07-19  |  46.1 KB  |  1,095 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 demonstrated 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
  95.           both with the system it is intended for use upon and 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 to license the program after a reasonable trial period
  132.           (about 30 - 45 days).  We also realize there are those to whom
  133.           the $20 license fee would be a burden.  For those persons,
  134.           please continue to use PmCat+ for as long as you wish, with
  135.           our blessing.  Obviously, whether or not you can afford to
  136.           license PmCat+ is not a consideration we would be so bold as
  137.           to 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 receive:
  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.         V.  Printing functions
  280.           A.  Formatting output   ...............................   14
  281.           B.  Printing   ........................................   16
  282.           C.  Printer set up string   ...........................   16
  283.           D.  Saving to ASCII disk file   .......................   16
  284.  
  285.        VI.  Misc functions
  286.           A.  Delete volume   ...................................   16
  287.           B.  Erase (delete) file   .............................   16
  288.           C.  Commenting   ......................................   17
  289.           D.  Shell   ...........................................   17
  290.           E.  Change volume label    ............................   17
  291.           F.  Using the .DEF file    ............................   17
  292.           G.  Using disk numbering   ............................   17
  293.           H.  Using categories   ................................   18
  294.           I.  Using Wildcards in PmCat+   .......................   19
  295.           J.  Soundex searches   ................................   19
  296.  
  297.       VII.  BBS Access  .........................................   20
  298.  
  299.  
  300.                                                                 Page 5
  301.  
  302.     INTRODUCTION
  303.  
  304.                 PmCat+ is a floppy and hard disk file cataloging and
  305.             browsing program intended for use on PC/XT/AT and compatible
  306.             systems.
  307.  
  308.                 PmCat+ is a direct descendent of PmCat which was a disk
  309.             file cataloging program intended for use only with floppy
  310.             disk files.  So many users just naturally began using it to
  311.             catalog their hard drive files that many requests were made
  312.             for features that were obviously hard drive oriented. So, we
  313.             decided PmCat+ should accomodate hard drives gracefully.
  314.  
  315.                 The original PmCat was written by Patrick Michaud for my
  316.             personal use.  Like so many others, I couldn't find a
  317.             cataloger that addressed my personal habits adequately
  318.             (simple, fast and useful were some of my prime requisites).
  319.  
  320.                 When Patrick first wrote PmCat, it was so good we
  321.             decided to pat it on the rear and send it out into the 'real
  322.             world' as a shareware product ... "as an experiment" we
  323.             decided ... just to see what happened.
  324.  
  325.                 Well, about three months later a phone call came to me
  326.             from Alfred Glossbrenner who was writing a book about PC
  327.             shareware products and wanted to include PmCat in his book
  328.             ... which did occur when it was published.  My thought at
  329.             this point was ... "here's a professional in the PC world
  330.             who thinks highly enough of PmCat to choose it over all
  331.             those others...gee whiz!"  Both Patrick and I were deeply
  332.             flattered.
  333.  
  334.                 We soon realized our experiment had told us we had
  335.             something in PmCat.  So we set about making the necessary
  336.             improvements to make it palatable and useful to as many
  337.             people as possible.
  338.  
  339.                 As it turned out, Patrick's studies kept him from doing
  340.             much more with PmCat except correcting and cleaning up my
  341.             early code as I learned to program in Turbo Pascal in order
  342.             to support PmCat.
  343.  
  344.                 Since late 1987, most of the changes made to PmCat have
  345.             been a result of my meanderings through Turbo Pascal and the
  346.             PmCat code in response to users requests for changes/fixes
  347.             and improvements.
  348.  
  349.                 So here it is, PmCat PLUS.  I am calling it version 5.0
  350.             in deference to its PmCat heritage, but it has been
  351.             substantially rewritten in many ways, including the use of
  352.             overlays, but retains the familiar look of the original
  353.             PmCat.
  354.  
  355.  
  356.  
  357.                                                                 Page 6
  358.  
  359.  
  360.         Minimum System Requirements:
  361.  
  362.             IBM PC/XT/AT or compatible, 384K RAM, one floppy disk
  363.             drive.  Hard drives and subdirectories are supported.
  364.  
  365.         Suggested extra system features:
  366.  
  367.             More Memory! - PmCat+ *will* run in only 384K but 512K or
  368.                            640K is strongly recommended.
  369.  
  370.             Color monitor - either CGA, EGA or VGA makes fuller use of
  371.                             the different menu options easier.
  372.  
  373.             Mouse - these rodents are down in price to about $30 on
  374.                     the bottom line of pricing and make a lazy man's
  375.                     use of a computer much more palatable.
  376.  
  377.             Disk caching - these programs are fairly common and many are
  378.                            either public domain or shareware. This can
  379.                            speed up PmCat+ because of its use of
  380.                            overlays.
  381.  
  382.  
  383.         FEATURES
  384.              * Use categories to group your files
  385.              * Use numbering of disks through volume labels or a separate
  386.                 disk number ... or both!
  387.              * Catalog contents of archived files
  388.              * View files, archived or not while in PmCat+!
  389.              * Context sensitive help
  390.              * Mouse support
  391.              * Include and/or exclude files (read/view/print)
  392.              * Delete individual files from catalog
  393.              * Delete volumes from catalog
  394.              * Find Free Space on cataloged diskettes
  395.              * Assign a DRIVE:\PATHNAME to be a VOLUME
  396.              * Read subdirectories and labels, too
  397.              * Comment each file with up to 80 characters
  398.              * "Rubber-stamp" for comments for duplicate files
  399.              * Sort catalog by filename, ext, size, path or date
  400.              * Supports WILDCARD ("*" and "?") searches of files
  401.                and comments
  402.              * User configurable printer formatting
  403.              * Automatic update of catalog when disks are reread
  404.              * User customizing of color, catalog name, ASCII filename
  405.              * Relabel diskette if desired
  406.              * Create ASCII disk file with user-assigned name
  407.              * Multiple catalogs with your specified names
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                                                 Page 7
  414.  
  415.  
  416.  
  417.         Explanation of features:
  418.  
  419.                 The detailed explanation of each menu function is listed
  420.                 in the later part of the manual.  This portion explains
  421.                 the general use of the keyboard and/or mouse to access
  422.                 those options.
  423.  
  424.                 The HELP function is toggled ON/OFF by pressing the 'H'
  425.                 key on the keyboard or the right AND left buttons of the
  426.                 mouse at the same time or <F1>. This function does not
  427.                 toggle in the shareware distribution copy.
  428.  
  429.                 Each menu can be accessed through three functions, the
  430.                 HOT KEY, the MENU BAR or the mouse.
  431.  
  432.                 On each menu item, one letter is capitalized. Pressing
  433.                 that letter or character on the keyboard will select
  434.                 that menu item and cause it to be executed.
  435.  
  436.                 On each menu, one item is indicated at a time by the bar
  437.                 selector or MENU BAR.  The MENU BAR is moved using the
  438.                 RIGHT and LEFT keyboard arrow keys. When the bar is on a
  439.                 item, pressing <ENTER> on the keyboard will select that
  440.                 item and cause it to be executed.
  441.  
  442.                 Where appropriate the RT/LT, UP/DN arrows, PgUp/PgDn and
  443.                 Home and End keys are active for the screen instead of
  444.                 the menu area, as well as functions available to do the
  445.                 same things on the menu with the mouse.
  446.  
  447.                 The cursor within the menu area (which you will see if a
  448.                 mouse is present) is the mouse cursor.  Use your mouse
  449.                 to select an item by placing the cursor on the item name
  450.                 or within 1 space on either side and pressing the left
  451.                 mouse button.  If HELP is turned on, another click of
  452.                 the left button is necessary to execute the function.
  453.                 This was done to allow you to see what the operation
  454.                 does before you execute it.  When HELP is turned off,
  455.                 the second click is not necessary.
  456.  
  457.                 Pressing the RIGHT mouse button is the same as pressing
  458.                 the <ESC> key on the keyboard.
  459.  
  460.                                                                 Page 8
  461.  
  462.  
  463.  
  464.         INSTALLING PmCat+
  465.  
  466.                 Two files are required for PmCat+ to run, the
  467.             PMCP??DS.EXE file and the PMCP??DS.OVR file.  The overlay
  468.             file, (.OVR extension) must be either in the same directory
  469.             from which PmCat+ is run or in a directory which is in your
  470.             DOS path definition.
  471.  
  472.                 You MUST retain the overlay filename of PMCP??DS.OVR.
  473.             The executable file of PMCP??DS.exe may be renamed as you
  474.             wish.
  475.  
  476.         The following items are essential only to the browsing and
  477.         archive extraction functions of PmCat+.
  478.  
  479.             The defaults installed in PmCat+ will look for the other
  480.             files it may require, in the current directory. (The
  481.             directory you are in when you run PmCat+).  The defaults
  482.             referred to involve the following programs and locations.
  483.  
  484.                 1. Text viewer/editor - PMLIST.COM (which is really a
  485.                                    public domain program called R.COM)
  486.        ( Note use of R.COM -> )    is included for simple viewing of
  487.                                    text files.  You may be able to use
  488.                                    your favorite text viewer/editor in
  489.                                    place of this (such as LIST or ML)
  490.                 2. ARC extractor - program for extracting the contents
  491.                                    of .ARC files. ARCE.COM is default.
  492.                 3. ZIP extractor - program for extracting the contents
  493.                                    of .ZIP files. PKZIP.EXE is default.
  494.                 4. ZOO extractor - program for extracting the contents
  495.                                    of .ZOO files. ZOO.EXE is default
  496.                 5. PAK extractor - program for extracting the contents
  497.                                    of .PAK files. PAK.EXE is default
  498.                 6. LZH extractor - program for extracting the contents
  499.                                    of .LZH files. LHARC.EXE is default.
  500.                 7. Scratch path -  a drive/directory path where the
  501.                                    files extracted from an archive will
  502.      (Choose carefully! .. the     be written while you view them. You
  503.       extracted file will be       cannot edit files from within an
  504.       deleted later..suggest a     archive and update the archive with
  505.       'SCRATCH' directory)         the changed file from PmCat+.
  506.                 8. Target drive - This is the drive on which PmCat+ will
  507.                                    try to find the file chosen, using
  508.                                    the pathname information stored in
  509.                                    the PmCat+ catalog. The default is
  510.                                    drive 'A'.
  511.  
  512.  
  513.  
  514.  
  515.                                                                 Page 9
  516.  
  517.  
  518.             NOTE: NO decompressing code is in the PmCat+ program.  It is
  519.                   assumed if you have files stored with a compression
  520.                   program, that program can be executed from the DOS
  521.                   command line and thereby used to extract files.
  522.                   PmCat+ just acts as a messenger between you and the
  523.                   archiving program by sending the filename to extract
  524.                   to the program you have said will extract it.
  525.  
  526.                 If you don't know how to configure your system using
  527.             PATH and don't want to deal with it (for whatever reason),
  528.             just place copies of the appropriate programs from the
  529.             above list in the same directory as your PmCat+ files and
  530.             catalog.
  531.  
  532.  
  533.  
  534.  
  535.                                                                 Page 10
  536.  
  537.  
  538.         Things to consider BEFORE you start building your catalog:
  539.  
  540.                 The new features added to PmCat have made a great deal
  541.                 of flexibility in structuring your catalog possible.
  542.  
  543.                 These very same features will likely confuse you if you
  544.                 decide to use them without proper consideration.  They
  545.                 CAN be ignored and everything done as always with PmCat,
  546.                 but they are there if you want or need them.
  547.  
  548.                 The features most likely to offer confusion are the DISK
  549.                 number and CATEGORY function.
  550.  
  551.                 As of version 5.3, these are NOT written to the disk in
  552.                 any manner.  They are a form of notation to aid you in
  553.                 keeping track of things with your disk collection.
  554.  
  555.         CATEGORIES - these are assigned to the volume when you catalog
  556.                 it. All files on the volume will have the same category
  557.                 in your PmCat data file.  You may Edit the categories of
  558.                 Files or Volumes once cataloged by using the Edit
  559.                 function in PmCat.  Presently, if you update the volume,
  560.                 you will lose those Edited categories and the category
  561.                 will once again be whatever you assign to the volume.
  562.                 This will be fixed in a future release..but be aware it
  563.                 is a limitation of sorts just now.
  564.  
  565.                 Assigning a category - when you Update a volume, there
  566.                 is a menu choice of CATEGORY. Select this and pick one
  567.                 of the existing categories or use the Update key to
  568.                 create a new category.  DON'T FORGET to save the new
  569.                 definitions to your .DEF file if you use CATEGORIES
  570.                 other than the defaults!
  571.  
  572.         DISK NUMBERING - in the early stages of testing, this seemed to
  573.                 create the greatest confusion.  Actually, it is a rather
  574.                 easy and powerful feature once you understand what it
  575.                 does.
  576.  
  577.                 There are three modes for Disk Numbering, OFF, MANual,
  578.                 and AUTOmatic and these are reflected on the Update
  579.                 Screen window. They are changed by selecting Numbering
  580.                 from the menu and using the arrow keys to select the one
  581.                 you want.
  582.  
  583.                 If you select OFF, a number of '0' will be assigned as a
  584.                 placeholder in the data file and otherwise ignored.
  585.  
  586.                 If you select MANual, the number that is shown above the
  587.                 window as Disk # will be assigned to the disk when it is
  588.                 cataloged. You may assign a new or different number just
  589.                 by typing it in.
  590.  
  591.                 If you select AUTOmatic the number you set is
  592.                 automatically incremented each time a disk is cataloged.
  593.                 You may set the starting number in the same way as for
  594.                 MANual ... just type it in.
  595.  
  596.  
  597.  
  598.                                                                 Page 11
  599.  
  600.         There is also an option called Duplicate Disk Numbers Allowed
  601.                 which is a YES/NO choice.  It WILL NOT PREVENT
  602.                 duplicates, it merely checks for them as an aid to you.
  603.                 If this is set to YES, the option is essentially
  604.                 inactive... since YES indicates you want to allow
  605.                 duplicates.
  606.  
  607.                 OK, when YES and when NO?  Let's take, for example, a
  608.                 situation where you want to store your disks in strict
  609.                 numerical order (as many do).  Each disk has a small
  610.                 sticker or other marking indicating its numeric order
  611.                 in your catalog.  In such a case, every number is likely
  612.                 to be unique and you would NOT want to allow duplicate
  613.                 Disk Numbers.
  614.  
  615.                 Alternatively, perhaps you have your disks stored or
  616.                 referenced alphabetically by categories, such as GAMES,
  617.                 BASIC, etc.  In this case you can catalog your disks
  618.                 using CATEGORIES and AUTOmatic numbering with duplicate
  619.                 disk numbers allowed.  You might catalog 5 games disks,
  620.                 as GAMES 1 thru GAMES 5 and your BASIC disks in the same
  621.                 manner.  As the categories grow, it is a simple matter
  622.                 to add GAMES 6, GAMES 7 and so on to your library. PmCat
  623.                 will allow you to view only the GAMES category disks if
  624.                 you like by selecting the <L>imit option in the <V>iew
  625.                 window.  Just place the cursor on a file with the category
  626.                 you want to limit your viewing to, and press <L>.  The
  627.                 catalog will be searched an only the GAMES (?) will be
  628.                 displayed.  (If you print at this point, only the selected
  629.                 category will be printed, as well)
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.                                                                 Page 12
  637.  
  638.     CATALOGING FUNCTIONS
  639.  
  640.         CREATE A NEW CATALOG:  <R>ead, <W>rite  on MENU 1 and MENU 2
  641.  
  642.             Any time PmCat+ <R>eads a catalog from disk, you are shown
  643.              the current catalog name and prompted for a catalog name. If
  644.              you wish to use the catalog name shown, just press <ENTER>.
  645.              If using a mouse, place the mouse cursor on the ENTER menu
  646.              item and press the right button.
  647.  
  648.             To specify a name of your choosing just start typing it in
  649.              and press <ENTER> or press the left mouse button when
  650.              complete. A filename with wildcards is acceptable and will
  651.              place you in the 'pick list' with the appropriate files to
  652.              choose from.
  653.  
  654.             To select a catalog from the files on disk, select or type
  655.              the asterisk ('*') and press <ENTER>.  This will present
  656.              you with a 'pick list' from which to choose.
  657.  
  658.             This sequence of events first occurs when you run PmCat+. It
  659.              also happens each time you <R>ead from or <W>rite to the
  660.              disk.
  661.  
  662.  
  663.         ADD FILES/UPDATE CATALOG:    <U>pdate menu option  on MENU 1
  664.  
  665.             <U>pdate appears only on the first menu (MENU 1) you
  666.              encounter in PmCat+.  Choosing this option takes you to a
  667.              window where you may
  668.  
  669.                 1) Read files from a drive which you specify by pressing
  670.                    the appropriate letter on the keyboard or choosing it
  671.                    from the menu ... or
  672.  
  673.                 2) Change the volume label of a disk drive by using the
  674.                    '#' symbol on the menu or from the keyboard.
  675.  
  676.         SAVE CURRENT CATALOG TO DISK:  <W>rite  on MENU 1 or MENU 2
  677.  
  678.             <W>rite will save the current catalog to disk from
  679.              either MENU 1 or MENU 2.
  680.  
  681.  
  682.  
  683.  
  684.                                                                 Page 13
  685.  
  686.  
  687.  
  688.     BROWSE FUNCTIONS:  <I>nfo, <V>olumes, <D>ir, <SPACE>  on MENU 2
  689.  
  690.     These are the functions you will use to find files and view their
  691.     statistics, comments and contents of the actual file if desired.
  692.  
  693.         <V> menu selection from MENU 2 will cause a list of volumes
  694.          contained within the current catalog to be displayed.  The
  695.          volumes may be sorted just as though they were filenames (which
  696.          really is what a DOS volume label is ... with the appropriate
  697.          attribute set).
  698.  
  699.         <D> on MENU 2 will show the list of files contained within that
  700.          directory-type object.  If it is a directory then the files are
  701.          shown. If it is a compressed file then the contents of the
  702.          archive are shown if you cataloged the disk with archive reading
  703.          turned on.
  704.  
  705.         <SPACE> - pressing the spacebar will allow you to view the
  706.          contents of the file that is currently being pointed to by the
  707.          selector bar in the window.  Check to make sure the file is
  708.          located on the drive indicated on the line just above the menu.
  709.          If it needs to be changed, just press the appropriate key to
  710.          select the right drive and then press <ENTER>.  What happens at
  711.          this point is partly dependent on which program you have chosen
  712.          to run (the text viewer/editor you specified or accepted in the
  713.          Set Defaults area).
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.                                                                 Page 14
  721.  
  722.  
  723.         SEARCH:  <F>ind, <N>ext   on MENU 2
  724.  
  725.         These functions are used to find files by filename, an entry in
  726.         the Comments field and they are also used to find free space on
  727.         a volume when the list of volumes is displayed. SEE NOTE ON PAGE
  728.         16 ABOUT SOUNDEX SEARCHES.
  729.  
  730.             <F>ind will first prompt you to select whether you wish to
  731.              search for a file based on filename, comments or free
  732.              space.  The free space choice is an invalid choice if a
  733.              list of volumes is not being displayed.
  734.  
  735.             <N>ext will find the next entry matching the search
  736.              criterion you provided for the <F>ind command.
  737.  
  738.  
  739.         SORT:  <S>ort    on MENU 2
  740.  
  741.             <S>ort can be selected only from MENU 2 while PmCat+ is
  742.              running.  However, turning autoSort ON while setting default
  743.              filenames and paths will cause a sort by filename when you
  744.              move from MENU 1 to MENU 2 to occur automatically.
  745.  
  746.             After selecting <S>ort from MENU 2, you will be prompted to
  747.              choose among filename, ext, size, date and path as the
  748.              options on which to sort.  Select one..
  749.  
  750.             Then you will be prompted for sort order - ascending or
  751.              descending.  Descending puts the largest value first which
  752.              would be appropriate for volume free space (that's the Size
  753.              of volumes) but not for alphabetically arranged data.
  754.  
  755.         CHANGE CATALOGS: <R>ead   on MENU 1
  756.  
  757.             This procedure is identical to the initial reading of a
  758.              catalog when you enter PmCat.  It first clears the memory
  759.              of the existing catalog and then prompts you for a new
  760.              catalog name which you may enter using the keyboard or pick
  761.              list function.
  762.  
  763.  
  764.         MASKS: <M>ask-set  on MENU 1a3    (arrow keys disabled in menu)
  765.  
  766.             The Mask function consists of two portions, Include and
  767.              Exclude and act as a filter.  It works on those files you
  768.              wish to View, Print or Catalog using PmCat+ when either of
  769.              its actions are turned ON.
  770.  
  771.             Include and Exclude may be toggled ON or OFF independently
  772.              of each other by selecting them from MENU 1a3.
  773.  
  774.  
  775.  
  776.  
  777.                                                                 Page 15
  778.  
  779.  
  780.             If both are selected, Include takes precedence.  Remember,
  781.              if you turn both ON, NOTHING will be INCLUDED, except what
  782.              you specify and the same goes for EXCLUDE.  This can be
  783.              tricky until you get used to it.
  784.  
  785.             The menu (1a3) for changing the MASK functions is accessed
  786.              thru the <S>et defaults option of MENU 1.
  787.  
  788.             At MENU 1a3:
  789.                 Exclude - toggles the exclude list ON/OFF
  790.                 Include - toggles the include list ON/OFF
  791.                 Clear - clears the item pointed to by the bar cursor
  792.                 <ENTER> - allows you to input a new or change the old item.
  793.  
  794.  
  795.     PRINTING: <P>rint on MENU 1a4, <P>rint on MENU 2, <D>isk from print
  796.  
  797.         FORMATTING OUTPUT:   (arrow keys disabled in menu)
  798.  
  799.             <P>rint selected from MENU 1a4 opens a window to allow the
  800.              specification of format parameters for your printed catalog.
  801.  
  802.                 Start-col is the column of the printed page on which the
  803.                  field will begin.
  804.  
  805.                 Width is how many characters the field will occupy on
  806.                  the printed document.  This can be any width you wish,
  807.                  but if it is less than required for any field except
  808.                  comments, it will be truncated (chopped off).
  809.  
  810.                 Comments will print col the width you specify and repeat
  811.                  until on the next line until all actual comments for
  812.                  that file are printed.  Then it will begin printing the
  813.                  next entry.  Comments are left justified.
  814.  
  815.                 Filename is a 12 character field consisting of the
  816.                  filename, a period and the file extension.  It is right
  817.                  justified.
  818.  
  819.                 Size is a number that will occupy 10 spaces.  It is right
  820.                  justified.
  821.  
  822.                 Date will occupy 10 spaces, MM/DD/YY format.
  823.  
  824.                 Path can be up to 65 characters and is the path to the
  825.                  file on its particular volume.
  826.  
  827.                 Volume is the volume name from which the file was read.
  828.                  It may be up to 11 characters and is left justified.
  829.  
  830.  
  831.  
  832.  
  833.                                                                 Page 16
  834.  
  835.  
  836.  
  837.         PRINTING:  <P>rint  on MENU 2
  838.  
  839.             PRINTER SET UP STRING: <*>  on Print window menu
  840.  
  841.                 <*> - will prompt you for a new string of characters
  842.                  which will be sent to your printer before printing of
  843.                  the catalog starts.  Each character must be in decimal
  844.                  form and preceded by a '#' and followed by a space.
  845.  
  846.                         e.g.,   #27 #15
  847.  
  848.                  Up to 20 characters may be used here.
  849.  
  850.             ASCII DISK FILE: <D>   on Print window menu
  851.  
  852.                 <D> - will cause the output which would normally go to
  853.                  your printer, to be sent to the disk as a file with the
  854.                  name you specify in ASCII format.  It can be easily
  855.                  edited and/or printed at a later time.
  856.  
  857.     MISC FUNCTIONS:
  858.  
  859.         DELETE VOLUME:
  860.  
  861.             <D> - chosen at MENU 1 will open a window with all the
  862.              volumes in your current catalog.  To delete a volume, use
  863.              the UP/DN arrow keys and select it with the bar and press
  864.              <ENTER>.  You will still be given an opportunity to abort
  865.              the operation at this point by answering Y/N on the menu.
  866.              Obviously this operation is not final till you save the
  867.              modified catalog to disk...but at that point, it is
  868.              permanent.
  869.  
  870.         ERASE FILE:
  871.  
  872.             <K>ill a file from MENU 2.  It is the same process as
  873.              deleting a volume from MENU 1.  The difference in the two
  874.              operations is, when you Erase a file, the slot it occupied
  875.              on the screen is shown >>DELETED<< instead of removed
  876.              altogether.  As with volume deletion, the operation is not
  877.              final until you save the modified catalog to disk.
  878.  
  879.  
  880.  
  881.                                                                 Page 17
  882.  
  883.  
  884.         COMMENTING FILE:
  885.  
  886.             <C>omments may be added to files *and* volumes.  To comment
  887.              a volume you just select the <V>olume list from MENU 2 and
  888.              select <C> from the menu.  A small editor aids you in the
  889.              input of your comments.  A 40x2 window accepts your
  890.              comments.  The UP/DN arrow keys will move between the lines,
  891.              the HOME/END keys are active and INSERT is the standard
  892.              mode (there is NO overstrike mode).  DELETE works as well.
  893.              PgUp/PgDn will accept your comments and immediately place
  894.              you in the comments field of the preceding or succeeding
  895.              file, ready to type more comments.
  896.  
  897.         OPERATING SYSTEM (Shell):
  898.  
  899.             <O> - from MENU 2 will execute a call to create a temporary
  900.              shell in DOS so you can copy, delete, inspect and otherwise
  901.              wreak havoc on your poor unsuspecting system.  If enough
  902.              memory is not available, this feature will refuse to work.
  903.  
  904.         CHANGING VOLUME LABEL:
  905.  
  906.             <#> - chosen when in the <U>pdate section, will read the
  907.              present disk label, tell you what it is and ask you if you
  908.              wish to change it.  You MUST have a drive selected for this
  909.              feature to function.
  910.  
  911.         USING THE .DEF FILE:
  912.  
  913.             This option, frankly can be tricky if you want a different name
  914.              than PMCAT.DEF.  PmCat+ will *always* look for 'PMCAT.DEF'
  915.              when it is run, if it isn't found the internal defaults are
  916.              used.  The option of providing the alternative .DEF files was
  917.              to cover the possibility that someone might want an
  918.              alternative color set or other defaults on occasion.
  919.              Frankly, I use PMCAT every day and never use this option, but
  920.              it was an option that was so simple to offer and doesn't get
  921.              in the way of anything else, that it was put in.
  922.  
  923.         USING DISK NUMBERING
  924.  
  925.             There are three aspects to using the disk numbering feature of
  926.              PmCat PLUS.  First, what number to assign the disk and second,
  927.              how to assign that number.  Finally, you decide whether to
  928.              allow duplicate disk numbers or not.
  929.  
  930.             Also, the disk numbering feature is separate from the
  931.              sequential numbering of the Volume Labels from within PmCat
  932.              PLUS.  These numbers are part of the catalog record but are
  933.              NOT written to the disk.
  934.  
  935.             When you catalog a disk with disk numbering active and have
  936.              decided NOT to allow duplicates, PmCat PLUS will check for
  937.              the existence of both that disk number and the volume label
  938.              with which it is associated and issue a warning when it finds
  939.              duplication of either.
  940.  
  941.  
  942.  
  943.                                                                 Page 18
  944.  
  945.             How To Number:
  946.  
  947.                 OFF - means ignore the function. A number of '0' is
  948.                       assigned in this case.
  949.  
  950.                 MAN - manual entry of the number.  You do this by simply
  951.                       beginning to type the number desired for the disk
  952.                       immediately prior to cataloging that disk.  When
  953.                       you make the first keystroke, a small text line
  954.                       will appear on the screen one line above the menu.
  955.                       If you wish to abort the process, just press <ESC>
  956.                       and the old number will be left unchanged.
  957.                       Remember, in this mode you MUST ENTER THE NUMBER
  958.                       for it to be assigned.
  959.  
  960.                 AUT - in this mode, each time a disk is read, the number
  961.                       that will be assigned to the next disk is
  962.                       generated auto- matically by incrementing the
  963.                       prior disk number by one. This feature may be
  964.                       overridden by manual entry of the number as
  965.                       described above, for any disk.  Upon entry to
  966.                       PmCat PLUS, the number is set to zero, unless it
  967.                       has been saved in the DEF file.
  968.  
  969.         USING CATEGORIES
  970.  
  971.             A category may be assigned at the same time the disk number
  972.              above is assigned, though neither is dependent on the use
  973.              of the other.
  974.  
  975.             The category list is accessed by choosing either <C>ategory
  976.              from the Update window menu or <E>dit from the View window
  977.              menu.
  978.  
  979.             In either case, to set a category for the item of interest,
  980.              just place the cursor bar on the category you wish and
  981.              press <ENTER>.  The list of CATEGORIES will automatically
  982.              be sorted.  They will be saved to your .DEF file when you
  983.              exit PmCat PLUS.
  984.  
  985.             If you wish to have different categories than those in the
  986.              defaults, just select <U>pdate from the menu while viewing
  987.              the category window and type in the new category.  A
  988.              category name is limited to 10 characters.
  989.  
  990.             When a category is assigned to a volume before it is read,
  991.              all files on that volume are assigned the same category by
  992.              default.
  993.  
  994.             The category of any file or volume may be changed by
  995.              choosing the <E>dit function in the View window menu.
  996.  
  997.             In order to limit your viewing or printing of files based on
  998.              their category, just place the cursor on a file that has
  999.              the category you want and select <L>imit from the View
  1000.              window menu.
  1001.  
  1002.  
  1003.  
  1004.                                                                 Page 19
  1005.  
  1006.  
  1007.  
  1008.         USING WILDCARDS:
  1009.  
  1010.             PmCat+'s wildcards are a bit more flexible than DOS's. E.g.,
  1011.              if you type *ca*.* with DOS's dir command, it will show ALL
  1012.              files.  It sees the first '*' and then looks for the '.'
  1013.              and extension wildcard.  If you used that same wildcard in
  1014.              PmCat+ it would find all files with 'ca' anywhere in their
  1015.              filename (not extension).
  1016.  
  1017.             When searching for a string in Comments, don't forget to
  1018.              precede it with a '*' unless you are certain the first
  1019.              character of the comments you want will match the first
  1020.              character of the string you search for.
  1021.  
  1022.             Where '*' assumes ALL characters match, '?' assumes the
  1023.              match of only a SINGLE character.
  1024.  
  1025.  
  1026.         SOUNDEX SEARCHES:
  1027.  
  1028.             When you chose the <F>ind option from MENU 2, you will see
  1029.              four options; filename, comments, size and soundex.  The
  1030.              soundex search functions only on filenames and from the
  1031.              first character.  With those limitations in mind, you can
  1032.              type in a key that simply 'sounds' like the one you want,
  1033.              and PmCat PLUS will locate that file for you.
  1034.  
  1035.             To find a string of characters within a string you must
  1036.              use the wildcards as described above.
  1037.  
  1038.             Soundex searches work in a very unique manner.  The first
  1039.              character (alphabetic) and a numeric code for the rest of
  1040.              the search string, which is generated by the Soundex routines
  1041.              based upon phonetic approximations, are combined into the
  1042.              patter which is searched for.  You will find it matches
  1043.              things you don't expect and doesn't on some things you
  1044.              expect.  A bit of experience in using it can make it a
  1045.              useful tool, however.
  1046.  
  1047.             Basically, type in the word you wish to find, or the closest
  1048.              spelling you can imagine.  The Soundex search may well
  1049.              surprise you with its effectiveness.
  1050.  
  1051.  
  1052.  
  1053.                                                                 Page 20
  1054.  
  1055.  
  1056.         PmCat PLUS and COALGATE BBS :
  1057.  
  1058.             On the first of February, 1990 the Coalgate BBS will
  1059.              officially go on-line.
  1060.  
  1061.             Purchase of a 9600 baud US Robotics HST modem is under way
  1062.              and should be on-line no later than 15 February.
  1063.  
  1064.             The Coalgate BBS is a free access board, primarily dedicated
  1065.              to providing information to the disabled/handicapped.
  1066.  
  1067.             Approximately 20-25 megabytes will be dedicated to
  1068.              downloadable files for MSDOS computers.  These will be the
  1069.              best of the public domain and shareware programs from my
  1070.              library of about 80 megs.
  1071.  
  1072.             Until the board becomes busy, there is no practical limit on
  1073.              access time (the system won't grant more than 255 minutes a
  1074.              day by design).
  1075.  
  1076.             Once a registered user calls, he/she will be given access to
  1077.              the registered user conference and have access to the
  1078.              latest version of PmCat PLUS (registered).  So, if you plan
  1079.              to get the updates, it would be good planning to call and
  1080.              just leave a quick note to let me know you want to be given
  1081.              access.  I'll do so for you as quickly as possible.
  1082.  
  1083.             Even on your first call, you have unlimited download
  1084.              privileges, so don't hesitate to give a ring.
  1085.  
  1086.             All the files may not be commented, but TPBoard allows the
  1087.              user to look into and read files within archives...even
  1088.              download the docs of a program without getting the whole
  1089.              thing! ... and you *can* browse the contents of any
  1090.              archived file while on line.
  1091.  
  1092.             Registered PmCat users will have other benefits on the
  1093.              Coalgate BBS.  Unregistered users are more than welcome, but
  1094.              will come under 'normal' restrictions.
  1095.