Skip past navigation linksSecure Global Desktop Administration Guide > Applications, documents and hosts > Terminal emulator keyboard maps

Terminal emulator keyboard maps

The Secure Global Desktop 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 /opt/tarantella/etc/data/keymaps.

Note Modifying these keyboard maps does not alter the default mappings used by Secure Global Desktop. 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:

Skip past command syntax or program codeClientKeys=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:

Skip past command syntax or program codePageDown=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:

Skip past command syntax or program codeF1="hello world"

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

Code Meaning
\r Carriage return
\n Line feed
\" Double-quote
\e Escape
\t Tab
\nnn The character with octal value nnn
\xHH The character with hex value HH

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

Skip past command syntax or program codeShift+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 Secure Global Desktop 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 Secure Global Desktop. 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:

Related topics