Ref: 11020023
Title: Defining Keys in 3VT under 3+Open TCP
Date: 12/13/90

Copyright 3Com Corporation, 1991.  All rights reserved.

The following article describes how to redefine keys in 3+Open
TCP.  It is intended for the VT user who may want to redefine
the keyboard.

Before you begin, you must know either the hexadecimal code or
the escape code for the character(s) you are mapping.  In the 3+Open
VT User Guide, Appendix A contains hex codes in logical order (table A-1)
and in numerical order (table A-2).  For example, to remap the F1 key to a
lowercase a, you would need to know that its hex value is 61.  (Note that
uppercase A has a different hex value, which is 41.)


METHOD 1

To define a key using the hexadecimal code, boot 3+Open TCP and follow
these steps:

1.  At the system prompt, type 3VT and press Return.

2.  Press F7 to get to the keyboard definition screen.

3.  Arrow down to the DEFINE area and type the key you want to
define inside angle brackets.  For example, to define F1, type <F1>.

4.  Press the right arrow to get to the AS area and type the hex value
for the string you want to define.  For example, to define F1 as the
letter "a," type 61.

5.  Press F2 to save the string temporarily into memory.

At the bottom of the screen, this message will appear:  "The previous
definition has been replaced."

6.  Arrow down to WRITE KEYBOARD DEFINITION FILE: and type in a name for
the new file, such as TEST.

7.  Press F2 to save the definition permanently in a keyboard file for
future use.

At the bottom of the screen, this message will appear: "Reading keyboard
definition file."

8.  Arrow up to READ KEYBOARD DEFINITION FILE: and type the name of your
keyboard definition file.

3VT is now using the new keyboard definition.

Note:  When you remap the function keys, you will find that any keyboard
definitions you make for those keys will not operate with the new definition
while you are using one of the 3+Open VT menus.  The 3+Open VT menus are
hardcoded as F1=help, F2=do, F3=connect, F4=script, F5=configure,
F6=transfer, F7=Keyboard, F8=print, F9=files, and F10=exit.


METHOD 2

If you know only the escape sequence, but not the hex equivalent of what
you want to define, you can determine the hex value of the escape sequence
by looking up each part of the escape sequence in the tables in Appendix A
of the 3+Open VT User Guide.  For example, to remap F1 to PA1, which has an
escape sequence of esc?q, you would find the hex value for ESC, which is 1B,
and the hex value of ?, which is 3F, and finally the hex value for q, which
is 71.

To use more than one hex value, enclose each one in angle brackets.

1.  At the system prompt, type 3VT and press Return.

2.  Press F7 to get to the keyboard definition screen.

3.  Arrow down to the DEFINE area and type the key you want to define; for
example, F1.

4.  Press the right arrow to get to the AS area and type in <1B><3F><71>.

5.  Press F2 to save the definition temporarily into memory.

At the bottom of the screen, this message will appear: "The previous
definition has been replaced."

6.  Arrow down to WRITE KEYBOARD DEFINITION FILE: and type in a name for
the new file, such as TEST2.

7.  Press F2 to save the definition permanently in a keyboard file for
future use.

At the bottom of the screen, this message will appear: "Reading keyboard
definition file."

8.  Arrow up to READ KEYBOARD DEFINITION FILE: and type the name of your
keyboard definition file.

3VT is now using the new keyboard definition.

