Creating Customized mvTerm Menus

This topic describes how to customize the mvTerm menu, which is created for use within an account contained in the MultiValue environment.

The mvBase Terminal Emulator (mvTerm) menu bar lists six default menus (Session, Edit, View, Options, Window, and Help). These menus are recognized as menu #1 through menu #6, respectively, and customized menus may be inserted before, between, or after them. Although it is not recommended, customized menus may replace any of the six standard menus.

Perform these steps to create a customized menu:

  1. Launch an mvTerm session (either new or previously saved).

  2. Select Session, then select Connect to mvBase Server. The Connect to mvBase Server dialog box displays.

  3. Specify the computer name of the mvBase Server to which you want to connect.

  4. Specify a line number by which to connect, or enter an asterisk (*) to connect to the next available line. (You can also enter -1 for the next available line.)

  5. Log on to a valid account. Once logged on to the account, you may create a customized menu. You can then access this menu from the mvBase Terminal Emulator (mvTerm) menu bar.

  6. Create an item in the master dictionary of the current account using the following commands:

  7. >ED MD itemname

    TOP

    .I

    &menu name

    #number action

    &menu entry name]execution command]execution mode

    -

    TOP

    .FI

    Line 1 of the item contains the name of the menu. Line 2 (an optional line) contains the # character, followed by a number indicating the menu number of the menu to perform the action. The action specified in Line 2 may be INSERT, REPLACE, or DELETE. Line 3 contains the name of the menu entry followed by a value mark (Control ']'), the execution command that will be executed by the menu entry followed by a value mark, and the execution mode.

    The execution mode may be the following:

    If you do not specify the execution mode, the execution command (to be executed by the menu entry) and carriage return will be sent on the data channel, and execution of the command will not occur. More lines may be added after Line 3, specifying additional menu entries.

    Specifying the ampersand (&) character causes the letter following the & character to be underlined, enabling the user to enter the underlined letter to select the menu bar name or menu entry name. The & character may appear before any letter in the menu bar name or menu entry name.

    A line containing the hyphen (-) character causes a separator to be placed between the menu entries specified on the lines above and below it.

Example #1

>ED MD MY.MENU

TOP

.I

001+&My Menu

002+#7 REPLACE

003+&LISTLINES]LISTLINES]E

004+&NOTEPAD]RUN BASICLIB NOTEPAD]E

005+-

006+&SYSPROG]LOGTO SYSPROG

007+&DEMO]LOGTO DEMO

008+&GAMES]LOGTO GAMES

009+-

010+&CALCULATOR]calc.exe]W

011+&EMAIL]eudora.exe]W

012+

TOP

.FI

To insert, replace, or delete a customized menu on the mvBase Terminal Emulator (mvTerm) menu bar, enter:

WINMENU itemname

or

WINMENU # number DELETE

Example #2

>WINMENU MY.MENU

After running WINMENU MY.MENU, menu #7 displays on the mvBase Terminal Emulator (mvTerm) menu bar and contains the specified menu entry names.

Example #3

>WINMENU #7 DELETE

After running WINMENU.#7 DELETE, menu #7 is deleted from the mvBase Terminal Emulator (mvTerm) menu bar.

See Also

Configuring and Using the mvTerm Client

Setting Up mvTerm on Windows

Overview of the mvTerm Window

Configuring (and Saving) mvTerm Properties

Using mvTerm Command Line Syntax

Controlling mvTerm Properties from mvBASIC

Starting and Connecting mvTerm

Logging off and Disconnecting mvTerm

Copying and Pasting Within an mvTerm Client Session

Using Back Pages

Using Enhanced Programmable Mouse Click Features