![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.2.jpg\")
<\/figure><\/div>\n\n\n\nOnly the most common features are configured directly on the client. Several configuration options are available using the Client Settings feature of the Administrator. These settings are not only cold boot persistent but can automatically be deployed to all of your devices without the need to configure each device manually. Please see the Administrator User\u2019s guide for additional details.<\/p>\n\n\n\n
Clients prior to v16.1 build 276 will prompt for a configuration password. The default value is esp. ios<\/strong> <\/em>and and <\/em><\/strong>also work for the respective operating systems.<\/p>\n\n\n\n If no password prompt appears, you can use the following instructions to re-enable a configuration access prompt.<\/strong><\/a><\/p>\n\n\n\n <\/p>\n\n\n\n The settings on the Server tab allow you to configure the IP and Port of the StayLinked Server. In cases where the device may need to connect to one of multiple StayLinked servers, you would configure the device to use a supplemental configuration file called servers.ini. Please see the section below for details about the options and format of this configuration file.<\/p>\n\n\n\n Server IP<\/strong>: Host name or IP address of your StayLinked server. The\nOperating System must be configured and able to resolve host names to use them\nas a valid address. Some client version may limit the number of characters\nallowed. <\/p>\n\n\n\n Server Port<\/strong>: Port number\nserver is listening on. The StayLinked server is configured by default to\nlisten for new connections on port 3006.<\/p>\n\n\n\n Use Device ID<\/strong>: Allows you to specify a [deviceid] value specific to\nthis device. This value can be used in StayLinked scripts or will be used for\niSeries virtual device names when the client connects to a device group that\ncontains the [deviceid] mnemonic in the device name prefix field. Devices that\ndo not contain a Device ID value in the StayLinked client will use the windows\nsystem name. <\/p>\n\n\n\n Max Connections<\/strong>: This setting will change the server address\ndialogue to include multiple StayLinked servers. When the option is selected\nfor only one server, the user will automatically be connected to that server\nwhen selecting \u2018Connect\u2019. If multiple servers are added to this list, the user\nwill be presented with a selection under the connect menu.<\/p>\n\n\n\n When a value higher than one is selected, the client will offer connection parameters for each possible connection. Android and iOS clients will list each connection, which can be configured independently.Windows clients will display a table that require you to press enter to populate each cell in the server list.<\/p>\n\n\n\n All clients populate a\nconnections.ini file. This file can be copied from one device to others if you\nwant to mirror the configuration options. Note that you must also configure the\nmax connections option for the table to be used. Without increasing the max\nconnections, the connections.ini configuration file will not be used, instead\nusing the standard staylink.ini options.<\/p>\n\n\n\n The following options are available on the Display configuration tab (right):<\/p>\n\n\n\n Use Bold Font<\/strong> will force all characters into a high-intensity\ndisplay. Disabling this option will result in narrower characters and allow\nmore characters to be displayed on the screen at any given time.<\/p>\n\n\n\n Fixed Rows and Columns<\/strong> are available to set the dimensions of the\ndisplay space.<\/p>\n\n\n\n Terminal emulation screens are\ntypically 24 rows by 80 columns. Some emulation specifications can be larger,\nbut most devices cannot clearly display that much text on a usable screen. The\nportion displayed by the client is called the viewport. <\/p>\n\n\n\n Multi-touch devices should be\nconfigured to use the entire emulation space. With these clients, you are able\nto pan and zoom across the entire emulation space (optional). Reducing the row\nand column will prevent users from accessing this area on your devices.<\/p>\n\n\n\n Screen Orientation<\/strong> selects the rotation options, allowing or restricting the user from turning the device to switch between portrait and landscape views.<\/p>\n\n\n\n Zoom and Pan<\/strong> allows the user to dynamically grow and shrink the\ndisplay size and shift the display left to right and up or down to see\ndifferent sections of the display space.<\/p>\n\n\n\n Session Fits Display<\/strong> sets the default zoom size to fit the height or width of the display space to the screen size.<\/p>\n\n\n\n The Miscellaneous settings are typical of any StayLinked client. <\/p>\n\n\n\n Auto Connect<\/strong> will default to never, which requires the user to\nmanually connect to the server to start a session. Setting the value to once\nwill automatically start a connection when the client is started. Using a\nsetting of always will start a new session any time the user ends the current\nsession. This will also disable the client ability to disconnect from an active\nsession. StayLinked recommends a setting of never or once on devices that\nperform functions other than terminal emulation. Sessions started using the\n\u2018always\u2019 connection option can still be disconnected from the StayLinked\nAdministrator\u2019s Connections List.<\/p>\n\n\n\n Full Screen<\/strong> configures the Client to remove operating system dialogue\nbars whenever possible. This option is disabled by default and should not be\nused when third-party programs are being used to secure your devices.<\/p>\n\n\n\n Extended Keys<\/strong> will allow the client to display a \u2018ribbon\u2019 along the\nbase of the screen. This ribbon slides left and right and displays many common\ncommands. The ribbon can be customized by creating an extkeys.ini file with\nyour desired options. This file and the configuration options are described in\nsection 2 of this guide.<\/p>\n\n\n\n Extended Keys Mapping<\/strong> changes the processing of extended keys\noptions from the Client to StayLinked Server. This option has no effect if you\ncreate a custom \u2018extkeys.ini\u2019 to make your own custom extended keys toolbar.<\/p>\n\n\n\n Local \u2013<\/strong> The client sends \u2018mnemonics\u2019 to the server, [pf3] if you\npress the F3 toolbar button, [enter] if you press the Enter toolbar button,\netc.<\/p>\n\n\n\n Server \u2013<\/strong> The client sends the appropriate keycode as if you pressed\na button on the keyboard. Since these items generate keyboard event codes, the\nkeyboard map on the server is used to determine what action to take for each\ntoolbar button.<\/p>\n\n\n\n The \u2018Extended Keys Mapping\u2019 option\ncontrols only the behavior of the \u2018built-in\u2019 toolbar button ribbons, All,\nInput, Cursor and FKeys.<\/p>\n\n\n\n More details regarding the extended keys configuration and options can be found in the extended keys section later in the document or in the general Client User Guide found in the documentation section of the StayLinked downloads site.<\/p>\n\n\n\n Devices with an integrated scanner will typically work automatically, supporting the scanner test and reporting a barcode symbology. Devices that attach an external or Bluetooth scanner may require additional configuration. Scan devices operating in HID mode will require standard scanner-as-wedge configuration as described in our scanner-as-wedge technical reference document. These clients also support the \u2018autowedge\u2019 feature when configured with a scan delimiter of 0. Devices operating in SPP mode can be natively operated by the StayLinked Client but require that the scan device is paired with the Android device before it can be selected from the StayLinked Client scanner configuration screen. <\/p>\n\n\n\n Both scanner-as-wedge and Bluetooth\nmode are displayed as options below. Bluetooth mode will offer a selection of\nall Bluetooth devices, and often include an icon that suggests the type of\npaired device.<\/p>\n\n\n\n More information on scan configuration can be found in the technical reference for scan configuration. Also note that without a symbology id, barcodes will report their symbology as unknown\/unsupported.<\/p>\n\n\n\n <\/p>\n\n\n\n Keyboards also support the operating system swipe gesture to switch between keyboards. This gesture is supported by the device operating system and hardware, so tuning and control would be accomplished in the device operating system.<\/p>\n\n\n\n A single long press or press and hold will hide the StayLinked menu bar\nthat displays File, Host and About.<\/p>\n\n\n\n A two-finger tap will show and hide the keyboard.<\/p>\n\n\n\n Smart Keyboard options include the following: <\/p>\n\n\n\n Keyboard Transparency:<\/strong> SmartTE keyboards support alpha levels.\nThis sets how transparent the keyboard is, which can allow the user to see the\nscreen through the keyboard.<\/p>\n\n\n\n Off \u2013<\/strong> Disables transparency allowing the keyboard\nto block the emulation screen behind it. This is an alpha level of 100.<\/p>\n\n\n\n Low \u2013<\/strong> Low transparency is a slightly transparent\nkeyboard. This is an alpha level of 80.<\/p>\n\n\n\n Medium \u2013 <\/strong>Medium transparency is the mid-level\ntransparent keyboard. This is an alpha level of 60.<\/p>\n\n\n\n High \u2013<\/strong> High transparency shows more of the\nemulation space than the keyboard. This is an alpha level of 40.<\/p>\n\n\n\n Fade While Pressed:<\/strong> This option will dim the keyboard if\npressed and held. The keyboard will return to the normal transparency when\nreleased.<\/p>\n\n\n\n Keyboard Pan Cursor:<\/strong> This option will shift the display if the\ncursor is behind the on-screen keyboard. Disabling this option will leave the\ncursor behind the keyboard, which would still be visible if the keyboard is at\nleast partially transparent.<\/p>\n\n\n\n Haptic Feedback:<\/strong> Not all devices support vibration options.\nIf supported, the device will slightly vibrate for each keypress to help users\nknow when a key has been entered.<\/p>\n\n\n\n QWERTY Keyboard Style: <\/strong>Select the default QWERTY keyboard style\nbetween the options; Disabled, Standard, Small, AZERTY, Full Screen, 4-Column\nRight, 4-Row Full, and 4-Column full.<\/p>\n\n\n\n Number\/Symbol Keyboard Style: <\/strong>Select the default Number\/Symbol style between Standard and Azerty keyboard layouts.<\/p>\n\n\n\n Numpad Keyboard Style: <\/strong>Select the default Number Pad keyboard style\nbetween the options; Disabled, Full Screen, 2-Row, 3-Row, 2-Column Right, 5-Row\nand 3-Column Right. In addition to the Smart Keyboard options list\nabove, the following standard options are available on most SmartTE devices. <\/p>\n\n\n\n When a client attempts to connect\nto the StayLinked server it will check for a keyboard map. You can add a\nkeyboard using the StayLinked Administrator. Navigate to the emulation settings\nsection and select keyboard maps. Then right click in the list of keyboards and\nselect add.<\/p>\n\n\n\n Once the keyboard map is opened,\nselect File and Save Changes to add it to your server\u2019s list of installed\nkeyboards. Additional information on keyboard maps and their use can be found\nin the Technical Reference on the subject in the Documentation section of our\nportal site.<\/p>\n\n\n\n If your device displays the error\nmessage \u201ceSP0003 No VT Keyboard Map Found\u201d, you have not added the keyboard map\nthat matches your device type and emulation. This message will show one of the\nthree main device types of VT, 5250 or 3270, based on the emulation type\nspecified in your telnet host entry.<\/p>\n\n\n\n This Client provides several different on-screen keyboards for emulation use. These generate keyboard event codes in the same manner as other StayLinked Clients. More information on keyboard maps can be found in the Keyboard Map Technical Reference document on the StayLinked downloads site.<\/p>\n\n\n\n Alpha QWERTY <\/p>\n\n\n\n Function Keys <\/p>\n\n\n\n Numeric <\/p>\n\n\n\n Voice and Text to speech will allow the client to provide voice feedback\nwhen licensed by the StayLinked Server. Speech products may incur an additional\ncost.<\/p>\n\n\n\n Please contact your StayLinked reseller for details.<\/p>\n\n\n\n Provides a list of images that have been replicated to your Client\ndevice for display speed. Graphical telnet mode requires additional Server\nconfiguration options to map these image files to display elements.<\/p>\n\n\n\n More information on GUI telnet mode can be found in the StayLinked Administrator User\u2019s Guide.<\/p>\n\n\n\n For devices that have been configured with a \u2018Printer Type\u2019 setting of Bluetooth, this menu provides options for data transfer modes and printer selection. Note that this setting is not available in the client user interface. It must be set using the StayLinked Administrator or by scanning a Scan2Configure barcode for \u201cPrinter_Type = 6\u201d for Bluetooth. <\/p>\n\n\n\n Scanning this barcode into a client scan test will enable to Bluetooth configuration dialogue. If this barcode will not read, you can create your own using Scan2Configure in the StayLinked Administrator section for Client Configuration.<\/p>\n\n\n\n The first option, Bluetooth Mode offers options for secure or non-secure communications:<\/p>\n\n\n\n The second option offers a printer selection from a list of paired devices: <\/p>\n\n\n\n Once Bluetooth printing is enabled and a device has been paired,\nprinting commands from the telnet host will be relayed to the attached device.<\/p>\n\n\n\n Please refer to the manufacturer documentation for instructions on pairing your printing device with your mobile computer.<\/p>\n\n\n\n Various\ntools are available for the testing of a StayLinked client. Not all devices\nsupport all features, but the available features will include the same possible\noptions.<\/p>\n\n\n\n Note that this section of the client does not allow for any configuration, but only the reporting and display of information.<\/p>\n\n\n\n Network Type:<\/strong> Shows if the device reports that the network is established by cellular or wifi. <\/p>\n\n\n\n IP Address<\/strong>: Current IP address of the device.<\/p>\n\n\n\n MAC<\/strong>: Current MAC address of the device. ESSID<\/strong>: Station ID of the Access Points to which the device is\nconnecting.<\/p>\n\n\n\n AP Mac<\/strong>: MAC Address of the Access Point to which the device is\ncurrently associated.<\/p>\n\n\n\n Signal<\/strong>: Depending on whether or not the device is currently in\nradio coverage, one of the following will be displayed in the \u201cSignal:\u201d field.<\/p>\n\n\n\n As the device is moved in\/out of\nradio coverage, the value of the \u201cSignal:\u201d field will toggle between the values\nabove. Where the \u201cSignal:\u201d value changes to \"Not Associated\"\nindicates dead zones, obstructions in the communication path, or fringe areas\nof radio coverage.<\/p>\n\n\n\n Stats information is sometimes\nhidden for wired devices, or devices running a client that can\u2019t request\ndetails from the device\u2019s network stack.<\/p>\n\n\n\n The Stats section displays radio\nand StayLinked protocol performance data.<\/p>\n\n\n\n TxRate<\/strong>: Current transmit rate in Megabits per second.<\/p>\n\n\n\n TxRetry<\/strong>: Number of transmit retries.<\/p>\n\n\n\n Sent<\/strong>: Number of StayLinked packets sent.<\/p>\n\n\n\n Recv<\/strong>: Number of StayLinked packets received.<\/p>\n\n\n\n OSQ<\/strong>: Number of out-of-sequence StayLinked packets.<\/p>\n\n\n\n RTX<\/strong>: Number of StayLinked packets retransmitted.<\/p>\n\n\n\n High values in the OSQ and RTX fields may indicate network issues. StayLinked will only transmit net changes to your devices. This means that packets received out of sequence will be discarded until the next sequential packet is received at the device.<\/p>\n\n\n\n Select the \u2018Ping\u2019 option from the \u2018Tools\u2019 menu to test network access between the StayLinked client and the selected host machine. <\/p>\n\n\n\n During a typical ping, the results\nwill be displayed in the number of milliseconds that the packet took to make\nthe round trip to the destination and back. Lower numbers are better. If your\nnumbers become excessively high, connectivity will be sluggish or unreliable.<\/p>\n\n\n\n If the results say Host\nUnreachable, no route was available to make the round trip, or the packets were\ndropped before the round trip could complete. <\/p>\n\n\n\n If the results report Unable to\nResolve, the name used was not listed in the name server, or the name server\nwas not reachable.<\/p>\n\n\n\n Enter the host IP address (defaults to the StayLinked Server) and choose \"Ping\" to cause the client to attempt to ping the host.<\/p>\n\n\n\n Select the \u2018Scan Test\u2019 option from the \u2018Tools\u2019 menu to test scanning on the device. <\/p>\n\n\n\n If you scan data when this test screen is displayed, you should see the scanned data, the length of the scanned data and the symbology type of the scanned data. If you do not see your scanned data on this screen, then it is most likely caused by an external scanner that is not or has not been configured to identify scan data. <\/p>\n\n\n\n More information on scanning can be found in the guide for scan configuration on our downloads site. <\/p>\n\n\n\n Select the \u2018Key Test\u2019 option from the \u2018Tools\u2019 menu to test the keyboard on the device. <\/p>\n\n\n\n Press any key on the keyboard to display its Scan code, ASCII code and Key code. The Key code is an important reference value to be used when programming keyboard maps using the StayLinked Administrator. Dismiss the dialog with a tap on the back button.<\/p>\n\n\n\n <\/p>\n\n\n\n <\/p>\n\n\n\n Select the \u2018About\u2019 option from the\n\u2018File\u2019 menu and the \u2018About\u2019 dialog will be displayed.<\/p>\n\n\n\n This dialogue allows a reset of\nthe unique value used by the StayLinked server to identify this device. When\nreset, the value will be repopulated based on the hardware in which the client\nis installed. This is typically required only in cases when the unique ID was\nreplicated to multiple devices by cloning the installation. This UID value is\nreferenced in the StayLinkedManager.log file when devices connect to the server\nduring an initial connection request.<\/p>\n\n\n\n SmartTE capable devices will offer several menu options that don\u2019t appear on traditional TE clients as long as the client is not locked down. This includes links to StayLinked on the web and access to the public StayLinked Experience server.<\/p>\n\n\n\n The public StayLinked Experience server walks a new user through the different products that the StayLinked company offers including SmartTE, Evolve and others. Each section shows a brief explanation for the product and invites the user to go to a webpage to request more information. Under SmartTE, there is a live demo of a simulated warehouse TE application. There are also options to see the app reformatted to have dynamically created buttons, or fully redesigned to show a more modern user experience. <\/p>\n\n\n\n One key difference between traditional clients and the newer device operating systems is the extent to which the client can control the device interface. Windows clients could operate in full screen mode and completely hide the operating system menu and program bars, displaying \u201c0 for Options\u201d on the splash screen….<\/p>\n","protected":false},"author":7,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[37],"ht-kb-tag":[],"yoast_head":"\nServer<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.3-1.jpg\")
<\/figure>\n\n\n\n Display<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.4.jpg\")
<\/figure><\/div>\n\n\n\nMiscellaneous<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.5.jpg\")
<\/figure><\/div>\n\n\n\nScanner-As-Wedge<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.6.jpg\")
<\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.7.jpg\")
<\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.8.jpg\")
<\/figure>\n\n\n\nSmart Keyboard<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.9.jpg\")
<\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.10.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.11.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.12.jpg\")
<\/figure>\n\n\n\nVoice<\/h3>\n\n\n\n
GUI Image Cache<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.13.jpg\")
<\/figure>\n\n\n\nBT Printing (Bluetooth)<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.14.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.15.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.16.jpg\")
<\/figure>\n\n\n\nTools<\/h2>\n\n\n\n
Radio Stats<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.17.jpg\")
<\/figure>\n\n\n\n
Note that some device operating systems do not provide visibility of the hardware network address. This value may reflect a different unique identifier provided by the device OS.<\/p>\n\n\n\nPing<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.18.jpg\")
<\/figure><\/div>\n\n\n\nScan Test<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.19.jpg\")
<\/figure><\/div>\n\n\n\nKey Test<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/10\/ClientUserGuide_1.20.jpg\")
<\/figure><\/div>\n\n\n\nAbout<\/h2>\n\n\n\n
Client Guide – Extended Keys<\/a><\/h2>\n\n\n\n
Running Third Party Programs<\/a><\/h2>\n","protected":false},"excerpt":{"rendered":"