;
                                  WHEEL.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
WHEEL.COM      2k (12)   E132  3.3        Gene Pizzetta 10/90      Z3COM26
WHEEL.3OM      2k (12)   93E0  3.3        Gene Pizzetta 10/90      Z3COM26
WHEEL.4OM      3k (17)   5749  3.3        Gene Pizzetta 10/90      Z3COM26

  1- Syntax/Options  2- Configuration  3- Error Msgs  4- Examples  5- Notes   


   WHEEL sets, resets, and displays the ZCPR3 Wheel Byte, which determines how
or whether some programs operate.

   Vs 1.0 (3/84) by R. Conn.

:1
    Syntax   WHEEL {{/}option {password}}

             or

             WHEEL {password {{/}option}}

   If no option or password is given,  DISPLAY is  assumed.   If a password is
given, but no option, SET/ON is assumed.   If a password is needed but was not
entered on the command line, WHEEL will prompt for one.
 Options - 1/2 

   Only enough letters are  required for the  option to be unique.   That  is,
only a single letter is necessary for all  options except  ON and  OFF,  which
require two letters.  A slash before the option is allowed, but not required.


     DISPLAY   displays current wheel byte status.  This is the 
               default option if no password is given.

     RESET     resets the wheel byte (turns it off).

     SET       sets the wheel byte (turns it on).  This is the 
               default option if a password is given.

     OFF       turns off the wheel byte (resets it).

     ON        turns on the wheel byte (sets it).  This is the 
               default option if a password is given.
 Options - 2/2 

   Preceding an option with  "Q" (e.g.,  "QSET"),  toggles the current default
quiet mode.   If the ZCPR3 quiet flag is on or if the quiet configuration byte
is set, WHEEL defaults to quiet mode.   The  Q  option  then  puts  WHEEL into
verbose mode.  Otherwise, the Q option puts WHEEL in quiet mode.  DISPLAY, the
usage message, and error reports work at all times.
:2
 Configuration - 1/2 

   WHEEL can be configured with ZCNFG using the  WHEELnn.CFG file.   If you do
not change the name of the  CFG  file,  ZCNFG  will always be able to find it,
even if you change the name of WHEEL.

   In quiet mode  WHEEL  suppresses screen  displays after  executing the SET/
RESET and ON/OFF options.   WHEEL can be  configured to default to quiet mode,
in which case the  Q option modifier on the  command line will restore verbose
operation, as discussed above.

   Normally WHEEL matches a password  regardless of  whether  it  is upper- or
lower-case.   Passwords entered from the command line will always be in upper-
case.   However, WHEEL can be configured to be case-sensitive.  If you do that
and there are any lower-case  characters in your password, you will have enter
password after WHEEL prompts for it.

   When the password is entered interactively, WHEEL normally echoes it to the
screen as it is typed.   If you choose,  WHEEL can be  configured to echo only
dots as the password is entered.
 Configuration - 2/2 

   As distributed, WHEEL requires a password only for the SET/ON options.  All
other options work,  whether or not a password is entered on the command line,
and WHEEL will not  prompt for one.   A configuration  byte,  however,  allows
requiring a  password for all options,  including  DISPLAY and  the  "//" help
request.   This is the ultimate in Wheel  security and nobody may ever use it,
but it was easy to add.  No one is ever trapped by WHEEL, though; at the pass-
word prompt, entering ^C aborts to ZCPR3.

   Lastly, ZCNFG is the easy way to set the password that WHEEL will use.   As
distributed, the password is "SYSTEM".  You will want to change this.   If you
need a secure system, the password should be changed periodically.   The pass-
word should not contain control characters.   If you  want to be able to enter
the password from the command line, it cannot begin with  a slash,  or contain
colons (":"), equal signs ("="), periods ("."), commas (","), asterisks ("*"),
or embedded spaces;  those characters will  confuse the  command  line parser.
Obviously,  the password should not be one of the command line options either.
Otherwise, use what you want.  "&%$?~+{}" will work fine.
:3
 Error Messages 


   "Invalid Password"       

      - the given password was not correct
:4
 Examples of Use 


   a. WHEEL mypass             <-- set Wheel Byte if MYPASS is the correct
                                   password
:5
 WHEEL Notes - 1/2 

   a. WHEEL has an RCP counterpart,  WHL,  which may also be in effect.  WHEEL
      and WHL can respond to different passwords.

   b. Vs 3.3 updates (October 19, 1990 -- Gene Pizzetta):
      - Command line parsing completely rewritten.  All options now acceptable
        as first parameter.  
      - Added configuration bytes for  echo/non-echo  of password,  default to
        quiet/verbose mode, to always require password for all options.  
      - All options and password configurable with ZCNFG.   (Now  the password
        can be changed quickly and conveniently on a regular basis, as it 
        should be on a secure system.)  
      - Added "DISPLAY", "ON", and "OFF" options.  
      - Added Q option modifier to toggle current setting of quiet mode.  
      - Now allows password as first or second token.  
      - Eliminated INLINE editor from SYSLIB for password input.  (This editor
        allows an unlimited number of characters to be entered and the version
        3.2 type-4 used a buffer in low memory.   Now uses  new  simple editor
        that writes to a 9-byte internal buffer and saves considerable program
        size.  
 WHEEL Notes - 2/2 

      - Eliminated sign-on  except  on  usage  screen,  which  has  also  been
        simplified.  
      - Code has been rearranged for easier maintenance and to allow a greater
        number of relative jumps.  

   c. Vs 3.2 updates (May 2, 1989 -- Bruce Morgen):
      - Adds  Wheel  Byte reset without  password and  optional  password case
        sensitivity in interactive (/S or /R) operations.  The byte at ENTRY+2
        is set to 0 to turn off  case  sensitivity, non-zero  (the default  as
        distributed) to enable it.   Note that in the  Type 4 version, ENTRY+2
        is at  202h in  DDT,  in the  Type 3 files it's at  102h in DDT.   The
        password is embedded at ENTRY+10h.

   d. Vs 3.1 updates (March 12, 1985 -- Joe W. Wright):
      - Responds to the quiet flag.
