filename.iomap-file

Definition/Access: General, Releases: AP

Used by 'set-iomap' for keyboard input and output translation.

Description

defines the one-to-one keyboard input and output translation used by the 'set-iomap' command. The data section of the file contains items that define the character translation. The dictionary level contains binary items which are compiled by the 'set-iomap' program when used with the 'c' option. The items in the dictionary have the same item-id's as the corresponding items in the data section, except that the (dictionary) items are preceded and followed by a '%'.

Each item in the data section contains up to 33 attributes. Attribute 1 is used for comments. Attributes 2 through 33 contain data for the actual character translation. Each attribute consists of 8 characters (32 x 8 = 256, the number of characters in the ASCII set). ASCII characters 0 through 7 (in hex) are stored in attribute 2. Characters 8 through 16 are stored in attribute 3, and so on. The 'set-iomap' program reads a specified item from the 'iomap-file' and converts the ASCII characters into binary equivalents, then writes the item to the dictionary level of the 'iomap-file'.

Example

set-iomap 1234 (c
Assuming that there was an item in the 'iomap-file' that contained
the following:

item-id: 1234

Attr# Contents

1 this is just a comment
2 0001020304050607
3 08090a0b0c0d0e0f
.
.
.
9 6061626364656667
10 68696a6b6c6d6e6f
11 7071727374757677
12 78797a7b7c7d7e7f
.
.
.
33 f8f9fafbfcfdfeff

This translates the characters 'A' through 'Z' into
'a' through 'z'. All other characters remain the same. The
resulting item, '%1234%' would then be written to the dictionary of
the 'iomap-file'.

See Also

Command Name Type Description
tcl.set-iomap Verb: Access PC/OA setting keyboard for all serial lines.
filename.keyboards Definition Defines keyboard layouts.
ascii Definition Definition of ASCII.
tcl.set-imap Verb: Access Sets a input/output translation table.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.