Keyboard
Overview
Introduction
Some of the keys on a 3270 terminal are not present on most computer
and workstation keyboards. When a key or key combination is pressed on
your keyboard JET 3270 can emulate the effect of a different
key from a 3270 terminal being pressed. JET 3270 is said to
"map" the keyboard key to the 3270 terminal key. JET
3270 can also run a script when a key or key combination is
pressed. In this case JET 3270 maps the keyboard key to the
script. The set of all maps
from keyboard keys to 3270 terminal keys or scripts is
called a "keyboard
mapping". JET 3270 allows the user to configure its keyboard
mapping from the Preference menu and using applet parameters.
As a Java applet JET does not access the keyboard
directly. When you press a key the browser will interpret the key and
usually pass an "Input Event" to JET. However, sometimes the
operating system or browser interprets the key as having meaning to
itself or as illegal and does not pass it to JET. For
example, when running JET in Microsoft Internet Explorer
under Windows 95, Alt-F6 is interpreted by Windows 95 as a
request to switch windows and is not passed to
JET. Furthermore, the same key combinations can produce
different Input Events on different operating systems or browsers. For
this reason JET 3270 maps from Input Events, not actual
keyboard combinations, to 3270 keys and scripts.
The relationship between keys or
key combinations on your keyboard and the Input Events they produce
can depend on your operating system and browser and sometimes is not
obvious. Information regarding some browsers and operating systems is
provided below.
The default keyboard mapping is shown in the table below. Note that
several Input Events can map to the same 3270 key. The table has a row
for each 3270 key which lists the Input Events which map to that 3270
key.
| 3270 Key |
Input Events |
Key combinations
that usually generate Input Events (if not the same) |
| PF1 |
F1 |
| PF2 |
F2 |
| PF3 |
F3 |
| PF4 |
F4 |
| PF5 |
F5 |
| PF6 |
F6 |
| PF7 |
F7 |
| PF8 |
F8 |
| PF9 |
F9 |
| PF10 |
F10 |
| PF11 |
F11 Ctrl-F1 |
| PF12 |
F12 Ctrl-F2 |
| PF13 |
Shift-F1 |
| PF14 |
Shift-F2 |
| PF15 |
Shift-F3 |
| PF16 |
Shift-F4 |
| PF17 |
Shift-F5 |
| PF18 |
Shift-F6 |
| PF19 |
Shift-F7 |
| PF20 |
Shift-F8 |
| PF21 |
Shift-F9 |
| PF22 |
Shift-F10 |
| PF23 |
Ctrl-Shift-F1 Shift-F11 |
| PF24 |
Ctrl-Shift-F2 Shift-F12 |
| PA1 |
Pgup
Alt-Insert |
| PA2 |
Pgdn
Alt-Home |
| PA3 |
Shift-Pgup |
| Attn |
001B Ctrl-0003 Alt-a
Meta-a |
Esc Ctrl-C |
| Backspace |
none |
| Backtab |
Shift-0009 |
Shift-Tab |
| Clear |
Pause |
| Cursor Up |
Up
Shift-Up |
| Cursor Down |
Down
Shift-Down |
| Cursor Right |
Right
Shift-Right |
| Cursor Left |
Left
Shift-Left |
| Delete |
007F |
Delete |
| Destructive
Backspace |
Ctrl-0008 0008 |
Backspace |
| Dup |
Shift-Insert Alt-d
Meta-d |
| Enter |
000A |
Enter |
| Erase Eof |
End |
| Erase Input |
Alt-End
Ctrl-Shift-End |
| Fast Down |
Alt-Down |
| Fast Left |
Alt-Left |
| Fast Right |
Alt-Right |
| Fast Up |
Alt-Up |
| Field Mark |
Shift-Home Alt-f
Meta-f |
| Home |
Home |
| Insert Mode |
Insert |
| New Line |
Shift-000A |
Shift-Enter |
| Reset |
Alt-r Meta-r |
| Tab |
0009 |
Tab |
| Reconnect |
none |
| Disconnect |
none |
| Clear Selection |
none |
| Copy |
Alt-c Meta-c Alt-008D Meta-008D |
| Cut |
Alt-x Meta-x Alt-Å Meta-Å |
| Paste |
Meta-v Alt-Ã Alt-v Meta-Ã |
| Ignore |
0000 Caps Lock
Num Lock |
(Note 1) |
Note 1: See below for details of which key combinations generate the
Input Event 0000.
The default keyboard mapping also includes mappings from all of the
Input Events that contain graphic characters (for example, letters,
digits, punctuation and the space) to the 3270 key for that graphic
character.
Netscape Communicator
and Windows 95
Some of the details of what Input Events Netscape Communicator
4.5 running under Windows 95 passes to JET 3270 are
described below.
Print Screen and combinations including it
are not passed.
Ctrl key combinations with numbers and symbols are generally passed as
the same input event, Ctrl-0000. However, if the combination would
produce a control code on a standard ASCII terminal then it is passed
as a unique input event. These combinations are Ctrl-\, Ctrl-[,
Ctrl-], Ctrl-^ (i.e. Ctrl-Shift-6) and Ctrl-_ (i.e. Ctrl-Shift-'-').
Windows key combinations are passed with a base character name of
0000. They are also interpretted by Window 95, causing the Start menu
to be displayed. Menu key combinations are passed with a base
character name of 0000. When Num Lock is off the 5 key on the numeric
keypad and key combinations including it are passed with a base
character name of 0000.
Alt-F6 is caught by Windows 95 and switches between
multiple windows in the same program, it is not
passed to JET 3270.
Alt-Tab is caught by Windows 95 and switches to the window
you last used, it is not passed to JET 3270.
Alt-Esc is caught by Windows 95 and puts the current window
at the back, it is not passed to JET 3270.
Microsoft Internet Explorer 4.01 and Windows 95
Some of the details of what Input Events Microsoft Internet Explorer
4.01 running under Windows 95 passes to JET 3270 are described below.
Print Screen and combinations including it are not passed.
Ctrl key combinations with numbers and symbols are generally passed as
the same input event, Ctrl-0000. However, if the combination would
produce a control code on a standard ASCII terminal then it is passed
as a unique input event. These combinations are Ctrl-\, Ctrl-[,
Ctrl-], Ctrl-^ (i.e. Ctrl-Shift-6) and Ctrl-_ (i.e. Ctrl-Shift-'-').
Ctrl-Esc and Ctrl-Shift-Esc bring up the Windows 95 Start menu and are
not passed.
Alt key combinations with letters, except d, either pop up an Internet
Explorer menu (a, e, f, g, h, v) or cause Internet Explorer to beep
(other letters) and in both cases are passed. Alt-d highlights
Internet Explorer's Address field and is not passed.
Alt-space pops up the Internet Explorer window menu and is passed.
Alt key combinations with numbers and symbols cause Internet Explorer
to beep and are passed.
Alt-F4 will exit Internet Explorer and JET 3270.
Alt-F6 is caught by Windows 95 and switches between multiple windows
in the same program, it is not passed.
Alt key combinations with the left and right cursor keys and the
numeric keypad left and right cursor keys are caught be Internet
Explorer and moves back or forward one page, they are not passed.
Alt-Tab is caught by Windows 95 and switches to the window you last
used, it is not passed.
Alt-Esc is caught by Windows 95 and puts the current window
at the back, it is not passed.
Alt key combinations with numeric keypad digits are all passed the
same input event, Alt-0000.
Details
This section describes the use of applet parameters to
configure keyboard mapping.
Applet parameters can specify the Input Events mapping to a
3270 key. They can also specify a script and the Input
Events mapping to it.
However, if the saved preferences file
specifies keyboard preferences come from those the user chooses on
the Change Preference Set screen then
these applet parameters will be ignored.
Applet parameters for
3270 keys
have the following form:
<name="key_for_3270_key_name"
value="input_event_name input_event_name
...">
The 3270 key names are composed of lower case letters,
digits, hyphens and underscores. There are two sorts of
3270 keys, control keys and graphic character keys. The names
of the control keys are listed in the table at the end of
this section. The name of a graphic character key is the
graphic character's Unicode 2.0 name (in lower case with
underscores instead of spaces). See Unicode Character Names for a
list of these names. Only 3270 graphic character keys with
Unicode codes less than 256 (decimal) can be specified in
applet parameters.
The value for the keyboard mapping applet parameter is
a space separated list of Input Event names. If the value
is empty (i.e. value="") then no Input Events will map to
the 3270 key.
Applet parameters for script keys have the following form:
<name="script_key_n"
value="script_url input_event_name
input_event_name ...">
The index n is an integer greater than or equal to 1. Each
script key applet parameter must have a diffent index.
The index of the last script key must be specified by an
applet parameter with the following form:
<name="last_script_key" value="last_index">
The value for a script key applet parameter is a script
URL, a space and a space seperated list of Input Event names.
The script
URL is a http: or file: URL of a plain text script file. See
Script files for information on
script files.
In applet parameters for both 3270 keys and script keys the
Input Event names have the following
form:
modifiers_string-base_action_character_name
The modifiers string represents a combination of Alt,
Meta, Shift and Ctrl keys. For each key depressed a single
lower case letter appears in the modifiers string as follows:
a for Alt
m for Meta
s for Shift
c for Ctrl
If no modifier keys were depressed the
modifiers_string is empty, but the hyphen
separating it from the base action/character name must
still be present.
The base action/character name represents either the
action key that was pressed or the character code that the
key combination produced. It is composed of lower case
letters, digits, hyphens and underscores. Action keys
include the cursor and function keys. Base action key
names are listed in a table at the end of this section.
Base character names can be either the Unicode 2.0 name
for the character or the four digit hexadecimal code for the
character. The Unicode names are in lower case with
underscores instead of spaces and can only be used for
characters with Unicode codes less than 256 (decimal). See
Unicode Character Names for a
list of these names. If the hexadecimal code is used four
hexadecimal digits must be specified.
3270 control key names for use in applet
parameter names
- attn
- backspace
- backtab
- clear_selection
- clear
- close
- copy
- cursor_down
- cursor_left
- cursor_right
- cursor_up
- cut
- delete
- destructive_backspace
- disconnect
|
- dup
- enter
- erase_eof
- erase_input
- fast_down
- fast_left
- fast_right
- fast_up
- field_mark
- home
- ignore
- insert_mode
- new_line
- pa1
- pa2
|
- pa3
- paste
- pf1
- pf2
- pf3
- pf4
- pf5
- pf6
- pf7
- pf8
- pf9
- pf10
- pf11
- pf12
- pf13
|
- pf14
- pf15
- pf16
- pf17
- pf18
- pf19
- pf20
- pf21
- pf22
- pf23
- pf24
- reconnect
- reset
- tab
|
Base action key names for use in applet
parameter values
|
|
|
|
- home
- insert
- left
- num_lock
- pause
|
- pgdn
- pgup
- print_screen
- right
- scroll_lock
- up
|