tcl.set-iomap Verb: Access/TCL


Command tcl.set-iomap Verb: Access/TCL
Applicable release versions:
Category TCL (746)
Description allows translatable input and output for each port on the system.

"port.number" is the number of the port (or pib) for which a keyboard table is installed.

"id" is the four-character item-id of the user-defined keyboard item. It must be numeric, and is not required when used with any of the following combinations of options: "ir", "ri", "or" or "ro".

The Virtual software of Pick reads the keyboard item and passes it to the monitor. "id", the item-id, is copied to the ID field of the I/O table translate. The counter in the second field is incremented or decremented by one depending on the option. The character set is copied to the third field of the entry. Depending on the option specified by the user, either IT or OT pointer is replaced by the address of the entry. The new keyboard table overwrites the old one even if a match is found when comparing the new item-id with the one in the table.

Monitor notifies virtual if an installation is not possible and virtual, in turn, notifies users of such results.

There is a file in the "dm" account called "iomap-file". This file contains keyboard items that are defined by users. The item-id should be numeric and should be in the range of 0 <= item-id <= 2147483647. The keyboard item has 34 attributes and has the following format:

attr 0 : item-id

attr 1 : user comments

attr 2 to 33 : ASCII code of characters from 0 to 127 in ASCII hex format. For example: character 'A' has its ASCII code is x'41' and should be entered in the item as '41'. Each attribute from 2 to 33 has exactly 8 entries each. User can put his/her comments after the 8th entry on that attribute.

The following example shows how to translate the character 'A' to 'B':

- ASCII code of A is x'41' = d'65'

- ASCII code of B is x'42' = d'66'

- 65 mod 8 = 8 with remainder 1

- Translated character, which is B, should be entered at attribute 8+2= 10 and at column 1+1 as 42. The reason that 2 is added to 8 is because counting begins at 0 and attr 1 is used for comments.
Syntax set-iomap port.number{,id} ([i|o|ri|ro]
Options ? Provides on-line help

i Installs input keyboard.

o Installs output keyboard.

ir (or ri) Removes an installed input keyboard.

or (or ro) Removes an installed output keyboard.
Related tcl.set-imap