WHEEL Version 3.3 Gene Pizzetta October 19, 1990 WHEEL, originally written by Richard Conn, sets, resets, and displays the ZCPR3 Wheel Byte, which determines how or whether some programs operate. USAGE: 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: 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. 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. CONFIGURATION: 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. 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 password 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 password 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. HISTORY: Version 3.3 -- 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. 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. Incorporated suggestions from Howard Goldstein for making the code more efficient. Version 3.2 -- May 2, 1989 -- Bruce Morgen Type 3 format and more smarts. Version 3.1 -- March 12.1985 -- Joe W. Wright Responds to the quiet flag. Version 3.0 -- March 8, 1984 -- Richard Conn Version 1.1 -- January 24, 1983 -- Richard Conn Version 1.0 -- January 14, 1983 -- Richard Conn