Secure Global Desktop 4.40 Administration Guide > Applications, Documents, and Application Servers > 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.
The emulators have built-in keyboard maps, which are equivalent to
the following sample keymap files in the /opt/tarantella/etc/data/keymaps
directory:
ansikey.txt
for the SCO Console emulatorvt420key.txt
for the VT420 emulatorw60key.txt
for the Wyse 60 emulatorNote 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.
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:
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 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:
F1="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:
Shift+NUMLOCK=INSLINE Shift+F1="\0330a" Alt+Shift+Control+DELETE="\003[33~"
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.
SCO Console:
VT420:
Wyse 60:
Copyright © 1997-2007 Sun Microsystems, Inc. All rights reserved.