Tarantella Administration Guide > Applications, documents and hosts > Terminal emulator keyboard maps

Terminal emulator keyboard maps

The Tarantella terminal emulators associate keys on the user's client keyboard with keys found on a real terminal. For each type of terminal emulator (SCO Console, Wyse 60 and VT420) there is a default keyboard mapping.

To change the default mappings or define additional mappings for a particular application, you can specify your own keyboard map file using an object's Keyboard Map attribute.

Default mappings

The emulators have built-in keyboard maps, which are equivalent to those found in the sample keymap files in install_dir/etc/data/keymaps.

• ansikey.txt for the SCO Console emulator.
• vt420key.txt for the VT420 emulator.
• w60key.txt for the Wyse 60 emulator.

Note Modifying these keyboard maps does not alter the default mappings used by Tarantella. The only way to do this is to specify a keyboard map in an application object's Keyboard Map attribute.

Creating a keyboard map

To create your own keyboard map, you should make a copy of the relevant default keyboard map and modify it to suit your application. You can modify a keyboard map in any text editor.

The format of a mapping is:

ClientKeys=Translation

Where ClientKeys is the key(s) that the user presses on the client device, and Translation is the keystroke(s) sent to the application on the application server. For example:

PageDown=Next

With this mapping, when the user presses Page Down the emulator sends the keystroke Next to the application server.

If a particular key has a user-defined mapping, the default settings will be overridden. If no user-defined mapping is present, the default mapping is sent.

You can send complete strings on a single keypress by surrounding the string in double-quotes. For example:

F1="hello world"

To enter non-printable characters when mapping strings, use the code shown in the table below:

To specify modifier keys (Shift, Control and Alt) in a mapping, separate the keys with the plus sign, +. For example:

Shift+NUMLOCK=INSLINE 
Shift+F1="\0330a"
Alt+Shift+Control+DELETE="\003[33~"

Key names

The following tables contain lists of key names that are valid in Tarantella keyboard maps. The first table shows the key names that represent keys on the user's client device. These are the keys that can be mapped to the emulator key names given in the subsequent tables, which are the keystrokes ultimately sent to the application on the application server.

Note The default mappings between these key names are as found in the keyboard maps supplied with Tarantella. If a key is not in a keyboard map, then it is not mapped.

Client device keys

Application server keystrokes

SCO Console:

VT420:

Wyse 60: