TekTerm Server Software
User Manual
TEKTERM SERVER SOFTWARE
USER MANUAL
8000281-003
Rev. A
December 2020
ii TekTerm Server Software User Manual
No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means,
without permission in writing from Zebra This includes electronic or mechanical means, such as
photocopying, recording, or information storage and retrieval systems. The material in this manual is subject to
change without notice.
The software is provided strictly on an “as is” basis. All software, including firmware, furnished to the user is on
a licensed basis.
software or firmware pro
may not be assigned, sublicensed, or otherwise transferred by the user without prior written consent of
Zebra. No right to copy a licensed program in whole or in part is granted, except as permitted under
copyright law. The user shall not modify, merge, or incorporate any form or portion of a licensed program with
other program material, create a derivative work from a licensed program, or use a licensed program in a
network without written permission from Zebra. The user agrees to maintain Zebra’s copyright notice on
the licensed programs delivered hereunder, and to include the same on any authorized copies it makes, in
whole or in part. The user agrees not to decompile, disassemble, decode, or reverse engineer any licensed
program delivered to the user or any portion thereof.
Zebra reserves the right to make changes to any software or product to improve reliability, function, or design.
Zebra grants to the user a non-transferable and non-exclusive
gram delivered hereunder (licensed program). Except as noted below, such license
license to use each
Zebra does not assume any product liability
any product, circuit, or application described herein.
No license is granted, either expressly or by implication, estoppel, or otherwise under any Zebra, Inc.,
intellectual property rights. An implied license only exists for equipment, circuits, and subsystems contained in
Zebra products.
arising out of, or in connection with, the application or use of
Warranty
iii
iv TekTerm Server Software User Manual
Revision History
Changes to the original guide are listed below:
Change Date Description
Rev -003 12/2020 Update term "slave" to "follower"
Rev -002A
Rev -001A
5/2019
4/2015
Update screen size field values on page 9-4.
Initial release.
TABLE OF CONTENTS
Table of Contents
About this Manual ........................................................................................................................... xi
Supported Emulations and Protocols..............................................................................................xii
Text Conventions ............................................................................................................................ xii
Emulations and Datastreams.......................................................................................................... xiii
Number of Connections.................................................................................................................. xiv
Chapter 1: Administering the TekTerm Server
Accessing the TekTerm Server Browser Interface .......................................................................... 1-3
Accessing Windows Desktop.......................................................................................................... 1-3
Stopping the TekTerm Server ......................................................................................................... 1-3
Restarting the TekTerm Server................................................................................................. 1-3
Reading Event Log Entries............................................................................................................. 1-3
Accessing the Debug Console........................................................................................................ 1-4
Chapter 2: 3274/Telnet Host Configuration
Overview......................................................................................................................................... 2-3
General Host Options Screen......................................................................................................... 2-3
3274 Emulation Options Screen ..................................................................................................... 2-4
3274 Options ..................................................................................................................................2-4
TESS Options................................................................................................................................. 2-5
HTML/HTTP Options...................................................................................................................... 2-13
3274 Telnet Protocol Options Screen .............................................................................................2-13
3274 Telnet Terminal Naming Screen ............................................................................................2-15
3274 Function Key Mappings Screen............................................................................................. 2-16
Typical Host Configuration.............................................................................................................. 2-17
Line Description ........................................................................................................................ 2-17
Controller Description ............................................................................................................... 2-18
TCP/IP Link............................................................................................................................... 2-18
vi TekTerm Server Software User Manual
Chapter 3: 5250/Telnet Host Configuration
Overview......................................................................................................................................... 3-3
General Host Options Screen......................................................................................................... 3-3
Emulation Options Screen .............................................................................................................. 3-4
5250 Options ..................................................................................................................................3-4
TESS Options.................................................................................................................................3-5
HTML/HTTP Options......................................................................................................................3-13
5250 Telnet Protocol Options Screen ............................................................................................. 3-14
5250 Telnet Terminal Naming Screen ............................................................................................3-17
Function Key Mappings Options Screen ........................................................................................ 3-18
Typical Host Configuration.............................................................................................................. 3-18
Line Description ........................................................................................................................ 3-18
Controller Description ............................................................................................................... 3-19
TCP/IP Link............................................................................................................................... 3-19
Chapter 4: ANSI/Telnet Host Configuration
Overview......................................................................................................................................... 4-3
General Host Options Screen......................................................................................................... 4-4
ANSI Emulation Options Screen..................................................................................................... 4-4
ANSI Telnet Protocol Options Screen .............................................................................................4-8
ANSI Function Key and Arrow Key Mappings Options Screen ...................................................... 4-12
Host Configuration .......................................................................................................................... 4-13
Chapter 5: ANSI/SSH Host Configuration
Overview......................................................................................................................................... 5-3
General Host Options ..................................................................................................................... 5-4
ANSI Emulation Options Screen..................................................................................................... 5-4
ANSI SSH Protocol Options Screen ............................................................................................... 5-7
ANSI Function Key and Arrow Key Mappings Options Screen ...................................................... 5-12
Chapter 6: 9010/Telnet Host Configuration
General Host Options ..................................................................................................................... 6-3
9010 Emulation Options ................................................................................................................. 6-3
9010 Protocol Options Screen........................................................................................................ 6-4
Chapter 7: 2392/Telnet Host Configuration
Overview......................................................................................................................................... 7-3
General Host Options ..................................................................................................................... 7-3
2392 Emulation Options Screen ..................................................................................................... 7-4
2392 Options ..................................................................................................................................7-4
TESS Options.................................................................................................................................7-4
2392 Telnet Protocol Options Screen .............................................................................................7-12
Table of Contents vii
Chapter 8: RF Modem/Telnet Host Configuration
General Host Options Screen......................................................................................................... 8-3
Telnet Protocol Options Screen ...................................................................................................... 8-3
Chapter 9: HTML Host Configuration
Overview......................................................................................................................................... 9-3
General Host Options Screen......................................................................................................... 9-3
HTML Emulation Options Screen ...................................................................................................9-4
HTML Options ................................................................................................................................9-4
TESS Options................................................................................................................................. 9-5
HTML Function Key Mappings Screen ........................................................................................... 9-6
Chapter 10: Narrowband Data Proxy (NDP)
Overview......................................................................................................................................... 10-3
General Host Options Screen......................................................................................................... 10-4
Narrowband Data Proxy Emulation Options Screen....................................................................... 10-4
Chapter 11: Remote Socket Emulation Host Configuration
Overview......................................................................................................................................... 11-3
General Host Options Screen......................................................................................................... 11-4
Other TekTerm Server Settings Associated with Remote Sockets ................................................. 11-4
Mobile Device Narrow Band Configuration for Remote Sockets .................................................... 11-4
Base Station Narrow Band Configuration for Remote Sockets....................................................... 11-4
Chapter 12: Base Station Configuration
Overview......................................................................................................................................... 12-3
General Options Screen ................................................................................................................. 12-3
Connectivity Options: TCP/IP Options for Base Station Screen ..................................................... 12-4
Chapter 13: RRM Groups Configuration
Overview......................................................................................................................................... 13-3
General Options Screen: Configure RRM Group Screen ............................................................... 13-3
General Options Parameters .................................................................................................... 13-3
Polling Protocol Parameters........................................................................................................... 13-3
Radio Parameters ..........................................................................................................................13-5
Group Parameters..........................................................................................................................13-5
RRMs Screen: Configure RRM Screen .......................................................................................... 13-6
Analyze Screen: Analyze RRM Group Screen ............................................................................... 13-6
General Parameters.................................................................................................................. 13-6
Polling Protocol Parameters ..................................................................................................... 13-6
Radio Parameters ..................................................................................................................... 13-7
Group Parameters .................................................................................................................... 13-7
Results ...................................................................................................................................... 13-7
viii TekTerm Server Software User Manual
Chapter 14: Radio Link Features Configuration
Cellular Switching and Timeplexing................................................................................................ 14-3
Radio Link Features Screen ........................................................................................................... 14-3
General Options .............................................................................................................................14-3
Chapter 15: 802.IQ v1 and v2 Features Configuration
802.IQ Protocol............................................................................................................................... 15-3
802.IQ Configuration Screen .......................................................................................................... 15-3
802.IQ Common Features..............................................................................................................15-3
Available Interfaces ........................................................................................................................15-4
802.IQ v2 Features.........................................................................................................................15-4
Chapter 16: Redundancy Configuration
Overview......................................................................................................................................... 16-3
Redundancy Parameters Screen.................................................................................................... 16-4
General Redundancy Options........................................................................................................16-4
Available Interfaces ........................................................................................................................16-4
Chapter 17: System Configuration
User Screen.................................................................................................................................... 17-3
SNMP Parameters Screen ............................................................................................................. 17-3
Miscellaneous Options Screen ....................................................................................................... 17-4
Chapter 18: Miscellaneous Commands Configuration
Display Entire Database Contents: Database Validation Results Screen....................................... 18-3
Export/Import Configuration: Configuration Database Import/Export Menu.................................... 18-3
Restart TekTerm Server .................................................................................................................. 18-3
Validate and Save Current Configuration........................................................................................ 18-3
Chapter 19: Setting Terminal Numbers on the General Host Options Screen
Introduction ..................................................................................................................................... 19-3
Systems with One Host .................................................................................................................. 19-3
Systems with Multiple Hosts ........................................................................................................... 19-4
Two Hosts with No Overlapping Terminal Numbers................................................................. 19-4
Two Hosts with Overlap in Terminal Numbers.......................................................................... 19-5
Index........................... .................................................................... ............Index-1
ABOUT THIS GUIDE
ABOUT THIS GUIDE
About this Manual............................................. xi
Supported Emulations and Protocols ..................................xii
Text Conventions.............................................xii
Emulations and Datastreams.......................................xiii
About this Manual
This manual contains information on the installation, basic operation, and configuration of TekTerm Server.
Chapter : About this Guide
an overview of this manual.
Chapter 1: Administering the TekTerm Server
describes how to open the browser interface, access the desktop, start and stop TekTerm Server.
Chapter 2: 3274/Telnet Host Configuration
describes the 3274/Telnet-specific settings.
Chapter 3: 5250/Telnet Host Configuration
describes the 5250/Telnet-specific settings.
Chapter 4: ANSI/Telnet Host Configuration
describes the ANSI/Telnet-specific settings.
About this Guide xi
Chapter 6: 9010/Telnet Host Configuration
describes the 9010/Telnet-specific settings.
Chapter 7: 2392/Telnet Host Configuration
describes the 2392/Telnet-specific settings.
Chapter 8: RF Modem/Telnet Host Configuration
describes the RF Modem/Telnet-specific settings.
Chapter 9: HTML Host Configuration
describes the HTML-specific settings.
Chapter 10: Narrowband Data Proxy (NDP)
describes the NDP-specific settings.
Chapter 11: Remote Socket Emulation Host Conf iguration
describes the remote sockets-specific settings.
Chapter 12: Base Station Configuration
describes the narrow band base station-specific settings.
Chapter 13: RRM Groups Configuration
describes the RRM groups-specific settings.
Chapter 14: Radio Link Features Configuration
describes the radio link-specific settings.
Chapter 15: 802.IQ v1 and v2 Features Configuration
describes the 802.IQ-specific settings.
xii TekTerm Server Software User Manual
Chapter 16: Redundancy Configuration
describes how to configure Communications server redundancy settings.
Chapter 17: System Configuration
describes the user, SNMP, serial number, and authentication settings.
Chapter 18: Miscellaneous Commands Configuration
describes the commands that import, export, and validate the database, as well as the
restart command.
Chapter 19: Setting Terminal Numbers on the General Host Options Screen
explains how the Terminal Range parameter on the Host General Options screen is calculated.
Supported Emulations and Protocols
Emulation
2392 yes
3274 3277, 3278-2, 3278-2-E yes
5250 5251-11, 5555-B01 yes
ANSI yes
9010/TESS yes
RF Modem yes
HTML yes
Remote sockets yes
Text Conventions
NOTE Notes highlight additional helpful information.
Use this Emulation for these
Terminals
Telnet Protocol
IMPORTANT These statements provide particularly important instructions or additional information
that is critical to the operation of the equipment.
WARNING These statements provide critical information that may prevent physical injury, equip-
ment damage or data loss.
Emulations and Datastreams
About this Guide xiii
The TekTerm Server performs emulation conversion: the translation of data between the emulation of the host
computer and the emulation used by the mobile devices.
The data that is sent from a host computer to a terminal, and the data which is returned to the host from the
terminal, is called a datastream.
Legacy Psion devices can accept only two types of datastream: TESS and ANSI. TESS (Teklogix Screen
Subsystem) is the native emulation used by the original Teklogix terminals. TESS features such as page
saving, passthru printing, and TekTerm Screen Formatter are available. ANSI emulation is a standard type of
datastream used by wired VT-type terminals; these terminals are specified by the American National Standards
Institute.
Some Psion mobile devices can accept HTML datastreams for display by a browser.
Other types of supported datastream provided by the host must be converted into TESS or HTML datastreams
by the TekTerm Server.
The emulation software on the TekTerm Server can accept IBM-5250, IBM-3270, HP2392, and HTML datastreams from host computers, and can convert them to, and from, TESS. TekTerm Server caches and
compresses information when creating TESS datastreams to optimize performance. This is most useful when
transmitting across low bandwidth connections using narrow band radios.
The emulation software can also convert IBM-5250 and IBM-3270 datastreams to HTML datastreams, so that
they may be viewed through a web browser on the mobile device. TekTerm Server does not cache or
compress HTML datastreams.
ANSI datastreams from host computers are not converted by the TekTerm Server before being sent to the
mobile devices. The TekTerm Server can, however, cache and compress ANSI datastreams to conserve bandwidth on a narrow band radio network.
xiv TekTerm Server Software User Manual
Some hosts may have Psion handler or SDK software. This software runs on the host and communicates
directly with the host applications. Handlers and SDKs provide TESS datastreams which are compatible with
Psion mobile devices.
Number of Connections
Maximum number of mobile devices 3840
Maximum number of base stations 254
Maximum number of hosts 16
CHAPTER 1 ADMINISTERING THE
TEKTERM SERVER
ADMINISTERING THE TEKTERM SERVER 1
Accessing the TekTerm Server Browser Interface ...........................1-3
Accessing Windows Desktop.......................................1-3
Stopping the TekTerm Server..................................1-3
Restarting the TekTerm Server.................................1-3
Reading Event Log Entries...................................1-3
Accessing the Debug Console......................................1-4
Administering the TekTerm Server 1 - 3
Accessing the TekTerm Server Browser Interface
TekTerm Server is configured through a browser interface.
Connecting locally
Use the following:
http://localhost:8008/
Connecting remotely
Use the following:
http://<IP address>:8008/
Where: <IP address> is the IP address of the computer running the TekTerm Server.
Accessing Windows Desktop
TekTerm Server runs as a service under Windows.
TekTerm Server automatically starts running when the computer starts or restarts.
Connecting remotely
If Remote Desktop access is enabled on the computer whereTekTerm Server is installed you can connect to
it remotely.
Stopping the TekTerm Server
To stop TekTerm Server do the following:
1. In Control Panel select Services from the Administrative Tools menu.
2. Select TekTerm Server Watchdog.
3. Select Stop.
Restarting the TekTerm Server
To restart the TekTerm Server without restarting the hardware do the following:
1. In Control Panel select Services from the Administrative Tools menu.
2. Select TekTerm Server Watchdog.
3. Select Restart.
Reading Event Log Entries
The TekTerm Server logs events that can be viewed with the Windows Event Viewer. The following events
are logged:
• The watchdog task is started.
• The watchdog restarts another task from crash or exit, or from checkpoint failure or timeout.
• The user manually starts, terminates, or restarts a process (through the watchdog).
1 - 4 TekTerm Server Software User Manual
• There is a change of redundancy status for the TekTerm Server: secondary to primary.
• The TekTerm Server starts up as primary, or secondary.
View the logged events
1. In Control Panel, select Event Viewer from the Administrative Tools menu.
2. Select Application events.
3. To view more information on a selected event, double-click the entry for the event.
Accessing the Debug Console
The TekTerm Server provides a text mode debug console. By default no username is needed to open this
console; however, the TekTerm Server may be configured to require a username and password. For information on setting a username and password see User Screen on page 17-3. To make the username and pass-
word required see Enable Telnet User Authentication on page 17-4.
Connecting locally
Use the following:
Telnet://localhost 9523
Connecting remotely
Use the following:
Telnet://<IP address> 9523
Where: <IP address> is the IP address of the computer running the TekTerm Server.
Using the debug console
You should only use this console with the help of Psion support staff.
CHAPTER 2 3274/TELNET HOST
CONFIGURATION
3274/TELNET HOST CONFIGURATION 2
Overview..................................................2-3
General Host Options Screen ......................................2-3
3274 Emulation Options Screen.....................................2-4
3274 Options...........................................2-4
TESS Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
HTML/HTTP Options .....................................2-13
3274 Telnet Protocol Options Screen.................................2-13
3274 Telnet Terminal Naming Screen ............................2-15
3274 Function Key Mappings Screen.................................2-16
Typical Host Configuration.......................................2-17
Line Description........................................2-17
Controller Description.....................................2-18
TCP/IP Link...........................................2-18
Overview
The TekTerm Server can emulate an IBM 3274 controller connected to a number of IBM terminals. The emulation software inside the TekTerm Server converts the 3274 data transparently to and from TESS or HTTP data
which is then sent to and from the Psion devices. The connection between the TekTerm Server and its base
stations, access points, and devices is transparent to the IBM host.
3274/Telnet Host Configuration 2 - 3
General Host Options Screen
Field Description
Name The unique name of the host.
Default: Unnamed Host
Enabled When selected the host task is started when the TekTerm Server starts.
Emulation and
protocol
Emulation and protocol combination for this host.
Select: 3274/Telnet
2 - 4 TekTerm Server Software User Manual
Field Description
Terminal range Terminal number range that communicates with this host.
Range: 1 to 3840. For S900L range is 1 to 50.
Default: 1 to 32
For information on selecting the terminal range see Chapter 19: “Setting Terminal
Numbers on the General Host Options Screen”
Auto terminal
number assignment
(not supported by
Direct TCP)
When selected, TekTerm Server assigns terminal numbers to all mobile devices that
use this session.
When not selected, terminal numbers must be assigned on the mobile devices.
Default: Selected.
3274 Emulation Options Screen
3274 Options
Field Description
Is Host Fujitsu When selected the TekTerm Server sends data in Fujitsu format.
The standard IBM formatting codes (for start of field, setting buffers, etc.) are
replaced by the codes used by Fujitsu host computers.
Default: Not selected.
Use International
EBCDIC
Allow null character
in fixed field
When selected the TekTerm Server uses the international EBCDIC character set,
the positions of the ! and ] characters are swapped.
Default: Not selected.
When selected, empty fields show video attributes properly when using
3274 emulation.
Default: Not selected.
Treat EraseWrite
NOP as Write NOP
Terminal Protocol The protocol used for the connection between the mobile devices and the TekTerm
When selected, during PASSTHRU printing of multiple screens, buffered print data
is not erased.
Default: Selected.
Server. Options are:
TESS/BCM: This uses the TekTerm Server data caching, and page
saving, features.
HTML/HTTP: This uses the Communication Server HTTP server. The browser on
the mobile devices must connect to port 80 on the TekTerm Server.
Default: TESS/BCM
TESS Options
Field Description
Alarm When selected, mobile devices beep when the word ALARM appears on the
Clear When selected, the TekTe r m S e rv e r creates an empty entry field for an entry field that
Passthru When selected, the TekTerm Server allows the host to send data directly to the serial
3274/Telnet Host Configuration 2 - 5
application screen, in the location specified by the Command Region setting. The
word ALARM should be a display-only field.
Command Region must also be set.
Default: Not selected.
For more information see Command Region on page 2-11.
is filled with spaces.
Default: Not selected.
port of the mobile device. This is commonly used for printing.
Preparing Host Screens for Pass-Through:
On the screen to be sent through the mobile device serial port, the word
PASSTHRU has to appear on the first line, starting in the second column. The
actual data to be sent to the mobile device may start anywhere below the first line.
Attributes occupy a position in the screen buffer. An attribute placed between
column 2 and the end of the word PASSTHRU pushes all following characters one
position to the right. Therefore, any required attributes should occupy column 1 of
the first line (just preceding the word PASSTH R U ).
For example:
where @ is an attribute.
When the TekTerm Server finishes sending the data to the printer attached to the
mobile device, it sends a packet containing only a Record Separator (0x1e)
character to the host. The host must wait for this packet before sending any more
screens (including other PASSTHRU screens) to the mobile device.
Refer to the user manual for the mobile device for information about setting
parameters on the mobile device for pass-through.
Default: Not selected.
Procedures Legacy setting. The last device to support this is the 7030.
When selected, the TekTerm Server can send TESS procedures to the mobile
devices. A TESS procedure is a group of TESS commands that can be executed by
the TESS execute procedure command.
Default: Not selected.
2 - 6 TekTerm Server Software User Manual
Field Description
Local Legacy setting. The last device to support this is the 7030.
When selected, the TekTerm Server can provide pages to be loaded as local TESS
procedures in the mobile devices.
The local procedures are selected from a menu on the mobile device. The mobile
device can perform these procedures when it is offline. Later when the mobile
device is online, it sends the results of these functions to the host.
Procedures must also be selected.
Default: Not selected.
Enable TekTerm
Screen Formatter
Remote Print When enabled, the TekTerm Server sends the print page to a mobile device
Pages The number of host screens (or pages) stored on the mobile device.
When selected, the TekTerm Server uses TekTerm Screen Formatter. TekTerm
Screen Formatter was previously known as TSF/0.
Default: Not selected.
whenever the mobile device requests it (by sending the F17 function key from the
mobile device, or the PRINT key on older mobile devices). The TekTerm Server
sends the function response back to the host.
Support for printing must be enabled on the mobile device; refer to the appropriate
user manual for the mobile device for more information.
Default: Not selected.
The TekTerm Server maintains an image of each page stored on the mobile device.
After receiving an application screen, the TekTerm Server tries to match the screen
with a stored page.
If a similar page is already in the mobile device memory, the TekTerm Server
instructs the mobile device to re-display its copy of the page; only the necessary
changes are sent from the TekTerm Server. If no match is found, the complete page
is sent to the mobile device.
There is a corresponding parameter on the mobile device itself, and the actual
number of saved pages is the smaller of the two values.
A value of 1 (one) disables this feature.
Values: 1 to 79
Default: 8
3274/Telnet Host Configuration 2 - 7
Field Description
Host Print When selected, an application can send data to the display on the mobile device as
well as to its attached printer.
The text that is passed to the printer is formatted into a 24 x 80 application screen. If
the host can initiate the print operation, the text is printed. The TekTerm Server
identifies the additional text as a print page by the presence of the string PRINT
beginning in the 2nd column of line 13 on the 24 x 80 screen. PRINT should be
defined as display-only text.
The print page is positioned below the display page of the mobile device (see the
following diagram). The size of the print page is always the same as the display
page of the mobile device (assuming that in the mobile device configuration, the
page length is less than 12 lines).
When Host Print is enabled, the TekTerm Server passes the print page to the mobile
device after receiving the application screen from the host.
Unlike with the Passthru option, when using Host Print no escape commands can
be sent to the printer.
Support for printing must be enabled on the mobile device; refer to the appropriate
user manual for the mobile device for more information
Default: Not selected.
2 - 8 TekTerm Server Software User Manual
Field Description
Transmit Line When enabled, all modified data on the mobile device is automatically transmitted
when the operator enters data into an entry field on or above this line.
The value in this text box specifies the line on the screen which is designated as the
transmit line. The last entry field on or above the transmit line on the screen is
identified as the field which will cause all modified data to be sent to the host. Any
entry fields that exist on lines below the transmit line will not cause the screen to
be transmitted.
A value of 0 (zero) disables this feature.
A value of 24 causes the last entry field on each application screen to be defined as
transmit-upon-entry.
Values: 0 to 24
Default: 0.
AIAG The decimal value of the special character (ASCII) used to tag a field to use
AIAG mode.
When barcode data is entered on a mobile device, the mobile device searches for
AIAG fields on the current page. These fields can accept the special barcode data.
The data preloaded into the AIAG field by the application program determines
whether a barcode is accepted. The format of the preloaded data is:
<mode><AIAG prefix>
The application program distinguishes an entry field as AIAG by preceding the entry
field with this special AIAG character.
A value of 0 (zero) disables this feature.
Values: 0 to 255
Default: 0.
For the AIAG mode character table see AIAG Mode Values on page 2-12.
Field Description
3274/Telnet Host Configuration 2 - 9
Visible Match
Character
The decimal value of the special character (ASCII) used to tag a field to use visible
match mode.
With field matching, the host computer preloads data into an entry field. Now the
mobile device operator can make an entry that matches this preloaded data. For
visible match fields, the preloaded data is displayed in the entry field on the mobile
device.
The application program distinguishes an entry field as a match field by preceding it
with a special character.
The special character is entered as the decimal character code for one of the first
127 ASCII characters.
For example, assume that the > character (ASCII decimal character code 62) is
defined for visible match fields. This character must immediately precede the
entry field:
Part #>_______
The field: Part #> includes the character > and is followed by the part number entry
field on the screen. If any other character was chosen as the last character of the
text, the entry field would not be a match field.
The preloaded data sent to a mobile device may consist of the exact characters,
special match characters or a combination of the two.
For example, suppose you wish to preload an entry field with a part number. If the
exact part number is known, you may preload the field with that part number. If more
flexibility is required, and part numbers always begin with two alphabetic characters
followed by a hyphen character and four digits, then the match string for the field
could be: &&–####.
If an entry is different from the preloaded data, the entry is displayed, the mobile
device beeps and the cursor is in the first position of the match field.
Now either another entry in the match field can be made, or the cursor can be
moved to a new field. When an entry (even if it does not match the host preloaded
data) is made in a match field, this entry is sent to the host as part of the modified
data from the mobile device during the next transmission.
A value of 0 (zero) disables this match field feature.
Values: 0 to 255
Default: 0.
For the Psion match characters see Match Characters on page 2-12.
2 - 10 TekTerm Server Software User Manual
Field Description
Hidden Match
Character
Serial I/O The decimal value of the special character (ASCII) used to tag a field to use serial
The decimal value of the special character (ASCII) used to tag a field to use hidden
match mode.
A special character is used to mark Hidden Match fields in a TESS screen. This
character precedes the field contents of the Hidden Match field. In hidden match
fields, as opposed to visible match fields, the preloaded entry is not displayed in the
entry field on the mobile device.
A value of 0 (zero) disables this feature.
Values: 0 to 255
Default: 0.
For the Psion match characters see Match Characters on page 2-12.
I/O mode.
Serial I/O fields are special entry and fixed fields that accept input from, and output
to, a serial port. The application program distinguishes this field as Serial I/O by
preceding the field with a special character.
If this character precedes a fixed field, the data is sent to the serial port of the mobile
device. If it precedes an entry field, the field accepts data from the serial port of
the mobile device.
A value of 0 (zero) disables this feature.
Values: 0 to 255
Default: 0.
Print Line The starting line number of the print page on the application screen.
A value of 1 (one) causes the display page to be printed. A value of 0 (zero) disables
this feature.
Values: 0 to 24
Default: 0.
Print Form Length The printer form length, in lines.
Values: 0 to 24
Default: 0.
Barcode The decimal value of the special character (ASCII) used to tag a field to use barcode
only mode.
Barcode-input-only fields are special entry fields that only accept input from a
barcode reader. The application program distinguishes an entry field as
barcode-input-only by preceding the field with a special character.
A value of 0 (zero) disables this feature.
Values: 0 to 255
Default: 0.
Loading...