This document explains which information can be modified in a .key file.
The tables directory of Entire Connection contains several .key files for protocol converters. Select the .key file that is most compatible with your protocol converter. Check whether the entries in this file correspond to the escape sequences required by your protocol converter (see the documentation for your protocol converter). Use only the VT100 escape sequences.
Among others, the following .key files are copied to your hard disk during installation:
| File | Description |
|---|---|
| Bb.key | Brown's Box |
| I3708.key | IBM 3708 |
| I71.key | IBM 7171 |
| Ldi.key | Local Data InterLynx |
| M80.key | MaComm MDS 8070 |
| Mic.key | MiCom |
| Pci.key | PCI 1071 |
| Prot.key | Default used in share file |
| Renex.key | Renex |
| Sitin.key | SitIntel |
| Tnt.key | Telenet Network Version of Local Data |
During installation, the file Ldi.key (see below) is copied to your hard disk. This sample .key file consists of several columns:
First column: identifies the terminal function key to be defined.
Second column: XCLOCK indicates that the key will wait
for a response from the host or protocol converter before allowing additional
input from the keyboard.
Third column: KEYRESET indicates that the keyboard is
reset when insert mode is switched on.
Fourth column: contains the escape sequence assigned to the terminal function key.
Important:
The only data in a key file that should be
modified are the data contained in the fourth column.
When modifying the data in column four, you can use the mnemonic names for the hexadecimal values X'00' through X'1F'. All escape sequences must be enclosed in single quotation marks; they are case-sensitive.
If your protocol converter does not support an entry in the key file, insert an asterisk (*) in the first position of the corresponding line. This entry will then be ignored.
If the key file you select contains an asterisk (*) in front of an entry required by your protocol converter, you must remove the asterisk and replace the question marks in column four with the required escape sequence.
* ldi.key
* (C)Copyright Software AG 1993-1999
* terminal emulation function key table for Local Data InterLynx
* and similar Protocol Converters.
*
* DO NOT change the keyword line below ("WiTeKeyTable PROT"):
*
* If you have to change the table in the share file, modify this
* file (or one of the others which is closer to your needs) and
* import the table using the Entire Connection configuration manager.
WiTeKeyTable PROT
* set vtkey attn type ????????
set vtkey backspace type esc '[D'
set vtkey backtab type BS
set vtkey break type cr
set vtkey clear xclock keyreset type esc 'Om'
set vtkey cr xclock keyreset type cr
set vtkey delete type DEL
set vtkey devcncl type esc ']'
set vtkey down type esc '[B'
set vtkey dup type esc 'Ov'
set vtkey eeof type esc 'Ot'
set vtkey eraseinp type esc 'Ow'
set vtkey fldmark type esc 'Ol'
set vtkey home type esc 'Op'
set vtkey icr keyreset type cr
* set vtkey ident type ????????
set vtkey insert type esc 'On'
set vtkey left type esc '[D'
set vtkey newline type LF
set vtkey pa1 xclock keyreset type esc 'Oq'
set vtkey pa2 xclock keyreset type esc 'Or'
set vtkey pa3 xclock keyreset type esc 'Os'
set vtkey pf1 xclock keyreset type esc '1'
set vtkey pf10 xclock keyreset type esc '0'
set vtkey pf11 xclock keyreset type esc '!'
set vtkey pf12 xclock keyreset type esc '@'
set vtkey pf13 xclock keyreset type esc '#'
set vtkey pf14 xclock keyreset type esc '$'
set vtkey pf15 xclock keyreset type esc '%'
set vtkey pf16 xclock keyreset type esc '^'
set vtkey pf17 xclock keyreset type esc '&'
set vtkey pf18 xclock keyreset type esc '*'
set vtkey pf19 xclock keyreset type esc '('
set vtkey pf2 xclock keyreset type esc '2'
set vtkey pf20 xclock keyreset type esc ')'
set vtkey pf21 xclock keyreset type esc esc '1'
set vtkey pf22 xclock keyreset type esc esc '2'
set vtkey pf23 xclock keyreset type esc esc '3'
set vtkey pf24 xclock keyreset type esc esc '4'
set vtkey pf3 xclock keyreset type esc '3'
set vtkey pf4 xclock keyreset type esc '4'
set vtkey pf5 xclock keyreset type esc '5'
set vtkey pf6 xclock keyreset type esc '6'
set vtkey pf7 xclock keyreset type esc '7'
set vtkey pf8 xclock keyreset type esc '8'
set vtkey pf9 xclock keyreset type esc '9'
set vtkey por keyreset type esc '<'
set vtkey print type esc 'Ox'
set vtkey refresh keyreset type ^w
set vtkey reset keyreset type DC2
set vtkey right type esc '[C'
* set vtkey sysreq type ????????
set vtkey tab type tab
set vtkey test xclock keyreset type esc 'Oy'
set vtkey up type esc '[A'
set vtkey vtdisc type esc '~'
set vtkey vtinit type esc '<'
The following entries in a .key file have special meanings:
| Entry | Description |
|---|---|
BREAK
|
Send a break signal only (data are not sent). You can specify a value for the length of the break. |
CR
|
Carriage return - required by Entire Connection when performing file transfers. |
HOME
|
Required by Entire Connection when performing data transfers. |
ICR
|
Immediate Carriage Return - similar to the CR
entry except that ICR does not wait for a response from the
mainframe or protocol converter. This entry is frequently used when
establishing communications.
|
POR
|
Simulate a power-on-reset function. It is possible that the required escape sequence is not supported by your protocol converter, or that it can only be invoked from the main menu of the protocol converter. |
REFRESH
|
Inform the protocol converter that the screen display needs to be refreshed. |
VTDISC
|
VT disconnect - terminate the connection with the protocol converter. |
VTINIT
|
VT initialize - establish a connection with the protocol converter. |
The following table contains all allowed mnemonic names for the hexadecimal values X'00' through X'1F'. The columns labeled "Alternative 1" and "Alternative 2" contain additional mnemonic names that can be used to transmit a particular hexadecimal value.
Note:
The caret (^) symbol is the internal representation for the
CTRL key.
| Hex. Value | Mnemonic Name | Alternative 1 | Alternative 2 |
|---|---|---|---|
| X'00' | ^@ | NUL | |
| X'01' | ^A | SOH | |
| X'02' | ^B | STX | |
| X'03' | ^C | ETX | |
| X'04' | ^D | EOT | |
| X'05' | ^E | ENQ | |
| X'06' | ^F | ACK | |
| X'07' | ^G | BEL | |
| X'08' | ^H | BS | |
| X'09' | ^I | HT | |
| X'0A' | ^J | LF | |
| X'0B' | ^K | VT | |
| X'0C' | ^L | FF | |
| X'0D' | ^M | CR | |
| X'0E' | ^N | SO | |
| X'0F' | ^O | SI | |
| X'10' | ^P | DLE | |
| X'11' | ^Q | DC1 | XON |
| X'12' | ^R | DC2 | |
| X'13' | ^S | DC3 | XOFF |
| X'14' | ^T | DC4 | |
| X'15' | ^U | NAK | |
| X'16' | ^V | SYN | |
| X'17' | ^W | ETB | |
| X'18' | ^X | CAN | |
| X'19' | ^Y | EM | |
| X'1A' | ^Z | SUB | |
| X'1B' | ^[ | ESC | |
| X'1C' | ^\ | FS | |
| X'1D' | ^] | GS | |
| X'1E' | ^^ | RS | |
| X'1F' | ^_ | US |