USER MANUAL CLE and BCE ======================= 1. Introduction. The Command Line Editor (CLE) and the Big Command line Editor (BCE) are RSX utility programs allowing the user to edit MCR and DCL commands before passing them to MCR or DCL (or to the current CLI). It is also possible to recall and re-edit previous commands. The programs stack a maximum of five commands. The programs only run on VT10X terminals. 2. Program startup. Install the programs with tasknames ...CLE and ...BCE. Invoke them with one of the following commands: 1. MCR>CLE 2. MCR>BCE [filespec] 3. DCL>MCR CLE 4. DCL>MCR BCE [filespec] BCE returns with a message denoting the control file that is in effect, followed by the current CLI's prompt in reverse video. CLE immediately returns with the reverse video prompt. It is also possible to start the programs in your login command file with: .XQT [MCR] CLE or .XQT [MCR] BCE [filespec]. The default filename for the BCE control file is: SY:[current uic]CLEINI.CLE . 3. Cursor moving commands. - Use the left arrow key to move the cursor one position to the left. New characters are inserted at the current cursor location, moving the rest of the line one position to the right. - Use the Right Arrow key to move the cursor one position to the right. - The Back Space key moves the cursor to the begin of the line. PAGE 2 - The keypad "2" key moves the cursor to the end of the line. - The keypad "1" key moves the cursor one word forward. Word delimiters are all non alpha-numeric characters. 4. Delete and Undelete commands. - The Delete key deletes the character in front of the cursor (backward delete). - The keypad "," key deletes the character "under" the cursor (forward delete). - PF1, followed by the keypad "," key undeletes the last deleted character. - The keypad "-" key deletes the word on which the cursor is placed (word delimiters are all non alpha-numeric characters). The word delimiters are not deleted by this command. - PF1, followed by the keypad "-" key undeletes the last deleted word. - PF4 deletes all characters from the current cursor position to the end of the line. - PF3 deletes all characters from the current cursor position to the begin of the line. - PF1, followed by PF3 or PF4 undeletes the charcters previously deleted by the delete to end of line or the delete to begin of line commands. 5. Command buffer manipulation. The program can store up to five commands, one of which is the current command. To skip to the other commands, you can use the up-arrow and down-arrow keys. After five "ups" or "downs", you return to the original buffer. 6. Execute commands. After pressing the RETURN or the ENTER key, the program spawns the current buffercontents to the current CLI and stops untill the CLI is ready with the command. If you used the ENTER key, the program just retypes the line. If you used RETURN, the program acts as if you had typed ENTER, down-arrow and control/U, thus skipping to the next commandbuffer and clearing it. Pressing RETURN or ENTER on an empty line just retypes the PAGE 3 prompt; it does not skip to an other command buffer. 7. Special commands. - Control/R retypes the current commandbuffer. - Control/U cancels the current. - Shift/3 ( # ) inserts the string "@LB[7,7]" in the line. 8. Help facility. Typing PF2 displays a EDT V2 like picture of the keypad with the key definitions. Exit the help facility by hitting the RETURN key. 9. How to abort the program. Abort the program by typing ABO CLE or ABO BCE. Don't abort CLE or BCE from another terminal as this will leave your terminal in an undefined state (Noecho and Transparant read/write still active). 10. BCE control file. There are three ways to activate the control file for BCE: 1. Activate BCE with a command line : >BCE DR:[100,100]EXAMPLE.CLE 2. Activate BCE without a command line : >BCE In this case BCE tries to open the file CLEINI.CLE on SY: in the current UFD. 3. Type Control/Space when BCE is already active. BCE will now ask for a filename. The BCE control file contains the information needed for single keystroke commands. A theoretical maximum of 128 control and GOLD (PF1) keys can be defined. Each line in the control file contains one command and must begin with a one byte identification value smaller than 128 decimal. The maximum length of the line (including the identification value) is 80 bytes. Commands with identification values smaller than 32 decimal are invoked by typing a control key (control/x). The control PAGE 4 key ascii value is the identification value. Commands with values greater than 32 decimal are invoked by typing PF1, followed by single character. The ascii value of the character is the identification value. The characters following the identification value are interpreted exactly as if they were typed in from the keyboard. The command itself may contain other identification values (value < 32.) or PF1 - identification values (value >= 32.). The result is that before continueing with the rest of the line, the command with the identification character specified is executed. The maximum nesting depth however is limited to 5. The following values cannot be used as identification values: 0. Control/space Used to enter new control file specs. 8. Control/H - Back space Used for goto begin of line. 13. Control/M - RETURN Used for execute command. 17. Control/Q Used by terminal driver (XON). 18. Control/R Used for retype line. 19. Control/S Used by terminal driver (XOF). 21. Control/U Used for cancel line. 27. Control/[ - ESC Example. The file EXAMPLE.CLE contains the following lines: ^E^HOSEDT TEST.TXTOM^UOPOSOPP P^HOSPIP *.*/PUOM^UOPOS Note that ^E, ^H, ^U and occupy only one byte. The identification value of the first line is 5 (control/E). The identification value of the second line is 80. (ascii P). When you hit control/E the program will first move the cursor to begin of line : ^H = control/H = Back space = goto begin of line. Then it deletes the current contents of the buffer : OS = PF4 = delete to end of line. The buffer is filled with : "EDT TEST.TXT" . OM = ENTER : BCE will spawn the contents of the buffer PAGE 5 (EDT TEST.TXT) to the current CLI. When EDT finishes BCE will retype the line EDT TEST.TXT (due to the use of ENTER). This line will be cancelled immediately by : ^U = cancel line. Then the original line is restored by : ( OP = GOLD - OS = delete line ) = undelete line. After this the command with identification value 80. (ascii P) is executed : OP = GOLD - P. The purge command can of course also be executed directly from the keyboard by typing GOLD P. 11. How to create a BCE control file. The easiest way to create a BCE control file is with EDT V2. Use the SPECINS functions in keypadmode, the Up-Arrow function in no-keypadmode or the ASC function in line-by-line mode to enter control characters in the file. Escape sequences for keypad and arrow keys can be entered in keypadmode by first pressing the ESC key, followed by a keypad or an arrow key. Following is a list control key characters/values you can use when you edit your control file. EDT DEC CALLING SEQUENCE - REMARKS DIS- VAL PLAY ^@ 0 control SPACE - get new control file ^A 1 control A ^B 2 control B ^C 3 control C ^D 4 control D ^E 5 control H ^F 6 control F ^G 7 control G ^H 8 control H or BACK SPACE - begin of line ^I 9 control I or TAB 10 control J 11 control K 12 control L 13 control M or RETURN - execute command ^N 14 control N ^O 15 control O ^P 16 control P ^Q 17 control Q - used by terminaldriver ^R 18 control R - retype line ^S 19 control S - used by terminaldriver ^T 20 control T ^U 21 control U - delete line ^V 22 control V ^W 23 control W ^X 24 control X ^Y 25 control Y PAGE 6 ^Z 26 control Z 27 control [ - escape ^\ 28 control BACKSLASH ^] 29 control RIGHT SQUARE BRACKET ^^ 30 control ~ ^_ 31 control ? -=O=-