home *** CD-ROM | disk | FTP | other *** search
/ Mega CD-ROM 1 / megacd_rom_1.zip / megacd_rom_1 / MISCUTL / GEN12.ZIP / GEN.DOC next >
Text File  |  1989-12-25  |  33KB  |  960 lines
  1.  
  2.  
  3.                   GEN
  4.  
  5.  
  6.  
  7.                   Test Character Generating Utility
  8.  
  9.  
  10.  
  11.                   Version  1.2
  12.                   Released 11-12-89
  13.  
  14.  
  15.  
  16.  
  17.                   Herron Software
  18.                   P.O. Box 1288
  19.                   Battle Ground, Washington  98604
  20.  
  21.  
  22.  
  23.  
  24.          COPYRIGHT 1988, 1989 Phil Herron.  ALL RIGHTS RESERVED.
  25.  
  26.  
  27.                   DISCLAIMER OF WARRANTY
  28.          __________________________________________
  29.  
  30.  
  31.  
  32.          THIS PRODUCT IS PROVIDED FOR EVALUATION, AS IS
  33.          AND WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR
  34.          MAKES NO EXPRESS OR IMPLIED WARRANTIES,
  35.          INCLUDING BUT NOT LIMITED TO MERCHANTABILITY
  36.          OR FITNESS FOR ANY PURPOSE.  IN NO EVENT SHALL
  37.          THE AUTHOR BE LIABLE FOR LOSS OF PROFIT OR ANY
  38.          OTHER COMMERCIAL DAMAGE ARISING FROM EITHER
  39.          THE USE OF OR THE INABILITY TO USE THIS PRODUCT.
  40.  
  41.  
  42.  
  43.          This product should be thoroughly evaluated
  44.          using backed up or noncritical data and files.
  45.  
  46.  
  47.  
  48.  
  49.    ______________________________________________________________
  50.  
  51.    Evaluation Preface                                     Section
  52.    ______________________________________________________________
  53.  
  54.    Shareware............................................... 0.1.0
  55.      What it is............................................ 0.1.1
  56.      License Terms......................................... 0.1.2
  57.      Registration.......................................... 0.1.3
  58.        Benefits, Forms, Registration fees,
  59.        Quantity discounts, Combined orders
  60.  
  61.    Evaluation.............................................. 0.2.0
  62.      Evaluation Version.................................... 0.2.1
  63.      Evaluation Menu....................................... 0.2.2
  64.      Virus Prevention...................................... 0.2.3
  65.  
  66.  
  67.  
  68.    _____________________________
  69.  
  70.    0.1.0          Shareware
  71.    _____________________________
  72.  
  73.  
  74.  
  75.    0.1.1   The SHAREWARE Concept
  76.    _____________________________
  77.  
  78.    "Shareware" is a software distribution method which enables
  79.    the potential user to obtain software at very low initial
  80.    cost, for evaluation on a trial basis.
  81.  
  82.    You can evaluate the software in your own environment, on your
  83.    own machine, with the programs and data that you normally use.
  84.    You're not required to become a registered user unless the
  85.    software meets your needs.
  86.  
  87.    Another benefit of Shareware is lower pricing.  By minimizing
  88.    the marketing and advertising expenses associated with more
  89.    traditional software distribution methods, Shareware products
  90.    can be priced lower.  You don't pay for what you don't need or
  91.    use.
  92.  
  93.    You are encouraged to share the evaluation version of this
  94.    software with others, so long as you follow the limitations
  95.    set forth in the LICENSE TERMS section below.
  96.  
  97.  
  98.    0.1.2   LICENSE TERMS
  99.    _____________________
  100.  
  101.    This product and its documentation are copyrighted and owned
  102.    solely by the author, who reserves all rights to any benefits
  103.    derived from it.  It is distinctly separate from, and should
  104.    not be confused with, those categories of software known as
  105.    "public domain" or "freeware."
  106.  
  107.    You are granted the right to use the evaluation version of
  108.    this software on a trial basis for a limited amount of time,
  109.    to decide whether to continue using (and therefore whether
  110.    to register) the product.
  111.  
  112.    You can transmit this evaluation version to associates by
  113.    copying on diskette or uploading to electronic bulletin board
  114.    services, so long as the following CONDITIONS are met:
  115.  
  116.      (a) The program and its documentation file must be
  117.          distributed together.
  118.  
  119.      (b) The program and its documentation must not be
  120.          altered in any way.  If you wish to include
  121.          notes for other evaluators, please add them in
  122.          a separate file and include that file along
  123.          with the program and documentation files.
  124.  
  125.  
  126.    0.1.3   REGISTRATION
  127.    ____________________
  128.  
  129.    When you send in the registration form and fee, you'll
  130.    receive by return mail a diskette containing the latest
  131.    REGISTERED version of the program and documentation.
  132.  
  133.  
  134.    BENEFITS OF REGISTRATION
  135.  
  136.      The registered version WILL NOT include the Evaluation Menu
  137.      front-end, startup time-delay or forms-printing sections of
  138.      this version.  Thus it will be more convenient to use, from
  139.      either the DOS prompt or from batch files.  It will also be
  140.      12k-15K bytes smaller, for more efficient disk storage and
  141.      faster loading.
  142.  
  143.      The registered version WILL include any new functions
  144.      or enhancements made to date.
  145.  
  146.      You will receive notification of future updates and
  147.      new products.
  148.  
  149.      You will be able to upgrade to newer versions at a
  150.      reduced cost.
  151.  
  152.  
  153.    REGISTRATION FORM
  154.  
  155.      The registration form and a pre-addressed mailing cover
  156.      can be printed from the "Forms Printing" selection of
  157.      the Evaluation menu, discussed in section 0.2.2 below.
  158.  
  159.  
  160.    FEES
  161.  
  162.      The single-quantity registration fee is displayed on the
  163.      initial Evaluation Menu screen.  Higher quantities are
  164.      discussed below.
  165.  
  166.  
  167.    QUANTITY DISCOUNTS
  168.  
  169.      Each registered copy of this software will be licensed for
  170.      operation at a single location (on a single terminal or
  171.      computer) at any one time.  If you need to run the software
  172.      on more than one terminal or computer at the same time, the
  173.      appropriate number of registrations must be made.
  174.  
  175.      Multiple-quantity registration fees are displayed in the
  176.      "QUANTITY DISCOUNT" section of the Evaluation menu.
  177.  
  178.      You can take advantage of quantity discounts by ordering
  179.      multiple registrations of one program or single
  180.      registrations of several different programs at the same
  181.      time.  You also save on shipping and handling charges
  182.      by registering several products together.
  183.  
  184.  
  185.    COMBINED ORDERS
  186.  
  187.      You can also take advantage of quantity discounts by
  188.      combining orders with associates:
  189.  
  190.      (1)   Complete a separate registration form for each person.
  191.               Each person's name, address and programs to be
  192.               registered are needed for support and update
  193.               notification purposes.
  194.  
  195.      (2)   Include only one standard shipping and handling charge.
  196.               Cross out the "Shipping & handling" amounts on
  197.               all but ONE registration form; the combined
  198.               order will be sent to the name and address on
  199.               that form.
  200.  
  201.      (3)   Mail all the forms together, with a single check/money
  202.               order for the total, in one envelope/mailing cover.
  203.  
  204.  
  205.  
  206.    _____________________________
  207.  
  208.    0.2.0          Evaluation
  209.    _____________________________
  210.  
  211.  
  212.  
  213.    0.2.1   EVALUATION VERSION
  214.    __________________________
  215.  
  216.    This software contains the complete and fully functional version
  217.    of the program, the latest available at the time of this release.
  218.  
  219.    The program itself is identical to the REGISTERED version.
  220.    An Evaluation Menu and forms-printing section were added
  221.    to ensure that:
  222.  
  223.      (a)   Registration information and forms will not
  224.            become separated from the program file.
  225.  
  226.      (b)   Users who might be unfamiliar with the process
  227.            of displaying a file's contents on the screen or
  228.            printer will have no difficulty learning about,
  229.            evaluating or registering this product.
  230.  
  231.  
  232.    0.2.2   EVALUATION MENU
  233.    _______________________
  234.  
  235.    The program is invoked from the DOS prompt by typing its name
  236.    and pressing the RETURN or ENTER key.
  237.  
  238.    The initial screen displays the warranty section and some
  239.    information about the program:
  240.  
  241.      Program name,
  242.      Version number,
  243.      Release date,
  244.      Single-quantity registration fee.
  245.  
  246.    It next displays the Shareware Product EVALUATION MENU.
  247.    A single key press will select the following functions
  248.    from the menu:
  249.  
  250.      ESC - EXIT to DOS without evaluating this program
  251.       R  - READ the documentation (THIS file)
  252.       x  - EVALUATE this program
  253.       Q  - QUANTITY Discount information
  254.       F  - FORMS printing menu - registration & mailer
  255.  
  256.    When you press "R" to READ the documentation, this file will
  257.    be shown one screen at a time.  The display pauses whenever the
  258.    screen becomes full, and prompts...
  259.  
  260.                      <downArrow> or Esc
  261.  
  262.    The <downArrow> character is similar to the "MORE" prompt in
  263.    other DOS utilities.  It indicates that more is available.
  264.    Press ESCape to exit back to the Evaluation Menu, or any normal
  265.    typing key to continue (space bar is a convenient key to use).
  266.  
  267.  
  268.    0.2.3   VIRUS PREVENTION
  269.    ________________________
  270.  
  271.    If you'd like to evaluate this software but you're not sure
  272.    where it's been, you can order a copy straight from the source.
  273.    See the SHAREWARE PRODUCT CATALOG section at the end of this file.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.    _________________________________________________________________
  280.  
  281.    Table of Contents                                         Section
  282.    _________________________________________________________________
  283.  
  284.    Gen........................................................ 1.0
  285.       Introduction............................................ 1.1
  286.       Explanation............................................. 1.2
  287.       System Requirements..................................... 1.3
  288.          Installing........................................... 1.3.1
  289.       Help.................................................... 1.4
  290.       Syntax.................................................. 1.5
  291.       Examples................................................ 1.6
  292.          Operating screen..................................... 1.6.1
  293.       Output Format........................................... 1.7
  294.       Applications............................................ 1.8
  295.       Error Messages.......................................... 1.9
  296.       DOS ErrorLevel.......................................... 2.0
  297.       Version History......................................... 3.0
  298.  
  299.    Support.................................................... 9.0
  300.       Problem Resolution...................................... 9.1
  301.       Before Reporting........................................ 9.2
  302.       Reporting a problem..................................... 9.3
  303.       Custom Modifications.................................... 9.4
  304.       Correspondence.......................................... 9.5
  305.  
  306.    Shareware Product Catalog................................. 10.0
  307.  
  308.  
  309.  
  310.   *******************************************
  311.   NEW in this version: corrected Elapsed Time
  312.   *******************************************
  313.   Following a run during which midnight occurs, prior versions
  314.   of this program were displaying incorrect elapsed times.
  315.   The oversight is corrected in this version.
  316.  
  317.  
  318.  
  319. ______________________________________________________________
  320.  
  321.                GEN
  322. 1.0
  323.                Test Character Generating Utility
  324. ______________________________________________________________
  325.  
  326.  
  327.  
  328.  
  329. 1.1   INTRODUCTION
  330. __________________
  331.  
  332.    There are a number of ways to produce disk files of some
  333.    given size for testing or experimentation.  The methods
  334.    available vary in speed and ease of use.
  335.  
  336.    METHOD 1 - Text Editor
  337.  
  338.       This method is pure trial-and-error: run your word processor
  339.       or text editor, type some random characters, save the result,
  340.       then check on the size of the saved file.  If it's not right,
  341.       go back into the editor and add or subtract some characters.
  342.       Repeat until you get the file size just right.
  343.  
  344.    METHOD 2 - DEBUG or SYMDEB utilities
  345.  
  346.       If one of these utilities is available, you can use a script
  347.       like this to generate a 1000-byte file named OneK.Txt...
  348.  
  349.          C>debug
  350.          -n OneK.Txt       name the file
  351.          -rcx              set file size
  352.          CX 0000
  353.          :3E8              hexadecimal size of file
  354.          -f 0 L 3E8 2E     fill space with a char (2E hex for dots)
  355.          -w                write the file to disk
  356.          Writing 03E8 bytes
  357.          -Q                quit back to DOS
  358.  
  359.       This method works well for files up to FFFFh (65,535 decimal)
  360.       bytes in length; for larger sizes, you must also set register
  361.       BX, and go through some calculations to fill the space with
  362.       known characters.
  363.  
  364.  
  365.    The schemes above do work, and they might be acceptable for small
  366.    files.  However, they're so much bother that you'll probably end up
  367.    saving the generated files on a disk just in case you ever need
  368.    them again.  But next time you'll probably need a file of a
  369.    different size.
  370.  
  371.  
  372.    GEN can remove all the bother.  It generates files of any size from
  373.    zero to twenty million bytes (20Mb), and generates them much faster
  374.    than you can type random characters into a text editor.
  375.  
  376.    Besides generating files on disk, it can send a specific number
  377.    of characters directly to the console screen, printer or other
  378.    DOS device.  When finished, it displays elapsed time.
  379.  
  380.  
  381.  
  382.  
  383. 1.2   EXPLANATION
  384. _________________
  385.  
  386.    GEN sends a specified number of characters to a specified
  387.    destination.  The default destination is the monitor screen;
  388.    others are accessed using the DOS redirection characters
  389.  
  390.                > and >>
  391.  
  392.    from the command line.  For more information on using
  393.    redirection, see your DOS manual and the sections below
  394.    covering syntax and examples.
  395.  
  396.  
  397.    The basic character that GEN generates in quantity is the
  398.    period, ASCII 2E hex.  It was selected for no particular
  399.    reason other than possibly minimizing ribbon wear during
  400.    printer testing.
  401.  
  402.    The final characters sent during each run depend upon the
  403.    output size specified, and are either CR (carriage return)
  404.    or CR LF (carriage return followed by linefeed).
  405.  
  406.    See section 1.7, OUTPUT FORMAT, for additional information.
  407.  
  408.  
  409.    The character count is displayed on screen after every twenty
  410.    thousand characters.  This count display is sent only to the
  411.    screen, and does not become part of the output to a file or
  412.    device.
  413.  
  414.  
  415.    The ESCape key can be used to exit at any time.  GEN will
  416.    terminate at the end of the 1000-character block it was
  417.    processing when the Escape key was detected.
  418.  
  419.  
  420.  
  421.  
  422. 1.3   SYSTEM REQUIREMENTS
  423. _________________________
  424.  
  425.    PC, XT, AT or compatible.
  426.    DOS version 2.1 or later.
  427.    64K free memory.
  428.  
  429.  
  430.  
  431.  
  432. 1.3.1    INSTALLING
  433. ___________________
  434.  
  435.    The program can be run from diskette or from hard disk.
  436.    No installation is necessary, other than copying the
  437.    files to a drive and directory of your choosing.
  438.  
  439.  
  440.  
  441.  
  442. 1.4   HELP
  443. __________
  444.  
  445.    Can't remember the command line syntax?
  446.    Issue the program's name without any parameters; it
  447.    will display a help screen, then return to the DOS prompt.
  448.  
  449.  
  450.  
  451.  
  452. 1.5   SYNTAX
  453. ____________
  454.  
  455.  
  456.       GEN [length] [>[>filespec or device]]
  457.  
  458.  
  459.       Parameter explanation:
  460.  
  461.          [length]
  462.             Length must be a positive number,
  463.             0 through 20000000 (twenty million),
  464.             with no embedded punctuation.
  465.  
  466.          [>] or [>>]
  467.             DOS redirection characters.
  468.             >  Sends output to specified file; overwrites the file
  469.                if it already exists.
  470.             >> Appends output to the end of the specified file.
  471.  
  472.          [filespec]
  473.             The string needed to reference a file;
  474.             can also be shown as [d:][path][filename.ext].
  475.  
  476.             The minimum filespec needed is filename.ext. If the file
  477.             is to be generated in another directory and/or on another
  478.             drive, the drive name and/or pathname must also be given.
  479.  
  480.             The complete filespec for a file named TestFile.Txt
  481.             residing in drive A: in a subdirectory named TestSub is
  482.  
  483.                   A:\TestSub\TestFile.Txt
  484.  
  485.             For further information on filespecs, see your DOS manual.
  486.  
  487.          [device]
  488.             A particular DOS device:
  489.  
  490.                PRN, LPT1, LPT2 - sends output to specified printer
  491.                CON               sends output to console (default)
  492.                NUL               discards the output
  493.  
  494.  
  495.  
  496.  
  497. 1.6   EXAMPLES
  498. ______________
  499.  
  500.       GEN 1000               Sends 1000 characters to screen.
  501.  
  502.       GEN 1000 >PRN          Sends 1000 characters to printer.
  503.  
  504.       GEN 1000 >OneK.Txt     Creates 1000-byte file on current
  505.                               drive, in current subdirectory.
  506.  
  507.       GEN 1000 >>OneK.Txt    Appends another 1000 bytes to an
  508.                               existing file.
  509.  
  510.       GEN 1000 >A:OneK.Txt   Creates 1000-byte file on drive A:
  511.  
  512.  
  513.       GEN    0 >Zip.Txt      Creates a file of zero length.
  514.  
  515.  
  516.  
  517.  
  518. 1.6.1   OPERATING SCREEN
  519. ________________________
  520.  
  521.    The operating screen appears whenever "GEN" is issued from the
  522.    DOS prompt (or from a batch file) with a size specification;
  523.    in this example, the complete command line is:
  524.  
  525.             Gen 56789 >Dummy.Txt
  526.  
  527.    and the screen displays:
  528.  
  529.     __Gen_________________________
  530.    |______________________________|
  531.  
  532.    Generating 56789 characters
  533.    Kbytes completed: nn
  534.                        \
  535.                        Running count of current size, in 20K steps
  536.  
  537.    Upon completion (or when ESC is pressed to terminate early),
  538.    elapsed time is normally displayed.  An exception is when GEN's
  539.    output is being redirected to a disk which has insufficient
  540.    space for the specified file size: the file is generated until
  541.    the disk has zero bytes free, then GEN terminates, but elapsed
  542.    time is not displayed.
  543.  
  544.  
  545.  
  546.  
  547. 1.7   OUTPUT FORMAT
  548. ___________________
  549.  
  550.    GEN generates the specified number of characters by blocks of
  551.    one thousand (if any), followed by any remaining characters
  552.    needed to make up the required size.
  553.  
  554.    Each 1K block consists of 998 dot characters (ASCII 2E hex)
  555.    followed by CR (ASCII 0D hex) and LF (ASCII 0A hex).
  556.  
  557.    Sizes in excess of even multiples of the basic one-thousand-
  558.    character block are generated as shown below:
  559.  
  560.             Size         Characters sent
  561.          ------------    -------------------
  562.               1             CR
  563.               2             CR, LF
  564.               3             1 dot,  CR, LF
  565.               4             2 dots, CR, LF
  566.               .             .
  567.               .             .
  568.             999           997 dots, CR, LF
  569.  
  570.       Example:
  571.  
  572.          Output length of    Will Contain
  573.          ----------------    ----------------------
  574.             1                CR
  575.             1000             998 dots CR LF (the basic 1K block)
  576.             1001             One 1K block  plus CR
  577.             1002             One 1K block  plus CR LF
  578.             1003             One 1K block  plus  1 dot CR LF
  579.             2001             Two 1K blocks plus CR
  580.            10001             Ten 1K blocks plus CR
  581.  
  582.  
  583.    It should be noted that if GEN is issued without being
  584.    redirected to a file or device, the number of dots appearing
  585.    on the screen will be fewer than specified in the length
  586.    parameter.
  587.  
  588.    A length of 1 or 2 will show no dots; 3 or higher will show
  589.    two fewer dots than specified, since the CR and LF are not
  590.    explicitly displayed on the screen.  However, the correct file
  591.    length will always be generated when the output is redirected
  592.    to a file or device.
  593.  
  594.  
  595.  
  596.  
  597. 1.8   APPLICATIONS
  598. __________________
  599.  
  600.    GENerated files can be used for:
  601.  
  602.       Printer speed tests
  603.       Printer buffer capacity tests
  604.       Print Spooler tests
  605.  
  606.       Disk file copying speed tests
  607.       Disk capacity tests
  608.       RAMdisk tests
  609.  
  610.       Dummy files for any purpose.
  611.  
  612.  
  613.  
  614.  
  615.    Below are some average output rates measured while generating
  616.    360Kb files on a 4.77 Mhz PC/XT compatible system:
  617.  
  618.                        Bytes per      Bytes per
  619.       Destination       Second         Minute
  620.       -----------      ---------     ----------
  621.       Floppy disk        2.3Kb        137.8Kb
  622.       Hard disk         12.6Kb        756.3Kb  (45.4Mb/hour)
  623.       NUL device        25.2Kb          1.5Mb  (90.6Mb/hour)
  624.  
  625.  
  626.  
  627.  
  628. 1.9   ERROR MESSAGES
  629. ____________________
  630.  
  631.   Command Line parameter error messages:
  632.  
  633.   - Length parameter error at digit nn
  634.       An illegal character (non-decimal or punctuation) was
  635.       found in the length parameter, at position nn.
  636.  
  637.   - Length cannot be negative
  638.       Length parameter begins with a minus sign.
  639.  
  640.   - Length cannot exceed nn
  641.       Length parameter is larger than the maximum permitted.
  642.  
  643.  
  644.   Output error messages:
  645.  
  646.   - Write fault error writing device PRN - Abort, Retry, Ignore?
  647.       Redirected to printer, but printer is not ready.
  648.       Make ready, then Retry.
  649.  
  650.   - Note: if GEN is redirected to a file on a disk which has
  651.           insufficient space for the specified size, no error
  652.           message is displayed.  The resulting file will
  653.           (obviously) not be of the specified size, but will be
  654.           whatever size will fit on the disk. At completion, the
  655.           disk will have 0 bytes free.
  656.  
  657.  
  658.  
  659.  
  660. 2.0   DOS ERRORLEVEL
  661. ____________________
  662.  
  663.   Upon termination, the program returns a DOS ErrorLevel value
  664.   which indicates how the program ended, and which can be used for
  665.   subsequent operations in a batch file.  For further information,
  666.   see the "IF ERRORLEVEL" batch command in your DOS manual.
  667.  
  668.   ErrorLevel list:
  669.  
  670.       0  -  Successful completion.
  671.       1  -  No parameters specified on command line.
  672.       4  -  Error in input parameter(s).
  673.      27  -  Early termination; ESCape key pressed.
  674.     254  -  Cannot set up for Dos Redirection
  675.  
  676.  
  677.  
  678.  
  679. 3.0   VERSION HISTORY
  680. _____________________
  681.  
  682.    1.00  Initial release.
  683.  
  684.    1.01  Early termination via the ESCAPE key.
  685.  
  686.    1.1   DOS ErrorLevels added.
  687.  
  688.    1.2   Modified to correct elapsed time when midnight
  689.          occurs during a run.
  690.  
  691.  
  692.  
  693.  
  694. _________________________________________________________________
  695.  
  696. 9.0            Support
  697. _________________________________________________________________
  698.  
  699.  
  700.  
  701.  
  702. 9.1   PROBLEM RESOLUTION
  703. ________________________
  704.  
  705.    Please document and report any anomaly in program operation,
  706.    whether it's a genuine "bug" or just some feature of the
  707.    program that particularly "bugs" you.
  708.  
  709.    If you're the first person to document and report a problem
  710.    that we agree needs attention, you'll receive a free upgrade
  711.    with the correction when it's been made.  If you're a
  712.    registered user, you'll get the upgraded registered version;
  713.    if you haven't yet registered, you'll get the upgraded
  714.    evaluation version.
  715.  
  716.  
  717.  
  718.  
  719. 9.2   BEFORE REPORTING
  720. ______________________
  721.  
  722.    Things to try prior to reporting a problem:
  723.  
  724.       1 - Reread the documentation to make sure you understand
  725.           what we thought we understood when we wrote it.
  726.  
  727.       2 - If the system reports "Bad command or file name" when
  728.           you attempt to run the program, its executable file
  729.           (or at least the file name you specified) was not found.
  730.  
  731.           First, make sure no typos or misspellings have crept
  732.           into your command line; next, try changing your PATH
  733.           setting, or make the drive & directory where the program
  734.           resides the "current" drive & directory.
  735.  
  736.       3 - If the program is being run from a batch file, try
  737.           deleting lines previous to the line that actually
  738.           invokes the program, to see if some prior activity
  739.           is causing the problem.
  740.  
  741.       4 - If you have any memory-resident or "TSR" utilities
  742.           installed (pop-up calculators/note pads, keyboard
  743.           enhancements, etc.), try removing them from memory
  744.           and running the program again to see if the problem
  745.           reoccurs.
  746.  
  747.  
  748.  
  749.  
  750. 9.3   REPORTING A PROBLEM
  751. _________________________
  752.  
  753.    If the problem persists, please document it as completely and
  754.    accurately as possible; we have to be able to duplicate it
  755.    before we can begin to resolve it.
  756.  
  757.    Include at least the following:
  758.  
  759.       1 - Version of DOS you are using.
  760.       2 - Machine type, drives, memory, etc.
  761.       3 - Programs executed prior to the problem.
  762.       4 - Problem program's name and version number.
  763.       5 - Where and how you obtained the problem program.
  764.       6 - Address and/or phone number where you can be contacted.
  765.       7 - Anything you can think of that might relate to the problem;
  766.           for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
  767.           files, or any batch files used to run the program.
  768.       8 - Any relevant printouts.
  769.  
  770.  
  771.    NOTE: If you're a registered user, you'll find the utility
  772.          UserResp.Exe on the distribution diskette; it can be used
  773.          to print a pre-addressed mailer and a problem report.
  774.  
  775.          If you have not yet registered, send problem reports to the
  776.          address below (or print the pre-addressed mailer from the
  777.          Evaluation Menu).
  778.  
  779.  
  780.  
  781.  
  782. 9.4   CUSTOM MODIFICATIONS
  783. __________________________
  784.  
  785.    If you need custom modifications to this software for your
  786.    particular application, please write to the below address
  787.    with complete details of your requirements.
  788.  
  789.  
  790.  
  791.  
  792. 9.5   CORRESPONDENCE
  793. ____________________
  794.  
  795.    We welcome any comments or suggestions you might have
  796.    concerning improvements and future enhancements to this
  797.    product.  Send all correspondence and orders to:
  798.  
  799.              Phil Herron
  800.              P.O. Box 1288
  801.              Battle Ground, Washington  USA  98604
  802.  
  803.  
  804.  
  805.  
  806. _________________________________________________________________
  807.  
  808. 10.0           Shareware Product Catalog
  809. _________________________________________________________________
  810.  
  811.  
  812.   This section contains a list of our other Shareware products;
  813.   it may be updated whenever products are added or changed.
  814.           ____________________________________________
  815.  
  816.   If you'd like to try any of the programs in this catalog, but
  817.   can't find them locally, you can order evaluation copies
  818.   straight from the source...
  819.  
  820.   Five programs and their associated documentation will fit on each
  821.   5.25 inch 362Kb diskette; the basic single-disk fee of $4.00
  822.   covers the cost of the first disk, shipping and handling.  Add an
  823.   additional dollar for each additional disk of programs you want to
  824.   evaluate ($4.00 for 1 to 5 programs, $5.00 for 6-10, $6.00 for
  825.   11-15, etc.; all payments in U.S. funds).  If your address is
  826.   outside the U.S. and Canada, add an additional $3.00.
  827.  
  828.   Include your mailing address and the names of the programs.  By
  829.   return mail you'll receive the latest versions of those programs
  830.   for evaluation.
  831.           ____________________________________________
  832.  
  833.   "Shareware" is a software distribution method which enables the
  834.   potential user to obtain software at very low initial cost, for
  835.   evaluation on a trial basis.  You can evaluate the software in your
  836.   own environment, on your own machine, with the programs and data
  837.   that you normally use.  You're not required to become a registered
  838.   user unless the software meets your needs.
  839.           ____________________________________________
  840.  
  841.           PROGRAM SPECIFICATIONS AND REGISTRATION FEES
  842.                    MAY CHANGE WITHOUT NOTICE.
  843.           ____________________________________________
  844.  
  845.  
  846. ChkD  v1.1
  847.   Check_Disk_space reports disk drive space usage.  It reports drive
  848.   cluster size, then drive space TOTAL, FREE and USED by actual value
  849.   and by percentage.  It is faster and more convenient than the DOS
  850.   "dir" or "chkdsk" utilities for displaying drive information.
  851.  
  852. ChkM  v1.1
  853.   Check_Memory_space reports standard system memory (RAM) space usage.
  854.   It reports memory space TOTAL, FREE and USED by actual value and by
  855.   percentage.  It is faster and more convenient than the DOS "chkdsk"
  856.   utility for displaying system memory information.
  857.  
  858. CleanOut  v1.3
  859.   CLEANOUT searches all directories of the default drive for file(s)
  860.   specified on command line (wildcards * and ? are legal).  Each time
  861.   a matching file is found, the user is prompted for disposition:
  862.   Delete or Save.  File contents, either text or binary, can be VIEWED
  863.   before deciding.  A single press of the "S" key saves a file; a
  864.   double press of the "D" key deletes it.  An optional mode allows
  865.   deletions without confirmation.  Useful for cleaning out .BAK file
  866.   leftovers, among others.
  867.  
  868. CleanTxt  v1.1
  869.   CleanTxt converts WordStar text files to straight ASCII.  It strips
  870.   out certain control characters, and will optionally expand tab
  871.   characters to the appropriate number of spaces.
  872.  
  873. CleanZ  v1.2
  874.   Most text editors won't read files beyond the first control-Z end-
  875.   of-file character.  Control-Z's can become embedded in a text file
  876.   when several files are combined using the DOS "type" command.
  877.   CleanZ will strip out each control-Z, or it will optionally replace
  878.   each with a seldom-used character, to ease the task of locating the
  879.   former boundaries in combined files.
  880.  
  881. FindF  v1.1
  882.   FindFile searches the default drive for specified files, and writes
  883.   the file information to screen or disk. Useful for locating
  884.   misplaced files or for generating a listing of all files and
  885.   subdirectories on the default drive.
  886.  
  887. Gen  v1.2
  888.   Gen replaces several trial-and-error methods of building specific-
  889.   sized files for printer, storage or timing tests.  It generates
  890.   files of any size from zero to twenty million bytes, much faster
  891.   than typing random characters into a text editor.  Besides
  892.   generating files on disk, it can send a specific number of
  893.   characters directly to the console screen, printer or
  894.   other DOS device.
  895.  
  896. KeyCode  v1.1
  897.   KeyCode responds to each press of a key or combination of keys by
  898.   displaying the key or combination pressed, its associated Ascii
  899.   character (if any), key type (normal or extended), Ascii code and
  900.   Scan code.
  901.  
  902. KeySet  v1.1
  903.   KeySet's interactive mode displays the current settings of the
  904.   CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
  905.   allows them to be changed.  The command line mode directly sets the
  906.   keys to specified states, allowing use of a batch file for
  907.   presetting at system bootup or between applications.
  908.  
  909. PrinTest  v1.2
  910.   PrinTest repetitively displays the status of ports assigned to
  911.   parallel printer interfaces. It can be used to isolate problems to
  912.   the printer interface card, the cable or the printer itself.  It
  913.   reports printer and port number, status byte and status condition.
  914.  
  915. Qscr  v1.2
  916.   QuickScreen converts a single text screen to an executable file for
  917.   more rapid display.  The resulting .COM file will write a screen of
  918.   text much faster than batch file ECHO statements.  Useful for
  919.   setting up compact menu systems, demos and tutorials.
  920.  
  921. ScanF  v1.1
  922.   Scan_File speeds up the search for ASCII text strings within
  923.   executable files.  It filters out the unintelligible control and
  924.   extended characters, allows user definition of minimum string length
  925.   for display, and pauses after each screen of information.
  926.  
  927. ScanM  v1.1
  928.   Scan_Memory speeds up the search for ASCII text such as ROM
  929.   copyright statements and machine identification, anywhere within
  930.   standard system memory space. It filters out the unintelligible
  931.   control and extended characters, displays each string longer than
  932.   three characters, and pauses after each screen of information.
  933.  
  934. Split  v1.1
  935.   Split breaks huge text files down into smaller ones that will fit
  936.   into your text editor or onto a diskette. Useful for working on
  937.   large files with a limited-filesize memory-resident notepad utility.
  938.  
  939. StoRm  v1.1
  940.   STOrage_RooM reports the amount of disk space required for storage
  941.   of a specified file or group of files on any disk, using any version
  942.   of DOS.  It takes into account all of the factors involved in
  943.   determining file storage size.  It locates files specified on the
  944.   command line and determines their actual total size and the amount
  945.   of room needed to store them.  Useful for determining the number of
  946.   files that will fit on a disk.
  947.  
  948. PhLBL  v0.75 (not yet released)
  949.   Label printer using text stored in ASCII files.  Each label/card/
  950.   tag can contain embedded commands for date, time, series (nn OF nn),
  951.   consecutive serial numbering, left margin, and selectable printer
  952.   attribute for each line; 5, 10, 12, 17 or 20 characters per inch
  953.   pitch, normal/bold/underlined on Epson compatible dot-matrix
  954.   printers.
  955.  
  956.  _______________________________________________________________
  957. |                                                               |
  958. |        COPYRIGHT 1989 Phil Herron.  ALL RIGHTS RESERVED.      |
  959. |_______________________________________________________________|
  960.