Use this task to edit the &console;'s 3270 emulator keymap.
To change the default keyboard key mapping for your preference, edit the keymap.
When you edit the keymap for the first time the new keymap defaults to a mapping that resembles the default keymap for the IBM Personal Communications (PCOM) emulator. You can keep these settings or modify them.
However, before modifying the keymap, you should familiarize yourself with the keymap syntax rules. Refer to http://x3270.bgp.nu for general information on the 3270 emulator and http://x3270.bgp.nu/Keymap.html for documentation on how to create a custom keymap. The key points include:
A general overview of the keymap syntax rules include:
x3270.keymap.hmc: #override
where:
hmc is the keymap name you will use for the console. This line must not change.
modifier <Key> keysym : Action(args)\n\
where:
modifier is an optional keyboard modifier like Ctrl or Shift
keysym is an X11 keysym: a symbolic name for a key, like Prior (the Page Up Key)
Action is an x3270 action such as Enter() or PF(7)
args are optional action arguments, such as the number of a PF key, like PF(7).
Note: | These lines must end with the characters \n\. |
To find out what keysyms are generated for any given key on your keyboard, start a 3270 Emulator session. Then select the File->Trace Keyboard and Mouse Events menu option, and click No File in the pop-up window. An xterm window appears. Click on the 3270 session window to bring it back to the forefront. Each time you press a key in the 3270 session window, several lines appear in the xterm window. The text enclosed in single quotes after the word "Event" is the keysym for the key(s) you pressed, and the text after the "->" is the current action defined for the key(s). Refer to http://x3270.bgp.nu/x3270-man.html#actions for a list of actions you can use in your keymap.
Once you have completed editing the keymap, click OK to save the keymap. Some syntax checking is performed by this task to ensure the syntax has been followed as outlined above. Test any specific keysym changes you made to ensure they are working as you prefer. To test your changes, follow the instructions above to see what actions are generated for the keysyms you specifically changed. If changes you made are not working as expected, you should check that the emulator has accepted all your keysym mappings by selecting the Options->Display Current Keymap menu option. This will open the x3270 Keymap window. Scroll down to find the hmc keymap and its keysym mappings. If any keysyms you changed are not displayed, this means the emulator found a problem with that keysym syntax, the keysym or the action specified. You should edit the hmc keymap again, review this keysym mapping, make corrections as needed and test the changes again.
To completely remove this hmc keymap definition, delete the syntax from the input area and click OK. To add this hmc keymap definition again with its original syntax, start the entire process again once you have removed the definition.
These keymap settings will be saved as part of the Save Upgrade Data task so that you can preserve them across console upgrades.
When you finish editing the keymap, click OK to save the keymap. To make the new settings take effect:
You can find more detailed help on the following elements of this window: