SDN¹ Plus/SDN1_.cdr/sdn/util1/keyset11.sdn/KEYSET.DOC

Text File | 1989-12-25 | 30KB | 895 lines

                  KeySet



                  CapsLock-NumLock-ScrollLock-PrtSc key Setup



                  Version  1.1
                  Released 12-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 PROVIDED FOR EVALUATION, AS IS
         AND WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR
         MAKES NO EXPRESS OR IMPLIED WARRANTIES,
         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.




   ______________________________________________________________

   Evaluation Preface                                     Section
   ______________________________________________________________

   Shareware............................................... 0.1.0
     What it is............................................ 0.1.1
     License Terms......................................... 0.1.2
     Registration.......................................... 0.1.3
       Benefits, Forms, Registration fees,
       Quantity discounts, Combined orders

   Evaluation.............................................. 0.2.0
     Evaluation Version.................................... 0.2.1
     Evaluation Menu....................................... 0.2.2
     Virus Prevention...................................... 0.2.3



   _____________________________

   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 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 the right to use the evaluation version of
   this software on a trial basis for a limited amount of time,
   to decide whether to continue using (and therefore whether
   to register) the product.

   You can 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, startup time-delay or forms-printing sections of
     this version.  Thus it will be more convenient to use, from
     either the DOS prompt or from batch files.  It will also be
     12k-15K 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 a single location (on a single terminal or
     computer) at any one time.  If you need to run the software
     on more than one terminal or computer 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.


   COMBINED ORDERS

     You can also take advantage of 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)   Mail all the forms together, with a single check/money
              order for the total, in one envelope/mailing cover.



   _____________________________

   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 order a copy straight from the source.
   See the SHAREWARE PRODUCT CATALOG section at the end of this file.





   _________________________________________________________________

   Table of Contents                                         Section
   _________________________________________________________________

   KeySet..................................................... 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 in INTERACTIVE mode................. 1.6.1
         OPERATING SCREEN in COMMAND LINE mode................ 1.6.2
      Applications............................................ 1.7
      Error Messages.......................................... 1.8
      DOS ErrorLevel.......................................... 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

   Shareware Product Catalog................................. 10.0




   ******************************************
            NEW in this version
   ******************************************

   Previous versions employed white text on black background
   exclusively; this version uses the default colors in
   effect when the program is started.

   DOS ErrorLevel is now returned upon termination.




_________________________________________________________________

               KeySet
1.0
               CapsLock-NumLock-ScrollLock-PrtSc Setup
_________________________________________________________________




1.1   INTRODUCTION
__________________

   Some systems automatically set the NumLock control state to
   ON during bootup.  This could be desirable if you always use
   NumLock ON.  It can be an unnecessary complication if you
   don't.


   Some accounting software accepts only UPPER-CASE CHARACTERS.
   If you forget to punch the CapsLock key when you first start
   the program, you'll waste time reentering rejected lower-case
   commands and text.


   On some systems, various lock key settings flip mysteriously,
   seemingly at random.  With older keyboards, the control key
   status indicators can end up showing erroneous results.

   Some older keyboards don't even HAVE status indicators for the
   control keys, so you can't tell what the settings are without
   experimentation.


   KEYSET can solve most of these problems.




1.2   EXPLANATION
_________________

   KEYSET's interactive mode will display the settings of the
   CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys,
   and allow you to change them.  The command line mode will
   directly set the keys to the states you specify on the
   command line or in a batch file.


   The PrtSc-disable function is included to prevent problems
   when you accidentally press the PrtSc key, especially on older
   keyboards that have PrtSc located next to the Right Shift
   and Return keys.

   Depending on printer status (and on whether a printer is even
   installed), the result of an unintended Print Screen can range
   from a minor interruption or a wasted sheet of printer paper,
   to a locked up system.




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

               KEYSET

   without any parameters; it will display help
   information, then wait in interactive mode.




1.5   SYNTAX
____________



   Interactive mode
   ________________

      KEYSET                  No parameters.  Displays table of
                              keys and current states; make
                              selections, then press <Return>.



   Command Line mode
   _________________

      KEYSET [commandString]

         Where commandString can contain any combination of the
         following letter-and-symbol pairs:

            S+    ScrollLock ON  (set)
            S-    ScrollLock OFF (clear)

            C+    CapsLock   ON  (set)
            C-    CapsLock   OFF (clear)

            N+    NumLock    ON  (set)
            N-    NumLock    OFF (clear)

            P+    PrtSc      ENABLE
            P-    PrtSc      DISABLE

         Letters can be either upper or lower case, and may be
         specified in any order.  Spaces or tabs can be included
         to separate the pairs for better readability.

         Any letters or symbols other than those specified will
         halt the program with an error message.




1.6   EXAMPLES
______________


      KEYSET                  Interactive mode; displays table of
                              keys and current states.

      KEYSET S-C-N-P-         Clears SL, CL, NL, disables PrtSc.

      KEYSET S+ C+ N+ P+      Sets   SL, CL, NL, enables PrtSc.

      KEYSET C+S- P-N+        Sets CL, CLEARS SL, disables PrtSc,
                              Sets NL.

      KEYSET P+N+             Enables PrtSc, sets NumLock.

      KEYSET SCNP             Halts with error message.

      KEYSET A+B+C+D+         Halts with error message; only
                              S, N, C and P are recognized.

      KEYSET S.C/N,P          Halts with error message; only
                              + and - symbols are recognized.

      KEYSET S+ S-            Sets SL (only the first occurrence of
                              a command letter is used; repeats are
                              ignored).




1.6.1   OPERATING SCREEN in INTERACTIVE mode
____________________________________________

   When you issue the command

            KEYSET

   with no parameters, the combined HELP and INTERACTIVE
   screen is displayed:

       __KeySet______________________
      |______________________________|

         Help information
         .
         .

       _ Key ________ Current State ____________
      |                                         |
      |  ScrollLock   Off / On                  |
      |  NumLock      Off / On                  |
      |  CapsLock     Off / On                  |
      |  PrtSc        Disabled / Enabled        |
      |_________________________________________|


   The current state of any of the keys can be reversed by
   pressing either that key (SCROLLLOCK, NUMLOCK, CAPSLOCK, PRTSC)
   or the first letter of its name (S, N, C, P).  The possible
   states for the first three keys shown above are ON or OFF.
   PrintScreen can be either ENABLED or DISABLED.

   When you're satisfied with the settings, press <Return>.




1.6.2   OPERATING SCREEN in COMMAND LINE mode
_____________________________________________

   When you issue the command

         KEYSET commandString       (see example section),

   the screen displays:

       __KeySet______________________
      |______________________________|

   It next displays the name of each key specified in the
   command string, along with its new state (On or Off,
   Enabled or Disabled).




1.7   APPLICATIONS
__________________

   Use KeySet in the INTERACTIVE MODE whenever you need to view
   the current lock key settings, or any time you need to change
   the settings but can't remember the command line syntax.


   KeySet's COMMAND LINE MODE can be used from the DOS prompt,
   but was designed for unattended batch file operation.

   You may want to set the lock keys and the print-screen key
   to a particular configuration upon system bootup.  Add a line
   to your AUTOEXEC.BAT file to call KeySet with the appropriate
   parameters.  For example, if you always want CapsLock ON and
   the PrtSc key disabled, use the line

               KEYSET C+ P-


   You may need different configurations for various application
   programs; write a batch file that runs KeySet with the new
   parameter list, then calls the application.  Below is a sample
   batch file that sets NumLock ON (to enable the numeric key pad),
   then runs a payroll program.  After the payroll program returns
   control to the batch file, NumLock is turned back OFF:

               echo off
               KEYSET N+
               PayRoll
               KEYSET N-




1.8   ERROR MESSAGES
____________________

  Command Line parameter error messages:

    <parameter> is an illegal parameter
      A parameter was entered that is not recognized
      by the program.

    <parameter> missing symbol + or -
      A parameter was entered without an associated
      + or - symbol.




1.9   DOS ERRORLEVEL
____________________

  Upon termination, the program returns a DOS ErrorLevel value
  which indicates how the program ended, and which can be used for
  subsequent operations in a batch file.  For further information,
  see the "IF ERRORLEVEL" batch command in your DOS manual.

  ErrorLevel list:

      0  -  Successful completion.
      1  -  Illegal parameter specified on command line.
      2  -  Parameter is missing symbol + or -.




2.0   VERSION HISTORY
_____________________

   1.00  Initial release.
   1.07  DOS ErrorLevels added.
   1.1   Display is no longer fixed white on black, but now uses
         the default colors in effect when the program is started.




_________________________________________________________________

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 and orders to:

             Phil Herron
             P.O. Box 1288
             Battle Ground, Washington  USA  98604




_________________________________________________________________

10.0           Shareware Product Catalog
_________________________________________________________________


  This section contains a list of our other Shareware products;
  it may be updated whenever products are added or changed.
          ____________________________________________

  If you'd like to try any of the programs in this catalog, but
  can't find them locally, you can order evaluation copies
  straight from the source...

  Five programs and their associated documentation will fit on each
  5.25 inch 362Kb diskette; the basic single-disk fee of $4.00
  covers the cost of the first disk, shipping and handling.  Add an
  additional dollar for each additional disk of programs you want to
  evaluate ($4.00 for 1 to 5 programs, $5.00 for 6-10, $6.00 for
  11-15, etc.; all payments in U.S. funds).  If your address is
  outside the U.S. and Canada, add an additional $3.00.

  Include your mailing address and the names of the programs.  By
  return mail you'll receive the latest versions of those programs
  for evaluation.
          ____________________________________________

  "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 become a registered
  user unless the software meets your needs.
          ____________________________________________

          PROGRAM SPECIFICATIONS AND REGISTRATION FEES
                   MAY CHANGE WITHOUT NOTICE.
          ____________________________________________


