Files for keyboard and mouse settings

Overview: keyboard and mouse settings

Clicking a button in the emulation window can trigger diverse functions: a character is copied into an input field, another field is activated automatically, or a corresponding key code is transmitted to the host system.
Similar settings apply for using the mouse in the emulation window.

The keyboard and mouse settings can be customized as required.

• System administrators usually perform these customizations when configuring the system: from the default keyboard settings, administrators select the appropriate settings for their implementation and make them available for their users as keyboard files.
• From this list, users select only the keyboard file that is appropriate for their needs.
• If necessary, keyboard and mouse settings can be changed individually using the keyboard editor and then saved as keyboard files.

The structure of the settings file is described here for your reference. However, we recommend that you always make changes using the keyboard editor:

• It can be very time-consuming to completely re-assign the settings.
• You also require good knowledge of JavaScript and the LogWeb/Ajax API to do this.

Keyboard settings: lwk.userkeys

The files for keyboard settings define the associative array lwk.userkeys that assigns an action to each key.
Example:

• The 3270 configuration file 3270/keyboard/default.js contains the parameters:

  lwk.userkeys = {
     ...
     /////////////////////// 3270 standard host keys ///////////////////////////
  
     control:   'lwk.send("<ENTER>")',
     RETURN:    'lwk.goLineNext()',
     ...
     F1:        'lwk.send("<PF1>")',
     F2:        'lwk.send("<PF2>")',
     ...
     s_F1:      'lwk.send("<PF13>")',
     s_F2:      'lwk.send("<PF14>")',
     ...
  };
  

• If you also want to trigger the host function <ENTER> by pressing RETURN (and not only by pressing the CTRL key), you need to change the corresponding parameter to

     RETURN:    'lwk.send("<ENTER>")',
  

Note:

• Many keys of the block-oriented mainframe terminals 3270, 5250 and 9750 are configured with functions for controlling the cursor and editing text locally. You can also change this:

     ...
     // cursor: char
     left:        'lwk.goCharLeft()',
     right:       'lwk.goCharRight()',
     ...
     // cursor: word
     c_left:      'lwk.goWordLeft()',
     c_right:     'lwk.goWordRight()',
     ...
     // select: char
     s_left:      'lwk.selectCharLeft()',
     ...
  

• With the character-oriented UNIX terminals xterm, VT and 97801, the corresponding codes must be transmitted directly to the UNIX host. At the host, cursor movement and text processing can only be performed by the UNIX application. Therefore, you can only change the transmitted codes but you cannot call up local functions:

     ...
     /////////////////////// VT standard cursor ///////////////////////////
     pageup:     'lwv.key("<prev>")',
     pagedown:   'lwv.key("<next>")',
     insert:     'lwv.key("<insert>")',
     DELETE:     'lwv.key("<remove>")',
     ...
     left:       'lwv.key("<cub>")',
     right:      'lwv.key("<cuf>")',
     ...
  

• For the same reason, the clipboard functions COPY and PASTE on UNIX terminals are not assigned to the standard key combinations CTRL+C and CTRL+V on conventional computers but to SHIFT+CTRL+C and SHIFT+CTRL+V:

     ...
     // clipboard
     sc_c:     'lwk.copy()',          // copy selected text to clipboard
     sc_v:     'lwk.paste()',         // paste clipboard to host
     ...
  

  These settings can be changed if necessary.

     ...
     /////////////////////// VT CTRL keys: use shift+control  ///////////////////////////
     sc_space: 'lwv.bld.data("\x00")',
     sc_a: 'lwv.bld.data("\x01")',
     sc_b: 'lwv.bld.data("\x02")',
     sc_c: 'lwv.bld.data("\x03")',
     ...
     sc_v: 'lwv.bld.data("\x16")',
     ...
     // clipboard
     c_c:     'lwk.copy()',          // copy selected text to clipboard
     c_v:     'lwk.paste()',         // paste clipboard to host
     ...
  

• Important:
  At character-oriented UNIX terminals, text on the clipboard is directly transmitted to the UNIX application using the function lwk.paste() and then processed. The function lwk.copy(), however, is only a local process and copies the selected text to the clipboard of the client computer without assistance from the host.

Mouse actions: lwk.userkeys

The associative array lwk.userkeys in the keyboard files is also used to assign the required actions to mouse events. The entries correspond to those of the keyboard settings, but instead of the name of the computer key, the name of mouse events are displayed.

Example:

• The 5250 configuration file 5250/keyboard/default.js contains the parameters:

  lwk.userkeys = {
     ...
     // assign mouse events
     onclick:         '*lwk.posMouse()',              // pos Cursor
     onclickright:    '*lwk.menuMouse("lwh.menu.main")',   // show context menu
     ondblclick:      'lwk.send("<ENTER>")',       // send ENTER
     ondrag:          '*lwh.select.start(false)',     // select lines
     ondragright:     '*lwh.select.start(true)',      // select block
     s_ondrag:        '*lwh.select.start(true)',      // select block
     c_ondrag:        '*lwh.select.start(true)',      // select block
     a_ondrag:        '*lwh.select.start(true)',      // select block
     ...
  };
  

• In this example, a (left) click positions the cursor.

     ...
     onclick:         '*lwk.posMouse()',              // pos Cursor
     ...
  

  Depending on the host system and the host application, the selected position may not be available. The cursor then moves the next available position.
• A right click opens the context menu:

     ...
     onclickright:    '*lwk.menuMouse("lwh.menu.main")',   // show context menu
     ...
  

  Further information about the menus can found in menu settings.
• By dragging the mouse, part of a line is selected (left mouse button) or a block is selected (right mouse button):

     ...
     ondrag:          '*lwh.select.start(false)',     // select lines
     ondragright:     '*lwh.select.start(true)',      // select block
     ...
  

• Some UNIX applications can also directly control the mouse as an input device. To enable the emulation program to make this distinction, the "host-controlled" mouse is specifically defined:

     ...
     sc_ondrag:       'lwv.bld.onmouse()',             // the VT controlled mouse
     ...