home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Hall of Fame
/
HallofFameCDROM.cdr
/
util2
/
ph-utils.lzh
/
GEN.DOC
< prev
next >
Wrap
Text File
|
1989-07-11
|
27KB
|
821 lines
GEN
Test Character Generating Utility
Version 1.01
Released 05-18-89
Herron Software
P.O. Box 1288
Battle Ground, Washington 98604
COPYRIGHT 1988, 1989 Phil Herron. ALL RIGHTS RESERVED.
DISCLAIMER OF WARRANTY
__________________________________________
THIS PRODUCT IS LICENSED AS IS AND WITHOUT
WARRANTY OF ANY KIND. THE AUTHOR MAKES NO
EXPRESS OR IMPLIED WARRANTIES WITH REGARD
TO THIS PRODUCT, INCLUDING BUT NOT LIMITED
TO MERCHANTABILITY OR FITNESS FOR ANY
PURPOSE. IN NO EVENT SHALL THE AUTHOR BE
LIABLE FOR LOSS OF PROFIT OR ANY OTHER
COMMERCIAL DAMAGE ARISING FROM EITHER THE
USE OF OR THE INABILITY TO USE THIS PRODUCT.
This product should be thoroughly evaluated
using backed up or noncritical data and files.
_________________________________________________________________
Table of Contents Section
_________________________________________________________________
Shareware.................................................. 0.1.0
What it is.............................................. 0.1.1
License Terms........................................... 0.1.2
Registration............................................ 0.1.3
Evaluation................................................. 0.2.0
Evaluation Version...................................... 0.2.1
Evaluation Menu......................................... 0.2.2
Virus Prevention........................................ 0.2.3
Gen........................................................ 1.0
Introduction............................................ 1.1
Explanation............................................. 1.2
System Requirements..................................... 1.3
Installing........................................... 1.3.1
Help.................................................... 1.4
Syntax.................................................. 1.5
Examples................................................ 1.6
Operating screen..................................... 1.6.1
Output Format........................................... 1.7
Applications............................................ 1.8
Error Messages.......................................... 1.9
Version History......................................... 2.0
Support.................................................... 9.0
Problem Resolution...................................... 9.1
Before Reporting........................................ 9.2
Reporting a problem..................................... 9.3
Custom Modifications.................................... 9.4
Correspondence.......................................... 9.5
Product Catalog........................................... 10.0
_________________________________________________________________
0.1.0 Shareware
_________________________________________________________________
0.1.1 The SHAREWARE Concept
_____________________________
"Shareware" is a software distribution method which enables
the potential user to obtain software at very low initial
cost, for evaluation on a trial basis.
You can evaluate the software in your own environment, on your
own machine, with the programs and data that you normally use.
You're not required to make payment and become a registered
user unless the software meets your needs.
Another benefit of Shareware is lower pricing. By minimizing
the marketing and advertising expenses associated with more
traditional software distribution methods, Shareware products
can be priced lower. You don't pay for what you don't need or
use.
You are encouraged to share the evaluation version of this
software with others, so long as you follow the limitations
set forth in the LICENSE TERMS section below.
0.1.2 LICENSE TERMS
_____________________
This product and its documentation are copyrighted and owned
solely by the author, who reserves all rights to any benefits
derived from it. It is distinctly separate from, and should
not be confused with, those categories of software known as
"public domain" or "freeware."
You are granted without charge a limited license to use the
evaluation version of this software on a trial basis, for
purposes of deciding whether to continue using (and therefore
whether to register) the product, and to transmit this
evaluation version to associates by copying on diskette or
uploading to electronic bulletin board services, so long as
the following CONDITIONS are met:
(a) The program and its documentation file must be
distributed together.
(b) The program and its documentation must not be
altered in any way. If you wish to include
notes for other evaluators, please add them in
a separate file and include that file along
with the program and documentation files.
0.1.3 REGISTRATION
____________________
When you send in the registration form and fee, you'll
receive by return mail a diskette containing the latest
REGISTERED version of the program and documentation.
BENEFITS OF REGISTRATION
The registered version WILL NOT include the Evaluation Menu
front-end or the forms-printing section of this version.
Thus it will be more convenient to use, from either the DOS
prompt or from batch files. It will also be about 16K
bytes smaller, for more efficient disk storage and faster
loading.
The registered version WILL include any new functions
or enhancements made to date.
You will receive notification of future updates and
new products.
You will be able to upgrade to newer versions at a
reduced cost.
REGISTRATION FORM
The registration form and a pre-addressed mailing cover
can be printed from the "Forms Printing" selection of
the Evaluation menu, discussed in section 0.2.2 below.
FEES
The single-quantity registration fee is displayed on the
initial Evaluation Menu screen. Higher quantities are
discussed below.
QUANTITY DISCOUNTS
Each registered copy of this software will be licensed for
operation at only one location (on only one machine) at any
one time. If this software will be in use at more than one
location at the same time, the appropriate number of
registrations must be made.
Multiple-quantity registration fees are displayed in the
"QUANTITY DISCOUNT" section of the Evaluation menu.
You can take advantage of quantity discounts by ordering
multiple registrations of one program or single
registrations of several different programs at the same
time. You also save on shipping and handling charges
by registering several products together.
GROUP REGISTRATIONS
You can also get quantity discounts by combining orders with
associates:
(1) Complete a separate registration form for each person.
Each person's name, address and programs to be
registered are needed for support and update
notification purposes.
(2) Include only one standard shipping and handling charge.
Cross out the "Shipping & handling" amounts on
all but one registration form; the combined
order will be sent to the name and address on
that form.
(3) Send all the forms together in one envelope or mailing
cover, with a single check or money order.
_________________________________________________________________
0.2.0 Evaluation
_________________________________________________________________
0.2.1 EVALUATION VERSION
__________________________
This software contains the complete and fully functional version
of the program, the latest available at the time of this release.
The program itself is identical to the REGISTERED version.
An Evaluation Menu and forms-printing section were added
to ensure that:
(a) Registration information and forms will not
become separated from the program file.
(b) Users who might be unfamiliar with the process
of displaying a file's contents on the screen or
printer will have no difficulty learning about,
evaluating or registering this product.
0.2.2 EVALUATION MENU
_______________________
The program is invoked from the DOS prompt by typing its name
and pressing the RETURN or ENTER key.
The initial screen displays the warranty section and some
information about the program:
Program name,
Version number,
Release date,
Single-quantity registration fee.
It next displays the Shareware Product EVALUATION MENU.
A single key press will select the following functions
from the menu:
_________________________________________
ESC - EXIT to DOS without evaluating this program
R - READ the documentation (THIS file)
x - EVALUATE this program
Q - QUANTITY Discount information
F - FORMS printing menu - registration & mailer
_________________________________________
When you press "R" to READ the documentation, this file will
be shown one screen at a time. The display pauses whenever the
screen becomes full, and prompts...
<downArrow> or Esc
The <downArrow> character is similar to the "MORE" prompt in
other DOS utilities. It indicates that more is available.
Press ESCape to exit back to the Evaluation Menu, or any normal
typing key to continue (space bar is a convenient key to use).
0.2.3 VIRUS PREVENTION
________________________
If you'd like to evaluate this software but you're not sure
where it's been, you can get a copy straight from the source
for a $4.00 charge to cover the cost of the diskette, shipping
and handling. If your address is outside the U.S. and Canada,
add an additional $3.00 (total $7.00, in U.S. funds).
Include your mailing address and the name of the program.
By return mail you'll receive the latest evaluation version
of that program and as many others as will fit on a 5.25
inch diskette.
______________________________________________________________
GEN
1.0
Test Character Generating Utility
______________________________________________________________
1.1 INTRODUCTION
__________________
For the sake of illustration, assume that you need a disk file of
a particular size for testing or experimentation.
METHOD ONE - use a Text Editor
You could use a trial-and-error method: run your word processor
or text editor, type some random characters, save the result,
then check on the size of the saved file. If it's not right,
go back into the editor and add or subtract some characters.
Repeat until you get the file size just right.
METHOD TWO - use Debug or Symdeb
Or, if you possess DEBUG or SYMDEB, you could use a script
like this to generate a 1000-byte file named OneK.Txt...
C>debug
-n OneK.Txt name the file
-rcx set file size
CX 0000
:3E8 hexadecimal size of file
-f 0 L 3E8 2E fill space with a char (2E hex for dots)
-w write the file to disk
Writing 03E8 bytes
-Q quit back to DOS
This method works well for files up to FFFFh (65,535 decimal)
bytes in length; for larger sizes, you must also set register
BX, and go through some calculations to fill the space with
known characters.
The schemes above do work, and they might be acceptable for small
files. However, they're so much bother that you'll probably end up
saving the generated files on a disk just in case you ever need
them again. But next time you'll likely need a file just a
little larger or smaller than the ones you've saved!
GEN can remove all the bother. It generates files of any size from
zero to twenty million bytes (20Mb), and generates them much faster
than you can type random characters into a text editor.
Besides generating files on disk, it can send a specific number
of characters directly to the console screen, printer or other
DOS device. When finished, it displays elapsed time.
1.2 EXPLANATION
_________________
GEN sends a specified number of characters to a specified
destination. The default destination is the monitor screen;
others are accessed using the DOS redirection characters
> and >>
from the command line. For more information on using
redirection, see your DOS manual and the sections below
covering syntax and examples.
The basic character that GEN generates in quantity is the
period, ASCII 2E hex. It was selected for no particular
reason other than possibly minimizing ribbon wear during
printer testing.
The final characters sent during each run depend upon the
output size specified, and are either CR (carriage return)
or CR LF (carriage return followed by linefeed).
See section 1.7, OUTPUT FORMAT, for additional information.
The character count is displayed on screen after every twenty
thousand characters. This count display is sent only to the
screen, and does not become part of the output to a file or
device.
The ESCape key can be used to exit at any time. GEN will
terminate at the end of the 1000-character block it was
processing when the Escape key was detected.
1.3 SYSTEM REQUIREMENTS
_________________________
PC, XT, AT or compatible.
DOS version 2.1 or later.
64K free memory.
1.3.1 INSTALLING
___________________
The program can be run from diskette or from hard disk. No
installation is necessary, other than copying the files
to a drive and directory of your choosing.
1.4 HELP
__________
Can't remember the command line syntax?
Issue the program's name without any parameters; it
will display a help screen, then return to the DOS prompt.
1.5 SYNTAX
____________
GEN [length] [>[>filespec or device]]
Parameter explanation:
[length]
Length must be a positive number,
0 through 20000000 (twenty million),
with no embedded punctuation.
[>] or [>>]
DOS redirection characters.
> Sends output to specified file; overwrites the file
if it already exists.
>> Appends output to the end of the specified file.
[filespec]
The string needed to reference a file;
can also be shown as [d:][path][filename.ext].
The minimum filespec needed is filename.ext. If the file
is to be generated in another directory and/or on another
drive, the drive name and/or pathname must also be given.
The complete filespec for a file named TestFile.Txt
residing in drive A: in a subdirectory named TestSub is
A:\TestSub\TestFile.Txt
For further information on filespecs, see your DOS manual.
[device]
A particular DOS device:
PRN, LPT1, LPT2 - sends output to specified printer
CON sends output to console (default)
NUL discards the output
1.6 EXAMPLES
______________
GEN 1000 Sends 1000 characters to screen.
GEN 1000 >PRN Sends 1000 characters to printer.
GEN 1000 >OneK.Txt Creates 1000-byte file on current
drive, in current subdirectory.
GEN 1000 >>OneK.Txt Appends another 1000 bytes to an
existing file.
GEN 1000 >A:OneK.Txt Creates 1000-byte file on drive A:
GEN 0 >Zip.Txt Creates a file of zero length.
1.6.1 OPERATING SCREEN
________________________
The operating screen appears whenever "GEN" is issued from the
DOS prompt (or from a batch file) with a size specification;
in this example, the complete command line is:
Gen 56789 >Dummy.Txt
and the screen displays:
__Gen_________________________
|______________________________|
Generating 56789 characters
Kbytes completed: nn
\
Running count of current size, in 20K steps
Upon completion (or when ESC is pressed to terminate early),
elapsed time is normally displayed. An exception is when GEN's
output is being redirected to a disk which has insufficient
space for the specified file size: the file is generated until
the disk has zero bytes free, then GEN terminates, but elapsed
time is not displayed.
1.7 OUTPUT FORMAT
___________________
GEN generates the specified number of characters by blocks of
one thousand, followed by any remaining characters needed to
make up the required size.
Each 1K block consists of 998 dot characters (ASCII 2E hex)
followed by CR (ASCII 0D hex) and LF (ASCII 0A hex).
Sizes in excess of even multiples of the basic one-thousand-
character block are generated as shown below:
Size over 1K Characters sent
------------ -------------------
1 CR
2 CR, LF
3 1 dot, CR, LF
4 2 dots, CR, LF
. .
. .
999 997 dots, CR, LF
Example:
Output length of Will Contain
---------------- ----------------------
1 CR
1000 998 dots CR LF (the basic 1K block)
1001 One 1K block plus CR
1002 One 1K block plus CR LF
1003 One 1K block plus 1 dot CR LF
2001 Two 1K blocks plus CR
10001 Ten 1K blocks plus CR
It should be noted that if GEN is issued without being
redirected to a file or device, the number of dots appearing
on the screen will be fewer than specified in the length
parameter.
A length of 1 or 2 will show no dots; 3 or higher will show
two fewer dots than specified, since the CR and LF are not
explicitly displayed on the screen. However, the correct file
length will always be generated when the output is redirected
to a file or device.
1.8 APPLICATIONS
__________________
GENerated files can be used for:
Printer speed testing
Printer buffer capacity testing
Print Spooler testing
Disk file copying speed testing
Disk capacity testing
RAMdisk testing
Dummy files for any purpose.
Below are some average output rates measured while generating
360Kb files on a 4.77 Mhz PC/XT compatible system:
Bytes per Bytes per
Destination Second Minute
----------- --------- ----------
Floppy disk 2.3Kb 137.8Kb
Hard disk 12.6Kb 756.3Kb (45.4Mb/hour)
NUL device 25.2Kb 1.5Mb (90.6Mb/hour)
1.9 ERROR MESSAGES
____________________
Command Line parameter error messages:
- Length parameter error at digit nn
An illegal character (non-decimal or punctuation) was
found in the length parameter, at position nn.
- Length cannot be negative
Length parameter begins with a minus sign.
- Length cannot exceed nn
Length parameter is larger than the maximum permitted.
Output error messages:
- Write fault error writing device PRN - Abort, Retry, Ignore?
Redirected to printer, but printer is not ready.
Make ready, then Retry.
- Note: if GEN is redirected to a file on a disk which has
insufficient space for the specified size, no error
message is displayed. The resulting file will
(obviously) not be of the specified size, but will be
whatever size will fit on the disk. At completion, the
disk will have 0 bytes free.
2.0 VERSION HISTORY
_____________________
1.00 Initial release.
1.01 Early termination via the ESCAPE key.
_________________________________________________________________
9.0 Support
_________________________________________________________________
9.1 PROBLEM RESOLUTION
________________________
Please document and report any anomaly in program operation,
whether it's a genuine "bug" or just some feature of the
program that particularly "bugs" you.
If you're the first person to document and report a problem
that we agree needs attention, you'll receive a free upgrade
with the correction when it's been made. If you're a
registered user, you'll get the upgraded registered version;
if you haven't yet registered, you'll get the upgraded
evaluation version.
9.2 BEFORE REPORTING
______________________
Things to try prior to reporting a problem:
1 - Reread the documentation to make sure you understand
what we thought we understood when we wrote it.
2 - If the system reports "Bad command or file name" when
you attempt to run the program, its executable file
(or at least the file name you specified) was not found.
First, make sure no typos or misspellings have crept
into your command line; next, try changing your PATH
setting, or make the drive & directory where the program
resides the "current" drive & directory.
3 - If the program is being run from a batch file, try
deleting lines previous to the line that actually
invokes the program, to see if some prior activity
is causing the problem.
4 - If you have any memory-resident or "TSR" utilities
installed (pop-up calculators/note pads, keyboard
enhancements, etc.), try removing them from memory
and running the program again to see if the problem
reoccurs.
9.3 REPORTING A PROBLEM
_________________________
If the problem persists, please document it as completely and
accurately as possible; we have to be able to duplicate it
before we can begin to resolve it.
Include at least the following:
1 - Version of DOS you are using.
2 - Machine type, drives, memory, etc.
3 - Programs executed prior to the problem.
4 - Problem program's name and version number.
5 - Where and how you obtained the problem program.
6 - Address and/or phone number where you can be contacted.
7 - Anything you can think of that might relate to the problem;
for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
files, or any batch files used to run the program.
8 - Any relevant printouts.
NOTE: If you're a registered user, you'll find the utility
UserResp.Exe on the distribution diskette; it can be used
to print a pre-addressed mailer and a problem report.
If you have not yet registered, send problem reports to the
address below (or print the pre-addressed mailer from the
Evaluation Menu).
9.4 CUSTOM MODIFICATIONS
__________________________
If you need custom modifications to this software for your
particular application, please write to the below address
with complete details of your requirements.
9.5 CORRESPONDENCE
____________________
We welcome any comments or suggestions you might have
concerning improvements and future enhancements to this
product. Send all correspondence to:
Phil Herron
P.O. Box 1288
Battle Ground, Washington USA 98604
_________________________________________________________________
10.0 Product Catalog
_________________________________________________________________
This section contains a list of products available or near
completion as of this release date; it will be updated
whenever new products are added.
ChkD - Drive Total/Free/Used report by value & percent
ChkM - Memory Total/Free/Used report by value & percent
CleanOut - Selective file deletion, with confirmation
CleanTxt - WordStar to Ascii convert, ctrl char strip, tab expand
CleanZ - Ctrl-Z End Of File char strip or replace
FindF - Find File(s) in any directory of current drive
Gen - Generate files for testing printer, storage or timing
KeySet - CapsLock-NumLock-ScrollLock-PrtSc key setup
PrinTest - Parallel Printer Test & Status reporting
Qscn - Convert text to executable file for Quick Screen display.
ScanF - Scan File for text strings
ScanM - Scan Memory for text strings
Split - File splitter
StoRm - STorage RooM needed for files on any disk/any DOS ver.
_______________________________________________________________
| |
| COPYRIGHT 1989 Phil Herron. ALL RIGHTS RESERVED. |
|_______________________________________________________________|