ChkD  v1.1
  Check_Disk_space reports disk drive space usage.  It reports drive
  cluster size, then drive space TOTAL, FREE and USED by actual value
  and by percentage.  It is faster and more convenient than the DOS
  "dir" or "chkdsk" utilities for displaying drive information.

ChkM  v1.1
  Check_Memory_space reports standard system memory (RAM) space usage.
  It reports memory space TOTAL, FREE and USED by actual value and by
  percentage.  It is faster and more convenient than the DOS "chkdsk"
  utility for displaying system memory information.

CleanOut  v1.3
  CLEANOUT searches all directories of the default drive for file(s)
  specified on command line (wildcards * and ? are legal).  Each time
  a matching file is found, the user is prompted for disposition:
  Delete or Save.  File contents, either text or binary, can be VIEWED
  before deciding.  A single press of the "S" key saves a file; a
  double press of the "D" key deletes it.  An optional mode allows
  deletions without confirmation.  Useful for cleaning out .BAK file
  leftovers, among others.

CleanTxt  v1.1
  CleanTxt converts WordStar text files to straight ASCII.  It strips
  out certain control characters, and will optionally expand tab
  characters to the appropriate number of spaces.

CleanZ  v1.2
  Most text editors won't read files beyond the first control-Z end-
  of-file character.  Control-Z's can become embedded in a text file
  when several files are combined using the DOS "type" command.
  CleanZ will strip out each control-Z, or it will optionally replace
  each with a seldom-used character, to ease the task of locating the
  former boundaries in combined files.

FindF  v1.1
  FindFile searches the default drive for specified files, and writes
  the file information to screen or disk. Useful for locating
  misplaced files or for generating a listing of all files and
  subdirectories on the default drive.

Gen  v1.2
  Gen replaces several trial-and-error methods of building specific-
  sized files for printer, storage or timing tests.  It generates
  files of any size from zero to twenty million bytes, much faster
  than typing 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.

KeyCode  v1.1
  KeyCode responds to each press of a key or combination of keys by
  displaying the key or combination pressed, its associated Ascii
  character (if any), key type (normal or extended), Ascii code and
  Scan code.

KeySet  v1.1
  KeySet's interactive mode displays the current settings of the
  CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
  allows them to be changed.  The command line mode directly sets the
  keys to specified states, allowing use of a batch file for
  presetting at system bootup or between applications.

PrinTest  v1.2
  PrinTest repetitively displays the status of ports assigned to
  parallel printer interfaces. It can be used to isolate problems to
  the printer interface card, the cable or the printer itself.  It
  reports printer and port number, status byte and status condition.

Qscr  v1.2
  QuickScreen converts a single text screen to an executable file for
  more rapid display.  The resulting .COM file will write a screen of
  text much faster than batch file ECHO statements.  Useful for
  setting up compact menu systems, demos and tutorials.

ScanF  v1.1
  Scan_File speeds up the search for ASCII text strings within
  executable files.  It filters out the unintelligible control and
  extended characters, allows user definition of minimum string length
  for display, and pauses after each screen of information.

ScanM  v1.1
  Scan_Memory speeds up the search for ASCII text such as ROM
  copyright statements and machine identification, anywhere within
  standard system memory space. It filters out the unintelligible
  control and extended characters, displays each string longer than
  three characters, and pauses after each screen of information.

Split  v1.1
  Split breaks huge text files down into smaller ones that will fit
  into your text editor or onto a diskette. Useful for working on
  large files with a limited-filesize memory-resident notepad utility.

StoRm  v1.1
  STOrage_RooM reports the amount of disk space required for storage
  of a specified file or group of files on any disk, using any version
  of DOS.  It takes into account all of the factors involved in
  determining file storage size.  It locates files specified on the
  command line and determines their actual total size and the amount
  of room needed to store them.  Useful for determining the number of
  files that will fit on a disk.

PhLBL  v0.75 (not yet released)
  Label printer using text stored in ASCII files.  Each label/card/
  tag can contain embedded commands for date, time, series (nn OF nn),
  consecutive serial numbering, left margin, and selectable printer
  attribute for each line; 5, 10, 12, 17 or 20 characters per inch
  pitch, normal/bold/underlined on Epson compatible dot-matrix
  printers.

 _______________________________________________________________
|                                                               |
|        COPYRIGHT 1989 Phil Herron.  ALL RIGHTS RESERVED.      |
|_______________________________________________________________|