Keyboard Mapping for Web Applications

You can map your keyboard so specific workstation keyboard keys will function as terminal keys for a host application. Keyboard mapping is available for Java or .NET Web applications.

You can implement keyboard mapping after a project is built, or incorporate it into a User-Defined Project Type, which you can use to build subsequent Web applications using the same keyboard map.

Keyboard mapping requires the:

• Host Integrator model to be connected to either a 3270 or 5250 terminal
• Client has JavaScript enabled
• Terminal screen layout option to be selected on the Host Screen tab
• Always show AID keys option to be selected on the Page Layout tab

Each time you build a Web application, a default keyboard mapping is generated for 3270 and 5250 keyboards.

Default Settings:

Keyboard key	3270 Terminal Key	5250 Terminal Key
F1-F12	F1-F12	F1-F12
Shift + F1-F12	PF1-PF12	PF1-PF12
Scroll lock	Clear	Clear
Escape	Reset	Reset
Page Up	PA1	Page Up
Page Down	PA2	Page Down
KP Minus (5250 only)	n/a	Field Minus
KP Plus (5250 only)	n/a	Field Plus

To modify the keyboard mapping

Use the following information to edit the keyboard mapping for 3270 or 5250 host applications:

AidKey Class Constructor

• aidKey— The AidKey3270/5250.Codes enumeration to map to the terminal key
• key— The local keyboard Key.Codes enumeration to map to the terminal key
• keyModifier— The local keyboard Key.Modifiers enumerations are required when mapping the local key. The single modifier Key.Modifiers.SHIFT requires only the Shift key to be pressed. Multiple Key.Modifiers.SHIFT|Key.Modifiers.CTRL requires the Shift and Control keys to be pressed.

Using keyboard.js

The keyboard.js file defines the local keyboard code enumeration, Key.Codes, and the modifier key, Key.Modifiers:

Key.Modifiers = {
	NONE: 0,
	ALT:  1,
	CTRL:  2,
	SHIFT:  4,
	META:  8  //Windows or Apple Command keys
};

Key.Codes = {
	ESCAPE:  27,   //ESC
	F1:  112,
	F2:  113,
	F3:  114,
	F4:  115,
	F5:  116,
	F6:  117,
};

Using aidkeys_3270.js and aidkeys_5250.js

Both the aidkeys_3270.js and aidkeys_5250.js define the AidKeysxxxx.Codes as well as the mapping between the Aid keys and the local keyboard.

AidKey3270.Codes = {
	ATTN: 257,
	CLEAR:  277,
	SYSRQ:  504,
	RESET:  393,
};

To edit your keyboard mapping configuration

1. Open aidkeys_3270.js or aidkeys_5250.js (depending on your terminal type), in a text or JavaScript editor.

   To...	Do this....
   Modify a key	Find the entry in the Keyboard3270 or Keyboard5250 constructor. new AidKey (AidKey3270.Codes.PF1, Key.Codes.F1, Key.Modifiers.NONE) Modify the key or keyModifier parameter as needed. new AidKey (AidKey3270.Codes.PF1, Key.Codes.F1, Key.Modifiers.ALT)
   Add a key	At the end of the Keyboard3270 or Keyboard5250 constructor, add a new entry. new AidKey (AidKey3270.Codes.PA2, Key.Codes.PAGE_DOWN, Key.Modifiers.NONE), new AidKey (AidKey3270.Codes. SYSRQ, Key.Codes.PGUP, KeyModifiers.SHIFT) ));
   Remove a key	Remove the line that contains the Aid key you want to remove. For example, change this: new AidKey (AidKey3270.Codes.PF23, Key.Codes.F11, Key.Modifiers.SHIFT), new AidKey (AidKey3270.Codes.PF24, Key.Codes.F12, Key.Modifiers.SHIFT), new AidKey (AidKey3270.Codes.PA1, Key.Codes.PAGE_UP, KeyModifiers.NONE) To this: new AidKey (AidKey3270.Codes.PF23, Key.Codes.F11, Key.Modifiers.SHIFT), new AidKey (AidKey3270.Codes.PA1, Key.Codes.PAGE_UP, KeyModifiers.NONE)
   Troubleshoot a problem	Edit the browser.js file by setting the logging settings, located near the beginning of the file, to True. var LOGGER = true; var ERROR = true; var WARN = true; var INFO = true; var DEBUG = true; var TRACE = true; Set the logging setting back to False when you are finished testing.

2. Save your changes.