Skip past navigation linksSecure Global Desktop 4.40 Administration Guide > Applications, Documents, and Application Servers > Terminal Emulator Keyboard Maps

Terminal Emulator Keyboard Maps

The SGD 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 the following sample keymap files in the /opt/tarantella/etc/data/keymaps directory:

Note Modifying these keyboard maps does not alter the default mappings used by SGD. 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, make a copy of one of the sample keyboard map files, 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 the Page Down key the emulator sends the keystroke Next to the application server.

If a particular key has a user-defined mapping, the default settings are 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 are lists of key names that are valid in SGD keyboard maps. The first list 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 lists, 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 SGD. 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