







        

        







                    +---------------+

                    |   +-------+   |

                    |  /         \  |

                    | / D E C U S \ |   D E C U S  makes it work

                    | \   P D P   / |

                    |  \  S I G  /  |

                    |   +-------+   |

                    +---------------+

             

             

             

             

                    MMMM     MMMM     CCCCCCCC      EEEEEEEEEE

                    MM MM   MM MM    CCC    CCC     EE     EEE

                    MM  MM MM  MM    CC      CC     EE

                    MM   MMM   MM    CC             EEEEEEE

                    MM    M    MM    CC             EEEEEEE

                    MM         MM    CC      CC     EE

                    MM         MM    CCC    CCC     EE     EEE

                    MM         MM     CCCCCCCC      EEEEEEEEEE

             



                                COMMAND LINE EDITOR



                          This manual describes MCE V4.27

                                  of 19 april 1996



                               originaly developed by



                               D. Sponza (YU) oct-81



                            Since 29-Jul-86 Supported by



                                   Hans Hamakers

                             ABB Support BV  Dept. SIS

                          P.O Box 2667   3000 CR Rotterdam

                                  The Netherlands



                   Phone      : +31 10 407 86 31                

                   Fax        : +31 10 456 86 80                

                   Internet   : jhamakers@abb.com               

                   CompuServe : 100137,3655                     

                   PSI        : 02041340077::Hamakers_J         

                   X400       : C=ch  A=400net  P=abb  OU1=nlsup

                                O=abb  S=hamakers  G=hans       





                     Different  "evolutions"  from DECUS tapes

                       (sometimes called CLE) where collected

                     and merged and  new features  where added.











        MCE -- Command line editor                                Page 2

        







            MCE is an RSX-task through which you  can  communicate  with

            the CLI active at your terminal.





             

              --------+           +---------+           +---------+

             /        |   QIO's   |         |   SPAWN   |         |

            /   TI:   |-<------->-|  MCE    |--<----->--|  CLI    |

            |         |           |         |           |         |

            +---------+           +---------+           +---------+

             



            MCE let you edit your command lines in an  EDT-like  way  in

            keypad-  or  non-keypad-mode.   MCE stores the command lines

            for you in a Fifo-buffer for later  retrieval  and  you  can

            define your own commands in the same way as in VMS.







            1.  Options



            A  list  of  optional  features  follows  below.   They  can

            individualy be selected at build time



                MCE V4.27 - Command line Editor options :

                ---------------------------------------

                 -  Multiple CLI support

                 -  Init-file support

                 -  Compound command line support

                 -  Statusline support

                 -  Startup and exit messages

                 -  Remote terminal (RT:  and HT:) detection

                 -  VT2plus support (*

                 -  VT4plus support (*

                 -  TDV2230 function key support

                 -  EDT-Keypad editing support

                 -  User prompt support

                 -  Extended prompt support

                 -  Terminal password locking

                 -  Automatic return to Insert- or Overstrikemode

                 -  Terminal time-out support

















        _______________

        *   In this manual VT2plus means support for VT2xx, VT3xx, VT4xx

            and VT5xx terminals, VT4plus for VT4xx, and VT5xx terminals









        MCE -- Command line editor                                Page 3

        Options







            1.1  Multiple CLI support



            When multiple CLI support is included MCE  uses  the  prompt

            from  the  CLI  that  is  active  at  the invoking terminal.

            Furthermore different Init-files for MCR, DCL or other CLI's

            can exist.







            1.2  Init-file support



            When Init-file support is included MCE reads  initialisation

            files   which   can  contain  Command  synonym  definitions,

            Internal- and CLI-commands.   Files  are  searched  in  this

            order:



            When multiple CLI support is included :



                    LB:[1,2]MCEINI.xxx, followed by

                    SY:[CurDir]MCEINI.xxx or SYS$LOGIN:MCEINI.xxx



            When multiple CLI support is not included :



                    LB:[1,2]MCEINI.CMD, followed by

                    SY:[CurDir]MCEINI.CMD or SYS$LOGIN:MCEINI.CMD



            where "xxx" is the name of the CLI defined for the  terminal

            invoking  MCE  and  "CurDir" is the default directory at the

            startup of MCE.



            This algorithm divides command definition into 2 groups:   A

            system-wide set in LB:[1,2] followed by users private set in

            SY:[CurDir] or SYS$LOGIN:

            MCE can be configured to always read the the user  Init-file

            from SYS$LOGIN:  on systems that support Logical Names (Only

            possible on M-Plus).  This makes you independent from  where

            you start MCE.  



            Overriding the default file name in the command  line  which

            invokes  MCE offers the possibility to tailor an application

            specific command set.

            Comments are possible  behind  "!"   which  is  the  comment

            character for CLI's.

            An Example of an Init-file can be found in Appendix A







            1.3  Compound command line support



            MCE allows definitions  of  compound  commands.   Using  the

            ampersand  (&)  sign  an  MCE  command  can  be defined as a

            sequence of multiple CLI commands :









        MCE -- Command line editor                                Page 4

        Options







                E.g.  +>STAT := TIM & PIP /LI & ACT /ALL ...etc.



            This defines STAT as a sequence  of  CLI-commands  that  are

            executed one after another.  MCE waits for completion of one

            command before activating the next.



            Also it can be done directly:



                E.g.  +>MAC @TASKASM & TKB @TASKTKB



            The "&" MUST be preceded by at least  one  space.   This  is

            done to let commands like "PIP /TD&/LI" still work.

            When  a  command  in  a  compound  command  line   gives   a

            non-successful   exitstatus,  MCE  terminates  the  compound

            command line there, showing the exitstatus and  the  command

            that caused it.

            A compound command line may also contain  Internal  Commands

            (Commands  starting  with  "MCE") in mixture with normal CLI

            commands.   Only  the   first   command   is   checked   for

            translation.









        MCE -- Command line editor                                Page 5

        Options







            1.4  Statusline support



            Line 24 on an ANSI CRT  terminal  can  be  used  for  status

            information.   The  statusline  shows the different settings

            and Fifo-buffer parameters of MCE and can be switched on/off

            with  "MCE STATus ON|OFF".   For  non  ANSI  terminals  like

            VT52's only a "SNAPSHOT" is possible with "MCE STATus".  The

            statusline is than displayed only once.



            The line displayes the following :

         

        -----------------------------------------------------------------------

        MCE-V4.27  FIFO:list/22/16/00 CMSZ:04 KEYP:on SVINT:off SVOLD:on TMO:xx

        -----------------------------------------------------------------------

              |          |   |  |  |     |      |        |      |         |

              |          |   |  |  |     |      |        |      |         v

              |          |   |  |  |     |      |        |      | Time-out time

              |          |   |  |  |     |      |        |      | in minutes,

              |          |   |  |  |     |      |        |      | "off" or "no"

              |          |   |  |  |     |      |        |      v

              |          |   |  |  |     |      |        |      Save  old  cmds

              |          |   |  |  |     |      |        |        "on" or "off"

              |          |   |  |  |     |      |        |

              |          |   |  |  |     |      |        +-->  Save intern cmds

              |          |   |  |  |     |      |                 "on" or "off"

              |          |   |  |  |     |      |

              |          |   |  |  |     |      +-----> Keypad editing  "on" or

              |          |   |  |  |     |                                "off"

              |          |   |  |  |     |

              |          |   |  |  |     +----->  Minimal  size of command line

              |          |   |  |  |

              |          |   |  |  +----->  Number of current cmdline from Fifo

              |          |   |  +-------->  Number of cmdlines in Fifo

              |          |   +----------->  Maximum  number of cmdlines in Fifo

              |          +--------------->  Fifo is a "list" or a "ring"

              |

              +-----------------> MCE Version







            1.5  Startup and exit messages



            The startup and exit messages like :



                    "MCE -- CLI-Command Line Editor V4.27"

            and

                    "MCE -- Exit"



            are optional.  They can be selected at build time.



            MCE indentifies its self with











        MCE -- Command line editor                                Page 6

        Options







                    "MCE -- MCR-Command Line Editor V4.27"

                           ___



            when no multiple CLI support was selected at build time.







            1.6  Remote terminal (RT: and HT:) detection



            When MCE is started via a remote terminal problems can occur

            if  the  local  system  is  VMS with its command line editor

            enabled.  The way MCE acts when it detects if it is  started

            via  a  remote terminal can be specified at build time.  One

            of the following options can be selected :



             -  Give the following message:



                MCE -- ** WARNING ** Started on a remote terminal.

                       If your local system is VMS with its command line

                       editor enabled please type "MCE EXIT"



             -  Give the folowing message and exit :



                 MCE -- Started on a remote terminal line.  Exiting ....



             -  Do nothing







            1.7  VT2plus support



            VT2plus support enables the use of VT2+ keyboards.  (*

            The keys <F11>, <F12> and <F13>  work  as  <ESC>,  <BS>  and

            <LF>.   The  keys <HELP>, <DO> etc.  can also be used and it

            is possible to define the function keys <F6>..<F20> like :



                    "F6 := TIM"



            Pushing <F6> then gives the time of day.

            (See function keys)







            1.8  VT4plus support



            On a VT4+ terminal it  is  possible  to  use  <F1>..<F5>  as

            normal  functionkeys.   MCE enables you to define those keys

            in the same way as other function keys when this support  is

            included with MCEBLD.  (**



        _______________

        *  VT2+ in this manual stands for VT2xx and later models.

        ** VT4+ in this manual stands for VT4xx and later models.









        MCE -- Command line editor                                Page 7

        Options







            1.9  TDV2230 function key support



            The keys of a TANDBERG TDV2230 terminal can be defined  like

            the ones on a VT2+.  (See function keys)







            1.10  EDT-Keypad editing support



            Some edit functions can be performed  on  a  VT52/VT1xx/VT2+

            -keypad,  similar  to  K52, KED and EDT.  The Keypad-editing

            can be switched on/off with "MCE KEYPad ON|OFF"







            1.11  User prompt support



            The  MCE  prompt  can  be  specified  by   the   user   with

            "MCE USPRompt userprompt".   A  userprompt can contain up to

            20 characters.

            The return to the defaultprompt type "MCE USPRompt".







            1.12  Extended prompt support



            The MCE prompt can show if  overstrike-  or  insert-mode  is

            active  by  "+"  and  "-".   Also  it  can display if keypad

            editing is enabled when the statusline is off by ":"



                    e.g.  "+:>"



            The  Extended   prompt   can   be   switched   on/off   with

            "MCE PROMpt ON|OFF"







            1.13  Terminal password locking



            When  selected  this  option  enables  the  The  "MCE  LOCK"

            command.   It  prompts  for  a password and verification and

            locks the terminal.  When the password is entered again  the

            terminal is ready to use again.



            This  is  all  like  the   LOCK   command   from   Digital's

            Terminalservers.















        MCE -- Command line editor                                Page 8

        Options







            1.14  Automatic return to Insert- or Overstrikemode



            Default overstrike- or insert-mode stayes active until it is

            changed  by  CTRL/A  or  <F14>.  MCE can be build so that it

            sets one of the modes active by default when it prompts  for

            a   new   command.    This   can   be   changed   with   the

            "MCE INSErt ON|OFF" and "MCE OVERstrike ON|OFF" commands.







            1.15  Terminal time-out support



            When terminal time-out support is included and the  terminal

            is not used within a given time the terminal is logged-out. 

            (at TT0:  MCE only exits)



            Optionaly  the   timeout   value   can   be   changed   with

            "MCE TIMOut nnn" to be 2 to 999 minutes or can be enabled or

            disabled  with   the   "MCE TIMOut ON|OFF"   command.    The

            MCE TIMOut command MUST be included during build time to let

            this work.  (So system managers, do not be afraid, if YOU do

            not want it, they will not get it)







            2.  Command Line Editor Startup



            Invoke MCE with command "MCE" ,  preferably  in  your  LOGIN

            file by ".XQT MCE".  If Init-file support is included a file

            of Command-Synonyms, CLI-Commands  and/or  Internal-Commands

            will  be  read and executed at MCE startup.  The file may be

            specified in the form "MCE  startup-file".   If  no  startup

            file is specified in the command line (the normal case), the

            default Init-files are searched for.  (See Init-files)







            3.  Command Line Editor Exit



            To exit MCE use the "MCE EXIT" internal command or <CTRL/Y>.







            4.  Command Lines



            When MCE is ready to accept a command  line  it  displays  a

            prompt.   How the prompt looks depends on the chosen options

            and setup of  MCE.   (See  Extended  prompt).   The  maximum

            length of command lines is 78 characters.



            If a command line starts with "MCE", it is interpreted as an

            Internal  Command.   Other  command  lines  are  checked for









        MCE -- Command line editor                                Page 9

        Command Lines







            translation and the result is spawned to the current CLI.



            Special action  is  performed  with  "BYE"  and  "LOG[out]".

            "BYE"  and when in DCL "LOG[out]" result in a spawn of "BYE"

            to MCR and MCE exits immediately.  Note that you may  define

            any  other  string  (e.g.   GOODBYE)  to  result in "BYE" or

            "LOGOUT".



            All command lines can be preceded by and contain one or more

            TAB's and/or spaces.



            Normally all command lines equal to or longer than  a  given

            length  are  saved  in  a  Fifo-buffer.   This length can be

            changed with the "MCE CMSZ n" command.



            The maximum number of command lines the Fifo-buffer can hold

            can  be  specified  with the "MCE FISZ n" command.  When the

            maximum number of command  lines  is  present,  or  when  no

            buffer  poolspace is available to hold more entries, the new

            command line is saved and the oldest disappears.



            Retrieved command lines from the Fifo-buffer are only  saved

            again if they are edited or when the saving of "old" command

            lines is enabled by "MCE SVOLd ON" and this command line  is

            not  the  newest in the fifo.  This prevents filling up your

            fifo with one command  by  continously  repeating  the  last

            command.



            Internal  commands  are  saved  when  this  is  enabled   by

            "MCE SVINternals ON".  (Save "INTERNAL" commands)







            5.  Command synonyms



            A Command synonym can be defined by:



                  +>Syn := <Command1> [ & <Command2> [ & ..... ] ]



            where "Syn" is the command synonym which will be substituted

            by the text at the right side of ":=".



                e.g.:  +>HE := HELP PIP   ! 

                       +>HE               ! Will request "HELP PIP"





                                        NOTE



                 The ":=" must be preceded and followed by at least

                 one TAB or space













        MCE -- Command line editor                               Page 10

        Command synonyms







            With Keypad-mode "OFF" the  keystrokes  <PF1>  ,  <BLUE>  or

            <ESC>P translate the command synonym without execution.



            If you enter a command synonym followed by additional  text,

            this additional text will normally be appended as a whole.



                e.g.   +>HE /RE           ! Will request "HELP PIP /RE

                or     +>HE /RE<PF1>      ! Will be translated and

                                          !  displayed

                result +>HELP PIP /RE



            A command synonym can be deleted by redefining it to null.



                e.g.   +>HE :=            ! Delete above definition



            Abbreviate commands by separating the optional part by "*"



                e.g.   +>HP*IP := HELP PIP



            This command can now be requested with:



                       +>HP or HPI or HPIP etc.



            More sophisticated is the Parameter Substitution, similar to

            the indirect command file processor.



                e.g.:  +>DIR*ECTORY := PIP 'P1'/LI

                       +>COP*Y      := PIP 'P2'/NV/CD='P1'



                       +>DIR              ! Will be translated

                                          !  into "PIP /LI"

                       +>DIREC FIL        ! Will be translated

                                          !  into "PIP FIL/LI"

                       +>COPY A.CMD [1,2] ! Will simulate the DCL

                                          !  COPY command



            Note that command synonyms may be performed from Init-files.







            6.  Function keys



            You can request a command with function keys  <PF1>,  <PF2>,

            <PF3> or <PF4>.



            The keys <BLUE>, <RED> and <GREY> on a VT52 are  synonym  to

            <PF1>, <PF2> and <PF3>.



            It is also possible to request commands  with  control  keys

            (e.g.  <CTRL/G>).



            With a VT2+ keyboard you can also define the  function  keys









        MCE -- Command line editor                               Page 11

        Function keys







            <F6>..<F20>   and  <FIND>  <INSERT HERE>  etc.   (Only  when

            VT2plus support is included)



            With a VT4+ <F1>..<F5> can be defined when this  support  is

            included.



            The keys of a TANDBERG TDV2230 keyboard can be defined  like

            the ones on a VT2+.  (Only when TDV2230 support is included)



            Define the command translation as "<key> := command".



                e.g.   +>PF2 := TIM       ! Redefine <PF2> or <RED> key

                       +><PF2>            !  to display the current time



                       +>F6 := ACT        ! Define F6 function key

                       +><F6>             !  to display the active tasks



            The keys <FIND> ect.  on a VT2+ keyboard must be entered  as

            F$a  where  "a"  is the first character of the key function.

            (English keynames)



                e.g.   "F$P" for <PREV SCREEN>.



            Define a control key as follows :



                e.g.   +>^G := SET /UIC   ! Define <CTRL/G> key

                       +><CTRL/G>         !  to display the current UIC



            Note that the following control-keys CAN NOT be defined:



                       <CTRL/M> = <RETURN>,

                       <CTRL/O>, <CTRL/Q>, <CTRL/S>

                       <CTRL/[> = <ESC>



            Next to the rest of the Alphabetic characters the  following

            keys can be defined :



                        <CTRL/\>

                        <CTRL/]>

                        <CTRL/^>

                        <CTRL/?>





                                        NOTE



                 A Userdefined key overrules the function that  the

                 key may already have for MCE















        MCE -- Command line editor                               Page 12

        Function keys







            7.  Internal Commands (MCE xxxx)



            If a Command Line starts with "MCE" an Internal  Command  is

            assumed.   Following  the  verb  "MCE " a 4 character action

            specifier defines the action wanted.



                e.g.  "MCE CLEA" this command clears the Fifo-buffer



            Here follows a list of all internal commands :



                 -  MCE CHAIn [file]

                 -  MCE CLEAr

                 -  MCE CMSZ n

                 -  MCE ECHO ON|OFF

                 -  MCE EXIT

                 -  MCE FISZ n

                 -  MCE FREE

                 -  MCE INSErt ON|OFF

                 -  MCE KEYPad ON|OFF

                 -  MCE LIST

                 -  MCE LOCK

                 -  MCE OVERstrike ON|OFF

                 -  MCE PROMpt ON|OFF

                 -  MCE PURGe

                 -  MCE READ [file]

                 -  MCE REPLace [file]

                 -  MCE RING

                 -  MCE STATusline [ON|OFF]

                 -  MCE SVINternals ON|OFF

                 -  MCE SVOLd ON|OFF

                 -  MCE TIMOut n|ON|OFF

                 -  MCE UPFind ON|OFF

                 -  MCE USPRompt [userprompt]

                 -  MCE VERSion







            7.1  MCE CHAIn [file]



            Chain from one  Init-file  to  another,  that  is  start  or

            continue  reading  commands  from  the specified file.  This

            command is a synonym for "MCE READ [file]".  This command is

            only available when Init-file support is included in MCE.







            7.2  MCE CLEAr



            This  command  deletes  all  commands   currently   in   the

            Fifo-buffer.













        MCE -- Command line editor                               Page 13

        Internal Commands (MCE xxxx)







            7.3  MCE CMSZ n



            Changes minimal command size to  "n".   Only  command  lines

            that  are  equal to or longer than "n" characters are stored

            in the Fifo-buffer.  Set the length to 79 if for any  reason

            you  do  not want to save commands.  The default setting can

            be specified at MCE build time.







            7.4  MCE ECHO ON|OFF



            When "ON", MCE echoes command lines to TI:.  This is  useful

            in  Init-files  to  display  messages  etc.   or  to see the

            translation of command synonyms.   The  default  setting  is

            "OFF".  (See example in Appendix A)







            7.5  MCE EXIT



            The task MCE exits.







            7.6  MCE FISZ n



            Changes the maximum number of command  lines  which  can  be

            saved in the command line Fifo-buffer.  Note that the actual

            number of command lines that can be  saved  depends  on  the

            size  of  the command lines and the available MCE poolspace.

            Information about MCE's poolspace can  be  obtained  by  the

            "MCE FREE"  command.   More  poolspace  can  be  created  by

            installing MCE with a larger increment.  "INS $MCE/INC=xxx".

            A  value  of  2400,  which is the default value that is used

            during taskbuilding/linking, will be enough in  most  cases.

            If  "n"  is  smaller than the active number of command lines

            stored, MCE  deletes  the  oldest  command  lines  from  the

            Fifo-buffer  untill "n" is reached.  The default setting can

            be specified at MCE build time.







            7.7  MCE FREE



            Displays MCE's Pool information like :



                "MCE -- Pool:xxx:yyy:zz."



                    xxx = Size of largest block in bytes

                    yyy = Total number of free bytes

                    zz  = Number of fragments









        MCE -- Command line editor                               Page 14

        Internal Commands (MCE xxxx)







            7.8  MCE INSErt ON|OFF



            When "ON", MCE goes back to INSERT mode when prompting for a

            new  command.   The  default setting can be specified at MCE

            build time.



            "MCE INSErt ON" Switches Auto-Overstrike mode off.

            "MCE OVERstrike ON" Switches Auto-Insert mode off.







            7.9  MCE KEYPad ON|OFF



            Set Keypad editing on/off.  (See EDT-Keypad editing).   This

            command   is  only  available  when  EDT-Keypad  support  is

            included in MCE.







            7.10  MCE LIST



            Makes command Fifo-buffer a list :  UP- and DOWN-ARROW  stop

            at  the  top  and  bottom  of the FIFO.  This is the default

            setting.

            (See also "MCE RING" command)







            7.11  MCE LOCK



            The LOCK command prompts for a Password and verification and

            locks the terminal untill the password is typed again.  Like

            the LOCK command from Digitals terminal servers.

            The maximum password-length is 8 characters.

            This  command  is  only  available  when  Terminal  Password

            locking support is included in MCE.







            7.12  MCE OVERstrike ON|OFF



            When "ON", MCE goes back to OVERSTRIKE mode  when  prompting

            for  a new command.  The default setting can be specified at

            MCE build time.



            "MCE OVERstrike ON" Switches Auto-Insert mode off.

            "MCE INSErt ON" Switches Auto-Overstrike mode off.















        MCE -- Command line editor                               Page 15

        Internal Commands (MCE xxxx)







            7.13  MCE PROMpt ON|OFF



            Switches extended prompt on/off.  The default setting can be

            specified at MCE build time.  This command is only available

            when Extended prompt support is included in MCE.







            7.14  MCE PURGe



            This command deletes all command synonyms currently  in  the

            synonym buffer.







            7.15  MCE READ [file]



            Read command lines from specified  file.   This  command  is

            only available when Init-file support is included in MCE.







            7.16  MCE REPLace [file]



            Combines the MCE PURGe and MCE READ [file]  commands.   This

            command is only available when Init-file support is included

            in MCE.







            7.17  MCE RING



            Makes command Fifo-buffer a ring :  UP- and DOWN-ARROW  roll

            through the buffer.

            The  default  setting  is  "LIST".   (See  also   "MCE LIST"

            command)







            7.18  MCE STATus [ON|OFF]



            This command sets the statusline "ON"  or  "OFF".   When  no

            option  is  specified the statusline is displayed only once.

            (See Statusline support)

            The default setting can be  specified  at  MCE  build  time.

            This  command  is  only available when Statusline support is

            included in MCE.















        MCE -- Command line editor                               Page 16

        Internal Commands (MCE xxxx)







            7.19  MCE SVINternals ON|OFF



            When "ON", Internal commands (Command  lines  starting  with

            "MCE")  are  saved  in  the  Fifo-buffer,  When  "OFF" these

            commands  are  not  saved.   The  default  setting  can   be

            specified at MCE build time.







            7.20  MCE SVOLd ON|OFF



            When "ON", an "old" command (retrieved from the Fifo-buffer)

            is saved again in the Fifo-buffer if it is not the newest in

            the fifo.

            When "OFF", "old" commands are not  saved  unless  they  are

            edited.   The  default setting can be specified at MCE build

            time.







            7.21  MCE TIMOut n|ON|OFF



            This command allows you  to  change  the  timeout  value  in

            minutes  that  you specified during MCEBLD run.  The value n

            may be anything in the range of 2  to  999.   You  may  also

            enable or disable timeout with the ON|OFF parameter.

            This  command  is  only  available  when  Settable  Terminal

            Time-Out support is included in MCE.







            7.22  MCE UPFInd ON|OFF



            Since Version 4.27 of MCE  <UP>  does  a  <RECALL>  function

            (like <FIND>) when there is something on the commandline and

            the cursor is at the end  of  the  line.   This  feature  is

            included  because  many  PC  commandline  editors  have that

            feature.  This is the default.  The user can change  to  the

            old situation with the "MCE UPFInd OFF" command.







            7.23  MCE USPRompt [userprompt]



            When "userprompt" is specified MCE uses this argument as the

            new prompt.  It can contain up to 20 characters.

            When "userprompt" is not  specified  MCE  uses  the  default

            prompt again.

            This command is only available when User Prompt  support  is

            included in MCE.













        MCE -- Command line editor                               Page 17

        Internal Commands (MCE xxxx)







            7.24  MCE VERSion



            Shows the MCE Version identification







            7.25  Some notes on files



            When with the CHAIn, READ and REPLace commands  no  file  is

            specified,  the  same  filename  convention  is  used  as at

            startup:  the files according to the current CLI  are  read,

            i.e.   the  command  "MCE REPLace" results in a MCE restart,

            but the  Fifo-buffer  is  kept.   This  is  useful  after  a

            "SET TERMINAL <new-cli>"  command.   When a "space" is given

            as     filename,     only      SY:[CurDir]MCEINI.xxx      or

            SYS$LOGIN:MCEINI.xxx is read.  (See Init-file support)







            8.  Recall function



            Recalling a command is done by entering the first part of  a

            command  which  was  previously  executed,  termimated  by a

            RECALL keystroke.  This will recall the last command already

            executed  starting with the string entered.  The command can

            be edited or executed by pressing the return key.  A  second

            RECALL  keystroke  searches further back in the Fifo-buffer.

            When no string is entered, the last defined string is taken.



            Recall keystrokes are :



                       <FIND>

                       <ESC>Q

                       In non EDT-Keypad mode :  <PF2> or <RED>

                       In EDT-Keypad mode     :  <PF3> or <GREY>

                       <UP>



                E.g.

                    Previously entered command lines :



                       +>DIR MCE*.*

                       +>MAC @MCEASM

                       +>TKB @MCETKB

                       +>DMP X.DAT

                       +>TIM



                    +>D<RECALL>   Will recall the last command line

                                  starting with "D" :  +>DMP X.DAT



                    Another <RECALL> keystroke will recall an older

                    command from the FIFO starting with "D"

                                                       +>DIR MCE*.*









        MCE -- Command line editor                               Page 18

        Recall function







                    +>DI<RECALL>  Will recall :        +>DIR MCE*.*



            Since Version 4.27 of MCE <UP> does a <RECALL> function when

            there  is  something on the commandline and the cursor is at

            the end of the line.  This feature is included because  many

            PC  commandline  editors  have  that  feature.   This is the

            default.  The user can change to the old situation with  the

            "MCE UPFInd OFF" command.







            9.  Help file



            A helpfile named MCE.HLP customized to the selected  options

            is created during MCE build time.

            The helpfile can be created in two different versions.



              VERSION 1 :  You can access this version by typing :

                           "HELP MCE [topic...]" but you have to include

                           a reference like :



                                1 MCE

                                @MCE



                           in MCR.HLP and DCL.HLP



              VERSION 2 :  You can access this version by typing :

                           "HELP /MCE [topic...]".

                           This version does not need any editing of

                           MCR.HLP and DCL.HLP



            Note that if you do not build  the  helpfile  together  with

            MCE, you can not use the <NEXT-SCREEN> and <PRV-SCREEN> keys

            to walk through the helpfile.









        MCE -- Command line editor                               Page 19

        Help file







            10.  Line editing commands



            For line-editing there are two modes :



                 o  Non-keypad mode

                 o  Keypad mode



            In the non-keypad mode you control MCE with control-keys  or

            escape-sequences.  In the keypad mode you can use the keypad

            of a VT52, VT1xx or a VT2+ terminal to give commands to MCE.

            The  advantage of this mode is that you can edit the current

            command line in the same way as you edit a line in K52,  KED

            or EDT.







            10.1  Non-keypad editing and cursor movement commands



               

            +----------------------------------------------------------+

            | Cursor movements                                         |

            +----------------------------------------------------------+

            | Move Cursor Left               | <LEFT>      or <CTRL/D> |

            | Move Cursor Right              | <RIGHT>     or <CTRL/F> |

            | Move Cursor to Begin Of Line   | <BACKSPACE> or <CTRL/H> |

            |                                |             or <F12> *  |

            | Move Cursor to End Of Line     | <CTRL/E>                |

            | Move one Word to the right or  |                         |

            |      move from EOL to BOL      | <TAB>       or <CTRL/I> |

            +----------------------------------------------------------+

               

               

            +----------------------------------------------------------+

            | Delete commands                                          |

            +----------------------------------------------------------+

            | Delete Character Left of Cursor| <DELETE>                |

            | Delete Character at Cursor     | <CTRL/V>                |

            | Delete Word Left of Cursor     | <LINEFEED>  or <CTRL/J> |

            |                                |             or <F13> *  |

            | Delete Word Right at Cursor    | <CTRL/W>                |

            | Delete from Cursor to BOL      | <CTRL/U>                |

            | Delete from Cursor to EOL      | <CTRL/K>                |

            | Delete whole line              | <CTRL/C>                |

            +----------------------------------------------------------+

               











        _______________

        *   On a VT2+ terminal only when VT2plus support is included.









        MCE -- Command line editor                               Page 20

        Line editing commands







             

            +----------------------------------------------------------+

            | Control commands                                         |

            +----------------------------------------------------------+

            | Rewrite Line                   | <CTRL/R>                |

            | Switch between Overstrike and  |                         |

            |                Insert mode.    | <CTRL/A>    or <F14> *  |

            +----------------------------------------------------------+

             

            +----------------------------------------------------------+

            | Save and execute                                         |

            +----------------------------------------------------------+

            | Execute Command                | <RETURN>    or <ENTER>  |

            | Execute Command without waiting| <ESC><ESC>  or <DO> *   |

            | Execute Cmd and leave Fifo-    |                         |

            |    bufferpointer where it is   | <CTRL/X>                |

            | Save Command without executing | <CTRL/N>                |

            | Enable output from other tasks |                         |

            |  Detach for 10 sec.            | <CTRL/T>                |

            | Enable output from other tasks |                         |

            |  Stop; Resume with "UNST MCE"  | <CTRL/P>                |

            +----------------------------------------------------------+

             

            +----------------------------------------------------------+

            | Non-keypad Command buffer manipulation keys:             |

            +----------------------------------------------------------+

            | Display contents of Fifo-buffer| <PF4>       or <ESC>S   |

            | Retrieve previous Command      | <UP>        or <CTRL/B> |

            | Reverse of <UP> (next command) | <DOWN>                  |

            | Recall Command from Fifo       | <PF2>       or <RED>    |

            |                                | or <FIND> * or <ESC>Q   |

            |                                | or <UP>   **            |

            +----------------------------------------------------------+

             

            +----------------------------------------------------------+

            | Non-keypad Help keys:                                    |

            +----------------------------------------------------------+

            | Gives HELP about MCE           | <HELP> *    or <CTRL/?> |

            | Gives Previous/Next HELP screen| <PREV-SCR>*/ <NEXT-SCR>*|

            +----------------------------------------------------------+

             

            +----------------------------------------------------------+

            | Non-keypad Command translation keys:                     |

            +----------------------------------------------------------+

            | Translate  Command synonym     |                         |

            |            without execution   | <PF1>       or <BLUE>   |

            |                                |             or <ESC>P   |

            | Show Command Synonym Buffer    | <PF3>       or <GREY>   |

            |                                |             or <ESC>R   |

            +----------------------------------------------------------+



        _______________

        *   On a VT2+ terminal only when VT2plus  support  is  included.

        **  See "MCE UPFInd" command.









        MCE -- Command line editor                               Page 21

        Line editing commands







            10.2  EDT-keypad editing and cursormovement commands



            While in keypad-mode  the  non-keypad  commands  are  valid,

            except those commands that are redefined.







            10.2.1  VT2+ Keyboard Lay-out



           

           

             F11       F12      F13     F14          HELP          DO

          +--------+--------+--------+--------+   +--------+-----------------+

          |*(ESC)  |* (BS)  |* (LF)  |*       |   |*       |*                |

          |        |        | DELWRD | INS/OVR|   |  HELP  |  EXECUTE NOWAIT |

          |        | BEGLIN | RIGHT  |        |   |        |                 |

          +--------+--------+--------+--------+   +--------+-----------------+

           

           

           

                                             PF1      PF2      PF3      PF4

          +--------+--------+--------+   +--------+--------+--------+--------+

          |*(FIND) |*INSERT |* RE-   |   |\\\\\\\\|        |        | DELLIN |

          | RECALL |  HERE  |  MOVE  |   |\\GOLD\\| KPHELP | RECALL | ------ |

          |        |        |        |   |\\\\\\\\|        |        |\UNDLIN\|

          +--------+--------+--------+   +--------+--------+--------+--------+

          |*       |* PREV  |* NEXT  |   |        | SHOSYN | SHOFIF | DELWRD |

          | SELECT |  HELP  |  HELP  |   | TRANSL | ------ | ------ | ------ |

          |        |(SCREEN)|(SCREEN)|   |        |\\VERS\\|\\FREE\\|\UNDWRD\|

          +--------+--------+--------+   +--------+--------+--------+--------+

                   |  PREV  |            | DETACH |        |  CUT   | DELCHR |

                   | COMMAND|            | ------ |        | ------ | ------ |

                   |**      |            |\SUSPND\|        |\PASTE\\|\UNDCHR\|

          +--------+--------+--------+   +--------+--------+--------+--------+

          |        |  NEXT  |        |   |        |  EOL   |        |        |

          |  <--   | COMMAND|  -->   |   |  WORD  | ------ | DO STAY| ENTER  |

          |        |        |        |   |        |\DELLIN\|        |        |

          +--------+--------+--------+   +--------+--------+--------+ ------ |

                                         |     BEGLIN      | SELECT |\\\\\\\\|

                                         | --------------- | ------ |\\SAVE\\|

                                         |\\\\\CLRLIN\\\\\\|\RESET\\|\\\\\\\\|

                                         +-----------------+--------+--------+















        _______________

        *   On a VT2+ terminal only when VT2plus  support  is  included.

        **  See "MCE UPFInd" command.









        MCE -- Command line editor                               Page 22

        Line editing commands







            10.2.2  VT1xx Keypad Lay-out



           

           

           

                        UP      DOWN     LEFT      RIGHT

                     +--------+--------+--------+--------+

                     |  PREV. |  NEXT  |        |        |

                     | COMMAND| COMMAND|  <--   |  -->   |

                     |*       |        |        |        |

                     +--------+--------+--------+--------+

           

                        PF1      PF2      PF3      PF4

                     +--------+--------+--------+--------+

                     |\\\\\\\\|        |        | DELLIN |

                     |\\GOLD\\| KPHELP | RECALL | ------ |

                     |\\\\\\\\|        |        |\UNDLIN\|

                     +--------+--------+--------+--------+

                     |        | SHOSYN | SHOFIF | DELWRD |

                     | TRANSL | ------ | ------ | ------ |

                     |        |\\VERS\\|\\FREE\\|\UNDWRD\|

                     +--------+--------+--------+--------+

                     | DETACH |        |  CUT   | DELCHR |

                     | ------ |        | ------ | ------ |

                     |\SUSPND\|        |\PASTE\\|\UNDCHR\|

                     +--------+--------+--------+--------+

                     |        |  EOL   |        |        |

                     |  WORD  | ------ | DO STAY| ENTER  |

                     |        |\DELLIN\|        |        |

                     +--------+--------+--------+ ------ |

                     |     BEGLIN      | SELECT |\\\\\\\\|

                     | --------------- | ------ |\\SAVE\\|

                     |\\\\\CLRLIN\\\\\\|\RESET\\|\\\\\\\\|

                     +-----------------+--------+--------+

           































        _______________

        *   See "MCE UPFInd" command.









        MCE -- Command line editor                               Page 23

        Line editing commands







            10.2.3  VT52 Keypad Lay-out



           

           

           

                       BLUE      RED      GREY      UP

                     +--------+--------+--------+--------+

                     |\\\\\\\\|        |        |  PREV. |

                     |\\GOLD\\| KPHELP | RECALL | COMMAND|

                     |\\\\\\\\|        |        |*       |

                     +-----------------+--------+--------+

                     |        | SHOSYN | SHOFIF |  NEXT  |

                     | TRANSL | ------ | ------ | COMMAND|

                     |        |\\VERS\\|\\FREE\\|        |

                     +-----------------+--------+--------+

                     | DETACH |        |  CUT   |        |

                     | ------ |        | ------ |   -->  |

                     |\SUSPND\|        |\PASTE\\|        |

                     +--------+--------+--------+--------+

                     |        |  EOL   |        |        |

                     |  WORD  | ------ | DO STAY|   <--  |

                     |        |\DELLIN\|        |        |

                     +--------+--------+--------+--------+

                     |     BEGLIN      | SELECT | ENTER  |

                     | --------------- | ------ | ------ |

                     |\\\\\CLRLIN\\\\\\|\RESET\\|\\SAVE\\|

                     +-----------------+--------+--------+















































        _______________

        *   See "MCE UPFInd" command.









        MCE -- Command line editor                               Page 24

        Line editing commands







            10.2.4  Keypad editing and cursormovement keys



            Note :  <KPx> means key x on the keypad.

             

             

            +----------------------------------------------------------+

            | Control commands                                         |

            +----------------------------------------------------------+

            | Select lower function          | <PF1>                   |

            |                                | or <BLUE>      = GOLD   |

            +----------------------------------------------------------+

             

             

            +----------------------------------------------------------+

            | Cursormovements                                          |

            +----------------------------------------------------------+

            | Move Cursor to Begin Of Line   | <KP0>          = BEGLIN |

            | Move Cursor to End Of Line     | <KP2>          = EOL    |

            | Move one Word to the right or  |                         |

            |      move from EOL to BOL      | <KP1>          = WORD   |

            +----------------------------------------------------------+

             

             

            +----------------------------------------------------------+

            | Delete commands                                          |

            +----------------------------------------------------------+

            | Delete Character at Cursor     | <KP,>          = DELCHR |

            | Delete Word Right at Cursor    | <KP->          = DELWRD |

            | Delete from Cursor to EOL      | <PF4>          = DELLIN |

            |                                | or <PF1><KP2>           |

            |                                | or <BLUE><KP2> = DELEOL |

            | Delete Whole line              | <PF1><KP0>              |

            |                                | or <BLUE><KP0> = CLRLIN |

            +----------------------------------------------------------+

             

             

            +----------------------------------------------------------+

            | Undelete commands                                        |

            +----------------------------------------------------------+

            | Undelete Character             | <PF1><KP,>     = UNDCHR |

            | Undelete Word                  | <PF1><KP->     = UNDWRD |

            | Undelete Line                  | <PF1><PF4>     = UNDLIN |

            +----------------------------------------------------------+









        MCE -- Command line editor                               Page 25

        Line editing commands







             

             

            +----------------------------------------------------------+

            | Cut and paste commands                                   |

            +----------------------------------------------------------+

            | Set Begin Of Textmarker BOT    | <SELECT>                |

            |                                | or <KP.>       = SELECT |

            | Remove text from BOT to cursor |                         |

            | and store it in the pastebuffer| <REMOVE>                |

            |                                | or <KP6>       = CUT    |

            | Insert text-string from paste- |                         |

            | buffer starting at cursor      | <INSERT>                |

            |                                | or <PF1><KP6>           |

            |                                | or <BLUE><KP6> = PASTE  |

            | Reset selected range           | <PF1><KP.>              |

            |                                | or <BLUE><KP.> = RESET  |

            +----------------------------------------------------------+

             

             

            +----------------------------------------------------------+

            | Save and execute                                         |

            +----------------------------------------------------------+

            | Execute Command                | <ENTER>                 |

            | Execute Cmd and leave Fifo-    |                         |

            |    bufferpointer where it is   | <KP3>          = DO-STAY|

            | Save Command without executing | <PF1><ENTER>            |

            |                                | or <BLUE><ENTER>        |

            |                                |                = SAVE   |

            | Enable output from other tasks |                         |

            |  Detach for 10 sec.            | <KP4>          = DETACH |

            | Enable output from other tasks |                         |

            |  Stop; Resume with "UNST MCE"  | <PF1><KP4>              |

            |                                | or <BLUE><KP4> = SUSPND |

            +----------------------------------------------------------+

             

             

            +----------------------------------------------------------+

            | Command buffer manipulation keys                         |

            +----------------------------------------------------------+

            | Display contents of Fifo-buffer| <KP9>          = SHOFIF |

            | Recall Command from Fifo       | <PF3>                   |

            |                                | or <GREY>      = RECALL |

            +----------------------------------------------------------+

             

             

            +----------------------------------------------------------+

            | Command translation keys                                 |

            +----------------------------------------------------------+

            | Translate  Command synonym     |                         |

            |             without execution  | <KP7>          = TRANSL |

            | Show Command Synonym Buffer    | <KP8>          = SHOSYN |

            +----------------------------------------------------------+









        MCE -- Command line editor                               Page 26

        Line editing commands







             

             

             

            +----------------------------------------------------------+

            | Miscellaneous keys                                       |

            +----------------------------------------------------------+

            | Show version                   | <PF1><KP8>              |

            |                                | or <BLUE><KP8> = VERS   |

            | Show free pool                 | <PF1><KP9>              |

            |                                | or <BLUE><KP9> = FREE   |

            | Keypad Lay-out                 | <PF2>                   |

            |                                | or <RED>       = KPHELP |

            +----------------------------------------------------------+









        MCE -- Command line editor                               Page 27

        Line editing commands







            11.  Building MCE



            This section deals with the generation of the MCE-task.  The

            distribution contains the following files.



                 -  MCE.MAC        Macro source file

                 -  MCEBLD.CMD     ICP command file to build MCE

                 -  MCEREL.DOC     Release notes

                 -  MCE.RNO        Source of this manual

                 -  MCE.DOC        This manual ready to print



            To build The MCE-task you need the following files :



                 -  MCE.MAC

                 -  MCEBLD.CMD

                 -  LB:[1,1]VMLIB.OLB



            You start the building by typing :



                @MCEBLD (works with MCR and DCL)



            Next you are asked  to  answer  the  questions  about  which

            options  you want to be included in MCE.  The questions that

            are asked are about :



                 -  MULTIPLE CLI SUPPORT

                 -  INIT-FILE SUPPORT

                 -  COMPOUND COMMAND LINE SUPPORT

                 -  STATUSLINE SUPPORT

                 -  STARTUP AND EXIT MESSAGES

                 -  TYPE OF RT:  AND HT:  DETECTION

                 -  VT2plus SUPPORT

                 -  VT4plus SUPPORT

                 -  TANDBERG TDV2230 SUPPORT

                 -  EDT-KEYPAD SUPPORT

                 -  USER PROMPT SUPPORT

                 -  EXTENDED PROMPT SUPPORT

                 -  TERMINAL PASSWORD LOCKING

                 -  AUTO INSERT/OVERSTRIKE DEFAULTS

                 -  SAVE OLD COMMANDS DEFAULT

                 -  SAVE INTERNAL COMMANDS DEFAULT

                 -  TERMINAL TIME-OUT SUPPORT

                 -  MINIMAL CMD-LINE LENGTH

                 -  MAXIMUM ENTRIES IN FIFO

                 -  HELP FILE



            MCEBLD.CMD creates the following files:



                 -  MCESAVED.DAT   Saved Answers

                 -  MCE.HLP        Help file

                 -  MCEPRE.MAC     Conditional assembly prefix file

                 -  MCEASM.CMD     MACRO command file









        MCE -- Command line editor                               Page 28

        Building MCE







                 -  MCETKB.CMD     TKB/LINK command file





            Than MCEBLD.CMD invokes:



                        MAC @MCEASM

                        TKB @MCETKB or LINK @MCETKB



            When present MCE will be built with FCSFSL.STB or FCSRES.STB



            Sample build-sessions can be found in Appendices B and C







            12.  Known problems 







            12.1  DCL and installed tasks



            MCE has some problems with DCL  and  installed  tasks.   DCL

            does  not wait for installed tasks to complete.  Compare the

            two examples below:

             

                    MCR                     DCL

             

                    +>INS $FOO/TASK=FOO     +$ INS $FOO/TASK=FOO

                    +>RUN FOO               +$ RUN FOO

                    >                       +$

             

            To solve this add the following line to MCEINI.DCL :



                    R*UN := RUN 'P1'/STATUS:TASK







            12.2  MCE on RT:, HT: and LAT terminals



            A terminal on an RT:, HT:  or  LAT  line  that  has  a  task

            running  that  attaches the terminal can give some problems.

            When the line becomes disconnected by network  time-outs  or

            manual  interference  the  system tries to log-out the line.

            On those lines BYE can not do I/O if the attached task has a

            priority higher than BYE.  This is an RSX problem.  MCE is a

            task that attaches the terminal and  can  give  problems  as

            mentioned.   If BYE is installed with a higher priority than

            MCE (e.g.  MCE 60 and  BYE  70)  the  problem  with  MCE  is

            solved.















        MCE -- Command line editor                               Page 29

        Known problems 







            12.3  Remarks on 8-Bit terminals and lines



            A  VT2+  terminal  in  7-bit  mode  always  sends   "normal"

            escape-sequences :



                    PF1 = ESC [ P         (33, 133,  120)

                    F20 = ESC ? 3 4 ~     (33,  77,   63, 64, 176)



            The EBC, RPA, PASTHRU settings  of  the  TI:   do  not  have

            effect on the processing of those keys.



            A VT2+ terminal in 8-bit mode sends other sequences :



                    PF1 = SS3 P           (217, 120)

                    F20 = CSI 3 4 ~       (233,  63,  64, 176)



            In this case the EBC, RPA, PASTHRU settings of the  TI:   do

            have  effect.   Although they do different things one of the

            options MUST be on to let MCE see the keypad keys the  right

            way.

            The  IO.RST  used  by  MCE  sees  the  folowing  terminating

            characters in IOSTB+1 :



                    EBC      RPA    PASTHRU    SS3      CSI      MCE

                   ----------------------------------------------------

                     0        0        0         0       33     not OK

                     0        0        1        17       33       OK

                     0        1        0        17       33       OK

                     0        1        1        17       33       OK

                     1        0        0       217      233       OK

                     1        0        1       217      233       OK

                     1        1        0       217      233       OK

                     1        1        1       217      233       OK













            Always look at the release notes in MCEREL.DOC  to  see  the

            latest information.









        

        











                                   APPENDIX A



                            Example of an Init-file:







        !

        !       LB:[1,2]MCEINI.MCR

        !

                MCE   STATUS   ON

                MCE   SVINTERN OFF

                MCE   USPROMPT Oldie>

        !

                ?               := HELP

                AS*SEMBLE       := MAC @'P1'ASM

                CO*PY           := PIP 'P2'/NV='P1'

                D*IR            := DIR

                FO              := FOR @'P1'FTN

                F20             := CLR

                LI*NK           := TKB @'P1'TKB

                MO*VE           := PIP 'P2'/NV='P1' & PIP 'P1';0/DE/NM

                RE*NAME         := PIP 'P2'='P1'/RE

                R*UN            := RUN

                BLD             := MAC @'P1'ASM & TKB @'P1'TKB

        !

        ! Next command let you change to DCL and read the MCEINI.DCL file(s)

        !

        	GODCL           := SET /DCL=TI: & MCE REPLACE

        !

        ! MCR Commands .....

        !

                CLR             ! Clear screen

                MCE ECHO ON     ! Echo on

        !

        ! ***WARNING*** -- The system will be down for PM next friday

        !

                MCE ECHO OFF    ! Echo off

                TIM             ! Show time and date

        !

        ! End of LB:[1,2]MCEINI.MCR

        !









        

        











                                   APPENDIX B



                           Sample MCE build-session 







        (RSX-11M with MCR and no saved answers)

        >@mcebld

         

               +---------------+

               |   +-------+   |

               |  /         \  |

               | / D E C U S \ |   D E C U S  makes it work

               | \   P D P   / |

               |  \  S I G  /  |

               |   +-------+   |

               +---------------+

         

        MCEBLD.CMD -- Command file to build the MCE command line editor V4.27

         

         

         This command file builds YOUR version of MCE. It prompts for several

         options to be build in MCE. It creates a conditional assembly 

         definition file called MCEPRE.MAC, two command files MCEASM.CMD and

         MCETKB.CMD and optionaly a helpfile MCE.HLP. If you already have those

         files you can restart MCEBLD with "@MCEBLD MAC" to assemble and

         taskbuild or "@MCEBLD LINK" to taskbuild.

         

        *****

         

         MCEBLD can use saved answers from a previous session.

         

         MCEBLD can use the saved answers as default and still ask questions

         or it can directly use these answers and skip the questions which

         answers are defined.

         

         

        MCEBLD -- Do you have a saved answer file [D:N] : 

         

        *****

         

         MCEBLD can save answers for a future session.

         

        MCEBLD -- Do you want to save answers [D:N] : y

        MCEBLD -- Name of the saved answer file [D:MCESAVED.DAT] : 

         

        *****

         

         The standard CLI (Command Line Interpreter) of RSX is MCR.

         When your system supports the use of other CLIs such as DCL than









        Sample MCE build-session                                      Page B-2

        







         include multiple CLI support in MCE.

         

        MCEBLD -- Want the multiple CLI support [D:N] ? y

         

        *****

         

         When init file support is included MCE reads initialisation files

         which can contain Command definitions Internal- and CLI- commands.

         

         Files are searched in this order:

         

             LB:[1,2]MCEINI.xxx, followed by SY:[CurDir]MCEINI.xxx,

         

         where "xxx" is the name of the CLI defined for the terminal invoking 

         MCE and "CurDir" is the default directory at the startup of MCE.

         

         This algorithm divides command definitions into 2 groups:

         A system-wide set in LB:[1,2], followed by a users private set.

         

        MCEBLD -- Want the MCEINI file support [D:N] ? y

         

        *****

         

         MCE allows definitions of compound commands.

         Using the ampersand (&) sign one can define an MCE command as a 

         sequence of multiple CLI commands :

         

                       E.g.    +>STAT := TIM & PIP /LI & ACT /ALL ...etc.

         

         or directly:  E.g.    +>MAC @TASKASM & TKB @TASKTKB

         

        MCEBLD -- Want the compound command support [D:N] ? y

         

        *****

         

         It is possible to include statusline support.

         The statusline shows the different settings and fifo parameters of 

         MCE and can be switched on/off with MCE STATus on/off

         Line 24 is used for status information.

         

        MCEBLD -- Want Statusline/Statusmessage support [D:N] ? y

        MCEBLD -- Want statusline ON by default         [D:N] ? 

         

        *****

         

         The startup and exit messages like :

         

             "MCE -- CLI-Command Line Editor V4.27"   and   "MCE -- Exit"

         

         are optional.

         

        MCEBLD -- Want Startup and exit messages [D:N] ? y









        Sample MCE build-session                                      Page B-3

        







         

        *****

         

         When starting MCE via a remote terminal (RT: or HT:) problems may occur

         if the local system is VMS with its command line editor enabled.

         MCE can detect if it was started via a remote terminal and can do

         3 different things :

         

        	1. Give the folowing message:

         

                    MCE -- ** WARNING ** Started on a remote terminal.

                           If your local system is VMS with its command line 

                           editor enabled please type "MCE EXIT"

         

        	2. Give the folowing message and exit :

         

                    MCE -- Started on a remote terminal line. Exiting .....

         

        	3. Do nothing

         

        MCEBLD -- Which option for RT: [D:1] : 

        MCEBLD -- Which option for HT: [D:1] : 

         

        *****

         

         VT2plus support enables the use of VT2xx, VT3xx, VT4xx and VT5xx

         terminals. The keys <F11>, <F12> and <F13> work as <ESC>, <BS> and 

         <LF>. The keys <HELP>, <DO> etc. can also be used and it is possible

         to define the functionkeys <F6>..<F20> like :

         

             "F6 := TIM"

         

         pushing <F6> gives the time of day then.

         

        MCEBLD -- Want the VT2plus support [D:N] ? y

         

        *****

         

         On a VT4xx and a VT5xx terminal it is possible to use <F1>..<F5> as 

         normal functionkeys.

         VT4plus support enables you to define those keys too if you answer "Y" 

         to the following question.

         

        MCEBLD -- Want the VT4plus support  [D:N] ? y

         

        *****

         

         The keys of a TANDBERG TDV2230 terminal can also be defined.

         

        MCEBLD -- Want the TANDBERG TDV2230 function key support [D:N] ? 

         

        *****









        Sample MCE build-session                                      Page B-4

        







         

         Some edit functions can be performed on the VTxxx keypad, similar

         to EDT, KED and K52.

         The Keypad-editing can be switched on/off with MCE KEYPad on/off

         

        MCEBLD -- Want the EDT-Keypad editing support   [D:N] ? y

        MCEBLD -- Want EDT-Keypad editing ON by default [D:N] ? y

         

        *****

         

         The MCE prompt can show if overstrike- or insert-mode is active

         by "+" and "-".

         It can also display if EDT-Keypad editing (when selected)

         is enabled when the statusline is off by ":"

         

             eg.    "+:>"

         

         The Extended prompt can be switched on/off with MCE PROMpt on/off

         

        MCEBLD -- Want the extended prompt           [D:N] ? y

        MCEBLD -- Want Extended prompt ON by default [D:N] ? y

         

        *****

         

         MCE can accept a userprompt.

         This prompt can be specified WITH MCE USPRompt <UserPrompt>.

         The maximum promptsize is 20 characters.

         

        MCEBLD -- Want the userprompt                [D:N] ? y

         

        *****

         

         MCE can lock a terminal with a password.

         Almost like the LOCK command from Digital's terminal servers.

         The maximum password-length is 8 characters.

         

        MCEBLD -- Want the terminal password locking [D:N] ? y

         

        *****

         

         Default overstrike- or insert-mode stays active until it is changed 

         with CTRL/A or <F14>. MCE can be build so that it sets one of the

         modes active by default when it prompts for a new command. 

         This can be changed with the MCE INSErt on/off and the

         MCE OVERstrike on/off commands.

         

        MCEBLD -- Want MCE to set insert-mode back by default     [D:N] ? y

         

        *****

         

         Default "old" commands (retrieved from fifo and not edited) are 

         saved again in the FIFO. MCE can be build so that it does not save









        Sample MCE build-session                                      Page B-5

        







         them again.

         This mode can be changed with the  MCE SVOLd on/off command.

         

         

        MCEBLD -- Want MCE to save "Old" Commands by default [D:N] ? 

         

        *****

         

         Default internal commands are saved in the FIFO. MCE can be build 

         so that it does not save them.

         This mode can be changed with the  MCE SVINtern on/off command.

         

         

        MCEBLD -- Want MCE to save Internal Commands by default [D:N] ? 

         

        *****

         

         When terminal time-out support is included the terminal is logged 

         out after a given time-out time (TT0: only exits MCE).

         Optionaly you can select a fixed Time-Out time or select that the

         user can  change the time.

         

        MCEBLD -- Want the terminal time-out support           [D:N] ? y

        MCEBLD -- Want to enable the user to change the values [D:N] ? y

        MCEBLD -- Enter default number of time-out minutes [2..999  D:4] : 360

        MCEBLD -- Want the timeout to be ON by default         [D:N] ? y

         

        *****

         

         Only command lines with a length greater than or equal to a given 

         length are saved in the command FIFO.

         The value can be changed with the MCE CMSZ nn command.

         Use a value of 79 if you donot want to save at all.

         

        MCEBLD -- Enter minimum command line length [1..79  D:4] : 

         

        *****

         

         Specify the default maximum number of commands which can be saved

         in the command line Fifo.  The value can be changed with the

         MCE FISZ nn command.

         Note that the actual number of commands that can be saved depends

         on the size of the commands and the available MCE pool space.

         Information about MCE's poolspace can be obtained by the 

         MCE FREE command.

         More poolspace can be created by installing MCE with a larger 

         increment.  INS $MCE/INC=xxx

         A value of 2400 will be enough in most cases.

         

        MCEBLD -- Enter maximum number of entries in FIFO [1..99  D:22] : 

         

         









        Sample MCE build-session                                      Page B-6

        







        *****

         

         A helpfile MCE.HLP customized to your selections is created 

         dynamicly if you answer "Y" to the following question.

         Note that if you donot build the helpfile now, you cannot use 

         the <NXT-SCREEN> and <PRV-SCREEN> keys to walk through the helpfile.

         

        MCEBLD -- Create helpfile on LB: [D:N] ? y

         

        MCEBLD -- What is your Help Directory [D:[1,2]] : 

         

        *****

         

         The helpfile can be created in two different versions.

         

         VERSION 1 :  You can access this one by typing HELP MCE [topic...] 

                      but you have to include a reference like :

                            1 MCE

                            @MCE

                      in  MCR.HLP and DCL.HLP

         

         VERSION 2 :  You can access this one by typing HELP /MCE [topic...]

                      This version does not need any editing of MCR.HLP and 

                      DCL.HLP

         

        MCEBLD -- Do you want VERSION 2 [D:N] ? 

         

        *****

         

        MCEBLD -- When ready and successful copy MCE.TSK to LB: device [D:N] ? y

        MCEBLD -- What is your Task Directory [D:[1,54]] : 

        MCEBLD -- Install task [D:N] ? y

        MCEBLD -- Print listing and map [D:N] ? 

        MCEBLD -- All questions asked .......

         

        MCEBLD -- Creating saved answer file MCESAVED.DAT 

        PIP MCESAVED.DAT/PU/NM

        MCEBLD -- Creating helpfile LB:[1,2]MCE.HLP .....

        PIP LB:[1,2]MCE.HLP/PU/NM

        MCEBLD -- Creating configuration prefixfile MCEPRE.MAC .....

        PIP MCEPRE.MAC/PU/NM

        MCEBLD -- Creating MAC-command file MCEASM.CMD .....

        PIP MCEASM.CMD/PU/NM

        MCEBLD -- Creating TKB-command file MCETKB.CMD .....

        PIP MCETKB.CMD/PU/NM

        MCEBLD -- Assembling MCE .....

        MAC @MCEASM

        PIP MCE.OBJ/PU/NM,MCE.LST

        MCEBLD -- Building MCE .....

        TKB @MCETKB

        PIP MCE.TSK/PU/NM,MCE.MAP

        PIP LB:[1,54]/NV/FO/CO=MCE.TSK









        Sample MCE build-session                                      Page B-7

        







        ABO ...MCE

        REM ...MCE

        INS LB:[1,54]MCE

        MCEBLD -- Procedure done









        

        











                                   APPENDIX C



                           Sample MCE build-session 







        (RSX-11M with MCR and saved answers)

        >@mcebld

         

               +---------------+

               |   +-------+   |

               |  /         \  |

               | / D E C U S \ |   D E C U S  makes it work

               | \   P D P   / |

               |  \  S I G  /  |

               |   +-------+   |

               +---------------+

         

        MCEBLD.CMD -- Command file to build the MCE command line editor V4.27

         

         

         This command file builds YOUR version of MCE. It prompts for several

         options to be build in MCE. It creates a conditional assembly 

         definition file called MCEPRE.MAC, two command files MCEASM.CMD and

         MCETKB.CMD and optionaly a helpfile MCE.HLP. If you already have those

         files you can restart MCEBLD with "@MCEBLD MAC" to assemble and

         taskbuild or "@MCEBLD LINK" to taskbuild.

         

        *****

         

         MCEBLD can use saved answers from a previous session.

         

         MCEBLD can use the saved answers as default and still ask questions

         or it can directly use these answers and skip the questions which

         answers are defined.

         

         

        MCEBLD -- Do you have a saved answer file [D:N] : y

        MCEBLD -- Name of the saved answer file [D:MCESAVED.DAT] : 

        MCEBLD -- Do you want to skip the questions [D:N] : y

         

        *****

         

         MCEBLD can save answers for a future session.

         

        MCEBLD -- Do you want to save answers [D:N] : y

        MCEBLD -- Name of the saved answer file [D:MCESAVED.DAT] : 

         

        *****

                         -- Multiple CLI support included    : T









        Sample MCE build-session                                      Page C-2

        







        *****

                         -- MCEINI file support              : T

        *****

                         -- Compound command support         : T

        *****

                         -- Statusline support               : T

                         -- Statusline ON by default         : F

        *****

                         -- Startup and Exit messages support: T

        *****

                         -- RT messages                      : T

                         -- RT Exit                          : F

                         -- HT messages                      : T

                         -- HT Exit                          : F

        *****

                         -- VT2plus support                  : T

        *****

                         -- VT4plus support                  : T

        *****

                         -- TANDBERG TDV2230 support         : F

        *****

                         -- EDT-Keypad support               : T

                         -- EDT-Keypad ON by default         : T

        *****

                         -- Extended Prompt support          : T

                         -- Extended Prompt ON by default    : T

        *****

                         -- User Prompt support              : T

        *****

                         -- Password Locking                 : T

        *****

                         -- Insert Mode default              : T

                         -- Overstrike Mode default          : F

        *****

                         -- Save OLD Commands                : F

        *****

                         -- Save Internal Commands           : F

        *****

                         -- Time-Out Support                 : T

                         -- Time-Out Support change          : T

                         -- Time-Out value                   : 360

                         -- Time-Out default ON              : T

         

        *****

                         -- Minimum commandline length       : 4

        *****

                         -- Maximum FIFO length              : 22

         

        *****

         

         A helpfile MCE.HLP customized to your selections is created 

         dynamicly if you answer "Y" to the following question.









        Sample MCE build-session                                      Page C-3

        







         Note that if you donot build the helpfile now, you cannot use 

         the <NXT-SCREEN> and <PRV-SCREEN> keys to walk through the helpfile.

         

        MCEBLD -- Create helpfile on LB: [D:Y] ? 

                         -- Help directory                   : [1,2]

        *****

                         -- VERSION 2 Helpfile               : F

         

        *****

         

        MCEBLD -- When ready and successful copy MCE.TSK to LB: device [D:Y] ? 

        MCEBLD -- What is your Task Directory [D:[1,54]] : 

        MCEBLD -- Install task [D:Y] ? 

        MCEBLD -- Print listing and map [D:N] ? 

        MCEBLD -- All questions asked .......

         

        MCEBLD -- Creating saved answer file MCESAVED.DAT 

        PIP MCESAVED.DAT/PU/NM

        MCEBLD -- Creating helpfile LB:[1,2]MCE.HLP .....

        PIP LB:[1,2]MCE.HLP/PU/NM

        MCEBLD -- Creating configuration prefixfile MCEPRE.MAC .....

        PIP MCEPRE.MAC/PU/NM

        MCEBLD -- Creating MAC-command file MCEASM.CMD .....

        PIP MCEASM.CMD/PU/NM

        MCEBLD -- Creating TKB-command file MCETKB.CMD .....

        PIP MCETKB.CMD/PU/NM

        MCEBLD -- Assembling MCE .....

        MAC @MCEASM

        PIP MCE.OBJ/PU/NM,MCE.LST

        MCEBLD -- Building MCE .....

        TKB @MCETKB

        PIP MCE.TSK/PU/NM,MCE.MAP

        PIP LB:[1,54]/NV/FO/CO=MCE.TSK

        INS LB:[1,54]MCE

        MCEBLD -- Procedure done

        >









        

        











                                    CONTENTS







            1.   Options . . . . . . . . . . . . . . . . . . . . . .   2

                 1.1   Multiple CLI support  . . . . . . . . . . . .   3

                 1.2   Init-file support . . . . . . . . . . . . . .   3

                 1.3   Compound command line support . . . . . . . .   3

                 1.4   Statusline support  . . . . . . . . . . . . .   5

                 1.5   Startup and exit messages . . . . . . . . . .   5

                 1.6   Remote terminal (RT: and HT:) detection . . .   6

                 1.7   VT2plus support . . . . . . . . . . . . . . .   6

                 1.8   VT4plus support . . . . . . . . . . . . . . .   6

                 1.9   TDV2230 function key support  . . . . . . . .   7

                 1.10  EDT-Keypad editing support  . . . . . . . . .   7

                 1.11  User prompt support . . . . . . . . . . . . .   7

                 1.12  Extended prompt support . . . . . . . . . . .   7

                 1.13  Terminal password locking . . . . . . . . . .   7

                 1.14  Automatic return to Insert- or Overstrikemode   8

                 1.15  Terminal time-out support . . . . . . . . . .   8

            2.   Command Line Editor Startup . . . . . . . . . . . .   8

            3.   Command Line Editor Exit  . . . . . . . . . . . . .   8

            4.   Command Lines . . . . . . . . . . . . . . . . . . .   8

            5.   Command synonyms  . . . . . . . . . . . . . . . . .   9

            6.   Function keys . . . . . . . . . . . . . . . . . . .  10

            7.   Internal Commands (MCE xxxx)  . . . . . . . . . . .  12

                 7.1   MCE CHAIn [file]  . . . . . . . . . . . . . .  12

                 7.2   MCE CLEAr . . . . . . . . . . . . . . . . . .  12

                 7.3   MCE CMSZ n  . . . . . . . . . . . . . . . . .  13

                 7.4   MCE ECHO ON|OFF . . . . . . . . . . . . . . .  13

                 7.5   MCE EXIT  . . . . . . . . . . . . . . . . . .  13

                 7.6   MCE FISZ n  . . . . . . . . . . . . . . . . .  13

                 7.7   MCE FREE  . . . . . . . . . . . . . . . . . .  13

                 7.8   MCE INSErt ON|OFF . . . . . . . . . . . . . .  14

                 7.9   MCE KEYPad ON|OFF . . . . . . . . . . . . . .  14

                 7.10  MCE LIST  . . . . . . . . . . . . . . . . . .  14

                 7.11  MCE LOCK  . . . . . . . . . . . . . . . . . .  14

                 7.12  MCE OVERstrike ON|OFF . . . . . . . . . . . .  14

                 7.13  MCE PROMpt ON|OFF . . . . . . . . . . . . . .  15

                 7.14  MCE PURGe . . . . . . . . . . . . . . . . . .  15

                 7.15  MCE READ [file] . . . . . . . . . . . . . . .  15

                 7.16  MCE REPLace [file]  . . . . . . . . . . . . .  15

                 7.17  MCE RING  . . . . . . . . . . . . . . . . . .  15

                 7.18  MCE STATus [ON|OFF] . . . . . . . . . . . . .  15

                 7.19  MCE SVINternals ON|OFF  . . . . . . . . . . .  16

                 7.20  MCE SVOLd ON|OFF  . . . . . . . . . . . . . .  16

                 7.21  MCE TIMOut n|ON|OFF . . . . . . . . . . . . .  16

                 7.22  MCE UPFInd ON|OFF . . . . . . . . . . . . . .  16

                 7.23  MCE USPRompt [userprompt] . . . . . . . . . .  16

                 7.24  MCE VERSion . . . . . . . . . . . . . . . . .  17









        

        







                 7.25  Some notes on files . . . . . . . . . . . . .  17

            8.   Recall function . . . . . . . . . . . . . . . . . .  17

            9.   Help file . . . . . . . . . . . . . . . . . . . . .  18

            10.  Line editing commands . . . . . . . . . . . . . . .  19

                 10.1  Non-keypad editing and cursor movement commands  19

                 10.2  EDT-keypad editing and cursormovement commands   21

                       10.2.1  VT2+ Keyboard Lay-out . . . . . . . .  21

                       10.2.2  VT1xx Keypad Lay-out  . . . . . . . .  22

                       10.2.3  VT52 Keypad Lay-out . . . . . . . . .  23

                       10.2.4  Keypad editing and cursormovement keys   24

            11.  Building MCE  . . . . . . . . . . . . . . . . . . .  27

            12.  Known problems  . . . . . . . . . . . . . . . . . .  28

                 12.1  DCL and installed tasks . . . . . . . . . . .  28

                 12.2  MCE on RT:, HT: and LAT terminals . . . . . .  28

                 12.3  Remarks on 8-Bit terminals and lines  . . . .  29

        

        A.  Example of an Init-file: . . . . . . . . . . . . . . . . A-1



        B.  Sample MCE build-session   . . . . . . . . . . . . . . . B-1



        C.  Sample MCE build-session   . . . . . . . . . . . . . . . C-1



