home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO012.ZIP / TAPUTIL.DOC < prev   
Text File  |  1988-09-10  |  52KB  |  1,452 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                        TapUtil
  12.  
  13.                                      Version 2.1
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    Utility Programs
  20.  
  21.                                          for
  22.  
  23.                             CompuServe Message Management
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                   September 6, 1988
  47.  
  48.  
  49.  
  50.                      Copyright (c) 1988 Software Architects, Inc.
  51.                                  All Rights Reserved
  52.  
  53.                   _______
  54.              ____|__     |  (tm)
  55.           --|       |    |-------------------
  56.             |   ____|__  |  Association of
  57.             |  |       |_|  Shareware
  58.             |__|   o   |    Professionals
  59.           -----|   |   |---------------------
  60.                |___|___|    MEMBER
  61.  
  62.  
  63.  
  64.  
  65.                                                                 TapUtil 2.1
  66.  
  67.                                    What is TapUtil?
  68.  
  69.           Have you ever known that you had a CompuServe message, somewhere,
  70.           on some topic and been unable to find it?  If you save lots of
  71.           messages and catalogs of libraries, it can be very tiresome to
  72.           look through all the files to find the one you need.  TapFind to
  73.           the rescue!  Given a text string, TapFind will find all messages
  74.           and catalog entries containing the string.  You can combine many
  75.           selection criteria to find just the messages and entries you
  76.           want.  TapFind can search any number of files.
  77.  
  78.           TapSplit helps you manage your message files by separating
  79.           messages in different Forum sections into different files.  If
  80.           you follow messages in several sections of a Forum, TapSplit will
  81.           separate the messages into separate files by Forum Section
  82.           number, making it easier to find the messages again.
  83.  
  84.           TapUtil is a package of utility programs to assist in managing
  85.           CompuServe message files and library catalogs.  TapUtil works
  86.           both with files created by TAPCIS as well as with files created
  87.           by other communications programs.
  88.  
  89.           TapUtil Version 2.1 includes TapFind and TapSplit.  Later
  90.           versions may contain additional programs.
  91.  
  92.           TapUtil is a shareware package and is not free software.  See
  93.           pages 1 and 15 for license terms and registration requirements.
  94.  
  95.  
  96.  
  97.                              Acknowledgements and Credits
  98.  
  99.           TAPCIS is "A Complete Program for Accessing CompuServe" by Howard
  100.           Benner, Omni Information Resources, Inc., and is Copyright 1986,
  101.           1987, 1988 Omni Information Resources, Inc.
  102.  
  103.           Special thanks are due to the TapUtil beta test team, who have
  104.           provided invaluable suggestions and assistance in testing the
  105.           TapUtil programs, and to the Computer Consultant's Forum on
  106.           CompuServe (GO CONSULT), who provided a place in which to test
  107.           TapUtil.
  108.  
  109.           TapUtil, TapFind, and TapSplit are trademarks of Software
  110.           Architects, Inc.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                         - i -
  119.  
  120.  
  121.  
  122.  
  123.                                                                 TapUtil 2.1
  124.  
  125.  
  126.  
  127.                                   Table of Contents
  128.  
  129.  
  130.  
  131.           What is TapUtil?  . . . . . . . . . . . . . . . . . . . . . .   i
  132.  
  133.           Acknowledgements and Credits  . . . . . . . . . . . . . . . .   i
  134.  
  135.           Shareware Terms . . . . . . . . . . . . . . . . . . . . . . .   1
  136.  
  137.           Technical Support . . . . . . . . . . . . . . . . . . . . . .   1
  138.  
  139.           Who is Software Architects, Inc.? . . . . . . . . . . . . . .   1
  140.  
  141.           Copyright Notice and Software License . . . . . . . . . . . .   2
  142.  
  143.           Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  144.  
  145.           1  Getting Started  . . . . . . . . . . . . . . . . . . . . .   3
  146.               1.1  Extracting the Files . . . . . . . . . . . . . . . .   3
  147.               1.2  Selecting a Directory for the Configuration File . .   3
  148.               1.3  Selecting a Directory for TapUtil EXE Files  . . . .   4
  149.  
  150.           2  TapFind  . . . . . . . . . . . . . . . . . . . . . . . . .   5
  151.               2.1  Starting TapFind . . . . . . . . . . . . . . . . . .   5
  152.               2.2  Using TapFind with Library Catalogs  . . . . . . . .   7
  153.               2.3  Restrictions and Limitations . . . . . . . . . . . .   8
  154.               2.4  Examples . . . . . . . . . . . . . . . . . . . . . .   8
  155.               2.5  Questions and Answers  . . . . . . . . . . . . . . .   9
  156.  
  157.           3  TapSplit . . . . . . . . . . . . . . . . . . . . . . . . .  11
  158.               3.1  Starting TapSplit  . . . . . . . . . . . . . . . . .  11
  159.               3.2  Configuration Limitations  . . . . . . . . . . . . .  13
  160.               3.3  Examples . . . . . . . . . . . . . . . . . . . . . .  13
  161.               3.4  Questions and Answers  . . . . . . . . . . . . . . .  14
  162.  
  163.           4  Registering Taputil  . . . . . . . . . . . . . . . . . . .  15
  164.  
  165.           5  Plans for TapUtil  . . . . . . . . . . . . . . . . . . . .  16
  166.  
  167.           Association of Shareware Professionals  . . . . . . . . . . .  18
  168.  
  169.           File Description  . . . . . . . . . . . . . . . . . . . . . .  20
  170.  
  171.           Order Form  . . . . . . . . . . . . . . . . . . . . . . . . .  21
  172.  
  173.  
  174.  
  175.  
  176.                                         - ii -
  177.  
  178.  
  179.  
  180.  
  181.                                                                 TapUtil 2.1
  182.  
  183.                                    Shareware Terms
  184.  
  185.           TapUtil is a 'shareware' program, which means that you may try
  186.           the program and evaluate its usefulness to you without payment. 
  187.           You may give complete copies of the TapUtil product to others,
  188.           provided that you do not charge for TapUtil.
  189.  
  190.           You are permitted under the terms of this license to use this
  191.           software for a period of 30 days without any payment.  If you
  192.           continue to use this software past this point, you must register
  193.           your copy as outlined below.
  194.  
  195.           Registering TapUtil for your personal use costs $25.  Payment of
  196.           this license fee entitles you to the following:
  197.  
  198.               1.    License to use TapUtil for your personal use
  199.               2.    A free update to the next release of TapUtil
  200.               3.    Printed documentation
  201.               4.    Technical support
  202.  
  203.           Site and commercial licenses are available.  Please contact us if
  204.           you are interested in other license arrangements.
  205.  
  206.  
  207.                                   Technical Support
  208.  
  209.           Technical support for TapUtil is provided free of charge to
  210.           registered users.  Support is provided in Section 4 of the
  211.           Computer Consultant's Forum (GO CONSULT) and Section 6 of the
  212.           TAPCIS Forum (GO TAPCIS) on CompuServe Information Service.  A
  213.           message left on CONSULT will generally obtain a faster response.
  214.  
  215.           For on-line support, send a message to Guy Scharf, CompuServe
  216.           User ID 76010,3250.
  217.  
  218.  
  219.                           Who is Software Architects, Inc.?
  220.  
  221.           Software Architects, Inc., specializes in the design and
  222.           development of office automation software.  We have developed
  223.           electronic mail systems, data base applications, spreadsheet
  224.           programs, and other products for use in the office.  We also
  225.           consult with companies on the use of computers in their business,
  226.           and adjust or write computer software to meet their needs.  We
  227.           work with personal computers, minicomputers, or mainframes as
  228.           necessary to accomplish the client's goals.  Guy Scharf, the
  229.           principal designer for Software Architects, Inc., has 25 years
  230.           experience in the computer industry.
  231.  
  232.  
  233.  
  234.                                         - 1 -
  235.  
  236.  
  237.  
  238.  
  239.                                                                 TapUtil 2.1
  240.  
  241.                         Copyright Notice and Software License
  242.  
  243.           TapUtil, the TapFind and TapSplit programs, and all documentation
  244.           are copyrighted by Software Architects, Inc.  The copyright owner
  245.           hereby licenses you to:  evaluate the software without charge;
  246.           make as many copies of the software and documentation as you
  247.           wish; give exact copies of the original to anyone; and distribute
  248.           the software and documentation in its unmodified form via
  249.           electronic means.  There is no charge for any of the above.
  250.  
  251.           You are specifically prohibited from charging or requesting
  252.           donations for any such copies, however made.  Exceptions may be
  253.           granted to organizations that charge a small fee for materials,
  254.           handling, postage and general overhead.
  255.  
  256.           This is not free software.  This license allows you to evaluate
  257.           this software without charge for a period of 30 days.  After the
  258.           30 day evaluation period, you are expected either to register the
  259.           product and pay the license fee, or remove the product from your
  260.           system.
  261.  
  262.           No copy of the software may be distributed or given away without
  263.           this accompanying documentation; this notice must not be removed.
  264.  
  265.  
  266.                                        Warranty
  267.  
  268.           There is no warranty of any kind associated with this software,
  269.           and the copyright owner is not liable for damages of any kind. 
  270.           By using this software, you agree to these conditions.  Every
  271.           effort has been made to make this product bug-free.  However, the
  272.           nature of software development is that it is impossible to
  273.           guarantee bug-free software.
  274.  
  275.           In the event a verifiable bug is found, Software Architects, Inc.
  276.           will attempt to repair the bug.  A registered user who reports a
  277.           valid bug in TapUtil will receive an update at no charge.
  278.  
  279.           This software and manual are sold "AS IS" and without warranties
  280.           of any kind.  SOFTWARE ARCHITECTS, INC. SPECIFICALLY DISCLAIMS
  281.           ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
  282.           IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  283.           PARTICULAR PURPOSE.  In no event shall Software Architects, Inc.,
  284.           be liable for any loss of profit or any other commercial damage,
  285.           including but not limited to special, incidental, consequential,
  286.           or other damages.  Any liability of seller or manufacturer will 
  287.           be limited exclusively to product replacement or refund of the
  288.           purchase price.
  289.  
  290.  
  291.  
  292.                                         - 2 -
  293.  
  294.  
  295.  
  296.  
  297.                                                                 TapUtil 2.1
  298.  
  299.                                   1  Getting Started
  300.  
  301.  
  302.           Getting started with the TapUtil family is easy.  You must
  303.           extract the programs from their archive file, place them where
  304.           they can be executed, and decide where the TapUtil configuration
  305.           file should be.
  306.  
  307.           The simplest approach is to extract the program files into your
  308.           TAPCIS directory, and then start TapFind or TapSplit.  However,
  309.           some additional steps may make the programs easier to use.
  310.  
  311.  
  312.           1.1  Extracting the Files
  313.  
  314.           It you are reading this document, you have probably mastered the
  315.           first step of extracting or "un-ARCing" the files.  If you have
  316.           yet to do that, you will need one of the extraction utilities
  317.           such as ARC, ARC-E, or PKUNPK (formerly PKXARC).  These utilities
  318.           are available from any Bulletin Board System and on many
  319.           CompuServe Forums.  At the DOS command line, type:
  320.  
  321.               pkunpak taputl
  322.  
  323.           PKUNPK will extract the TapUtil programs from the TAPUTL.ARC file
  324.           and place them in the current directory.
  325.  
  326.  
  327.           1.2  Selecting a Directory for the Configuration File
  328.  
  329.           The TapUtil programs have a configuration file.  The first time
  330.           you use the program, the TAPUTIL.CFG configuration file will be
  331.           created automatically.  You should decide which subdirectory the
  332.           configuration file should be in.
  333.  
  334.           If you use TAPCIS, the best place to put the configuration file
  335.           is in the subdirectory with the TAPCIS configuration file.  If
  336.           you use other communications programs, pick any convenient
  337.           directory for the configuration file.
  338.  
  339.           The location of the configuration file can be controlled in one
  340.           of two ways.  If you have a TAPPATH environment variable, then
  341.           that variable will identify the subdirectory in which the
  342.           configuration file is kept.  If you do not have that variable,
  343.           the configuration file will be kept in the current directory. 
  344.           Without the TAPPATH environment variable, a separate copy of the
  345.           configuration file will be needed for each directory in which you
  346.           execute any of the TapUtil programs.  
  347.  
  348.  
  349.  
  350.                                         - 3 -
  351.  
  352.  
  353.  
  354.  
  355.                                                                 TapUtil 2.1
  356.  
  357.           To create the TAPPATH variable, modify your AUTOEXEC.BAT file to
  358.           include this statement:
  359.  
  360.               SET TAPPATH=d:\tap
  361.  
  362.           where "d:\tap" is the directory in which you wish to keep the
  363.           configuration file.  Any drive and subdirectory may be specified. 
  364.           If you have TAPCIS, set the directory to the one containing your
  365.           PARAMS.CIS file.
  366.  
  367.           After modifying your AUTOEXEC.BAT file, reboot your system so
  368.           that the environment variable is set.
  369.  
  370.  
  371.           1.3  Selecting a Directory for TapUtil EXE Files
  372.  
  373.           TapUtil has two executable files:  TAPFIND.EXE and TAPSPLIT.EXE. 
  374.           These files need to be in a subdirectory from which they can be
  375.           executed.
  376.  
  377.           We recommend placing programs you are evaluating in a different
  378.           directory than the directory you use for programs that are
  379.           registered and paid for.  This practice helps you distinguish
  380.           programs under evaluation from those you have registered and
  381.           incorporated into your regular working environment.
  382.  
  383.           For TapUtil, you can place the executable files in the TAPCIS
  384.           directory.  After you have evaluated the programs and registered
  385.           them, move them to any directory that is in your PATH statement.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.                                         - 4 -
  409.  
  410.  
  411.  
  412.  
  413.                                                                 TapUtil 2.1
  414.  
  415.                                       2  TapFind
  416.  
  417.  
  418.           Last month, you saved a message about "SMARTDRV.SYS," knowing
  419.           that you would need to refer to it again.  A month's gone by. 
  420.           But where is the message?  Which Forum was it on, and which file
  421.           is the message in?
  422.  
  423.           Or, you know you have seen a description of a program that speeds
  424.           up the keyboard, but what is it called?  You remember that the
  425.           file description includes the word "keyboard" or "rate" -- but
  426.           which of the hundreds of catalog descriptions for a dozen Forums
  427.           was it in?
  428.  
  429.           You can spend an hour looking through possible files with TAPCIS
  430.           or your favorite editor, or just ask TapFind to find the message
  431.           or library entry for you.  Just start TapFind, tell it the files
  432.           to examine, and tell it what to look for.  TapFind prepares a
  433.           file containing all messages or catalog entries that meet your
  434.           criteria.
  435.  
  436.           Then, you can examine this small subset of your messages with
  437.           TAPCIS or your favorite editor.
  438.  
  439.  
  440.           2.1  Starting TapFind
  441.  
  442.           TapFind is controlled from the DOS command line.  To start
  443.           TapFind, type:
  444.  
  445.               tapfind <options> -w <outfile> <filename> [<filename> ...]
  446.  
  447.           The minimum command line requires one parameter to select
  448.           messages, the -w parameter to say where the selected messages are
  449.           to be stored, and the name of a file to scan.  For example:
  450.  
  451.               tapfind -s Sony -w sony.msg ibmhw.msg
  452.  
  453.           The following options tell the program what to do:
  454.  
  455.               -t "xxx"        Select TO field with specified contents.
  456.  
  457.               -f "xxx"        Select FROM field with specified contents.
  458.  
  459.               -s "xxx"        Select SUBJECT field with specified contents.
  460.  
  461.               -x "xxx"        Select TEXT with specified contents.
  462.  
  463.               -n nn           Select message with specified SECTION NUMBER.
  464.  
  465.  
  466.                                         - 5 -
  467.  
  468.  
  469.  
  470.  
  471.                                                                 TapUtil 2.1
  472.  
  473.               -a "xxx"        Select ANY field with specified contents. 
  474.                               The To, From, Subject, and Text fields are
  475.                               searched for "xxx".
  476.  
  477.               -o              Combine multiple tests with OR logic.  The
  478.                               default is to combine tests with AND logic. 
  479.                               With OR logic, only one selection test need
  480.                               be true for the message to be written to the
  481.                               output file.  With the default AND logic, all
  482.                               selection tests must be true for the message
  483.                               to be written to the output file.
  484.  
  485.               -w <outfile>    Specify the output file in which the messages
  486.                               are to be saved.
  487.  
  488.               -v              Overwrite the output file.  If -v is not
  489.                               specified, messages found by TapFind will be
  490.                               appended to the end of the file specified by
  491.                               -w, if it exists when you start the program. 
  492.                               With -v, the output file will be created anew
  493.                               and any existing contents will be lost.
  494.  
  495.               -q              Be quiet and do not display messages on the
  496.                               console about the TapFind's progress, except
  497.                               for identification and summary lines.
  498.  
  499.               -qq             Be very quiet and do not display any messages
  500.                               on the console.  This option is available
  501.                               only to registered users.
  502.  
  503.               -cm             Configure system for monochrome monitor
  504.  
  505.               -ca             Configure system for automatic monitor type
  506.                               determination.  This is the default
  507.                               configuration and is required for color
  508.                               monitors.
  509.  
  510.           The -t, -f, -s, -x, -n, and -a parameters must all be followed by
  511.           a text string to be looked for.  At least one of these parameters
  512.           is required on the command line; otherwise TapFind doesn't know
  513.           what to look for.  If the text string contains blanks or special
  514.           characters, it must be enclosed in quotes.  TapFind ignores the
  515.           case in which you type the text when searching the files.  Thus,
  516.           you may type in upper or lower case as you please -- it makes no
  517.           difference.
  518.  
  519.           As many selection parameters as you desire may be placed on the
  520.           command line, and the same parameter may be repeated with
  521.           different selection strings.  All of the selections will be
  522.           combined with "and" or "or" logic, depending on whether the -o
  523.  
  524.                                         - 6 -
  525.  
  526.  
  527.  
  528.  
  529.                                                                 TapUtil 2.1
  530.  
  531.           parameter was given.  If operating with the default "and"
  532.           condition, then only messages in which all of the tests are
  533.           satisfied will be displayed.  If the -o parameter was included,
  534.           then the message must satisfy any one of the criteria to be
  535.           selected and output.
  536.  
  537.           The -w parameter must be followed by a file name.  The -w
  538.           parameter is required to tell TapFind where to write the messages
  539.           it finds.  Without that parameter, TapFind wouldn't know what to
  540.           do with the messages.  You may optionally redirect the output to
  541.           a disk file with '>' or '>>' on the command line instead of using
  542.           the -w parameter.  Whether you use -w or redirection, the
  543.           selected messages must be written to a disk file, not to the
  544.           console, a printer, a serial port or other character device.
  545.  
  546.           If a file name being searched ends with ".CAT", TapFind assumes
  547.           that the file is a library catalog prepared by TAPCIS.  The next
  548.           section describes how TapFind searches library catalogs.
  549.  
  550.           You may interrupt TapFind operation at any time by pressing the
  551.           ESC key.
  552.  
  553.  
  554.           2.2  Using TapFind with Library Catalogs 
  555.  
  556.           TapFind will search TAPCIS library catalogs (.CAT files), and
  557.           find all file descriptions that match your criteria.  TapFind
  558.           adjusts its search automatically based on the file name
  559.           extension.  If the extension is ".CAT," then library catalog
  560.           searching is done.  Otherwise, the message searching process is
  561.           used.  Library catalogs and message files may even be intermixed
  562.           on the TapFind command line, although that will result in
  563.           messages and file descriptions being mixed together in the output
  564.           file.
  565.  
  566.           The selection parameters (-s, -t, -f, -n, -x, -n) have slightly
  567.           different meanings when processing a library catalog.  Their
  568.           meanings are:
  569.  
  570.               -f    The "From" switch matches the User ID of the person who
  571.                     uploaded the file.  Because only the CIS User ID is in
  572.                     the library catalog, and not the person's name, you
  573.                     must specify the User ID.  For example, the command
  574.                     "tapfind -f 76010,3250" will locate all files uploaded
  575.                     by "76010,3250."
  576.  
  577.               -t    The "To" switch matches the line containing the file
  578.                     name and dates in the catalog.  This switch is probably
  579.                     useful only when searching for a specific file.
  580.  
  581.  
  582.                                         - 7 -
  583.  
  584.  
  585.  
  586.  
  587.                                                                 TapUtil 2.1
  588.  
  589.               -n    The "Section Number" switches matches the library
  590.                     number, as you would expect.
  591.  
  592.               -a    The "Any" switch matches anything in the library entry. 
  593.                     This is probably the most useful switch when searching
  594.                     library catalogs.
  595.  
  596.           The -s and -x switches are not fully supported for library
  597.           catalog files.  The -a switch should generally be used instead. 
  598.           If you wish to use the -s or -x switch, you should be aware of
  599.           their limitations:
  600.  
  601.               -s    The -s switch matches only a portion of the "Keywords:
  602.                     " for the catalog entry.  If the keyword string is
  603.                     long, the Keywords: entry in the file may require two
  604.                     lines, and successive lines are not matched with the -s
  605.                     switch.
  606.  
  607.               -x    The -x switch matches anything after the "Keywords:"
  608.                     line.  This includes both the full description and any
  609.                     keywords that did not fit on the first line.
  610.  
  611.  
  612.           2.3  Restrictions and Limitations
  613.  
  614.           TapFind cannot handle a message more than 10,000 bytes long.  The
  615.           CompuServe limit on message sizes on Forums is much less than
  616.           that.  However, the limit on EasyPlex messages is 50,000 bytes.
  617.  
  618.           If you have messages more than 10,000 bytes long in your EasyPlex
  619.           message files, TapFind will look at only the first 10,000 bytes
  620.           when searching to see if the message matches your selection
  621.           criteria.  TapFind will also write only the first 10,000 bytes to
  622.           the output file for selected messages.
  623.  
  624.           If you need a version of TapFind that will handle larger
  625.           messages, please let us know.
  626.  
  627.  
  628.           2.4  Examples
  629.  
  630.           1)  Find all messages in any IBMHW file with the word Wyse
  631.               somewhere in them, and display them on the screen.
  632.  
  633.                     tapfind -a wyse -w wyse.msg ibmhw.*
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.                                         - 8 -
  641.  
  642.  
  643.  
  644.  
  645.                                                                 TapUtil 2.1
  646.  
  647.           2)  Find all messages with "redirect" in the Subject field OR
  648.               "environ" in the text, and save output in TEMP.MSG:
  649.  
  650.                     tapfind -s redirect -x environ -o -w temp.msg ddj*.msg
  651.  
  652.           3)  Find all messages from Guy Scharf and to Nick Cvetkovic, save
  653.               output in NICK.MSG:
  654.  
  655.                     tapfind -f "Guy Scharf" -t cvet -w nick.msg consult.msg
  656.  
  657.               Now add all messages to Howard Benner:
  658.  
  659.                     tapfind -f "guy scharf" -t "howard benner" -w nick.msg
  660.                                                                 consult.msg
  661.  
  662.           4)  Find catalog entries for programs that affect the keyboard:
  663.  
  664.                     tapfind -a keyboard -w keyboard.cat ibm*.cat
  665.  
  666.           5)  Find all messages about WordPerfect Version 5.0.  The subject
  667.               titles vary widely, but all contain the strings "WP" and the
  668.               digit "5".  Write the output to WP5.MSG, and overwrite any
  669.               existing file of that name:
  670.  
  671.                     tapfind -s wp -s 5 -w wp5.msg -v wpsg.msg
  672.  
  673.           2.5  Questions and Answers
  674.  
  675.           1)  Q.  When I use TapFind to find all messages about
  676.               "compatibility," it does not find all of the messages.  Why
  677.               does this happen?
  678.  
  679.               A.  Not everyone can spell correctly!  When you have a long
  680.               word, or one for which innovative spellings are likely,
  681.               search instead on some unique portion of the word.  For
  682.               example "-x compat" would find all messages with
  683.               "compatible," "compatibility," "compatability" and other
  684.               variations in the spelling or form of the word.
  685.  
  686.           2)  Q.  Can TapFind be used to find phrases?  I want to find all
  687.               messages that discuss a "Code of Ethics."
  688.  
  689.               A.  Yes, TapFind will do that just fine.  When you want
  690.               TapFind to find a phrase or any string containing special
  691.               characters or blanks, you must put the phrase in quotes:
  692.  
  693.                     tapfind -x "code of ethics" -w outfile infile
  694.  
  695.  
  696.  
  697.  
  698.                                         - 9 -
  699.  
  700.  
  701.  
  702.  
  703.                                                                 TapUtil 2.1
  704.  
  705.               Hint:  When searching for phrases, it is often better to
  706.               instead search for messages with words from the phrase.  In
  707.               the above example, you might instead say:
  708.  
  709.                     tapfind -x code -x ethics -w outfile infile
  710.  
  711.               Using this approach, TapFind will find more messages,
  712.               including those that use the same words in a slightly
  713.               different order but with the same general meaning.  Of
  714.               course, when this second approach is used, TapFind will find
  715.               messages that mention "assembler code" in the first line and
  716.               "marginal ethics" in the last line.  Depending on your needs,
  717.               broadening the search in this way may be useful or may find
  718.               lots of messages that are not of interest.
  719.  
  720.           3)  Q.  How can I look for a phrase that may begin on one line of
  721.               a message and continue on the next?
  722.  
  723.               A.  TapFind handles this situation automatically.  Phrases
  724.               are permitted to span multiple lines.  A blank in a phrase
  725.               being searched for will match either a single blank in the
  726.               text, or a end-of-line character.
  727.  
  728.           4)  Q.  I have a monochrome monitor attached to a color card. 
  729.               The TapFind and TapSplit screens are hard to read.
  730.  
  731.               A.  Type "tapfind -cm" to set the configuration file for
  732.               monochrome output only.  Type "tapfind -ca" to set the
  733.               configuration file back to color mode.  In the future,
  734.               TapUtil will have a configuration utility so you can set
  735.               color parameters of your own choosing.
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.                                         - 10 -
  757.  
  758.  
  759.  
  760.  
  761.                                                                 TapUtil 2.1
  762.  
  763.                                      3  TapSplit
  764.  
  765.           TapSplit reads any number of CIS message files, and splits them
  766.           into one file per message section.  TapSplit will split message
  767.           files created by TAPCIS as well as message files created by other
  768.           communications programs.
  769.  
  770.           Nineteen output files are produced.  The first 18 correspond to
  771.           Forum Sections 0 through 17.  The last corresponds to a section
  772.           "18" for Forum Announcements and anything else that TapSplit
  773.           could not identify.  After you run TapSplit, all messages that
  774.           from Section 0 of the Forum will be in the Section "0" output
  775.           file; all messages from Section 1 in the Section "1" output file,
  776.           and so forth.
  777.  
  778.           TAPCIS creates Forum Announcement messages to hold any text
  779.           displayed when you enter a CompuServe Forum.  These messages
  780.           contain both CompuServe Forum Announcements as well as a list of
  781.           messages waiting for you and other introductory information. 
  782.           Other communications programs may handle this introductory text
  783.           differently, and TapSplit may not place the text in the "section
  784.           18" file.
  785.  
  786.  
  787.           3.1  Starting TapSplit
  788.  
  789.           To use TapSplit, type:
  790.  
  791.               tapsplit [<options>] <filename> ...
  792.  
  793.           The file names may be any valid DOS file names.  They may contain
  794.           * and ? wild cards.  The file names may include the directory
  795.           path.  There is no limit on the number of file names.
  796.  
  797.           Output files are named SECT.Dnn, where 'nn' ranges from '00'
  798.           through '18'.  If you would like TapSplit to use a different set
  799.           of file names, use the -f option described later.
  800.  
  801.           While no options are required, several options give increased
  802.           flexibility in how you can use TapSplit. 
  803.  
  804.           These options are available when using TapSplit:
  805.  
  806.               -f <filepattern>     File pattern option.  Set the output
  807.                                    file names to the pattern.  A pattern is
  808.                                    a legal file name, except that it
  809.                                    contains "##" somewhere in the name. 
  810.                                    Tapsplit will replace the "##" with the
  811.                                    section number (00 through 18) when
  812.                                    creating the file.  The pattern may
  813.  
  814.                                         - 11 -
  815.  
  816.  
  817.  
  818.  
  819.                                                                 TapUtil 2.1
  820.  
  821.                                    contain a directory path.  The default
  822.                                    pattern for file names is "-f sect.d##".
  823.  
  824.               -v                   Overwrite the output files.  The default
  825.                                    is to append to the output files.
  826.  
  827.               -m                   Count messages rather than lines.  On
  828.                                    the status display, show the number of
  829.                                    messages written rather than number of
  830.                                    lines written.
  831.  
  832.               -r                   Report option.  When TapSplit completes,
  833.                                    display a report showing the number of
  834.                                    lines processed, the number of messages
  835.                                    processed, and the average lines per
  836.                                    message, by Forum section.
  837.  
  838.               -s                   Suppress the output.  Don't write the
  839.                                    CompuServe messages to the nineteen
  840.                                    section files.  Just count the number of
  841.                                    messages that would have been written if
  842.                                    -s had not been specified.  -s might be
  843.                                    used in conjunction with -r to prepare a
  844.                                    report of the number of messages in each
  845.                                    section.
  846.  
  847.               -q                   Be quiet and do not display messages on
  848.                                    the console about the TapFind's
  849.                                    progress, except for identification and
  850.                                    summary lines.
  851.  
  852.               -qq                  Be very quiet and do not display any
  853.                                    messages on the console.  This option is
  854.                                    available only to registered users.
  855.  
  856.           TapSplit tries to be very careful with your message data, and
  857.           never discards anything.  Every line it reads is written,
  858.           somewhere.  Forum Announcements are written to the Section 18
  859.           file.  Any other text that TapSplit is unable to recognize will
  860.           be written to the Section 18 file also.
  861.  
  862.           TapSplit recognizes a new message by the "#: " at the beginning
  863.           of a line in the input file.  If that line is garbled because of
  864.           line noise when you captured the message, it may not be properly
  865.           recognized.  If that happens, the message will be written to the
  866.           same file as the previously recognized message.
  867.  
  868.           We strongly recommend that you not erase the Section 18 file
  869.           without examining it to see if any there is anything of value in
  870.           it.
  871.  
  872.                                         - 12 -
  873.  
  874.  
  875.  
  876.  
  877.                                                                 TapUtil 2.1
  878.  
  879.  
  880.           If you do find that good messages are being put in the Section 18
  881.           file, please let us know so that we can modify TapSplit so that
  882.           it saves the messages in the correct places.
  883.  
  884.           You may interrupt TapFind operation at any time by pressing the
  885.           ESC key.
  886.  
  887.  
  888.           3.2  Configuration Limitations
  889.  
  890.           1)  You should have as much free space on your hard disk as the
  891.               files you are going to process through TapSplit.  If you
  892.               don't have enough space, TapSplit will be unable to complete
  893.               the work you have asked of it.
  894.  
  895.           2)  The FILES parameter in your CONFIG.SYS file must be set to 20
  896.               or larger.  If you do not set FILES to 20 or more, TapSplit
  897.               will fail with a "not enough handles" message.
  898.  
  899.           3)  The number of messages and lines processed is limited only by
  900.               available disk space.
  901.  
  902.           4)  TapSplit handles only message files.  It does not attempt to
  903.               split .CAT files into multiple sections.
  904.  
  905.  
  906.           3.3  Examples
  907.  
  908.           1)  Split all of your files from the Computer Consultant's Forum
  909.               into section files named "CONSnn".  Show the number of
  910.               messages written on the status display.
  911.  
  912.                     tapsplit -f cons## -m consult*.*
  913.  
  914.           2)  Count the number of messages by section for IBMHW without
  915.               producing any output.  Show the average number of lines per
  916.               message.  Place the report in a file named IBM.RPT.
  917.  
  918.                     tapsplit -r -s -q ibmhw.msg >ibm.rpt
  919.  
  920.               When you use the -q option, the report prepared by -r is
  921.               written to the console and may be redirected to a file.  If
  922.               you do not use the -q option, the report prepared by -r is
  923.               displayed on the console and may not be redirected to a file
  924.               in the current version of TapSplit.
  925.  
  926.  
  927.  
  928.  
  929.  
  930.                                         - 13 -
  931.  
  932.  
  933.  
  934.  
  935.                                                                 TapUtil 2.1
  936.  
  937.           3.4  Questions and Answers
  938.  
  939.           Q.  The SECT.D18 file does not always end with a CR/LF (carriage
  940.               return and line feed -- the standard MS-DOS way to end a
  941.               line).  Why does this happen?
  942.  
  943.           A.  This is a problem in TAPCIS.  If you go online using the
  944.               TAPCIS "I" command, and do not capture any messages, TAPCIS
  945.               does not put a CR/LF at the end of the last line in the .MSG
  946.               file.  If such a session is the last one in a .MSG file that
  947.               you have run TapSplit on, then the last line of the SECT.D18
  948.               file will not have a CR/LF.  This situation will normally not
  949.               cause you any problems, unless you then combine the files
  950.               again using COPY or some other file concatenation tool.
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                         - 14 -
  989.  
  990.  
  991.  
  992.  
  993.                                                                 TapUtil 2.1
  994.  
  995.                                 4  Registering Taputil
  996.  
  997.           Registering TapUtil is simplicity itself.  Just use the order
  998.           form on the last page of this document.  Complete the form, and
  999.           mail it with your check for $25.00 (plus sales tax if you are
  1000.           located in California) to:
  1001.  
  1002.               Software Architects, Inc.
  1003.               Attn: TapUtil Registration
  1004.               2163 Jardin Drive
  1005.               Mountain View, CA  94040
  1006.  
  1007.           By return mail, we will send you a code to use to mark your copy
  1008.           of TapUtil as registered to you.  After you apply this code, the
  1009.           TapUtil screens will show your name as the registered licensee
  1010.           for your copy of TapUtil.
  1011.  
  1012.           As a registered user, you will be licensed to use TapUtil for
  1013.           your personal use.  The next major release and printed
  1014.           documentation will be sent you free of charge.
  1015.  
  1016.           If you include your CompuServe ID, we will be able to send you
  1017.           notices of future versions electronically.
  1018.  
  1019.           Please tell us what you like about TapUtil, and what new features
  1020.           you would like to see.  Your feedback is our most important guide
  1021.           in deciding what features to add.
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.                                         - 15 -
  1047.  
  1048.  
  1049.  
  1050.  
  1051.                                                                 TapUtil 2.1
  1052.  
  1053.                                  5  Plans for TapUtil
  1054.  
  1055.           Development of the TapUtil programs is continuing.  As a
  1056.           registered user, you will be shipped the next major release
  1057.           automatically.
  1058.  
  1059.           Some of the enhancements planned for future releases include:
  1060.  
  1061.           o   A full screen interface to TapFind, so that you can control
  1062.               TapFind without using the command line switches.
  1063.  
  1064.           o   An interactive option to TapFind that will permit selective
  1065.               browsing of the message files, allowing even finer control of
  1066.               the message finding process.
  1067.  
  1068.           o   Configuration capabilities so you can adjust the screen
  1069.               colors and other operational controls to your preference.
  1070.  
  1071.           o   Closer integration of TapUtil with TAPCIS and its parameter
  1072.               file, while maintaining its usefulness for people who use
  1073.               other communications programs.
  1074.  
  1075.           o   Specification of TAPCIS Forum names instead of files, using a
  1076.               !forum notation.  Wild cards would be supported.
  1077.  
  1078.           We are considering additional programs that may be included with
  1079.           TapUtil in future releases.  TapClean would remove Forum
  1080.           Announcement messages.  TapExam would report on the message
  1081.           threads present in files, the size and ages of those threads, and
  1082.           the Forum section numbers and files the messages are in.
  1083.  
  1084.           The most important additions will be the ones you suggest.  The
  1085.           registration form asks for your suggestions, and we will use that
  1086.           feedback as guidance for future development.  Please tell us what
  1087.           features or programs you would like.
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.                                         - 16 -
  1105.  
  1106.  
  1107.  
  1108.  
  1109.                                                                 TapUtil 2.1
  1110.  
  1111.                        Other Software Architects, Inc. Products
  1112.  
  1113.           Software Architects, Inc. publishes two shareware products, with
  1114.           other shareware and commercial products now in development.  The
  1115.           currently published products include:
  1116.  
  1117.           FontID         A program to assist in downloading fonts to the HP
  1118.                          LaserJet.  FontID allows you to set up a batch
  1119.                          file for downloading fonts to the HP LaserJet at
  1120.                          high speed.  These programs offer a much more
  1121.                          flexible method for downloading fonts than the
  1122.                          BASIC programs supplied by Hewlett-Packard with
  1123.                          soft fonts for the HP LaserJet+ or Series II
  1124.                          printers.  Shareware.
  1125.  
  1126.           TapUtil        Programs for maintaining and searching TAPCIS
  1127.                          message files and library catalogs.  TapFind finds
  1128.                          any message or library catalog entry, searching on
  1129.                          subject, from, to, text, section number, or any
  1130.                          combination.   TapSplit splits message files into
  1131.                          one file per Forum section number.  Shareware.
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.                                         - 17 -
  1163.  
  1164.  
  1165.  
  1166.  
  1167.                                                                 TapUtil 2.1
  1168.  
  1169.                         Association of Shareware Professionals
  1170.  
  1171.           Software Architects, Inc. is a member of the Association of
  1172.           Shareware Professionals (ASP), an organization formed in April
  1173.           1987 to strengthen the future of shareware (user-supported
  1174.           software) as an alternative to commercial software.  Its members,
  1175.           all of whom are programmers who subscribe to a code of ethics,
  1176.           are committed to the concept of shareware as a method of
  1177.           marketing.
  1178.  
  1179.           The primary goals of the ASP are:
  1180.  
  1181.           o   To inform users about shareware programs and about shareware
  1182.               as a method of distributing and marketing software;
  1183.  
  1184.           o   To encourage broader distribution of shareware through user
  1185.               groups and disk dealers who agree to identify and explain the
  1186.               nature of shareware;
  1187.  
  1188.           o   To assist members in marketing their software;
  1189.  
  1190.           o   To provide a forum through which ASP members may communicate,
  1191.               share ideas, and learn from each other; and 
  1192.  
  1193.           o   To foster a high degree of professionalism among shareware
  1194.               authors by setting programming, marketing and support
  1195.               standards for ASP members to follow.
  1196.  
  1197.  
  1198.                Standards for the Association of Shareware Professionals
  1199.  
  1200.           Programming Standards
  1201.  
  1202.           The program meets the ASP's definition of "shareware" (i.e., it
  1203.           is not a commercial demo with major features disabled, nor a
  1204.           time-limited program).
  1205.  
  1206.           The program has been thoroughly tested by the author and should
  1207.           not be harmful to other files or hardware if used properly.
  1208.  
  1209.  
  1210.           Documentation Standards
  1211.  
  1212.           Sufficient documentation is provided to allow the average user to
  1213.           try all the major functions of the program.
  1214.  
  1215.           Any discussion of the shareware concept and of registration
  1216.           requirements is done in a professional and positive manner.
  1217.  
  1218.  
  1219.  
  1220.                                         - 18 -
  1221.  
  1222.  
  1223.  
  1224.  
  1225.                                                                 TapUtil 2.1
  1226.  
  1227.           Support Standards
  1228.  
  1229.           The member will respond to people who send registration payments,
  1230.           as promised in the program's documentation.  At a minimum, the
  1231.           member will acknowledge receipt of all payments.
  1232.  
  1233.           The member will establish a procedure for users to report, and
  1234.           have acknowledged, matters such as bug reports, and will describe
  1235.           such means in the documentation accompanying all versions of the
  1236.           programs.  The author will respond to written bug reports from
  1237.           registered users when the user provides a self-addressed, stamped
  1238.           envelope.
  1239.  
  1240.           Known incompatibilities with other software or hardware and major
  1241.           or unusual program limitations are noted in the documentation
  1242.           that comes with the shareware (evaluation) program.
  1243.  
  1244.  
  1245.           General
  1246.  
  1247.           Members will keep the ASP apprised of changes in mailing address;
  1248.           which shareware programs they have published and are currently
  1249.           supporting; the current version numbers; and any changes in the
  1250.           status of their programs.
  1251.  
  1252.           If a user has a dispute with an ASP member-author, the user may
  1253.           appeal to the ASP to mediate for arbitration of the dispute.
  1254.  
  1255.           For more information about the Association of Shareware
  1256.           Professionals, contact Jim Button, chairman of the board of
  1257.           directors, at CompuServe 71435,2012.
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.                                         - 19 -
  1279.  
  1280.  
  1281.  
  1282.  
  1283.                                                                 TapUtil 2.1
  1284.  
  1285.  
  1286.                                    File Description
  1287.  
  1288.           When uploading this package to CompuServe, use the name
  1289.           TAPUTL.ARC.  Upload as a binary file.  When uploading to a BBS,
  1290.           use the name TAPUTL21.ARC.
  1291.  
  1292.           TAPUTIL - CompuServe Message and Library Utilities.  TapFind
  1293.           finds any message or library catalog entry, searching on subject,
  1294.           from, to, text, section number, or any combination.  TapSplit
  1295.           splits message files into one file per Forum section number. 
  1296.           Both programs support message and library files created by TAPCIS
  1297.           and other communications programs.  Shareware.  Upl/Auth: Guy
  1298.           Scharf, Member Association of Shareware Professionals.
  1299.  
  1300.           Keywords: TAPUTIL TAPFIND TAPSPLIT COMPUSERVE MESSAGE FILE
  1301.           MAINTENANCE
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.                                         - 20 -
  1337.  
  1338.  
  1339.  
  1340.  
  1341.                                                                 TapUtil 2.1
  1342.  
  1343.                                            Order Form
  1344.  
  1345.                Software Architects, Inc. Products And Registration Form
  1346.  
  1347.  
  1348.           Name:     ______________________________________
  1349.  
  1350.           Address:  ______________________________________
  1351.  
  1352.                     ______________________________________
  1353.  
  1354.           City:     ______________________________________
  1355.  
  1356.           State:    __________________________ Zip: ______
  1357.  
  1358.           Telephone:  ____________________________________
  1359.  
  1360.           CompuServe ID: _________________________________
  1361.  
  1362.  
  1363.           Item                                         Quantity       Total
  1364.           -----------------------------------------------------------------
  1365.  
  1366.           TapUtil 2.1 Registration ($25 each)___________________ |_________
  1367.  
  1368.           ______________________________     ___________________ |_________
  1369.  
  1370.           -----------------------------------------------------------------
  1371.  
  1372.                                              Total Due:          |_________
  1373.  
  1374.                  California residents add 7% sales tax:          |_________
  1375.  
  1376.                                              Total Due:          |_________
  1377.  
  1378.           Preferred Disk Size:  3.5" ____ 5.25" ____
  1379.  
  1380.  
  1381.           We would very much appreciate your evaluation of TapUtil and
  1382.           suggestions for future versions.  If you will answer the
  1383.           questions on the next page, that will assist us greatly in
  1384.           determining the future direction of our products.
  1385.  
  1386.  
  1387.           Mail Completed Form to:
  1388.  
  1389.               Software Architects, Inc.
  1390.               Attn: TapUtil Registration
  1391.               2163 Jardin Drive
  1392.               Mountain View, CA  94040
  1393.  
  1394.                                         - 21 -
  1395.  
  1396.  
  1397.  
  1398.  
  1399.                                                                 TapUtil 2.1
  1400.  
  1401.                         TapUtil Evaluation and Recommendations
  1402.  
  1403.           What do you find most useful about TapUtil? _____________________
  1404.  
  1405.           _________________________________________________________________
  1406.  
  1407.           _________________________________________________________________
  1408.  
  1409.  
  1410.           What features would you like added to TapUtil?  Your suggestions
  1411.           are important, as they will determine TapUtil's future direction.
  1412.  
  1413.           _________________________________________________________________
  1414.  
  1415.           _________________________________________________________________
  1416.  
  1417.           _________________________________________________________________
  1418.  
  1419.           _________________________________________________________________
  1420.  
  1421.  
  1422.           What aspects of TapUtil would you most like to see improved? ____
  1423.  
  1424.           _________________________________________________________________
  1425.  
  1426.           _________________________________________________________________
  1427.  
  1428.           _________________________________________________________________
  1429.  
  1430.  
  1431.           What other programs would you like included with TapUtil? _______
  1432.  
  1433.           _________________________________________________________________
  1434.  
  1435.           _________________________________________________________________
  1436.  
  1437.           _________________________________________________________________
  1438.  
  1439.           _________________________________________________________________
  1440.  
  1441.           _________________________________________________________________
  1442.  
  1443.  
  1444.           Please mail with your registration to:
  1445.  
  1446.                     Software Architects, Inc.
  1447.                     2163 Jardin Drive
  1448.                     Mountain View, CA  94040
  1449.  
  1450.  
  1451.  
  1452.                                         - 22 -