On the command line, you create a character application object with the tarantella object new_charapp command. You can also create multiple character application objects at the same time with the tarantella object script command. See Section 3.1.5, “Populating the SGD Organizational Hierarchy Using a Batch Script”.

Character application objects can only be created in the o=applications organizational hierarchy.

The emulators have built-in keyboard maps, which are equivalent to the following sample keymap files in the /opt/tarantella/etc/data/keymaps directory:

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, or keys, that the user presses on the client device, and Translation is the keystroke, or keystrokes, 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 to the application server.

You can send complete strings on a single key press, by surrounding the string in straight quotation marks. 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, such as 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~"

To specify your own keyboard map for a character application, use the following command:

$ tarantella object edit --name obj --keymap keymap

where obj is the character application object and keymap is the path name of a keyboard map file.

You can use a full path name or a relative path name. Relative path names are relative to the /opt/tarantella/etc/data/keymaps directory.

For example, the following example uses the named keyboard map, which is stored in /opt/tarantella/etc/data/keymaps.

$ tarantella object edit --name obj --keymap mykeymap.txt

The following are lists of key names that are valid in SGD keyboard maps. The Section 4.4.2.4, “Client Device Keys” 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 Section 4.4.2.5, “Application Server Keystrokes”, which are the keystrokes ultimately sent to the application on the application server.

SGD supports the following keys on the user's client device:

The following application server keystrokes are supported for SCO Console applications:

The following application server keystrokes are supported for VT420 applications:

The following application server keystrokes are supported for Wyse 60 applications:

The SGD attribute maps enable you to map the following attributes:

To map combinations of attributes, separate the attributes with the plus sign +, for example, Bold+Underline.

To display colors in the terminal emulators, SGD maps logical colors to RGB values. For example, the logical color Color_9 maps to the RGB value 128 0 0 (red).

When mapping attributes to colors in your attribute map, specify the logical color name. For example:

For a complete list of logical color to RGB value mappings, refer to the comments in attrmap.txt.

You can change the default color mappings by editing the color map used by the terminal emulators. See Section 4.4.4, “Terminal Emulator Color Maps”.