VMS Help TCPIP Services, TELNET, Redefining TN3270 Keyboard  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    You can reassign functions and keys.

    To redefine a keyboard key, use either of the following methods:

    o  Create a key definition file, a text file with individual
       key definitions in the form of DEFINE/KEY statements and
       DELETE/KEY statements.

    o  Use the DEF KEY function (see DEF KEY Function).

    The following example establishes a TELNET/TN3270 connection
    to host JUNCO. By default, the terminal functions as if it were
    an IBM-3278-2 model terminal. It uses your customized keyboard
    definition file NEW_KEYS.DAT.

    $ TN3270 JUNCO /KEY_DEFINITION=NEW_KEYS.DAT

    You can also reassign the following functions:

    o  All emulated functions

    o  Most IBM 3270 model functions

    o  All emulated alphanumeric and graphic characters

1 - Definable Keys

    The keys you can define are:

    Location                 Key Name

    Function keys            PF1-PF4
    (VT100 and VT200)

    Application keypad       KP0-KP9
    (VT100 and VT200)        ENTER
                             MINUS
                             COMMA
                             PERIOD

    Top-row function keys    F6-F20
    (VT200)                  HELP (F15)
                             DO (F16)

    Editing keypad (E1-E6)   FIND (E1)
    (VT200)                  INSERT_HERE (E2)
                             REMOVE (E3)
                             SELECT (E4)
                             PREV_SCREEN (E5)
                             NEXT_SCREEN (E6)

    Cursor keys              UP
    (VT100 and VT200)        DOWN
                             LEFT
                             RIGHT

    Control keys             Ctrl/A-Ctrl/Z, including:
    (VT100 and VT200)
                             Ctrl/H (BS)
                             Ctrl/I (HT)
                             Ctrl/J (LF)
                             Ctrl/M (CR)

                             Excluding:

                             Ctrl/Y-Interrupt
                             Ctrl/C-Cancel/interrupt
                             Ctrl/O-Output off/on
                             Ctrl/S-Suspend output
                             Ctrl/Q-Resume output

2 - Nondefinable Keys

    You cannot redefine the following DIGITAL-reserved keys:

    o  Ctrl/Y - Interrupt

    o  Ctrl/C - Cancel/interrupt

    o  Ctrl/O - Output off/on

    o  Ctrl/S - Suspend output

    o  Ctrl/Q - Resume output

    o  F1-F5

3 - Key Definition File

    Use the DEFINE/KEY and DELETE/KEY statements to create your own
    key definition file as described in the following sections.

    The DEFINE/KEY statement assigns a new function to a particular
    key. Its format is:

    DEFINE/KEY [/STATE=EXTEND] key_name function

    /STATE         Optional. Default: non-extend mode.
                   Redefines the key in extend mode.
    key_name       Standard key name on the DIGITAL terminal.
    function       TN3270 function you want mapped to this key.

    You can define most of the named keys both in normal (non-extend)
    mode and in extend mode.

    You can define the control keys (and the synonyms for them) only
    in normal mode. Do not specify the qualifier /STATE=EXTEND.

    The following example assigns the EXIT function to the key
    sequence EXT + Z :

    DEFINE/KEY/STATE=EXTEND "Z" EXIT

    The DELETE/KEY statement removes the function assigned to a
    particular key. Its format is:

    DELETE/KEY [/STATE=EXTEND] key_name

    /STATE         Optional. Default: nonextend mode. Deletes the key
                   in extend mode.
    key_name       Standard key name on the DIGITAL terminal.

4 - DEF KEY Function

    Use the DEF KEY function to define or redefine a key
    interactively. Your new definition exists until you log out from
    the remote host or disconnect from it.

    When you invoke the DEF KEY function, TN3270 displays a prompt
    in the status line at the bottom of your screen. What you enter
    during the DEF KEY dialog is subject to translation from the
    National Character Set to the DIGITAL Multinational Character
    Set.

    You cannot redefine a key that exists on your National Character
    Set terminal if it lacks a DIGITAL Multinational Character Set
    equivalent.