Keyboard remapping lets you associate a sequence of keystrokes with a particular action, so that typing the sequence of keystrokes causes the action to occur. The sequence of keystrokes can be either a single key or a single key combined with Shift, Ctrl, or Alt. The action can be to display a character, to execute a host function, to execute a custom function, or to execute a menu command.
To access the Keyboard window, either click the Remap button on the toolbar, click Edit > Preferences > Keyboard, or click Keyboard in the session properties. The numberic keys 0-9 and * and # can be remapped.
This remainder of this help file contains the following subsections:
Assigning keys to functions
Assigning keys to custom functions
Assigning keys to applets
Assigning keys to macros
Duplicate key assignments
Searching for key assignments
Restoring key assignments
Restrictions on key remapping
APL keyboard support
The current keyboard definition in your session is selected by default. In order to open a keyboard or toolbar definition file, it must have been previously saved to a drive (shared or local) to which you have access. For more information, refer to Opening Keyboard, Popup Keypad and Toolbar configuration components.
When you select a category, the specific functions within that category appear in the table below, along with the keys assigned to those functions. Select a function in this table to change its key assignment. Refer to Default Characters and Functions for more information.
|Note that if the administrator has disabled Edit Keyboard Mappings, the only available button on this screen will be Search for Key.|
To assign or reassign a key to a function:
|You can assign a key combination to a function using the Alt, Ctrl, and Shift keys (for example, Alt+F1 or Ctrl+Alt+Q). If your browser is a version of Netscape earlier than 6.x, you might experience problems attempting to assign a key combination to a function using the Alt key. If this happens, you should not use Alt in key combinations.|
|If the key has already been assigned to a function, you will be shown the function that the key is assigned to and told to unassign the key first.|
If you want to assign a key or key combination to a custom function that is not currently listed in Keyboard Remap under the Custom Functions category, you can define these functions using the Custom Function Editor. When you do this, the Custom Functions category will appear with your newly defined functions, which can then be assigned to any key. Complete the assignment by following the steps for Assigning keys to functions, choosing Custom Functions as the category.
You can optionally define a custom function in the HTML or Java script file used to start the sessions. See adding additional HTML parameters for more information.
To assign or reassign a key to an applet, you must first run the applet:
The applet is now available for a key assignment.
|This feature only applies to Z and I Emulator for Web clients running with a Java Plug-in of 1.8 or newer (or Java Plug-in 8 or newer on Macintosh clients). Refer Restrictions on key remapping for additional restrictions.|
Duplicate keys on a keyboard can be assigned to independent functions. Duplicate keys include keys like Shift or Ctrl that occur in multiple places on the keyboard. To assign unique mappings for duplicate keys, follow the steps for Assigning keys to functions.
This support does not affect keys used as modifiers. If you use Ctrl, Alt, Shift or Meta in combination with another key, then no key location is processed with regard to the modifier. For example, for the key combination Shift+Enter, the location of the Shift key is disregarded. Therefore, the right or left Shift keys both act in the same manner for this combination, since the Shift key is defined as the modifier.
|Administrators can use the Deployment Wizard to directly modify properties
of sessions that have been defined for HTML model pages. If the administrator uses
the Deployment Wizard to modify keyboard properties, then the following
should be noted:
To undo an assignment of a key to a function, select the function, and then click Unassign Key.
To find out if a key has already been assigned to a function:
If there is that key has already been assigned a function, that function will appear highlighted along with its assigned key. If no function is assigned to that key, a "Not Assigned" message will appear.
To restore a previously reassigned key to its default assignment:
To restore all keys to their default assignments, click Reset All.
|The Ctrl key is mapped to the Enter function by default for the 3270 and 5250 emulators. Because Java does not distinguish between left and right Ctrl keys, this change means that both Ctrl keys now act as Enter. You can still remap Ctrl or use it in combination with another key, and you can still remap the Enter function to any other key.|
Please note the following restrictions on key remapping:
When using Java 2 with Z and I Emulator for Web, the Ctrl-Tab and the Ctrl-Shift-Tab key combinations cannot be remapped. With Java 2, these key combinations are consumed by the Java Focus Manager and are not returned to Z and I Emulator for Web for processing.
Certain key combinations are treated in a similar fashion and cannot be assigned to different keyboard functions.
Duplicate key support only applies to Z and I Emulator for Web clients running with a Java Plug-in of 1.8 or newer. Macintosh clients require a JRE of version 1.8 or newer for duplicate key support. If the JRE is lesser than version 1.8, it does not recognize the locations of keys on the keyboard.
For JREs older than version 1.8, key events, such as key pressed and key
released, are dependent upon the operating system and keyboard layout of the
machine where they are processed. The JRE makes no distinction between the
Duplicate key support does not affect keys used as modifiers. If you use Ctrl, Alt, Shift or Meta in combination with another key, then no key location is processed with regard to the modifier. A Z and I Emulator for Web user or administrator cannot assign different key remapping functions to the following:
The JRE processes these key combinations as the same key event. For example, if since Right Ctrl+P is processed in the same way as Left Ctrl+P by the JRE, then these key combinations cannot be assigned to different key remapping functions in Z and I Emulator for Web.
If you reassign a duplicate key that is a left Shift/Ctrl/Alt/Meta key or a numpad key, and you bring up Z and I Emulator for Web in a previous Java release, you will receive an Unknown key code message.
Some duplicate keys do not appear on all keyboards, however, Java is not
capable of testing to see if a particular key exists. Therefore, the key
remapping facility might have default assignments for keys that do not exist
on your keyboard. You can delete these key remaps, but you will not be
able to reassign them.
When you are mapping keys as an administrator, keep in mind that some clients might not have the same keyboard layout that you do (for example, the user may lack the Meta Key or Command key on Macintosh). Plan your mappings accordingly, otherwise clients might not be able to use some of the default mappings.
By default, Z and I Emulator for Web now provides APL keyboard support. Prior to this, APL keyboard support was provided by running customized applet in Z and I Emulator for Web. In this case, you need to write the applet that contains your mapping for APL keys. With this new enhancement, you no longer need to do this. The APL support in Z and I Emulator for Web is similar to what is provided with HCL Z and I Emulator for Windows. APL keyboard can be enabled or disabled by pressing Ctrl+F8. APL support is meant only for 3270 sessions.
Z and I Emulator for Web supports 3278 APL Extended Character Code along with 3270 APL Characters for 3270 Display sessions.
Configuration: The ExtendedAPL applet that has the mappings for 3278 APL Extended Character Set can be added to the session at startup. You can perform the following tasks:
To run this applet after the session has been started,you can select Actions > Run applet from the session menu and type com.ibm.eNetwork.HOD.applet.ExtendedAPL as the name of the applet.
To run this applet in WCT, you need to add the hodappln2.jar (or hodappl2.jar if the problem determination is enabled) user as the User Jar file when creating the plugin.
|Note: The addition of 3278 APL Extended Character Code does not affect the existing 3270 APL functions, which can be enabled using the Ctrl+F8 key combination.|
This support is available only for the Type 3 APL keyboard layout. (It is not available for codepages in BIDI, Thai, and Hindi.)
Follow the steps below to configure the Regional and Language settings of the system:
When the ExtendedAPL applet is running, the Ctrl+F11 key combination is always used to enable and disable Extended APL mode, and any action assigned to this combination in keyremap will be ignored.