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

+---------------+ |   +-------+   |
+---------------+
|
+-------+
|
| /
\ |
| / D E C U S \ |
| \
R S X
/ |
| \ S I G / |
|
+-------+
|
+---------------+
MMMM
MMMM
MM MM
MM MM
MM MM MM MM
MM
MMM
MM
MM
M
MM
MM
MM
MM
MM
MM
MM
D E C U S
makes it work
CCCCCCCC
CCC
CCC
CC
CC
CC
CC
CC
CC
CCC
CCC
CCCCCCCC
EEEEEEEEEE
EE
EEE
EE
EEEEEEE
EEEEEEE
EE
EE
EEE
EEEEEEEEEE
COMMAND LINE EDITOR
This manual describes MCE V4.24
originaly developed by
D. Sponza (YU) oct-81
Since 29-Jul-86 Supported by
Hans Hamakers
ABB Industrie b.v.
P.O Box 113
3000 AC Rotterdam
The Netherlands
Different "evolutions" from DECUS tapes
( sometimes called CLE ) where collected
and merged and new features where added
CONTENTS
1.
2.
3.
4.
5.
6.
7.
Options . . . . . . . . . . . . . . . . . . . . . .
1.1
Multiple CLI support . . . . . . . . . . . .
1.2
Init-file support . . . . . . . . . . . . . .
1.3
Compound command line support . . . . . . . .
1.4
Statusline support . . . . . . . . . . . . .
1.5
Startup and exit messages . . . . . . . . . .
1.6
Remote terminal (RT:) detection . . . . . . .
1.7
VT2xx/VT3xx/VT4xx keyboard support . . . . .
1.8
VT4xx extra function key support . . . . . .
1.9
TDV2230 function key support . . . . . . . .
1.10 EDT-Keypad editing support . . . . . . . . .
1.11 User prompt support . . . . . . . . . . . . .
1.12 Extended prompt support . . . . . . . . . . .
1.13 Automatic return to Insert- or Overstrikemode
1.14 Terminal time-out support . . . . . . . . . .
Command Line Editor Startup . . . . . . . . . . . .
Command Line Editor Exit . . . . . . . . . . . . .
Command Lines . . . . . . . . . . . . . . . . . . .
Command synonyms . . . . . . . . . . . . . . . . .
function keys . . . . . . . . . . . . . . . . . . .
Internal Commands ( MCE xxxx ) . . . . . . . . . .
7.1
MCE CHAIn [file] . . . . . . . . . . . . . .
7.2
MCE CLEAr . . . . . . . . . . . . . . . . . .
7.3
MCE CMSZ n . . . . . . . . . . . . . . . . .
7.4
MCE ECHO ON|OFF . . . . . . . . . . . . . . .
7.5
MCE EXIT . . . . . . . . . . . . . . . . . .
7.6
MCE FISZ n . . . . . . . . . . . . . . . . .
7.7
MCE FREE . . . . . . . . . . . . . . . . . .
7.8
MCE INSErt ON|OFF . . . . . . . . . . . . . .
7.9
MCE KEYPad ON|OFF . . . . . . . . . . . . . .
7.10 MCE LIST . . . . . . . . . . . . . . . . . .
7.11 MCE OVERstrike ON|OFF . . . . . . . . . . . .
7.12 MCE PROMpt ON|OFF . . . . . . . . . . . . . .
7.13 MCE PURGe . . . . . . . . . . . . . . . . . .
7.14 MCE READ [file] . . . . . . . . . . . . . . .
7.15 MCE REPLace [file] . . . . . . . . . . . . .
7.16 MCE RING . . . . . . . . . . . . . . . . . .
7.17 MCE STATus [ON|OFF] . . . . . . . . . . . . .
7.18 MCE SVINternals ON|OFF . . . . . . . . . . .
7.19 MCE SVOLd ON|OFF . . . . . . . . . . . . . .
2
2
3
3
4
5
5
5
6
6
6
6
6
6
7
7
7
7
8
9
10
11
11
11
11
11
12
12
12
12
13
13
13
13
13
13
14
14
14
14
8.
9.
10.
7.20 MCE USPRompt [userprompt]
7.21 MCE VERSion . . . . . . .
7.22 Some notes on files . . .
Recall function . . . . . . . .
Help file . . . . . . . . . . .
Line editing commands . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
14
15
15
15
16
17
10.1
Non-keypad editing and cursor movement commands
10.2
EDT-keypad editing and cursormovement commands
17
19
10.2.1
10.2.2
10.2.3
10.2.4
VT2xx/VT3xx/VT4xx Keyboard Lay-out . 19
VT1xx Keypad Lay-out . . . . . . . . 20
VT52 Keypad Lay-out . . . . . . . . . 21
Keypad editing and cursormovement keys
22
11.
12.
Building MCE . . . . . . . . . . . . . . .
Known problems . . . . . . . . . . . . . .
12.1 DCL and installed tasks . . . . . . .
12.2 MCE on RT: and LAT terminals . . . .
12.3 Remarks on 8-Bit terminals and lines
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
24
25
25
25
26
A.
Example of an Init-file: . . . . . . . . . . . . . . . . A-1
B.
A sample MCE build-session . . . . . . . . . . . . . . . B-1
MCE -- Command line editor
MCE is an RSX-task through which you
the CLI active at your terminal.
Page 2
can
communicate
with
--------+
+---------+
+---------+
/
|
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 possible features follows
individualy be selected at build time
below.
They
can
MCE V4.24 - Command line Editor options :
--------------------------------------- Multiple CLI support
- Init-file support
- Compound command line support
- Statusline support
- Startup and exit messages
- Remote terminal (RT:) detection
- VT2xx/VT3xx/VT4xx keyboard support
- VT4xx extra function key support
- TDV2230 function key support
- EDT-Keypad editing support
- User prompt support
- Extended prompt support
- Automatic return to Insert- or Overstrikemode
- Terminal time-out support
1.1
Multiple CLI support
When multiple CLI support is included MCE
uses
the
prompt
from the CLI currently active for the invoking terminal.
Furthermore there can be different Init-files for MCR, DCL
or other CLI's
MCE -- Command line editor
Options
1.2
Page 3
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:<Cur-Dir>MCEINI.xxx
When multiple CLI support is not included :
LB:[1,2]MCEINI.CMD, followed by
SY:<Cur-Dir>MCEINI.CMD
where "xxx" is the name of the CLI defined for the terminal
invoking MCE and "Cur-Dir" 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 users private set in
SY:<Cur-Dir>
Overriding the default file name in the command line
invoking MCE offers the possibility to tailor an application
specific command set.
Comments are possible behind "!" , 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 one can define an MCE command as a
sequence of multiple CLI commands :
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
done to let commands like "PIP /TD&/LI" still work.
When a command in a compound command line
gives
is
a
MCE -- Command line editor
Options
Page 4
non-successful
exitstatus, MCE terminates the compound
command line there, showing the exitstatus and the command
that caused it.
A compound command line may not contain Internal Commands
( Commands starting with "MCE" ) and only the first command
is checked for translation.
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.24
FIFO:list/22/16/00 CMSZ:04 KEYP:on SVINT:off SVOLD:on
TMO:xx
---------------------------------------------------------------------|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Time-
|
|
|
|
|
|
|
|
| in
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
v
Save
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
+-->
|
|
|
|
|
|
|
|
v
out time
minutes or
"no"
old
cmds
"on" or
"off"
Save
intern cmds
"off"
"on" or
|
|
|
|
|
|
|
|
|
|
|
|
|
+-----> 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
MCE -- Command line editor
Options
1.5
Page 5
Startup and exit messages
The startup and exit messages like :
"MCE -- CLI-Command Line Editor V4.24"
and
"MCE -- Exit"
are optional.
They can be selected at build time.
MCE indentifies its self with
"MCE -- MCR-Command Line Editor V4.24"
___
when no multiple CLI support was selected at build time.
1.6
Remote terminal (RT:) detection
When starting MCE via a remote terminal (RT:) problems may
occur if the local system is VMS with its command line
editor enabled. The way MCE acts when it detects if it was
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 (RT:)
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
..
-
1.7
(RT:)
Exiting
Do nothing
VT2xx/VT3xx/VT4xx keyboard support
VT2xx/VT3xx/VT4xx support enables the use
<F12> and <F13> as <ESC>, <BS> and <LF>.
of keys <F11>,
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 )
MCE -- Command line editor
Options
1.8
Page 6
VT4xx extra function key support
On a VT4xx 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.
1.9
TDV2230 function key support
The keys of a TANDBERG TDV2230 terminal can be defined like
the ones on a VT2xx/VT3xx/VT4xx. ( See function keys )
1.10
EDT-Keypad editing support
Some
edit
functions
can
be
performed
on
a
VT52/VT1xx/VT2xx/VT3xx/VT4xx-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.
To 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
"MCE PROMpt ON|OFF"
can
be
switched
on/off
with
1.13
Automatic return to Insert- or Overstrikemode
Default overstrike- or insert-mode stayes active until it is
changed by CTRL/A. MCE can be build so that it sets one of
the modes active by default when it prompts for a new
MCE -- Command line editor
Options
Page 7
command.
This can be changed with the "MCE INSErt ON|OFF"
and "MCE OVERstrike ON|OFF" commands.
1.14
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 )
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 gives a
prompt.
How the prompt looks depend 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
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 may be preceded by and contain one or more
TAB's and/or spaces.
Normally all command lines equal to or longer than
a
given
MCE -- Command line editor
Command Lines
Page 8
length are saved in a Fifo-buffer.
changed with the "MCE CMSZ n" command.
This length may be
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".
Internal commands are saved when this is enabled
"MCE SVINternals ON". ( Save "INTERNAL commands )
5.
by
Command synonyms
A Command synonym may 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
With Keypad-mode "OFF" the keystrokes <PF1> , <BLUE>
<ESC>P translate the command synonym without execution.
or
If you enter a command synonym followed by additional text,
this additional text will normally be appended as a whole.
e.g.
or
+>HE /RE
+>HE /RE<PF1>
! Will request "HELP PIP /RE
! 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
MCE -- Command line editor
Command synonyms
Page 9
Abbreviate commands by seperating the optional part by "*"
e.g.
+>HP*IP := HELP PIP
This command may 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 may request a command with function keys
<PF3> or <PF4>.
<PF1>,
The keys <BLUE>, <RED> and <GREY> on a VT52 are
<PF1>, <PF2> and <PF3>.
It is also possible to request commands
(e.g. <CTRL/G>).
with
<PF2>,
synonym
control
to
keys
With a VT2xx/VT3xx/VT4xx keyboard you can also define the
function keys <F6> .. <F20> and <FIND> <INSERT HERE> etc.
( Only when VT2xx/VT3xx/VT4xx keyboard support is included )
With a VT4xx <F1> .. <F5> can be defined when
is included.
this
support
The keys of a TANDBERG TDV2230 keyboard can be defined like
the ones on a VT2xx/VT3xx/VT4xx.
( Only when TDV2230
support is included )
Define the command translation as "<key> := command".
e.g.
+>PF2 := TIM
+><PF2>
! Redefine <PF2> or <RED> key
! to display the current time
MCE -- Command line editor
function keys
Page 10
+>F6 := ACT
+><F6>
! Define F6 function key
! to display the active tasks
The keys <FIND> ect. on a VT2xx/VT3xx/VT4xx 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
+><CTRL/G>
! Define <CTRL/G> key
! to display the current UIC
Note that the following control-keys CANNOT be defined:
<CTRL/M> = <RETURN>,
<CTRL/O>, <CTRL/Q>, <CTRL/S>
<CTRL/[> = <ESC>
Next to the rest of the Alphabetic characters the
keys can be defined :
following
<CTRL/\>
<CTRL/]>
<CTRL/^>
<CTRL/?>
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
MCE
MCE
MCE
MCE
MCE
CHAIn [file]
CLEAr
CMSZ n
ECHO ON|OFF
EXIT
FISZ n
-
MCE
MCE
MCE
MCE
MCE
MCE
FREE
INSErt ON|OFF
KEYPad ON|OFF
LIST
OVERstrike ON|OFF
PROMpt ON|OFF
MCE -- Command line editor
Internal Commands ( MCE xxxx )
-
7.1
MCE
MCE
MCE
MCE
MCE
MCE
MCE
MCE
MCE
Page 11
PURGe
READ [file]
REPLace [file]
RING
STATusline [ON|OFF]
SVINternals ON|OFF
SVOLd ON|OFF
USPRompt [userprompt]
VERSion
MCE CHAIn [file]
Chain from one Init-file to another, that is start or
continue reading commands on 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
Fifo-buffer.
7.3
deletes
all
commands
currently
in
the
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. 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.
MCE -- Command line editor
Internal Commands ( MCE xxxx )
7.6
Page 12
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 depend on the size
of the command lines 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, 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
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.
MCE -- Command line editor
Internal Commands ( MCE xxxx )
7.10
Page 13
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 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.
7.12
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.13
MCE PURGe
This command deletes all command synonyms currently
synonym buffer.
7.14
in
the
MCE READ [file]
Read command lines from specified file.
This command is
only available when Init-file support is included in MCE.
7.15
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.
MCE -- Command line editor
Internal Commands ( MCE xxxx )
7.16
MCE RING
Makes command Fifo-buffer a ring :
through the buffer.
The default setting is "LIST".
command )
7.17
Page 14
UP- and DOWN-ARROW
( See
also
roll
"MCE LIST"
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.
7.18
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.19
MCE SVOLd ON|OFF
When "ON", "old" commands ( retrieved from the Fifo-buffer )
are saved again in the Fifo-buffer, otherwise they are not
saved unless they are edited. The default setting can be
specified at MCE build time.
7.20
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 Userprompt Support is
included in MCE.
MCE -- Command line editor
Internal Commands ( MCE xxxx )
7.21
Page 15
MCE VERSion
Shows the MCE Version identification
7.22
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:[Cur-Dir]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 may
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 :
In EDT-Keypad mode
:
<PF2> or <RED>
<PF3> or <GREY>
E.g.
Previously entered command lines :
+>DIR
+>MAC
+>TKB
+>DMP
+>TIM
MCE*.*
@MCEASM
@MCETKB
X.DAT
+>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
Recall function
+>DI<RECALL>
9.
Will recall :
Page 16
+>DIR MCE*.*
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 cannot use the <NEXT-SCREEN> and <PRV-SCREEN> keys
to walk through the helpfile.
MCE -- Command line editor
Help file
10.
Page 17
Line editing commands
For line-editing there are two modes :
o
o
Non-keypad mode
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, VT2xx, VT3xx or a VT4xx 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
+----------------------------------------------------------+
| Cursormovements
|
+----------------------------------------------------------+
| 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 VT2xx/VT3xx/VT4xx terminal only when their keyboard
support is included.
MCE -- Command line editor
Line editing commands
Page 18
+----------------------------------------------------------+
| Control commands
|
+----------------------------------------------------------+
| Rewrite Line
| <CTRL/R>
|
| Switch between Overstrike and |
|
|
Insert mode.
| <CTRL/A>
|
+----------------------------------------------------------+
+----------------------------------------------------------+
| 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 |
|
| Suspend.
|
|
| Resume with "RES 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
|
+----------------------------------------------------------+
+----------------------------------------------------------+
| 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 VT2xx/VT3xx/VT4xx terminal
support is included.
only
when
their
keyboard
MCE -- Command line editor
Line editing commands
10.2
Page 19
EDT-keypad editing and cursormovement commands
While in keypad-mode the non-keypad commands
except those commands that are redefined.
10.2.1
are
valid,
VT2xx/VT3xx/VT4xx Keyboard Lay-out
F11
F12
F13
F14
+--------+--------+--------+--------+
HELP
DO
+--------+-------------
|*(ESC)
|* (BS)
|* (LF)
|
|
|*
|
|
| DELWRD |
|
|
|
| BEGLIN | RIGHT
|
|
----+
|*
|
HELP
|
EXECUTE
NOWAIT |
|
|
|
+--------+--------+--------+--------+
+--------+-------------
----+
PF1
PF2
PF3
PF4
+--------+--------+--------+
+--------+--------+--------+---
|*(FIND) |*INSERT |* RE-
|
|\\\\\\\\|
| RECALL |
|
|\\GOLD\\| KPHELP | RECALL | --
|
|\\\\\\\\|
-----+
|
|
DELLIN |
HERE
|
MOVE
---- |
|
|
|
|
|\UNDLIN\|
+--------+--------+--------+
+--------+--------+--------+---
|*
-----+
|* PREV
|* NEXT
|
|
| SHOSYN | SHOFIF |
|
|
| TRANSL | ------ | ------ | --
DELWRD |
| SELECT |
HELP
HELP
---- |
|
|(SCREEN)|(SCREEN)|
|\\VERS\\|\\FREE\\|\UNDWRD\|
+--------+--------+--------+
-----+
|
+--------+--------+--------+---
|
PREV
|
|
|
|
CUT
|
| COMMAND|
|
|
| ------ | --
|
|
DELCHR |
---- |
|
|
|\PASTE\\|\UNDCHR\|
+--------+--------+--------+
-----+
|
| NEXT |
|
|
| <-| COMMAND| -->
|
|
|
|
|
|
|
+--------+--------+--------+
ENTER |
+--------+--------+--------+--|
|
|
|
WORD
EOL
|
|
| ------ |
|
|\DELLIN\|
|
+--------+--------+--------+
|
BEGLIN
| SELECT |
|
| --------------- | ------ |
|
|\\\\\CLRLIN\\\\\\|\RESET\\|
|
+-----------------+--------+-------+
_______________
*
These keys are only available
when
keyboard
keyboard support is included.
VT2xx/VT3xx/VT4xx
MCE -- Command line editor
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\|
+--------+--------+--------+--------+
|
|
| CUT
| DELCHR |
|
|
| ------ | ------ |
|
|
|\PASTE\\|\UNDCHR\|
+--------+--------+--------+--------+
|
| EOL
|
|
|
| WORD | ------ |
|
|
|
|\DELLIN\|
|
|
+--------+--------+--------+ ENTER |
|
BEGLIN
| SELECT |
|
| --------------- | ------ |
|
|\\\\\CLRLIN\\\\\\|\RESET\\|
|
+-----------------+--------+--------+
Page 20
MCE -- Command line editor
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\\|
|
+-----------------+--------+--------+
|
|
| CUT
|
|
|
|
| ------ |
--> |
|
|
|\PASTE\\|
|
+--------+--------+--------+--------+
|
| EOL
|
|
|
| WORD | ------ |
|
<-- |
|
|\DELLIN\|
|
|
+--------+--------+--------+--------+
|
BEGLIN
| SELECT |
|
| --------------- | ------ | ENTER |
|\\\\\CLRLIN\\\\\\|\RESET\\|
|
+-----------------+--------+--------+
Page 21
MCE -- Command line editor
Line editing commands
10.2.4
Keypad editing and cursormovement keys
Note :
<KPx> means key x on the keypad.
Page 22
+----------------------------------------------------------+
| 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 |
+----------------------------------------------------------+
+----------------------------------------------------------+
| Control commands
|
+----------------------------------------------------------+
| Select lower function
| <PF1>
|
|
| or <BLUE>
= GOLD
|
+----------------------------------------------------------+
MCE -- Command line editor
Line editing commands
Page 23
+----------------------------------------------------------+
| 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>
|
+----------------------------------------------------------+
+----------------------------------------------------------+
| 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 |
+----------------------------------------------------------+
+----------------------------------------------------------+
| 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
Line editing commands
11.
Page 24
Building MCE
This section deals with the generation of the MCE-task.
distribution contains the following files.
-
MCE.MAC
MCEBLD.CMD
MCEREL.DOC
MCE.RNO
MCE.DOC
The
Macro source file
ICP command file to build MCE
Release notes
Source of this manual
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 under 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: DETECTION
VT2xx/VT3xx/VT4xx KEYPAD SUPPORT
VT4xx EXTRA FUNCTION KEY SUPPORT
TANDBERG TDV2230 SUPPORT
EDT-KEYPAD SUPPORT
USER PROMPT SUPPORT
EXTENDED PROMPT SUPPORT
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:
-
MCE.HLP
MCEPRE.MAC
MCEASM.CMD
MCETKB.CMD
Help file
Conditional assembly prefix file
MACRO command file
TKB/LINK command file
MCE -- Command line editor
Building MCE
Page 25
Than MCEBLD.CMD invokes:
MAC @MCEASM
TKB @MCETKB or LINK @MCETKB
When present MCE will be built with FCSFSL.STB or FCSRES.STB
A sample build-session can be found in Appendix B
12.
12.1
Known problems
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
+>RUN FOO
>
+$ INS $FOO/TASK=FOO
+$ RUN FOO
+$
To solve this add the following line to MCEINI.DCL :
R*UN := RUN 'P1'/STATUS:TASK
12.2
MCE on RT: and LAT terminals
A terminal on an RT: 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 cannot 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
Known problems
12.3
Page 26
Remarks on 8-Bit terminals and lines
A VT2xx/VT3xx/VT4xx terminal
"normal" escape-sequences :
PF1 = ESC [ P
F20 = ESC ? 3 4 ~
in
7-bit
( 33,
( 33,
33,
77,
The EBC, RPA, PASTHRU settings of the TI:
the correct processing of those keys.
A VT2xx/VT3xx/VT4xx
sequences :
terminal
PF1 = SS3 P
F20 = CSI 3 4 ~
in
8-bit
mode
always
sends
120 )
63, 64, 176 )
do not
mode
influence
sends
other
( 217, 120 )
( 233, 63, 64, 176 )
In this case the EBC, RPA, PASTHRU settings of the TI:
do
influence the processing. Although they do different things
one of the options MUST be on to let MCE see the keypad
keys.
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
latest information.
to
see
the
APPENDIX A
Example of an Init-file:
!
!
!
LB:[1,2]MCEINI.MCR
MCE
MCE
STATUS
ON
SVINTERN OFF
!
?
AS*SEMBLE
CO*PY
D*IR
FO
F20
LI*NK
MO*VE
RE*NAME
R*UN
BLD
:=
:=
:=
:=
:=
:=
:=
:=
:=
:=
:=
HELP
MAC @'P1'ASM
PIP 'P2'/NV='P1'
DIR
FOR @'P1'FTN
CLR
TKB @'P1'TKB
PIP 'P2'/NV='P1' & PIP 'P1';0/DE/NM
PIP 'P2'='P1'/RE
RUN
MAC @'P1'ASM & TKB @'P1'TKB
!
! 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
!
! End of LB:[1,2]MCEINI.MCR
!
APPENDIX B
A sample MCE build-session
>@mcebld
+---------------+
|
+-------+
|
| /
\ |
| / D E C U S \ |
| \
R S X
/ |
| \ S I G / |
|
+-------+
|
+---------------+
D E C U S
makes it work
MCEBLD.CMD -- Command file to build the MCE command line editor
V4.24
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 -- Give <RETURN> to continue .....
*****
The standard CLI ( Command Line Interpreter) of RSX is MCR.
When your system supports the use of other CLIs such as DCL than
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 CLIcommands.
Files are searched in this order:
LB:[1,2]MCEINI.xxx, followed by SY:<cur_dir>MCEINI.xxx,
where "xxx" is the name of the CLI defined for the terminal
invoking
MCE and "cur_dir" 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.
A sample MCE build-session
Page B-2
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 :
or directly:
E.g.
+>STAT := TIM & PIP /LI & ACT /ALL ...etc.
E.g.
+>MAC @TASKASM & TKB @TASKTKB
MCEBLD -- Want the compound command definition 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 ] ? y
*****
The startup and exit messages like :
"MCE -- CLI-Command Line Editor V4.24"
and
"MCE -- Exit"
are optional.
MCEBLD -- Want Startup and exit messages [ D:N ] ? y
*****
When starting MCE via a remote terminal (RT:) 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 (RT:)
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 (RT:) Exiting
....
A sample MCE build-session
Page B-3
3. Do nothing
MCEBLD -- Which option [ D:1 ] :
*****
VT2xx/VT3xx/VT4xx-Keyboard support enables the use of keys
<F11>,
<F12> and <F13> 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 VT2xx/VT3xx/VT4xx-Keyboard support [ D:N ] ? y
*****
On a VT4xx terminal it is possible to use <F1>..<F5> as normal
functionkeys.
MCE enables you to define those keys too if you answer "Y" to
the
following question.
MCEBLD -- Want the extra VT4xx functionkeys 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 ]
? y
*****
Some edit functions can be performed on the VT52/VT1xx/VT2xx/
VT3xx/VT4xx Keypad, similar to EDT, KED and K52.
The Keypad-editing can be switched on/off with MCE KEYPad on/off
MCEBLD -- Want EDT-Keypad editing ON by default [ D:N ] ? y
*****
The MCE prompt can show if overstrike- or insert-mode is active
by "+". It can also display if EDT-Keypad editing ( when
selected )
is enabled
eg.
"+:>"
The Extended prompt can be switched on/off with MCE PROMpt
on/off
MCEBLD -- Want the extended prompt
[ D:N ] ? y
A sample MCE build-session
Page B-4
MCEBLD -- Want Extended prompt ON by default [ D:N ] ? y
*****
MCE can accept a userprompt.
This prompt can be specified "MCE USPRompt <userprompt>"
command.
The maximum promptsize is 20 characters.
MCEBLD -- Want the userprompt
[ D:N ] ? y
*****
Default overstrike- or insert-mode stays active until it is
changed
by CTRL/A.
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.
MCEBLD -- Want MCE to set insert-mode back by default
[ D:N ]
?
MCEBLD -- Want MCE to set overstrike-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
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 ] ? y
*****
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 ] ?
y
*****
When terminal time-out support is included the terminal is
logged
out after a given time-out time ( TT0: only exits MCE )
MCEBLD -- Want the terminal time-out support
[ D:N ] ? y
MCEBLD -- Enter number of time-out minutes [ 2..120 D:4 ] : 60
*****
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.
A sample MCE build-session
Page B-5
MCEBLD -- Enter minimum command line length [ 1..10
D:1 ] : 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 depend
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.
] :
*****
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 canot 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 :
[topic...]
You can access this one by typing HELP MCE
but you have to include a reference like :
1 MCE
@MCE
in MCR.HLP and DCL.HLP
VERSION 2 :
[topic...]
You can access this one by typing HELP /MCE
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: dev. [
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 ] ? y
MCEBLD -- Creating helpfile LB:[1,2]MCE.HLP .....
PIP LB:[1,2]MCE.HLP/PU/NM
A sample MCE build-session
Page B-6
MCEBLD -- Creating configuration prefixfile MCEPRE.MAC .....
MCEBLD -- Creating MAC-command file MCEASM.CMD .....
MCEBLD -- Creating TKB-command file MCETKB.CMD .....
PIP MCEASM.CMD/PU/NM,MCEASM.CMD
MCEBLD -- Assembling MCE .....
MAC @MCEASM
PIP MCE.OBJ/PU/NM,MCE.LST,MCEPRE.MAC
MCEBLD -- Building MCE .....
PIP MCETKB.CMD/PU/NM
TKB @MCETKB
PIP MCE.TSK/PU/NM,MCE.MAP
PIP LB:[1,54]/NV/FO/CO=MCE.TSK
REM ...MCE
INS LB:[1,54]MCE
PRI MCE/FLA=MCE.LST,MCE.MAP
PRI - Job 322, name "MCE
", submitted to queue "PRINT "
MCEBLD -- Procedure done
>
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement