{"id":913,"date":"2019-08-06T15:02:04","date_gmt":"2019-08-06T22:02:04","guid":{"rendered":"https:\/\/portal.staylinked.com\/sl\/kb\/?post_type=ht_kb&p=913"},"modified":"2026-02-12T14:36:21","modified_gmt":"2026-02-12T22:36:21","slug":"keyboard-maps","status":"publish","type":"ht_kb","link":"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/keyboard-maps\/","title":{"rendered":"Keyboard Maps"},"content":{"rendered":"\n

In order for a device to connect to a StayLinked Server, that Server must have an installed keyboard map that exactly matches the device type and emulation type. Keyboard maps are installed on a server using the StayLinked Administrator. These keyboard maps can be configured with a variety of functions, strings and escapes to meet the requirements of your hosted application. This brief guide describes the different device types, keyboard maps and the available options.<\/p>\n\n\n\n

Adding New Keyboard Maps<\/h3>\n\n\n\n

During the connection handshake each device provides several bits of information to the Server; including screen size, client version, device type among other details. In server versions 15.5 and older, devices that need a keyboard map will report an error Esp0003, No VT\/5250\/3270<\/em> keyboard map found for device devicetype<\/em>. <\/p>\n\n\n\n

Default Keyboard Maps<\/h2>\n\n\n\n

V16 and newer Windows servers will come preconfigured with default keyboard maps. Future releases of the server process will enable this option on new installations for other platforms. The option can be manually enabled under Server Configuration > Server Settings.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Default keyboard maps take effect when the server process does not have an installed keyboard, Default maps are not installed, and there is no option for the to be automatically installed. Any customization or changes from the default map require the Administrator to manually perform the standard historical process for installing a new keyboard map.<\/p>\n\n\n\n

What is a Device Type? <\/h4>\n\n\n\n
\"\"<\/figure><\/div>\n\n\n\n

The Device Type for your client will be displayed on the splash screen next to the client version. Device Types are a combination of values specific to each client that tell the server some basic information. Device types are made up of: the manufacturer (PTX in this case is Psion Teklogix), the device model (which is a 7535), the operating system (not used in the example, but typically a C\/CE or W\/WM for Windows CE or Windows Mobile) and lastly the keyboard type reported by the device operating system (58-key in this example). Some devices may report keyboard types like AN or QW for Alpha-Numeric and QWERTY respectively.<\/p>\n\n\n\n

Devices reporting keyboard types of 00 or XX are getting an invalid result from the operating system. These may be resolved by simply rebooting the device. Some devices have removable keyboards that might have a poor connection between the keyboard and handheld. While you may be able to copy a keyboard map with this different device type, the keyboard may not operate as expected. Some devices may need to be repaired for normal keyboard use.<\/p>\n\n\n\n

Note that device types can be configured with custom values. It is not recommended that device types are changed because they represent the make and model of the device as well as the software that\u2019s been installed. It is often necessary to exclude or separate a test device from the other devices in order to allocate it to a different device group. Client Settings or Scan2Configure features can be used to adjust the device type. A copy of the preferred keyboard map must be made for any new device types.<\/p>\n\n\n\n

Esp0003 and Adding New Keyboards from the Connections List<\/h4>\n\n\n\n

From the Administrator\u2019s Connections list: <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\"\"<\/figure><\/div>\n\n\n\n

When your device displays the Esp0003 error message, you can quickly add the keyboard map by opening the details display in the Administrator\u2019s Connections List. Just double-click on the connection and select the \u2018Add Keyboard Map\u2019 option.<\/p>\n\n\n\n

<\/p>\n\n\n\n

<\/p>\n\n\n\n

Adding Keyboard Maps Manually<\/h4>\n\n\n\n

The StayLinked Administrator section for keyboard maps shows a list of installed keyboards. You can add new keyboards, create custom keyboards, edit installed keyboards, or copy installed keyboards. Adding a new keyboard is done by right clicking in the window and selecting \u2018Add\u2019. Each keyboard appears in the list multiple times, once for each emulation type. Choose the emulation types that matches the eSP0003 error message or your telnet host entry. Note that UTF8 and SSH emulation hosts utilize the VT emulation type for keyboard maps.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Video – Adding a Keyboard Map<\/h3>\n\n\n\n