Secure Global Desktop Administration Guide > Applications, documents and hosts > 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.
The emulators have built-in keyboard maps, which are equivalent to
those found in the sample keymap files in
/opt/tarantella/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 Secure Global Desktop. 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, 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:
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 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.
SCO Console:
VT420:
Wyse 60:
Copyright © 1997-2006 Sun Microsystems, Inc. All rights reserved.