DL TCL™ User’s Manual
DL TCL™ USER'S MANUAL
DATALOGIC S.p.A. Via Candini 2 40012 - Lippo di Calderara di Reno Bologna - Italy DL TCL™ This manual refers to software version 4.0 and later. Ed.: 04/2004 ALL RIGHTS RESERVED Datalogic reserves the right to make modifications or improvements without prior notification. Datalogic shall not be liable for technical or editorial errors or omissions contained herein, nor for incidental or consequential damages resulting from the use of this material.
CONTENTS 1 1.1 1.1.1 GENERAL INFORMATION .......................................................................... 1 DL TCL™ ...................................................................................................... 1 DL TCL™ Operating Modes.......................................................................... 2 2 2.1 2.1.1 INSTALLATION............................................................................................ 3 Installing DL TCL™ onto the Terminal .....................
4.6 4.7 NEW Password........................................................................................... 51 FTP Server.................................................................................................. 52 5 5.1 DL TCL™ EXTENDED COMMANDS......................................................... 53 Proprietary Commands ............................................................................... 53 6 TERMINAL ERROR MESSAGES ..........................................................
GENERAL INFORMATION 1 1.1 1 GENERAL INFORMATION DL TCL™ Datalogic Terminal Emulation Client (DL TCL™) is a software providing VT100, VT220 and IBM5250/3270 Telnet terminal emulation on Datalogic RF portable terminals having an hardware architecture based on the DOS operating system.
DL TCL™ 1 1.1.1 DL TCL™ Operating Modes DL TCL™ can be used for radio transmission with an Host or with a "Keep Connecting" PC which is connected to a remote Host through a network connection: - Direct Host Mode Keep Connecting (KC) Mode In "Direct Host Mode" DL TCL™ runs on an RF terminal in VTxxx or IBM5250/3270 Telnet emulation which communicates via radio with a Host PC selected from a list of up to 5 Hosts (Multi-Host functionality).
INSTALLATION 2 2.1 2 INSTALLATION INSTALLING DL TCL™ ONTO THE TERMINAL Once the DL Mobile Configurator™ Enterprise 2 has been installed (see relevant manual), it is possible to set and configure the DL TCL™ application and download the related files onto your terminal. Configuration Tree Figure 3 – DL Mobile Configurator™ Enterprise 2 Main Window For a correct and complete downloading, you must define the parameters available in the configuration tree.
DL TCL™ 2 Once the communication between the terminal and DL Mobile Configurator™ Enterprise 2 has been enabled, it is possible to start the downloading procedure by clicking on the 2.1.1 icon available on the program toolbar.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 3 CONFIGURING FROM DL MOBILE CONFIGURATOR™ By selecting the DL TCL™ item in the Select download type parameter of the Application branch, new sub-branches will appear allowing to configure the DATALOGIC terminal emulator application. Each new branch within the work area (right side) of the main window allows to set some general variables of the terminal emulation application.
DL TCL™ 3 3.1 DEVICE It allows defining the main parameters of the terminal: Figure 6 – Device Parameters Beep Duration It defines the beep duration in milliseconds. Beep Frequency It defines the beep frequency in hertz. Key Beep It enables/disables a beep emission at any key press. Out of Range It allows signalling if a terminal is out of the area covered by the Access Point.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3.2 3 CONNECTION It allows configuring the connection between the application and the remote host: Figure 7 – Connection Parameters KCn Name/IP It defines the address for the 4 Keep Connect (KC) Host PCs listed in the mask. Enable Multiple Session It defines the type of connection to be used by the terminal to interact with applications running on the remote Host and provided by the KC PC.
DL TCL™ 3 3.3 EMULATION It allows defining the emulation parameters: Figure 8 – Emulation Parameters Device Name It defines the name of the terminal performing the connection. Password It defines the password to type for entering the DL TCL™ setup. Auto Run It enables/disables the terminal automatic connection on startup of DL TCL™ or on closure/connection failure. Log File It enables/disables the event log to track the events.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 Del to BS It enables/disables the delete command when pressing the Backspace (BS) key on the terminal keyboard. Local Echo It enables/disables the terminal Local Echo. VT Answer Back It defines the answer to be transmitted by the emulation program to the Host. It is possible to customize a string of characters to be transmitted as answer; otherwise you may send a part or the whole IP[n] or MAC[n] address.
DL TCL™ 3 3.4 ADVANCED It allows to configure the advanced configuration features: Figure 9 – Advanced Parameters Start Row It defines the line number (from 1 to 25) of the physical screen to be relocated on the logical screen of the terminal. Number of Rows It defines the total number of rows to be relocated. Destination Row It defines the line number (from 1 to 25) of the terminal logical screen where the relocated line(s) will be placed to.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3.5 3 DISPLAY It allows configuring the font type for the application. Figure 10 – Display Parameters Font Selection A list of 7 font types is available, where six font types are fixed and one can be customized by the user. For each font type is reported the maximum number of characters (columns x lines). The defined font will be adopted as soon as the terminal emulation is started.
3 DL TCL™ Scrolling Modes Fixed The terminal display is always locked at column 0 and row 0. Quadrant Mode The entire host screen (80x25) is divided in different quadrants, where each of them defines the maximum number of characters (columns X lines) available for the defined font set. In connection with an AS400 Host, if the active input field is completely inside a quadrant, the display will be placed to this quadrant.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3.6 3 BARCODE DATA ENTRY It allows configuring the entry of barcode data. Figure 11 – Barcode Data Entry Definition Laser Enable It enables/disables the terminal laser for barcode reading. If disabled, the Barcode branch (see par. 3.8) will not appear within the Configuration tree.
DL TCL™ 3 Clear Before Scan This special key is only available in connection with an AS400 host. If checked, it clears the input field before sending the barcode read. Baud Rate (available only for Rhino™) This parameter is available only when the Rhino™ Barcode Input parameter is set to Scanner (COM2/Scanner), Cordless-Card or Serial (COM1). Refer to DL Mobile Configurator™ Enterprise 2 User’s Manual for further details. It defines the baud rate.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 Mode If set to Recognition Only, it allows editing a single input filtering mask to select the codes to be read. Click on the Edit button to open the following dialog box: Figure 12 – Input Filtering Mask Digit the matching string in the edit box by using the given syntax. The edited string must have the same length as the one of the code to be formatted.
DL TCL™ 3 3.7 PRINTER It allows configuring the printer. Figure 14 – Printer Setting Communication It defines the port to be used to send data from the terminal to the printer. The RS232 port indicates the electrical port, while IrDA indicates the optical port. The only communication speed allowed for both ports is 38400 baud. IBM AS400 Printer It defines the parameters for the IBM AS400 printer.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 Stop Bits It indicates the number of stop bits the data packet of the communication protocol frame. 3.8 BARCODE The parameters available in the Barcode branch allow to configure the laser driver parameters (SE 1200, SE122x and SE2223). It is possible to select an item in left part of the screen and to set its proper parameters on the right part.
DL TCL™ 3 3.8.1 General Parameters Code Length It defines the minimum and maximum length of the code to be read. Figure 16 – Code Length Reading Security By setting these parameters it is possible to guarantee a more precise code reading. Figure 17 – Reading Security Severity : 0 defines a more aggressive decoding, while 2 a more severe decoding Redundancy : defines the number of times (plus 1) the code will be read before being accepted Quiet Zone: defines a standard or a narrow quiet zone.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 Preamble/Postamble It defines the preamble and postamble characters using the ASCII decimal value. Figure 19 – Preamble/Postamble For all parameters possible values are in the range 0-128, where 128 corresponds to disabled. Reading Feedback It defines the type of indicator signaling that the code has been decoded. Figure 20 – Reading Feedback Decode Beep Tone : defines the beep tone.
DL TCL™ 3 Always On : if checked, it allows the scanner to read even if the DS function has not been called (for diagnostic purpose only). SW Control : if checked, it allows the scanner to read even if the trigger is not pressed (for diagnostic purpose only). Keyboard Emulation : if checked, it enables the keyboard emulation (for diagnostic purpose only). Booklet Menu : if checked, it enables the scanner programming through the Booklet menu.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3.8.2 3 Linear Codes The Linear Codes branch lists all the code symbologies which can be read by the terminal. Figure 23 – Linear Code Selection For each code symbology it is possible to define the following parameters: Decoding Enable: if checked, it enables the decoding of the specific symbology. Check Digit Enable : if checked, it enables the check digit for the specific symbology.
DL TCL™ 3 3.8.3 2D Codes If configuring a terminal supporting the SE2223 driver, it is possible to read 2D codes. Figure 24 – 2D Code Selection By selecting the desired code it is possible to select the related parameters.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3.9 3 HOSTS It allows defining the configuration of up to 5 Hosts to which DL TC™ can be connected.
3 DL TCL™ Host Profile It defines the logical name to be assigned to the current Host. Host Name / IP It defines the address to be used by the terminal when connecting to the Host PC. Host Port It defines the TCP/IP port to be used by the terminal for connection to the Host PC. Emulation Type It defines the type of emulation to be run on the terminal. Enable Custom If checked, it allows defining the Negotiation String.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 The button available on the program Tool bar allows deleting the selected Host from the list. 3.9.1 Key Mapper For each defined Host it is possible to use the “key mapper” utility to reconfigure the terminal keyboard. In this way, it is possible to map the most frequently used character combinations into single key clicks.
DL TCL™ 3 The table next to the keyboard graphical layout list all the defined key mappings. In particular, the “Virtual Sequence” column shows the key sequence to be mapped, while the “Physical Key” column displays the terminal physical key mapping the key sequence. The Key Mapping can be managed through the New, Edit and Delete buttons. The Exit Emulation Key edit box shows (if defined) the mapped terminal key and can be managed through the Map and Restore buttons.
CONFIGURING THROUGH DL MOBILE CONFIGURATOR™ ENTERPRISE 2 3 Then, click on the Next button to define the mapping terminal key. In this case, whenever the mouse passes over a button this is red-highlighted. Once selected, its borders turn to red and the corresponding key is stored in the Physical Key to Press edit box.
DL TCL™ 3 Setting the Exit Emulation Key The Exit Emulation Key is a special key allowing to exit the terminal emulation application. For this reason a special command has been introduced to map this key. By default the used function key is F10. To configure the Exit Termination key, position the cursor in the lower part of the screen labelled “Exit Emulation Key” and click on the button.
DL TCL™ EXTENDED COMMANDS 4 4 CONFIGURING FROM TERMINAL Once the DL TCL™ application and configuration files have been downloaded onto the terminal by using the DL Mobile Configurator™ Enterprise 2 program, it is possible to change the value for most of the defined parameters directly from the terminal. This operation is suggested when modifying a few parameters.
DL TCL™ 4 4.1 MAIN SETUP MENU At terminal boot, the following opening mask is displayed: Datalogic Spa DL - TCL Terminal Emulation ESC to Setup ENTER to Connect Figure 30 - Opening Mask By pressing the [Enter] key it is possible to proceed with the connection to the Host PC. The [ESC] key enters the main setup menu: Datalogic SETUP Terminal Emulation Password Request Password Figure 31 - Entering Password A password must be typed and the [Enter] key pressed to display the main setup menu.
DL TCL™ EXTENDED COMMANDS 4 As described in the introduction of this chapter, press the numeric key corresponding to the number next to each option to select the desired menu: 1) Network: 2) Emulation: 3) Device: 4) Info Terminal: 5) New Password: 6) FTP-Server: 7) Exit Setup: 8) Exit to DOS: 4.
DL TCL™ 4 4.2.1 TCP/IP If selecting this submenu, the following masks appear allowing to define the IP parameters related to the terminal.
DL TCL™ EXTENDED COMMANDS 4 The IP Address value must respect the xxx.yyy.www.zzz structure, where x, y, w and z value is in the range 0-255. After address selection and validation through the [Enter] key, you will return to the first TCP/IP mask where the Static option is displayed in reverse video. In case of wrong address definition, the terminal will not proceed with the configuration. Since the DHCP and BOOTP option have an exclusive selection, they do not open a further mask.
DL TCL™ 4 DNS The definition of the DNS IP address must respect the xxx.yyy.www.zzz structure, where x, y, w and z are in the range 0-255: Datalogic - SETUP Network TCP/IP - DNS Address: ENTER to Continue Figure 39 - DNS Mask Once the DNS has been configured, logical names substituting the IP address may be used by the Host PC to identify the devices. Device Name This parameter allows assigning a name to the terminal performing the connection. By inserting an (*) asterisk before the name (i.e.
DL TCL™ EXTENDED COMMANDS 4.2.2 4 Radio This submenu allows selecting the radio network the terminal belongs to. The selected parameter acts upon the configuration files of the radio driver. It is required to know the radio type installed on the terminal before configuring these parameters. NOTE Datalogic - SETUP Network Settings 1) TCP/IP 2) Radio 3) Connection ENTER to Continue "2" [ENTER] Datalogic - SETUP Network Radio 1) Open Air 2) IEEE 802.11b 3) IEEE 802.
DL TCL™ 4 Open Air Radio Datalogic - SETUP Network Radio 1) Open Air 2) IEEE 802.11b 3) IEEE 802.
DL TCL™ EXTENDED COMMANDS 4 IEEE802.11b Radio Datalogic - SETUP Network Radio 1) Open Air 2) IEEE 802.11b 3) IEEE 802.11 ENTER to Continue "2" [ENTER] IEEE802.
DL TCL™ 4 When configuring the radio, the "Out of Range" option (set [AUTO]) allows DL TCL™ to automatically signal if during data transmission a terminal is out of the area covered by the Access Point. For all terminals this condition will be signaled by the LED activation, while for Rhino™ terminal the signal is emitted by the beeper. If set to [ON], it is possible to verify this condition only if trying to transmit from the terminal.
DL TCL™ EXTENDED COMMANDS 4 IEEE802.11 Radio Datalogic - SETUP Symbol 802.11 2Mb Datalogic - SETUP Network Radio 1) Open Air 2) IEEE 802.11b 3) IEEE 802.11 ENTER to Continue "3" [ENTER] Datalogic - SETUP Symbol 802.11 2Mb "1" 1) ESS_ID 2) Power Options ENTER to Continue "2" - ESS_ID Network Name: [ENTER] ENTER to Continue [ENTER] Datalogic - SETUP Symbol 802.11 2Mb 1) Enable Pwr Save 2) Disable Pwr Save ENTER to Continue Figure 44 – IEEE802.
DL TCL™ 4 Host If configuring the Host PC, the communication will automatically enter the Direct Host Mode (see par. 1.1.1 for details). Datalogic - SETUP - Host Name/IP Address: - Host Port: - Emulation: Figure 46 - Host Selection This mask requires to set the Host IP address or the Host name to be used by the terminal when connecting to the Host PC and the TCP/IP port (default value is port 23). Then, you must select the desired emulation type (VT100, VT220, IBM5250/3270) by means of the arrow keys.
DL TCL™ EXTENDED COMMANDS 4 The management of this feature depends on the selection of the Multi-Session parameter: - Single Session: - Multiple Session: the Multi-Session option is set to on. The terminal works as in Single Session but in this case it can manage up to 4 different sessions (Mode 1, Mode2, Mode 3 and Mode 4) at the same time.
DL TCL™ 4 4.3 EMULATION MENU This menu allows setting the parameters managing the terminal emulation: Datalogic - SETUP Emulation 1) General 2) VT100/VT220 3) 3270/5250 ENTER to Continue Figure 49 - Emulation Menu 4.3.
DL TCL™ EXTENDED COMMANDS 4 KeepAlive Timeout It defines the time interval (in seconds) between the transmission of two NOP packets. DL TCL Scroll It enables/disables the DL TCL™ proprietary scroll mode. In particular, the CTRL + Arrow sequence allows scrolling up, down, left and right; otherwise, it is possible to activate other commands through the CTRL + key sequence (ex. for DL 9600 Viper™ 48-key model: CTRL + C = break). Log Enable It enables/disables the event log to track the events.
4 DL TCL™ Local Echo It enables/disables the terminal Local Echo. Del to BS It enables/disables the delete command when pressing the Backspace (BS) key on the terminal keyboard. Enter CR + LF It selects the CR or CR+LF characters to be added to the data format when pressing the [Enter] key on the keyboard. Host Login It enables/disables the automatic login.
DL TCL™ EXTENDED COMMANDS 4.3.
DL TCL™ 4 AS400 Printer It defines the parameters for the IBM AS400 printer. Unlikely the VT emulation, the AS400 emulation has no protocol standard command to start the printing process and it requires defining a byte for this purpose. Specify the screen position of the byte through “Row Position” and “Col Position”, and its ASCII value in “Flag Byte”. Reset Mode It enables/disables the activation of the Reset button when the data transmission from Host is blocked.
DL TCL™ EXTENDED COMMANDS 4.4.1 4 Input / Output The Input submenu allows defining the data input through the keyboard or the scanner.
4 DL TCL™ - Terminator key: defines the key to be pressed to include a terminator character in the output data format. Possible selections are: None = no terminator added to the data string Enter = terminator ASCII value is 13 Tab = terminator ASCII value is 08 Field Exit = special key available in the AS400 emulation (only for IBM5250/3270 terminal emulation).
DL TCL™ EXTENDED COMMANDS 4.4.2 4 Display The Display submenu allows defining the font dimension to be used for terminal emulation and the backlight management.
DL TCL™ 4 Backlight The terminal Backlight is managed through the following parameters: - Auto: enables/disables the backlight each time a keyboard key is pressed. - Timeout: defines the timeout (secs.) for the backlight activation. As soon as the timeout expires, the backlight is disabled. These parameters are not effective when the backlight is disabled by BIOS. Cursor It defines the shape of the cursor. Possible selections are Underline and Block.
DL TCL™ EXTENDED COMMANDS - 4.5 4 Key Click: enables/disables a beep emission at any key press. Beep: if selected, a further mask is displayed showing the following parameters: Beep Duration = defines the alarm beep duration in milliseconds. Beep Frequency = defines the alarm beep frequency in hertz. INFO TERMINAL This menu shows information about the BIOS version, DL TCL™ emulation version, MAC address of the radio the terminal is equipped with.
DL TCL™ 4 4.7 FTP SERVER The FTP server is supported by each terminal and allows both the KC mode connection and file upload/download. When the terminal works as an FTP server the following mask appears: Datalogic FTP SERVER Version: Server IP Address: You’re on Remote.. Figure 59 - FTP Server An FTP client can be connected to the FTP server through the IP address displayed on the terminal as showed in the figure above.
DL TCL™ EXTENDED COMMANDS 5 5.1 5 DL TCL™ EXTENDED COMMANDS PROPRIETARY COMMANDS The proprietary commands allows exploiting standard features performed by the Datalogic portable terminals.
DL TCL™ 5 The following table lists commands managing different terminal functions: Function Change beeper frequency () and duration () Enable barcode formatting, if configured Disable barcode formatting, if configured Enable a customized alarm for the defined period of time (). During this period the terminal is locked while its beeper, LED and backlight are activated at regular intervals.
TERMINAL ERROR MESSAGES 6 6 TERMINAL ERROR MESSAGES During the terminal normal functioning some error messages may appear on the display. The following table lists and explains all error messages: Error Message Description Error on Password Connecting KC1… A wrong password has been inserted. The terminal is trying to connect to KC HOST 1. A similar message is also displayed when trying connection to other KC Hosts.
DL TCL™ 6 Error Message Parameters changed. changes? (Y/N) Description Save If exiting the main setup menu after changing some parameters, the terminal prompts for confirmation before updating the values. Wait…(saving changes) The terminal asks to wait while saving the new configuration values. WARNING! Default Parameters The configuration of specific parameters, such changed. If you save you need as IP Address and Radio parameters, requires to reboot.
