Category : Batch File Utilities - mostly for DOS
Archive   : BATCHKEY.ZIP
Filename : BATCHKEY.DOC

BatchKey, Ver 1.00, by Christopher D. Bonatti
Copyright General technologies International, 1989.
All rights reserved.


ABSTRACT:

BatchKey reads input from either the keyboard or a file, and
returns numerical input in the DOS errorlevel variable. The program
can be called with the following parameters:


BATCHKEY [/OFS=byte offset] [/FILE=filename] [/ELSE=n] [/ERR=n] [/CAPS]
[string:value] [string:value] [string:value] . . .


LICENSE RESTICTIONS:

This product is shareware. Development of GTI (TM)
shareware is financed entirely by user contributions. You
are granted a limited license to use this program on a trial
basis. If you find this program useful and wish to continue
using it, please register by sending a $20 registration fee
to the address below. Registered users will receive
notification of the next major revision. Your contribution
will also help to support further shareware products from
GTI. All software and data files remain the exclusive
property of GTI.

General Technologies International
P.O. Box 11276
Pittsburgh, PA 15238

Please include the program name and revision number in all
correspondence. Constructive commentaries or suggestions
are welcomed. Additional Profound sayings databases are
available from the above address. ProParser, a program which
allows you to create your own Profound databases, is also
available. These upgrades are available to registered users
only.


OPERATION:

This program reads the information stored at the nth byte
of a file, and compares this to user defined string:value pairs.
Strings can be up to 25 characters long, but may not include
spaces. Corresponding values may range from 0-255. Up to 25
pairs can be defined in the command line. The program returns the
byte value assigned to each string in the DOS errorlevel variable.
The /ELSE= parameter allows the user to specify the errorlevel to
be returned if none of the specified strings are matched. The /CAPS
parameter specifies a case insensitive string compare. All
parameters for this program are optional. If no byte offset is
specified, the program begins the compare with the first byte in
the file. If no filename is specified, the program reads
keystrokes from the keyboard. If no string:value pairs are
specified, the program returns the byte value of the encountered
character. If the /ELSE= parameter is not specified, the default
return code is zero.