JET 3270 Documentation
JET 3270 2.4E     Reference - Preferences
 
Table of Contents
Previous
Next

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.

Default Keyboard Mapping

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
  • caps_lock
  • down
  • end
  • f1
  • f2
  • f3
  • f4
  • f5
  • f6
  • f7
  • f8
  • f9
  • f10
  • f11
  • f12
  • home
  • insert
  • left
  • num_lock
  • pause
  • pgdn
  • pgup
  • print_screen
  • right
  • scroll_lock
  • up

Table of Contents | Previous | Next
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.