CLE is an interactive command line editor for RSX.  This is a non-privileged
task which requires no modification whatsoever to any other software.  It works
with MCR, DCL, and CCL.  With CLE the user is able to edit his command line
before or even after dispatching the CLI and it "remembers" the last several
commands which can be recalled, edited, and resubmitted as well.  It is very
"VMS-like" though the user can toggle between "VMS mode" and "CLE mode",
changing the definitions of several <Ctrl> keys (others do not change).  CLE
function keys and <Ctrl> keys are described below. 

  CLE function keys & <Ctrl> keys

    LEFTARROW	backup 1 character	   UPARROW	backup 1 command
    RIGHTARROW	advance 1 character	   DOWNARROW	advance 1 command
    GOLD_LEFT	backup to begin of cmd	   GOLD_UP	backup to oldest cmd
    GOLD_RIGHT	advance to end of command  GOLD_DOWN	advance to newest cmd
    ^A		overstrike/insert	   
    DELETE	delete 1 character left	   PF1		GOLD
    ^D		delete 1 char at cursor	   PF2		help
    ^B		delete to begin of cmd	   PF3		show status
    ^E		delete to end of command   PF4		show all commands
    ^R		redisplay command	   ^K		CLE/VMS <Ctrl> keys
    ^U		cancel command		   ^Z		exit CLE
 
  VMS <Ctrl> keys

    ^D		backup 1 character         ^B		backup 1 command
    ^F		advance 1 character
    ^H		backup to begin of cmd
    ^E		advance to end of command
    ^A		overstrike/insert
    ^R		redisplay command	   ^K		CLE/VMS <Ctrl> keys
    ^U		delete to begin of cmd	   ^Z		exit CLE

There are three options determined by assembly conditionals.  If the symbol
LINE24 is defined, line 24 is is used as a status line (requires VT100/VT220
and only partially tested).  OVRMOD determines whether insert mode or overstrike
mode is the default, and VMSKEY determines whether CLE <Ctrl> keys or VMS <Ctrl>
keys is the default.

You should be aware of the following problems/unexpected behaviors:

  1. If a character is inserted or deleted to the left of a horizontal tab
     ("011) or if a tab is inserted to the left of any character, the command
     line will be displayed improperly, though passed to the CLI correctly.
     <CTRL-R> can be used to redisplay the command line.
  2. CLE must wait for completion.  So pressing <RETURN> while a command is
     executing will generate a CLI prompt, not a CLE prompt.  And the command
     entered at the CLI prompt can not be edited.
  3. CONTROL-C ABORT, under versions of RSX which support it, should be disabled
     for CLE use.
  4. Some kind of problem exists between CLE and SET /UIC with named directory
     support.  Not fully investigated.

Included in this distribution are the following files:

  CLE.HLP     help file, move to LB:[1,2]
  CLE.MAC     source file
  CLE.MAK     command file to assemble & taskbuild
  MYMACS.MLB  library containing macros such as PUSH, POP, JEQ, etc.
  README.1ST  this file

CLE can be installed and then invoked by typing "CLE" or you might consider
placing ".xqt CLE" in your LOGIN.CMD.
