



        
        



                    +---------------+
                    |   +-------+   |
                    |  /         \  |
                    | / 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

