TekTerm Client
Configuration Guide
TEKTERM CLIENT
CONFIGURATION GUIDE
8000300-001
Rev. A
April 2015
ii TekTerm Client Configuration Guide
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
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 Zebra use a licensed p
networ
k without written permission from Zebra. The user agrees
the licensed
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 grants to the user a non-transfer
firmware program delivered hereunder (licensed program). Except as noted below, such license
programs delivered hereunder, and to include the same on any authorized copies it makes, in
able and non-exclusive license to use each
rogram in a
to maintain ’s copyright notice on
Zebra reserves the right to make changes to
design.
Zebra does
any p
roduct, 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.
not assume any product liability arising out
any software or product to improve reliability, function, or
of, or in connection with, the application or use of
Warranty
iii
iv TekTerm Client Configuration Guide
Revision History
Changes to the original guide are listed below:
Change Date Description
Rev -001a 4/2015 Zebra rebrand.
TABLE OF CONTENTS
Table of Contents
About this Guide ............................................................................................................................. xv
Text Conventions ............................................................................................................................ xvi
Ensure that TekTerm Client Persists When the Mobile Device is Cold Booted............................... xvi
Windows CE-based Mobile Devices .............................................................................................. xvi
Windows Embedded Hand-Held-based Mobile Devices...............................................................xvi
Chapter 1: Create a Session and Edit a Session
Overview......................................................................................................................................... 1-3
TekTerm Client Terminology............................................................................................................ 1-3
Field Types ..................................................................................................................................... 1-3
Launching TekTerm Client............................................................................................................... 1-3
Create a New TekTerm Session...................................................................................................... 1-4
Save the Session and Test the Host Connection........................................................................... 1-6
Open the Session Settings to Continue the Setup.......................................................................... 1-6
Configure the Screen Size and Font for the Session...................................................................... 1-6
Chapter 2: Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band
Overview......................................................................................................................................... 2-3
Screen Options ............................................................................................................................... 2-3
Font Advanced ...............................................................................................................................2-4
Legacy Font Code Mapping................................................................................................ 2-4
Font Cycle........................................................................................................................... 2-5
Video...............................................................................................................................................2-5
Colours ...........................................................................................................................................2-6
Default Colours ................................................................................................................... 2-6
Remap Colours ...................................................................................................................2-6
Status Line...................................................................................................................................... 2-6
Lock-B................................................................................................................................. 2-6
Lock-H................................................................................................................................. 2-6
Unlocked ............................................................................................................................. 2-7
vi TekTerm Client Configuration Guide
Advisory Field ..................................................................................................................... 2-7
Hey-you Field...................................................................................................................... 2-7
Highlight Current Field.................................................................................................................... 2-8
Characters Options......................................................................................................................... 2-8
Field Matching ................................................................................................................................ 2-8
Settings...........................................................................................................................................2-9
Tests Options .................................................................................................................................. 2-10
Features Options ............................................................................................................................ 2-10
Local Process .................................................................................................................................2-12
Scanner Options ............................................................................................................................. 2-13
Fields Options................................................................................................................................. 2-14
Runtime Edit Modes and Associated Cursor Movement ...............................................................2-14
5250 Enhanced Edit Mode.............................................................................................................2-14
Field Numbering .............................................................................................................................2-15
Options Settings .............................................................................................................................2-15
Ports Options .................................................................................................................................. 2-17
Printer .............................................................................................................................................2-17
Serial Port ....................................................................................................................................... 2-17
Serial In Function Key ....................................................................................................................2-19
Panning Options ............................................................................................................................. 2-19
Anchor View....................................................................................................................................2-20
Programmable Keys Options.......................................................................................................... 2-20
Label a Programmable Key............................................................................................................2-20
Set the Action Sequence for a Programmable Key .......................................................................2-21
Settings...........................................................................................................................................2-21
Chapter 3: Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP
Overview......................................................................................................................................... 3-3
Host Connection ............................................................................................................................. 3-3
Screen Options ............................................................................................................................... 3-3
Font Advanced ...............................................................................................................................3-4
Legacy Font Code Mapping................................................................................................ 3-4
Font Cycle........................................................................................................................... 3-5
Video...............................................................................................................................................3-5
Colours ...........................................................................................................................................3-6
Default Colours ................................................................................................................... 3-6
Remap Colours ...................................................................................................................3-6
Status Line ......................................................................................................................................3-6
Lock-B................................................................................................................................. 3-6
Lock-H................................................................................................................................. 3-6
Unlocked ............................................................................................................................. 3-7
Advisory Field ..................................................................................................................... 3-7
Hey-you Field...................................................................................................................... 3-7
Highlight Current Field.................................................................................................................... 3-8
Characters Options......................................................................................................................... 3-8
Field Matching ................................................................................................................................ 3-8
Settings...........................................................................................................................................3-9
Table of Contents vii
Tests Options .................................................................................................................................. 3-10
Features Options ............................................................................................................................ 3-11
Local Process ................................................................................................................................. 3-12
Scanner Options ............................................................................................................................. 3-13
Fields Options................................................................................................................................. 3-14
Runtime Edit Modes and Associated Cursor Movement............................................................... 3-14
5250 Enhanced Edit Mode............................................................................................................. 3-14
Field Numbering .............................................................................................................................3-15
Options Settings .............................................................................................................................3-15
Ports Options .................................................................................................................................. 3-17
Printer ............................................................................................................................................. 3-17
Serial Port....................................................................................................................................... 3-17
Serial In Function Key .................................................................................................................... 3-19
Panning Options ............................................................................................................................. 3-19
Anchor View....................................................................................................................................3-20
Programmable Keys Options.......................................................................................................... 3-20
Label a Programmable Key............................................................................................................3-20
Set the Action Sequence for a Programmable Key ....................................................................... 3-21
Settings........................................................................................................................................... 3-21
Chapter 4: Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet
Overview......................................................................................................................................... 4-3
Host Connection Options................................................................................................................ 4-3
Emulation Options For 5250 Emulation and 3270 Emulation........................................................ 4-3
Function Key Remap for 5250 Emulation and 3270 Emulation..................................................... 4-4
Emulation Options for 2392 Emulation .......................................................................................... 4-4
Features.......................................................................................................................................... 4-5
Passthru Printing ............................................................................................................................4-8
Screen Options ............................................................................................................................... 4-9
Font Advanced ...............................................................................................................................4-10
Legacy Font Code Mapping................................................................................................ 4-10
Font Cycle........................................................................................................................... 4-11
Video...............................................................................................................................................4-11
Colours ...........................................................................................................................................4-12
Default Colours ................................................................................................................... 4-12
Remap Colours ...................................................................................................................4-12
Status Line...................................................................................................................................... 4-12
Lock-B................................................................................................................................. 4-12
Lock-H................................................................................................................................. 4-12
Unlocked ............................................................................................................................. 4-13
Advisory Field...................................................................................................................... 4-13
Hey-you Field ...................................................................................................................... 4-13
Highlight Current Field.................................................................................................................... 4-14
Characters Options......................................................................................................................... 4-14
Field Matching ................................................................................................................................ 4-14
Settings........................................................................................................................................... 4-15
viii TekTerm Client Configuration Guide
Tests Options .................................................................................................................................. 4-16
Features Options ............................................................................................................................ 4-17
Local Process .................................................................................................................................4-18
Scanner Options ............................................................................................................................. 4-19
Fields Options................................................................................................................................. 4-20
Runtime Edit Modes and Associated Cursor Movement ...............................................................4-20
5250 Enhanced Edit Mode.............................................................................................................4-20
Field Numbering .............................................................................................................................4-21
Options Settings .............................................................................................................................4-21
Ports Options .................................................................................................................................. 4-23
Printer .............................................................................................................................................4-23
Serial Port ....................................................................................................................................... 4-23
Serial In Function Key ....................................................................................................................4-25
Panning Options ............................................................................................................................. 4-25
Anchor View....................................................................................................................................4-26
Programmable Keys Options.......................................................................................................... 4-26
Label a Programmable Key............................................................................................................4-26
Set the Action Sequence for a Programmable Key .......................................................................4-27
Settings...........................................................................................................................................4-27
Chapter 5: Advanced Configuration for VT Using 802.IQ and Narrow Band
Overview......................................................................................................................................... 5-3
Screen Options ............................................................................................................................... 5-3
Font Advanced ...............................................................................................................................5-3
Legacy Font Mode Mapping ............................................................................................... 5-4
Font Cycle........................................................................................................................... 5-5
Video...............................................................................................................................................5-5
Colours ...........................................................................................................................................5-6
Default Colours ................................................................................................................... 5-6
Remap Colours ...................................................................................................................5-6
Transmit Modes .............................................................................................................................. 5-6
Block Mode Settings.......................................................................................................................5-8
Keyboard Modes............................................................................................................................. 5-10
Special Keys in Local Echo Mode.................................................................................................. 5-12
Edit Modes...................................................................................................................................... 5-12
Ports ............................................................................................................................................... 5-13
Ports Options..................................................................................................................................5-13
Primary Port....................................................................................................................................5-14
Secondary Port...............................................................................................................................5-14
Host Character Set ......................................................................................................................... 5-15
Panning Options ............................................................................................................................. 5-15
Anchor View....................................................................................................................................5-16
Programmable Keys Options.......................................................................................................... 5-16
Label a Programmable Key............................................................................................................5-17
Set the Action Sequence for a Programmable Key .......................................................................5-17
Settings...........................................................................................................................................5-17
Table of Contents ix
Chapter 6: Advanced Configuration for VT Using Direct TCP
Overview......................................................................................................................................... 6-3
Host Connection Options................................................................................................................ 6-3
Screen Options ............................................................................................................................... 6-3
Font Advanced ...............................................................................................................................6-4
Legacy Font Mode Mapping................................................................................................ 6-4
Font Cycle........................................................................................................................... 6-5
Video...............................................................................................................................................6-5
Colours ...........................................................................................................................................6-6
Default Colours ................................................................................................................... 6-6
Remap Colours ...................................................................................................................6-6
Transmit Modes .............................................................................................................................. 6-7
Block Mode Settings.......................................................................................................................6-8
Keyboard Modes............................................................................................................................. 6-10
Special Keys in Local Echo Mode.................................................................................................. 6-12
Edit Modes...................................................................................................................................... 6-12
Ports................................................................................................................................................ 6-13
Ports Options..................................................................................................................................6-13
Primary Port....................................................................................................................................6-14
Secondary Port............................................................................................................................... 6-14
Host Character Set ......................................................................................................................... 6-15
Panning Options ............................................................................................................................. 6-15
Anchor View....................................................................................................................................6-16
Programmable Keys Options.......................................................................................................... 6-16
Label a Programmable Key............................................................................................................6-17
Set the Action Sequence for a Programmable Key ....................................................................... 6-17
Settings........................................................................................................................................... 6-17
Chapter 7: Advanced Configuration for VT Direct to Host Using Telnet
Overview......................................................................................................................................... 7-3
Host Connection Options................................................................................................................ 7-3
Auto Login....................................................................................................................................... 7-4
Extra Prompts ..................................................................................................................... 7-5
Function Key Remap...................................................................................................................... 7-5
Arrow Key Remap .......................................................................................................................... 7-6
Screen Options ............................................................................................................................... 7-6
Font Advanced ...............................................................................................................................7-7
Legacy Font Mode Mapping................................................................................................ 7-7
Font Cycle........................................................................................................................... 7-8
Video...............................................................................................................................................7-8
Colours ...........................................................................................................................................7-9
Default Colours ................................................................................................................... 7-9
Remap Colours ...................................................................................................................7-9
Transmit Modes .............................................................................................................................. 7-10
Block Mode Settings.......................................................................................................................7-11
Keyboard Modes............................................................................................................................. 7-13
Special Keys in Local Echo Mode.................................................................................................. 7-15
x TekTerm Client Configuration Guide
Edit Modes...................................................................................................................................... 7-15
Ports ............................................................................................................................................... 7-16
Ports Options..................................................................................................................................7-16
Primary Port....................................................................................................................................7-17
Secondary Port...............................................................................................................................7-17
Host Character Set ......................................................................................................................... 7-18
Panning Options ............................................................................................................................. 7-18
Anchor View....................................................................................................................................7-19
Programmable Keys Options.......................................................................................................... 7-19
Label a Programmable Key............................................................................................................7-20
Set the Action Sequence for a Programmable Key .......................................................................7-20
Settings...........................................................................................................................................7-20
Chapter 8: Advanced Configuration for VT Direct to Host Using SSH
Overview......................................................................................................................................... 8-3
Host Connection Options................................................................................................................ 8-3
Host Validation Options ..................................................................................................................8-4
User Authentication Options...........................................................................................................8-4
SSH Advanced Options..................................................................................................................8-5
Function Key Remap......................................................................................................................8-6
Arrow Key Remap ..........................................................................................................................8-6
Screen Options ............................................................................................................................... 8-7
Font Advanced ...............................................................................................................................8-7
Legacy Font Mode Mapping ............................................................................................... 8-8
Font Cycle........................................................................................................................... 8-9
Video...............................................................................................................................................8-9
Colours ...........................................................................................................................................8-10
Default Colours ................................................................................................................... 8-10
Remap Colours ...................................................................................................................8-10
Transmit Modes .............................................................................................................................. 8-10
Block Mode Settings.......................................................................................................................8-12
Keyboard Modes............................................................................................................................. 8-14
Special Keys in Local Echo Mode.................................................................................................. 8-16
Edit Modes...................................................................................................................................... 8-16
Ports ............................................................................................................................................... 8-17
Ports Options..................................................................................................................................8-17
Primary Port....................................................................................................................................8-18
Secondary Port...............................................................................................................................8-18
Host Character Set ......................................................................................................................... 8-19
Panning Options ............................................................................................................................. 8-19
Anchor View....................................................................................................................................8-20
Programmable Keys Options.......................................................................................................... 8-20
Label a Programmable Key............................................................................................................8-21
Set the Action Sequence for a Programmable Key .......................................................................8-21
Settings...........................................................................................................................................8-21
Table of Contents xi
Chapter 9: Global Settings
Opening the Global Settings........................................................................................................... 9-3
User Feedback................................................................................................................................ 9-3
Audio Method .................................................................................................................................9-3
Feedback Types.............................................................................................................................9-3
Audio Method Beeper Options....................................................................................................... 9-4
Audio Method WAV Options ........................................................................................................... 9-4
Vibrator Options.............................................................................................................................. 9-4
802.IQ ............................................................................................................................................. 9-5
Security - User Permissions............................................................................................................ 9-7
Window Properties.......................................................................................................................... 9-7
Session Manager............................................................................................................................ 9-9
Ports................................................................................................................................................ 9-11
About Button ................................................................................................................................... 9-13
Save Button or OK Button............................................................................................................... 9-14
Cancel Button ................................................................................................................................. 9-14
Clean All Button .............................................................................................................................. 9-14
Index....................................................... .................................................Index-1
ABOUT THIS MANUAL
ABOUT THIS MANUAL
About this Guide..............................................xv
Text Conventions.............................................xvi
Ensure that TekTerm Client Persists When the Mobile Device is Cold Booted . . . . . . . . . . . . xvi
Windows CE-based Mobile Devices..............................xvi
Windows Embedded Hand-Held-based Mobile Devices . . . . . . . . . . . . . . . . . . . xvi
About this Guide
This configuration guide describes how to configure the TekTerm Client.
TekTerm Client is a powerful emulation application that enables mobile devices to communicate with mainframe hosts. TekTerm Client is able to maintain several, simultaneous sessions with several hosts. The host
connection can be through a TekTerm Server or direct to the host.
Chapter 1: Create a Session and Edit a Session
describes how to how to create a new TekTerm Client session and make non-emulation-specific
changes to the session.
Chapter 2: Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band
describes how to configure network connection and the emulation when using 5250, 3270, 2392,
or TESS, emulations, on an 802.IQ network or a narrow band network.
Chapter 3: Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP
describes how to configure network connection and the emulation when using 5250, 3270, 2392,
or TESS, emulations, on an direct TCP network.
About this Manual xv
Chapter 4: Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet
describes how to configure network connection and the emulation when using 5250, 3270, 2392,
or TESS, emulations, on a Telnet network.
Chapter 5: Advanced Configuration for VT Using 802.IQ and Narrow Band
describes how to configure network connection and the emulation when using VT100 or VT220,
emulations, on an 802.IQ network or a narrow band network.
Chapter 6: Advanced Configuration for VT Using Direct TCP
describes how to configure network connection and the emulation when using VT100 or VT220,
emulations, on an direct TCP network.
Chapter 7: Advanced Configuration for VT Direct to Host Using Telnet
describes how to configure network connection and the emulation when using VT100 or VT220,
emulations, on a Telnet network.
Chapter 8: Advanced Configuration for VT Direct to Host Using SSH
describes how to configure network connection and the emulation when using VT100 or VT220,
emulations, on an SSH connection.
Chapter 9: Global Settings
describes how to configure features that apply to all the sessions, such as user feedback, security, and ports.
xvi TekTerm Client Configuration Guide
Text Conventions
The following conventions are followed throughout this document:
NOTE Notes highlight additional helpful information.
IMPORTANT These statements provide important instructions or additional information that is critical
to the operation of the computer or other equipment.
WARNING These statements provide important information that may prevent injury, damage to
the equipment, or loss of data.
Ensure that TekTerm Client Persists When the Mobile Device is Cold Booted
To ensure that TekTerm Client is not lost during a cold boot, it must be installed in persistent storage. If you
follow the default installation process, TekTerm Client is safely installed in persistent storage.
Windows CE-based Mobile Devices
The process is as follows:
1. The CAB file installs in \\{TekTermTempForAutoPersist}
WARNING If you select a different folder during CAB installation, the TekTerm Client application
will not remain after a cold boot.
2. The setup utility moves the files to these persistent locations:
Psion mobile devices \Flash disk
Zebra mobile devices \A
NOTE Do not attempt to change the install path.
Windows Embedded Hand-Held-based Mobile Devices
The following description applies to Windows Mobile-based mobile devices as well as Windows Embedded
Hand-Held-based mobile devices.
TekTerm Client is installed in the \Program files folder. This folder is persistent and so is saved during a
cold boot.
pplication
CHAPTER 1 CREATE A SESSION AND EDIT
A SESSION
CREATE A SESSION AND EDIT A SESSION 1
Overview..................................................1-3
TekTerm Client Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
Field Types............................................1-3
Launching TekTerm Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
Create a New TekTerm Session.....................................1-4
Save the Session and Test the Host Connection.......................1-6
Open the Session Settings to Continue the Setup...........................1-6
Configure the Screen Size and Font for the Session..........................1-6
Overview
This chapter describes how to create a new TekTerm Client session and define the essential settings for the
network connection to the host and the emulation type.
The following chapters describe the settings that are available for each connection/emulation combination by
selecting the Advanced button.
TekTerm Client Terminology
Field Types
Field Type Description
Fixed Field Data that cannot be changed from the keyboard.
Entry Field For data from the keyboard, a barcode reader, or a serial port.
Match Field The host computer loads data in the format of the expected entry. If the entered
data does not match the expected format, the mobile device emits a long beep.
Create a Session and Edit a Session 1 - 3
Auto-tab Field When this field is filled, the cursor automatically moves to the next field.
Barcode only Field For data from a barcode reader only. Keyboard entry is not accepted.
Serial I/O Field For data from a serial port only. Keyboard entry is not accepted.
Transmit on entry Field Data is transmitted to the host as soon as the field is full.
Launching TekTerm Client
The TekTerm Client is launched from the desktop of your mobile device.
The Launch Menu is displayed. There is an icon for each existing session and an Add Session icon.
1 - 4 TekTerm Client Configuration Guide
Create a New TekTerm Session
Double-click the Add Session icon:
The Session Settings screen opens. It looks like one of the following:
Starting at the top of the screen, enter the session settings. As you select settings, some of the following
settings are greyed out if they do not apply to those that you have already chosen.
Set the session name
This name appears on the Home screen below the icon for this session.
The Session name must be unique.
Select the emulation
Select the emulation used by this session.
Emulation Description
IBM 5250 The mobile device is emulating a 5250 terminal.
IBM 3270 The mobile device is emulating a 3270 terminal.
VT 100/220 The mobile device is emulating a VT100 terminal or a VT220 terminal.
HP 2392 The mobile device is emulating an HP 2392 terminal.
TekTerm Emulation (TESS) The mobile device is using the TESS emulation.
Create a Session and Edit a Session 1 - 5
Emulation Description
TekTerm Console This session displays the console screen of the TekTerm Client.
Connection Statistics This session displays the connection status of the other sessions.
Set the method of connection to the host
Select the connection method used by this session.
Host Connection Method Description
Direct to Host This session connects to the host without passing through the TekTerm
Server.
When selected, a text box opens where you must enter the IP address
of the host.
Not available for the TekTerm Emulation.
TekTerm Server This session is routed through the TekTerm Server to the host.
Set the session connection type
Select the connection type used by this session.
When the host connection method is Direct to Host the options are:
Session Connection Type Description
Te ln e t Use a telnet connection.
SSH Only available for VT 100/220 emulation.
When the host connection method is TekTerm Server the options are:
Session Connection Type Description
802.IQ Use an 802.IQ connection.
Direct TCP When selected, a text box opens where you must enter the IP address
of the TekTerm Server.
Narrow Band The narrow band connection is configured in the Control Panel.
Set the terminal number for this mobile device
Terminal Number Type Description
Auto Terminal Number The terminal number is allocated by the TekTerm Server.
Manual Terminal Number When selected, a text box opens where you must enter the terminal
number for this session on this mobile device. You must ensure that this
number is non-zero and unique.
1 - 6 TekTerm Client Configuration Guide
Select the Host on the TekTerm Server used by this session
When Auto Terminal Number is selected, select the TekTerm Server host used by this session.
TekTerm Server Host Description
TekTerm Server Host 1 This session connects through Host 1 on the TekTerm Server.
TekTerm Server Host 2 This session connects through Host 2 on the TekTerm Server.
... ...
TekTerm Server Host 15 This session connects through Host 15 on the TekTerm Server.
Save the Session and Test the Host Connection
When you have completed this screen, you can test the connection between this session and the host.
1. Click Save.
The Launch Menu opens.
2. Double-click the icon for the session that you have just created.
TekTerm Client makes a connection to the host for this session.
Open the Session Settings to Continue the Setup
1. On the Launch Menu, single-click the icon for the session that you want to configure.
2. Click the Edit icon .
The Session Settings screen opens.
Configure the Screen Size and Font for the Session
When you have completed all the new TekTerm Client session settings, you must configure the data screen for
the session.
Ensure that you have the Session Settings screen open.Click Screen. The Session Screen opens. Set
the following:
Setting Description
Font Rows The number of rows of text that appear on a data screen.
Font Columns The maximum number of characters in a row of text on a data screen.
Not all font sizes are available on all mobile devices. If you configure a size that is not available on your device,
TekTerm Client sets the nearest available font size.
For emulations: 5250, 3270, HP 2392, TESS:
TekTerm Server Host Description
Host Character Set Select the character set used for data for this session.
Create a Session and Edit a Session 1 - 7
For emulation: VT100/220:
TekTerm Server Host Description
Host Character Set Lower Select the character set for the lower character table.
If you select an 8-bit character set, you cannot set the upper
character table.
Host Character Set Upper Select the character set for the upper character table.
CHAPTER 2 ADVANCED CONFIGURATION
FOR 5250, 3270, 2392, AND TESS
USING 802.IQ AND NARROW
BAND
ADVANCED CONFIGURATION FOR 5250, 3270, 2392, AND TESS USING 802.IQ AND NARROW BAND 2
Overview..................................................2-3
Screen Options..............................................2-3
Font Advanced..........................................2-4
Legacy Font Code Mapping..............................2-4
Font Cycle .......................................2-5
Video...............................................2-5
Colours..............................................2-6
Default Colours.....................................2-6
Remap Colours.....................................2-6
Status Line............................................2-6
Lock-B..........................................2-6
Lock-H .........................................2-6
Unlocked........................................2-7
Advisory Field .....................................2-7
Hey-you Field......................................2-7
Highlight Current Field......................................2-8
Characters Options............................................2-8
Field Matching..........................................2-8
Settings..............................................2-9
Tests Options ..............................................2-10
Features Options............................................2-10
Local Process .........................................2-12
Scanner Options.............................................2-13
Fields Options..............................................2-14
Runtime Edit Modes and Associated Cursor Movement..................2-14
5250 Enhanced Edit Mode..................................2-14
Field Numbering........................................2-15
Options Settings........................................2-15
2 - 2 TekTerm Client Configuration Guide
Ports Options...............................................2-17
Printer..............................................2-17
Serial Port............................................2-17
Serial In Function Key.....................................2-19
Panning Options.............................................2-19
Anchor View...........................................2-20
Programmable Keys Options......................................2-20
Label a Programmable Key..................................2-20
Set the Action Sequence for a Programmable Key.....................2-21
Settings.............................................2-21
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 3
Overview
This chapter describes all the advanced settings that are available for the 5250, 3270, 2392 and TESS emulations on an 802.IQ connection through a TekTerm Server.
The 802.IQ, or narrow band, connection is configured on the desktop of the mobile device.
Screen Options
Setting Description
Screen Size Host screen size.
If the page size received from the host is larger than this size,
TekTerm Client trims the host page to this size.
If the size is larger than the session screen size, scrolling and panning
are used to view the screen on the mobile device. For information on
setting the session screen size see Configure the Screen Size and
Font for the Session on page 1-6.
Default: 24 rows x 80 columns.
Block Cursor Yes: The cursor is a flashing block.
No: the cursor is a flashing underline character.
Default: Yes.
Pages Saved The maximum number of pages that are stored by TekTerm Client.
Storing frequently used page data on the mobile device reduces the
need for the TekTerm Server to retransmit complete data pages over
the radio link. Retransmitting data can reduce the system response
time. Increasing the number of saved pages decreases the available
memory for other functions.
Default: 16.
Origin Scroll Yes: The display window moves to the origin (upper-left corner) after
LOCK-H or LOCK-B messages.
No: The cursor does not move.
Default: No.
Field Scroll Yes: The display window moves to the left after entering a new entry
field.
No:The window does not move.
Default: No.
Application Parameter Applies only when the host is running a TSDK application.
Sent to the host system as part of the response to the TESS
Parameter Query command.
Default: 0 (zero).
2 - 4 TekTerm Client Configuration Guide
Font Advanced
Setting Description
Font name The name of the font used for this session. Select from the
drop-down list.
Default selects the default font defined for the mobile device the
TekTerm Client is running on.
Default: Default.
Normal font weight A number defining the weight of non-bolded text. The larger the
number, the heavier the text.
Default: 500.
Bold font weight A number defining the weight of bolded text. The larger the number,
the heavier the text.
Default: 700.
Ignore host commands Yes: Use the font name and font weights defined for this session. If
the host sends font change requests these are ignored.
Legacy Font Code Mapping
The Font Codes parameters are used to define how legacy font codes are handled when received as part of a
font change command from the host. If a font code is not explicitly handled, the result depends on the screen
size available to the application.
Setting Description
Font Code 1 Default: 0.
Font 1 Default: 17x30.
Font Code 2 Default: 1.
Font 2 Default: 22x30.
Font Code 3 Default: 2.
Font 3 Default: 13x20.
Font Code 4 Default: 3.
Font 4 Default: 34x48.
No: The host can change the font name and the font weights.
Default: No.
Font Code 5 Default: 4.
Font 5 Default: 9x15.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 5
Font Cycle
When the operator of the mobile device cycles through the font sizes while running the TekTerm Client session,
this is the list of font sizes that can be selected.
Setting Description
Font 1 First font size in cycle.
Font 2 Second font size in cycle.
Font 3 Third font size in cycle.
Font 4 Fourth font size in cycle.
Font 5 Fifth font size in cycle.
Default: 17x30.
Default: 22x30.
Default: 13x20.
Default: 34x48.
Video
Default: 9x15.
These settings specify the video attributes to be displayed on the mobile device, when a video setting is
received in the data from the host. The choices are:
• Normal—display as normal text.
• Bold—display as bold text.
• Blink—display as blinking text.
• Reverse—display in reverse video.
• Underline—display as underlined text.
Setting Description
Normal Default: Normal.
Bold Default: Bold.
Blink Default: Blink.
Reverse Default: Reverse.
Underline Default: Underline.
2 - 6 TekTerm Client Configuration Guide
Colours
Default Colours
These settings specify the foreground and background screen colours for this session. Use Remap Colours to
set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for this session.
Default: Black.
Background Select the screen background colour for this session.
Default: White.
Remap Colours
Remap Colours gives access to the colour definitions for the colours that can be selected as the foreground
and background colours for this session. When you select a colour from the menu, you can set its RGB values.
Status Line
Lock-B
Lock-H
The status line is displayed at the bottom of the screen during the session.
These settings specify the foreground and background screen colours for the status line when the session is in
Lock-B status. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for the status line.
Default: Black.
Background Select the screen background colour for the status line.
Default: Red.
These settings specify the foreground and background screen colours for the status line when the session is in
Lock-H status. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for the status line.
Default: Black.
Background Select the screen background colour for the status line.
Default: Yellow.
Unlocked
These settings specify the foreground and background screen colours for the status line when the session is in
unlocked status. Use Remap Colours to set the colour definitions for these colours.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 7
Setting Description
Enabled Yes: The status line is displayed when the session is in unlocked
status.
No: The status line is not displayed when the session is in unlocked
status.
Default: No.
Foreground Select the screen foreground colour for the status line.
Default: Black.
Background Select the screen background colour for the status line.
Default: Green.
Advisory Field
These settings specify the foreground and background screen colours for the status line when an advisory
message is received. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Acknowledge key The keyboard key that is used to clear the advisory message.
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Hey-you Field
These settings specify the foreground and background screen colours for the status line when a hey-you
message is received. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Acknowledge key The keyboard key that is used to clear the hey-you message.
Default: F0.
Default: Black.
Default: White.
Default: F0.
Foreground Select the screen foreground colour for the status line.
Default: White.
Background Select the screen background colour for the status line.
Default: Black.
2 - 8 TekTerm Client Configuration Guide
Highlight Current Field
These settings specify the foreground and background screen colours for the current field. Use Remap
Colours to set the colour definitions for these colours.
Setting Description
Enabled Yes: The current field is highlighted.
No: The current field is not highlighted.
Default: No.
Foreground Select the screen foreground colour for the highlighted field.
Default: Black.
Background Select the screen background colour for the highlighted field.
Default: Yellow.
Characters Options
Field Matching
The field matching function permits the TekTerm Client to perform some checks on the entered data before it is
sent to the host. If the data entered by the operator does not match a data string preloaded by the host, the
mobile device generates an input error, and the cursor remains in the same field. However, if the operator
ignores the input error, the data is accepted and sent to the host. It is then up to the host system to resolve the
mismatched data.
The input error generated can be a sound and/or a vibration. For options see the Input Error settings in User
Feedback on page 9-3.
Match Fields
The host application can specify an exact character-by-character match, using field match characters; or, it can
use special characters in the preloaded string to specify a more general match requirement, using field match
strings.
The host application can specify whether the preloaded match string should be displayed to the terminal operator (visible match field) or not (hidden match field). Data is returned to the host from match fields in the same
way as from normal entry fields.
Set the Visible Match Character or the Hidden Match Character to the character that begins the match field.
If the first character of an update to an entry field is one of the match characters, the rest of the update is
loaded as a match string. The entire string is displayed if the character matches the Visible Match Character, or
hidden if it matches the Hidden Match Character.
For example, if the Visible Match Character is set to v, the string v15abcde sent from the host specifies a
visible match for field1 of abcde.
Since the leading match character occupies field space, the entry field size must be specified as one character
larger than the expected data.
The preloaded match string remains in effect until the host clears the field or loads a different string.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 9
Field Match Strings
Use the following special characters in match strings to specify non-exact matching:
• # to match a number (0123456789).
• & to match a letter, either case (AaBbCc...Zz).
• ^ to match an upper case letter (ABCDE...Z).
• _ (underscore) to match a lower case letter (abcde...z).
• | to match an alphanumeric character.
• " to match a text character (letter, number, or space).
• ? to match a punctuation character (.,;:?!...).
• ' to match any character.
• : to match all character positions in the field with the preceding character.
• ; to match any remaining characters entered with the preceding character, but not necessarily with the
remainder of the field.
For example, the match string &&-## will match on AA-67, GH-01, and so on. If the match string is shorter
than the field size, the characters not specified by the match string are not checked (unless : or ; is used).
Settings
Setting Description
Bidirectional Text Applies to Arabic text and Hebrew text.
Yes: Text direction is set by the host.
No: All text is left to right.
Default: No.
Assume Right-To-Left Applies to Arabic text and Hebrew text.
Yes: Assume that the first message from the host is to be displayed
from right to left. This message may precede a text direction setting
from the host.
No: All text is left to right.
Default: No.
Visible Match Character The decimal value of the character (ASCII) that begins a visible
match field.
A value of 0 (zero) disables this feature.
Default: 0 (zero).
Hidden Match Character The decimal value of the character (ASCII) that begins a hidden
match field.
A value of 0 (zero) disables this feature.
Default: 0 (zero).
2 - 10 TekTerm Client Configuration Guide
Setting Description
Fill Character The ASCII decimal representation of the character that fills empty
entry fields. Commonly used values are:
• 95 for underline character fill
• 46 for period character fill
Some systems may use the space character with the host using
reverse video attributes to mark entry fields.
Default: 46.
Upper Case Yes: Lower case input is converted to upper case.
No: Lower case is not converted.
Default: No.
Tests Options
Setting Description
Auto Repeat Function Key The function key sent to the host in auto reply mode.
Auto Repeat Timeout The time (in seconds) between the mobile device being unlocked and the
Features Options
These settings apply to printing from the session.
Queueing Mode
In some sessions, queueing mode can decrease the lock time. In queueing mode, the host computer may send
several pages to a unit without waiting for a response. These pages are stored in a queue within the device.
The operator completes the entries on the first page and then, presses a function key. The mobile device
simultaneously transmits to the host and displays the next page in the queue. The computer does not lock,
allowing the operator to enter data on the next page immediately. This continues as long as there are pages in
the queue.
After sending this key, the mobile device locks and waits for the host to
unlock it.
0 (zero) represents F0, 1 represents F1...
Default: 0 (zero).
next transmission of the function key specified in Auto Repeat
Function Key.
0 (zero) disables auto reply mode.
Default: 0 (zero).
Queueing mode is used for repetitive tasks, and the queued screens look identical. The device displays a Next
message indicating that a new page is on the display. Next messages also contain information about radio
communications: NEXT-B indicates that the unit has data to transmit to the base station. NEXT-H indicates that
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 11
the base station has acknowledged a transmission. Unlike lock messages, Next messages do not lock the
keyboard. Keying is allowed while Next messages are displayed.
While queueing mode may improve apparent response time, it can present difficulties to hosts that are oper-
ating in real time. It should only be used after careful consideration of the host environment. Queueing = Yes
must be set for the session.
Setting Description
Binary Print Yes: The page displayed on the mobile device is spooled to the printer
unchanged except for white space removal.
No: Each line of the displayed page is preceded by a line feed character
(LF) and followed by a carriage return character (CR).
Default: No.
Remap Passthru Yes: Passthru data is remapped from the host character set to the port
character set.
No: Passthru data is sent to the port with no remapping.
Default: No.
Queueing Yes: Queueing mode is enabled. It also enables TESS procedures to be
loaded onto the mobile device.
This setting should be enabled if local procedures and the ability to
switch between hosts within a TESS session are required.
No: Queueing mode is not enabled.
Changes to this setting take effect only after the mobile device is reset.
Default: Yes.
Send Milestone Yes: A milestone is sent to the host after a hey-you command.
No: A milestone is not sent to the host.
Default: No.
Next X Yes: Next messages are enabled in queueing mode.
No: Next messages are not enabled.
Default: No.
2 - 12 TekTerm Client Configuration Guide
Setting Description
Keyboard Locked Yes: If the keyboard is locked the following keys still function:
• Function keys
•Arrow keys
• Enter key
The mobile device emits an error beep, if a character is rejected because
the keyboard is locked.
No: The keyboard is not locked.
Changes to this setting take effect only after the mobile device is reset.
Default: No.
Disable Beep Yes: The beep generated by the o, G, and # TESS commands is turned
off.
No: The beep is not turned off.
Default: No.
Local Process
Local procedures are downloaded to the session by the host. They are intended to be run locally on the mobile
device when there is no radio signal. At runtime, these procedures are selected from the Local Menu screen.
Each procedure is associated with a function key. This function key association is only active while the Local
Menu is displayed, and does not affect any other function key mappings.
Once data entry for a procedure is completed, the data is placed in a queue for transmission to the host. This
data is transmitted as a background task when there is a radio link to the host.
Setting Description
Enabled Yes: Local procedures are enabled.
Save on Reset Yes: Data entered into local procedures on the mobile device is saved
No: Local procedures are not enabled.
Default: Yes.
when the device is reset.
No: Data entered into local procedures on the mobile device is lost when
the device is reset.
Default: No.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 13
Scanner Options
Setting Description
Continue in Next Field Yes: Barcodes that are longer than the field length flow into the next field.
Append Enter Yes: An Enter is appended to the barcode. The Enter completes the
Append F0 Yes: An F0 is appended to the barcode. The F0 completes the entry of
Applies only to string data entry.
No: Barcodes do not flow into the next field.
Default: Yes.
barcode and moves the cursor to the next field.
No: An Enter is not appended to the barcode.
Default: Yes.
the barcode.
No: F0 is not appended to the barcode.
Default: No.
Mixed AIAG Yes: AIAG labels are always accepted and processed–even if mixed with
keyboard input. The AIAG label can replace the partially entered
keyboard data.
No: AIAG labels are rejected if keyboard entry is in progress.
Default: No.
Reject if Alpha Yes: Barcodes containing alphabetic characters are rejected when the
cursor is in a numeric field.
No: These barcodes are not rejected.
Default: No.
Beam Lockout Yes: The scanner cannot be used when the session is in LOCK-H mode.
No: The scanner can be used in Lock-H mode.
Default: No.
2 - 14 TekTerm Client Configuration Guide
Fields Options
Runtime Edit Modes and Associated Cursor Movement
Edit Mode
Field mode Press Ctrl, f Once data entry into
Fcursor mode Press Ctrl, u Once data entry into
Insert mode Press Ctrl, i Data can be entered
Enter this
Mode
Description
a field has been
completed, the entry
cannot be changed
without retyping the
entire field.
a field has been
completed, the entry
cannot be changed
without retyping the
entire field.
between two
existing characters.
Cursor Movement
Enter On Arrow = Yes
The Right Arrow key
and the Left Arrow key
do not perform any
functions.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous or
next field.
The Up Arrow key, the
Down Arrow key, the
Left Arrow key, and the
Right Arrow key move
the cursor
between fields.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Cursor Movement
Enter On Arrow = No
The Right Arrow key
and the Left Arrow key
do not perform any
functions.
The Up Arrow key, the
Down Arrow key, the
Left Arrow key, and
the Right Arrow key
move the cursor
between fields.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Replace mode Press Ctrl, r Data can be
5250 Enhanced Edit Mode
In Enhanced Edit mode, the cursor can be moved freely about the terminal screen with the arrow keys. In the
normal edit mode, a cursor can be moved among the entry fields using the up and down arrow keys.
entered over
existing characters.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous, or
next, field.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous, or
next, field.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 15
When an AID key is pressed the terminal would then return the row and column positions of the cursor, in addition to user data.
When Enhanced Edit Mode is enabled, replace mode and insert mode are the only edit modes available.
Field Numbering
The way that the cursor moves between fields is determined by one of the following:
• The location of the field on the screen.
• The field numbers assigned by the host. Any field, fixed or entry, can have a field number assigned to it.
Field numbers have two uses:
• They associate data moving between the host and terminal with specific fields.
• When Field Order is set to Yes, in the following edit modes the arrow keys send the cursor to the field with
the next number no matter where the field is on the screen:
- Field mode
- Fcursor mode
- 5250 enhanced edit mode
Options Settings
Setting Description
Field Order Yes: The cursor moves according to the field locations on the screen.
Enter to F0 Yes: Enter is interpreted as F0, and it starts a transmission from
Enter on Arrow Yes: The Up Arrow key and the Down Arrow key can be used to
No: The cursor moves according to the numeric order of the
field numbers.
Default: Yes.
For more information see Field Numbering on page 2-15.
the session.
No: Enter moves the cursor to the next field.
Default: Yes.
complete data entry into a field, and start a transmission from
the session.
No: The arrow keys do not start transmission from the session.
Default: Yes.
All Field Video Yes: Video attributes apply to the entire entry field, including spaces.
No: Video attributes apply only to text in the entry field.
Default: Yes.
2 - 16 TekTerm Client Configuration Guide
Setting Description
Entry Mode Select the data entry edit mode.
Options:
• Field
• Replace
• Insert
•Fcursor
Default: Field.
For more information see Runtime Edit Modes and Associated Cursor
Movement on page 2-14
Open for Function Keys Only Yes: The cursor is not positioned on the screen, and only the function
keys are available for entry.
No: The cursor is positioned in a data entry field.
Default: No.
Ignore Barcode Only Yes: Fields that are defined as barcode only accept keyboard input
as well.
No: Barcode only fields do not accept keyboard input.
Default: No.
Enhanced Edit Mode Applies only to 5250 emulation.
Yes: Enhanced edit mode is enabled.
No: Enhanced edit mode is not enabled.
Default: No.
For more information see 5250 Enhanced Edit Mode on page 2-14.
Valid Numerics Up to 39 characters that are to be considered as valid in a numeric field.
There is no need to include the numerals from 0 to 9.
Default: +-%*/.,$
Touch Macro A string that is sent to the host as keyboard input when the operator taps
a field.
Default: None.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 17
Ports Options
Printer
Setting Description
Printer Select the printer port used by this session The options are:
Character Set Select the character set for use with the printer on this port.
• None
• Private Port
• Shared Port 1
• Shared Port 2
• Shared Port 3
• Shared Port 4
Default: None.
Serial Port
Setting Description
Serial Port Select the serial port that this session uses for serial I/O.
Character Set The character set to use with the device on this port. Select from a list.
Serial Out Yes: The serial port output fields are enabled.
Serial In Yes: The serial port input fields are enabled.The session has exclusive
Default: IBM PC 437 USA
Default: None.
Default: IBM PC 437 USA.
No: The serial port output fields are not enabled.
Default: Yes.
use of the serial port.
Acceptance of data in a SI field is determined by the Serial In prefix and
Serial In suffix.
No: The serial port input fields are not enabled
Default: No.
2 - 18 TekTerm Client Configuration Guide
Setting Description
Serial In Mode Field: Data received through the serial port is displayed in the serial input
fields.
Command: Data received through the serial port is transmitted as
passthru data to the host. At the host this data can only be processed if
the host application is using TSDK or TTH; otherwise, the host
application discards it.
Default: Field.
Serial In prefix The start of message character on serial input. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no prefix.
Default: 10.
Serial In suffix The end of message character on serial input. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no suffix.
Default: 13.
Serial in CRC Yes: A packet is rejected if its CRC is not valid. Also, every DLE
character is removed and the character following it is replaced by its 1s
complement.
No: A packet is not rejected if its CRC is not valid.
Default: No.
Serial Out prefix The start of message character on serial output. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no prefix.
Default: 0a 00 00 00 00 00 00 00.
Serial Out suffix The end of message character on serial output. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no suffix.
Default: 0d 00 00 00 00 00 00 00.
Serial Out CRC Yes: A CRC16 is appended to the serial output message. Also for each
control character in the serial output stream, a DLE is inserted before the
control character, and the control character is replaced by its 1s
complement.
No: A CRC16 is not appended to the serial output message.
Default: No.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 19
Serial In Function Key
Setting Description
Use Function Key Yes: A function key is appended to the serial input.
Function Key Number When Use Function Key is set to Yes, this is the number of the function
Panning Options
These are the screen panning setting for the session.
No: A function key is not appended to the serial input.
Default: No.
key that is to be appended to the serial input.
Entering 0 appends F0, entering 1 appends F1, entering 2 appends F2...
Data is transmitted as soon as the function key is appended.
Default: 0 (zero).
Setting Description
Row Increment The number of rows that the screen pans on each time Alt, Up Arrow, or
Alt, Down Arrow, is entered.
Default: 1
Column Increment The number of columns that the screen pans on each time Alt,
Left Arrow, or Alt, Right Arrow, is entered.
Default: 1
Touch Panning Touch panning allows the operator to drag the screen.
Yes: Touch panning is enabled.
No: Touch panning is not enabled.
Default: Yes
Display Shift Display shift shifts the application screens so that there are no empty
columns on the left-most side of the display.
Yes: Display shift is enabled.
No: Display shift is not enabled.
Default: Yes
2 - 20 TekTerm Client Configuration Guide
Anchor View
Setting Description
Enabled Yes: The display is locked at a specific location on the screen.
No: The display is not locked at a specific location on the screen.
Default: No.
X origin The column where the upper left corner of the screen is locked.
Default: 1
Y origin The row where the upper left corner of the screen is locked.
Default: 1
Programmable Keys Options
Programmable keys are soft keys that you can configure for the session. 24 programmable keys are available
for each session. Each of these keys can have a sequence of up to 20 actions defined. You can also give each
key a label.
Runtime use of programmable keys
The operator can toggle the display of the programmable keys on the screen. When displayed they look
like this:
In this example the labels on Key 1, Key 2, and Key 3 have been changed from the default labels. All 24
programmable keys are available as onscreen softkeys, if you can fit them onto the two lines of keys on the
display of your mobile device.
At runtime Key 1 through to Key 10 are also selected by the following keyboard shortcuts:
Ctrl, n
where n is a digit between 0 and 9. Ctrl, 1 selects Key 1.Ctrl, 2 selects Key 2. Ctrl, 9 selects Key 9. Ctrl, 0
selects Key 10.
Label a Programmable Key
You can set the onscreen label for a programmable key as follows:
1. Double click the label item for the key on the menu.
The label item looks like this:
Key 1 (Ctrl-1): F1
2. Enter the new label in the dialog box.
Advanced Configuration for 5250, 3270, 2392, and TESS Using 802.IQ and Narrow Band 2 - 21
Set the Action Sequence for a Programmable Key
For each key that you want to define:
1. Expand the key menu item.
A list of 20 action items is displayed.
2. Select each action item that you want to configure.
You can configure one of the following for each item:
• A keyboard character.
• The code for a Unicode character.
• A function key, a keyboard navigation command, or an emulation command, selected from the
drop-down list.
Settings
Setting Description
On-screen (Top Row) Number of programmable key labels displayed on the top row.
Valid values are 0 to 12.
0 (zero): No keys are displayed on this line.
Default: 5.
On-screen (Bottom Row) Number of programmable key labels displayed on the bottom row.
Valid values are 0 to 12.
0 (zero): No keys are displayed on this line.
Default: 5.
Key 1 ... Key 24 Programmable key settings. An onscreen label and up to 20 actions for
each key.
Default label: F1 ... F24
Default action: F1 ... F24
CHAPTER 3 ADVANCED CONFIGURATION
FOR 5250, 3270, 2392, AND TESS
USING DIRECT TCP
ADVANCED CONFIGURATION FOR 5250, 3270, 2392, AND TESS USING DIRECT TCP 3
Overview..................................................3-3
Host Connection..............................................3-3
Screen Options..............................................3-3
Font Advanced..........................................3-4
Legacy Font Code Mapping..............................3-4
Font Cycle .......................................3-5
Video...............................................3-5
Colours..............................................3-6
Default Colours.....................................3-6
Remap Colours.....................................3-6
Status Line............................................3-6
Lock-B..........................................3-6
Lock-H .........................................3-6
Unlocked........................................3-7
Advisory Field .....................................3-7
Hey-you Field......................................3-7
Highlight Current Field......................................3-8
Characters Options............................................3-8
Field Matching..........................................3-8
Settings..............................................3-9
Tests Options ..............................................3-10
Features Options............................................3-11
Local Process .........................................3-12
Scanner Options.............................................3-13
Fields Options..............................................3-14
Runtime Edit Modes and Associated Cursor Movement..................3-14
5250 Enhanced Edit Mode..................................3-14
Field Numbering........................................3-15
Options Settings........................................3-15
3 - 2 TekTerm Client Configuration Guide
Ports Options...............................................3-17
Printer..............................................3-17
Serial Port............................................3-17
Serial In Function Key.....................................3-19
Panning Options.............................................3-19
Anchor View...........................................3-20
Programmable Keys Options......................................3-20
Label a Programmable Key..................................3-20
Set the Action Sequence for a Programmable Key.....................3-21
Settings.............................................3-21
Overview
This chapter describes all the advanced settings that are available for the 5250, 3270, 2392 and TESS emulations on a direct TCP connection through a TekTerm Server. Also the ports used for the direct TCP connection
are configured.
Host Connection
Setting Description
Auto Host Port Yes: Port 9999 is used.
Host Port The host port when Auto Host Port is not selected.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 3
No: The port defined in Host Port is used.
Default: Yes.
Default: 9999.
Screen Options
Setting Description
Screen Size Host screen size.
Block Cursor Yes: The cursor is a flashing block.
Pages Saved The maximum number of pages that are stored by TekTerm Client.
If the page size received from the host is larger than this size,
TekTerm Client trims the host page to this size.
If the size is larger than the session screen size, scrolling and panning
are used to view the screen on the mobile device. For information on
setting the session screen size see Configure the Screen Size and
Font for the Session on page 1-6.
Default: 24 rows x 80 columns.
No: the cursor is a flashing underline character.
Default: Yes.
Storing frequently used page data on the mobile device reduces the
need for the TekTerm Server to retransmit complete data pages over
the radio link. Retransmitting data can reduce the system response
time. Increasing the number of saved pages decreases the available
memory for other functions.
Default: 16.
3 - 4 TekTerm Client Configuration Guide
Setting Description
Origin Scroll Yes: The display window moves to the origin (upper-left corner) after
LOCK-H or LOCK-B messages.
No: The cursor does not move.
Default: No.
Field Scroll Yes: The display window moves to the left after entering a new entry
field.
No:The window does not move.
Default: No.
Application Parameter Applies only when the host is running a TSDK application.
Sent to the host system as part of the response to the TESS
Parameter Query command.
Default: 0 (zero).
Font Advanced
Setting Description
Font name The name of the font used for this session. Select from the
Normal font weight A number defining the weight of non-bolded text. The larger the
Bold font weight A number defining the weight of bolded text. The larger the number,
Ignore host commands Yes: Use the font name and font weights defined for this session. If
drop-down list.
Default selects the default font defined for the mobile device the
TekTerm Client is running on.
Default: Default.
number, the heavier the text.
Default: 500.
the heavier the text.
Default: 700.
the host sends font change requests these are ignored.
No: The host can change the font name and the font weights.
Default: No.
Legacy Font Code Mapping
The Font Codes parameters are used to define how legacy font codes are handled when received as part of a
font change command from the host. If a font code is not explicitly handled, the result depends on the screen
size available to the application.
Setting Description
Font Code 1 Default: 0.
Font 1 Default: 17x30.
Font Code 2 Default: 1.
Font 2 Default: 22x30.
Font Code 3 Default: 2.
Font 3 Default: 13x20.
Font Code 4 Default: 3.
Font 4 Default: 34x48.
Font Code 5 Default: 4.
Font 5 Default: 9x15.
Font Cycle
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 5
Video
When the operator of the mobile device cycles through the font sizes while running the TekTerm Client session,
this is the list of font sizes that can be selected.
Setting Description
Font 1 First font size in cycle.
Default: 17x30.
Font 2 Second font size in cycle.
Default: 22x30.
Font 3 Third font size in cycle.
Default: 13x20.
Font 4 Fourth font size in cycle.
Default: 34x48.
Font 5 Fifth font size in cycle.
Default: 9x15.
These settings specify the video attributes to be displayed on the mobile device, when a video setting is
received in the data from the host. The choices are:
• Normal—display as normal text.
• Bold—display as bold text.
• Blink—display as blinking text.
• Reverse—display in reverse video.
• Underline—display as underlined text.
3 - 6 TekTerm Client Configuration Guide
Setting Description
Normal Default: Normal.
Bold Default: Bold.
Blink Default: Blink.
Reverse Default: Reverse.
Underline Default: Underline.
Colours
Default Colours
These settings specify the foreground and background screen colours for this session. Use Remap Colours to
set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for this session.
Background Select the screen background colour for this session.
Remap Colours
Remap Colours gives access to the colour definitions for the colours that can be selected as the foreground
and background colours for this session. When you select a colour from the menu, you can set its RGB values.
Status Line
The status line is displayed at the bottom of the screen during the session.
Lock-B
These settings specify the foreground and background screen colours for the status line when the session is in
Lock-B status. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Default: Black.
Default: White.
Default: Black.
Lock-H
Default: Red.
These settings specify the foreground and background screen colours for the status line when the session is in
Lock-H status. Use Remap Colours to set the colour definitions for these colours.
Unlocked
These settings specify the foreground and background screen colours for the status line when the session is in
unlocked status. Use Remap Colours to set the colour definitions for these colours.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 7
Setting Description
Foreground Select the screen foreground colour for the status line.
Default: Black.
Background Select the screen background colour for the status line.
Default: Yellow.
Setting Description
Enabled Yes: The status line is displayed when the session is in unlocked
status.
No: The status line is not displayed when the session is in unlocked
status.
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Advisory Field
These settings specify the foreground and background screen colours for the status line when an advisory
message is received. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Acknowledge key The keyboard key that is used to clear the advisory message.
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Default: No.
Default: Black.
Default: Green.
Default: F0.
Default: Black.
Default: White.
Hey-you Field
These settings specify the foreground and background screen colours for the status line when a hey-you
message is received. Use Remap Colours to set the colour definitions for these colours.
3 - 8 TekTerm Client Configuration Guide
Setting Description
Acknowledge key The keyboard key that is used to clear the hey-you message.
Default: F0.
Foreground Select the screen foreground colour for the status line.
Default: White.
Background Select the screen background colour for the status line.
Default: Black.
Highlight Current Field
These settings specify the foreground and background screen colours for the current field. Use Remap
Colours to set the colour definitions for these colours.
Setting Description
Enabled Yes: The current field is highlighted.
Foreground Select the screen foreground colour for the highlighted field.
Background Select the screen background colour for the highlighted field.
Characters Options
Field Matching
The field matching function permits the TekTerm Client to perform some checks on the entered data before it is
sent to the host. If the data entered by the operator does not match a data string preloaded by the host, the
mobile device generates an input error, and the cursor remains in the same field. However, if the operator
ignores the input error, the data is accepted and sent to the host. It is then up to the host system to resolve the
mismatched data.
The input error generated can be a sound and/or a vibration. For options see the Input Error settings in User
Feedback on page 9-3.
Match Fields
No: The current field is not highlighted.
Default: No.
Default: Black.
Default: Yellow.
The host application can specify an exact character-by-character match, using field match characters; or, it can
use special characters in the preloaded string to specify a more general match requirement, using field match
strings.
The host application can specify whether the preloaded match string should be displayed to the terminal operator (visible match field) or not (hidden match field). Data is returned to the host from match fields in the same
way as from normal entry fields.
Set the Visible Match Character or the Hidden Match Character to the character that begins the match field.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 9
If the first character of an update to an entry field is one of the match characters, the rest of the update is
loaded as a match string. The entire string is displayed if the character matches the Visible Match Character, or
hidden if it matches the Hidden Match Character.
For example, if the Visible Match Character is set to v, the string v15abcde sent from the host specifies a
visible match for field1 of abcde.
Since the leading match character occupies field space, the entry field size must be specified as one character
larger than the expected data.
The preloaded match string remains in effect until the host clears the field or loads a different string.
Field Match Strings
Use the following special characters in match strings to specify non-exact matching:
• # to match a number (0123456789).
• & to match a letter, either case (AaBbCc...Zz).
• ^ to match an upper case letter (ABCDE...Z).
• _ (underscore) to match a lower case letter (abcde...z).
• | to match an alphanumeric character.
Settings
• " to match a text character (letter, number, or space).
• ? to match a punctuation character (.,;:?!...).
• ' to match any character.
• : to match all character positions in the field with the preceding character.
• ; to match any remaining characters entered with the preceding character, but not necessarily with the
remainder of the field.
For example, the match string &&-## will match on AA-67, GH-01, and so on. If the match string is shorter
than the field size, the characters not specified by the match string are not checked (unless : or ; is used).
Setting Description
Bidirectional Text Applies to Arabic text and Hebrew text.
Yes: Text direction is set by the host.
No: All text is left to right.
Default: No.
Assume Right-To-Left Applies to Arabic text and Hebrew text.
Yes: Assume that the first message from the host is to be displayed
from right to left. This message may precede a text direction setting
from the host.
No: All text is left to right.
Default: No.
3 - 10 TekTerm Client Configuration Guide
Setting Description
Visible Match Character The decimal value of the character (ASCII) that begins a visible
match field.
A value of 0 (zero) disables this feature.
Default: 0 (zero).
Hidden Match Character The decimal value of the character (ASCII) that begins a hidden
match field.
A value of 0 (zero) disables this feature.
Default: 0 (zero).
Fill Character The ASCII decimal representation of the character that fills empty
entry fields. Commonly used values are:
• 95 for underline character fill
• 46 for period character fill
Some systems may use the space character with the host using
reverse video attributes to mark entry fields.
Upper Case Yes: Lower case input is converted to upper case.
Tests Options
Setting Description
Auto Repeat Function Key The function key sent to the host in auto reply mode.
Auto Repeat Timeout The time (in seconds) between the mobile device being unlocked and the
Default: 46.
No: Lower case is not converted.
Default: No.
After sending this key, the mobile device locks and waits for the host to
unlock it.
0 (zero) represents F0, 1 represents F1...
Default: 0 (zero).
next transmission of the function key specified in Auto Repeat
Function Key.
0 (zero) disables auto reply mode.
Default: 0 (zero).
Features Options
These settings apply to printing from the session.
Queueing Mode
In some sessions, queueing mode can decrease the lock time. In queueing mode, the host computer may send
several pages to a unit without waiting for a response. These pages are stored in a queue within the device.
The operator completes the entries on the first page and then, presses a function key. The mobile device
simultaneously transmits to the host and displays the next page in the queue. The computer does not lock,
allowing the operator to enter data on the next page immediately. This continues as long as there are pages in
the queue.
Queueing mode is used for repetitive tasks, and the queued screens look identical. The device displays a Next
message indicating that a new page is on the display. Next messages also contain information about radio
communications: NEXT-B indicates that the unit has data to transmit to the base station. NEXT-H indicates that
the base station has acknowledged a transmission. Unlike lock messages, Next messages do not lock the
keyboard. Keying is allowed while Next messages are displayed.
While queueing mode may improve apparent response time, it can present difficulties to hosts that are oper-
ating in real time. It should only be used after careful consideration of the host environment. Queueing = Yes
must be set for the session.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 11
Setting Description
Binary Print Yes: The page displayed on the mobile device is spooled to the printer
unchanged except for white space removal.
No: Each line of the displayed page is preceded by a line feed character
(LF) and followed by a carriage return character (CR).
Default: No.
Remap Passthru Yes: Passthru data is remapped from the host character set to the port
character set.
No: Passthru data is sent to the port with no remapping.
Default: No.
Queueing Yes: Queueing mode is enabled. It also enables TESS procedures to be
loaded onto the mobile device.
This setting should be enabled if local procedures and the ability to
switch between hosts within a TESS session are required.
No: Queueing mode is not enabled.
Changes to this setting take effect only after the mobile device is reset.
Default: Yes.
Send Milestone Yes: A milestone is sent to the host after a hey-you command.
No: A milestone is not sent to the host.
Default: No.
3 - 12 TekTerm Client Configuration Guide
Setting Description
Next X Yes: Next messages are enabled in queueing mode.
No: Next messages are not enabled.
Default: No.
Keyboard Locked Yes: If the keyboard is locked the following keys still function:
• Function keys
•Arrow keys
• Enter key
The mobile device emits an error beep, if a character is rejected because
the keyboard is locked.
No: The keyboard is not locked.
Changes to this setting take effect only after the mobile device is reset.
Default: No.
Disable Beep Yes: The beep generated by the o, G, and # TESS commands is turned
Local Process
Local procedures are downloaded to the session by the host. They are intended to be run locally on the mobile
device when there is no radio signal. At runtime, these procedures are selected from the Local Menu screen.
Each procedure is associated with a function key. This function key association is only active while the Local
Menu is displayed, and does not affect any other function key mappings.
Once data entry for a procedure is completed, the data is placed in a queue for transmission to the host. This
data is transmitted as a background task when there is a radio link to the host.
Setting Description
Enabled Yes: Local procedures are enabled.
Save on Reset Yes: Data entered into local procedures on the mobile device is saved
off.
No: The beep is not turned off.
Default: No.
No: Local procedures are not enabled.
Default: Yes.
when the device is reset.
No: Data entered into local procedures on the mobile device is lost when
the device is reset.
Default: No.
Scanner Options
Setting Description
Continue in Next Field Yes: Barcodes that are longer than the field length flow into the next field.
Append Enter Yes: An Enter is appended to the barcode. The Enter completes the
Append F0 Yes: An F0 is appended to the barcode. The F0 completes the entry of
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 13
Applies only to string data entry.
No: Barcodes do not flow into the next field.
Default: Yes.
barcode and moves the cursor to the next field.
No: An Enter is not appended to the barcode.
Default: Yes.
the barcode.
No: F0 is not appended to the barcode.
Default: No.
Mixed AIAG Yes: AIAG labels are always accepted and processed–even if mixed with
keyboard input. The AIAG label can replace the partially entered
keyboard data.
No: AIAG labels are rejected if keyboard entry is in progress.
Default: No.
Reject if Alpha Yes: Barcodes containing alphabetic characters are rejected when the
cursor is in a numeric field.
No: These barcodes are not rejected.
Default: No.
Beam Lockout Yes: The scanner cannot be used when the session is in LOCK-H mode.
No: The scanner can be used in Lock-H mode.
Default: No.
3 - 14 TekTerm Client Configuration Guide
Fields Options
Runtime Edit Modes and Associated Cursor Movement
Edit Mode
Field mode Press Ctrl, f Once data entry into
Fcursor mode Press Ctrl, u Once data entry into
Insert mode Press Ctrl, i Data can be entered
Enter this
Mode
Description
a field has been
completed, the entry
cannot be changed
without retyping the
entire field.
a field has been
completed, the entry
cannot be changed
without retyping the
entire field.
between two
existing characters.
Cursor Movement
Enter On Arrow = Yes
The Right Arrow key
and the Left Arrow key
do not perform any
functions.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous or
next field.
The Up Arrow key, the
Down Arrow key, the
Left Arrow key, and the
Right Arrow key move
the cursor
between fields.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Cursor Movement
Enter On Arrow = No
The Right Arrow key
and the Left Arrow key
do not perform any
functions.
The Up Arrow key, the
Down Arrow key, the
Left Arrow key, and
the Right Arrow key
move the cursor
between fields.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Replace mode Press Ctrl, r Data can be
5250 Enhanced Edit Mode
In Enhanced Edit mode, the cursor can be moved freely about the terminal screen with the arrow keys. In the
normal edit mode, a cursor can be moved among the entry fields using the up and down arrow keys.
entered over
existing characters.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous, or
next, field.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous, or
next, field.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
When an AID key is pressed the terminal would then return the row and column positions of the cursor, in addition to user data.
When Enhanced Edit Mode is enabled, replace mode and insert mode are the only edit modes available.
Field Numbering
The way that the cursor moves between fields is determined by one of the following:
• The location of the field on the screen.
• The field numbers assigned by the host. Any field, fixed or entry, can have a field number assigned to it.
Field numbers have two uses:
• They associate data moving between the host and terminal with specific fields.
• When Field Order is set to Yes, in the following edit modes the arrow keys send the cursor to the field with
the next number no matter where the field is on the screen:
- Field mode
- Fcursor mode
- 5250 enhanced edit mode
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 15
Options Settings
Setting Description
Field Order Yes: The cursor moves according to the field locations on the screen.
Enter to F0 Yes: Enter is interpreted as F0, and it starts a transmission from
Enter on Arrow Yes: The Up Arrow key and the Down Arrow key can be used to
No: The cursor moves according to the numeric order of the
field numbers.
Default: Yes.
For more information see Field Numbering on page 3-15.
the session.
No: Enter moves the cursor to the next field.
Default: Yes.
complete data entry into a field, and start a transmission from
the session.
No: The arrow keys do not start transmission from the session.
Default: Yes.
All Field Video Yes: Video attributes apply to the entire entry field, including spaces.
No: Video attributes apply only to text in the entry field.
Default: Yes.
3 - 16 TekTerm Client Configuration Guide
Setting Description
Entry Mode Select the data entry edit mode.
Options:
• Field
• Replace
• Insert
•Fcursor
Default: Field.
For more information see Runtime Edit Modes and Associated Cursor
Movement on page 3-14
Open for Function Keys Only Yes: The cursor is not positioned on the screen, and only the function
keys are available for entry.
No: The cursor is positioned in a data entry field.
Default: No.
Ignore Barcode Only Yes: Fields that are defined as barcode only accept keyboard input
as well.
No: Barcode only fields do not accept keyboard input.
Default: No.
Enhanced Edit Mode Applies only to 5250 emulation.
Yes: Enhanced edit mode is enabled.
No: Enhanced edit mode is not enabled.
Default: No.
For more information see 5250 Enhanced Edit Mode on page 3-14.
Valid Numerics Up to 39 characters that are to be considered as valid in a numeric field.
There is no need to include the numerals from 0 to 9.
Default: +-%*/.,$
Touch Macro A string that is sent to the host as keyboard input when the operator taps
a field.
Default: None.
Ports Options
Printer
Setting Description
Printer Select the printer port used by this session The options are:
Character Set Select the character set for use with the printer on this port.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 17
• None
• Private Port
• Shared Port 1
• Shared Port 2
• Shared Port 3
• Shared Port 4
Default: None.
Serial Port
Setting Description
Serial Port Select the serial port that this session uses for serial I/O.
Character Set The character set to use with the device on this port. Select from a list.
Serial Out Yes: The serial port output fields are enabled.
Serial In Yes: The serial port input fields are enabled.The session has exclusive
Default: IBM PC 437 USA
Default: None.
Default: IBM PC 437 USA.
No: The serial port output fields are not enabled.
Default: Yes.
use of the serial port.
Acceptance of data in a SI field is determined by the Serial In prefix and
Serial In suffix.
No: The serial port input fields are not enabled
Default: No.
3 - 18 TekTerm Client Configuration Guide
Setting Description
Serial In Mode Field: Data received through the serial port is displayed in the serial input
fields.
Command: Data received through the serial port is transmitted as
passthru data to the host. At the host this data can only be processed if
the host application is using TSDK or TTH; otherwise, the host
application discards it.
Default: Field.
Serial In prefix The start of message character on serial input. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no prefix.
Default: 10.
Serial In suffix The end of message character on serial input. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no suffix.
Default: 13.
Serial in CRC Yes: A packet is rejected if its CRC is not valid. Also, every DLE
character is removed and the character following it is replaced by its 1s
complement.
No: A packet is not rejected if its CRC is not valid.
Default: No.
Serial Out prefix The start of message character on serial output. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no prefix.
Default: 0a 00 00 00 00 00 00 00.
Serial Out suffix The end of message character on serial output. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no suffix.
Default: 0d 00 00 00 00 00 00 00.
Serial Out CRC Yes: A CRC16 is appended to the serial output message. Also for each
control character in the serial output stream, a DLE is inserted before the
control character, and the control character is replaced by its 1s
complement.
No: A CRC16 is not appended to the serial output message.
Default: No.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 19
Serial In Function Key
Setting Description
Use Function Key Yes: A function key is appended to the serial input.
Function Key Number When Use Function Key is set to Yes, this is the number of the function
Panning Options
These are the screen panning setting for the session.
No: A function key is not appended to the serial input.
Default: No.
key that is to be appended to the serial input.
Entering 0 appends F0, entering 1 appends F1, entering 2 appends F2...
Data is transmitted as soon as the function key is appended.
Default: 0 (zero).
Setting Description
Row Increment The number of rows that the screen pans on each time Alt, Up Arrow, or
Alt, Down Arrow, is entered.
Default: 1
Column Increment The number of columns that the screen pans on each time Alt,
Left Arrow, or Alt, Right Arrow, is entered.
Default: 1
Touch Panning Touch panning allows the operator to drag the screen.
Yes: Touch panning is enabled.
No: Touch panning is not enabled.
Default: Yes
Display Shift Display shift shifts the application screens so that there are no empty
columns on the left-most side of the display.
Yes: Display shift is enabled.
No: Display shift is not enabled.
Default: Yes
3 - 20 TekTerm Client Configuration Guide
Anchor View
Setting Description
Enabled Yes: The display is locked at a specific location on the screen.
No: The display is not locked at a specific location on the screen.
Default: No.
X origin The column where the upper left corner of the screen is locked.
Default: 1
Y origin The row where the upper left corner of the screen is locked.
Default: 1
Programmable Keys Options
Programmable keys are soft keys that you can configure for the session. 24 programmable keys are available
for each session. Each of these keys can have a sequence of up to 20 actions defined. You can also give each
key a label.
Runtime use of programmable keys
The operator can toggle the display of the programmable keys on the screen. When displayed they look
like this:
In this example the labels on Key 1, Key 2, and Key 3 have been changed from the default labels. All 24
programmable keys are available as onscreen softkeys, if you can fit them onto the two lines of keys on the
display of your mobile device.
At runtime Key 1 through to Key 10 are also selected by the following keyboard shortcuts:
Ctrl, n
where n is a digit between 0 and 9. Ctrl, 1 selects Key 1.Ctrl, 2 selects Key 2. Ctrl, 9 selects Key 9. Ctrl, 0
selects Key 10.
Label a Programmable Key
You can set the onscreen label for a programmable key as follows:
1. Double click the label item for the key on the menu.
The label item looks like this:
Key 1 (Ctrl-1): F1
2. Enter the new label in the dialog box.
Advanced Configuration for 5250, 3270, 2392, and TESS Using Direct TCP 3 - 21
Set the Action Sequence for a Programmable Key
For each key that you want to define:
1. Expand the key menu item.
A list of 20 action items is displayed.
2. Select each action item that you want to configure.
You can configure one of the following for each item:
• A keyboard character.
• The code for a Unicode character.
• A function key, a keyboard navigation command, or an emulation command, selected from the
drop-down list.
Settings
Setting Description
On-screen (Top Row) Number of programmable key labels displayed on the top row.
Valid values are 0 to 12.
0 (zero): No keys are displayed on this line.
Default: 5.
On-screen (Bottom Row) Number of programmable key labels displayed on the bottom row.
Valid values are 0 to 12.
0 (zero): No keys are displayed on this line.
Default: 5.
Key 1 ... Key 24 Programmable key settings. An onscreen label and up to 20 actions for
each key.
Default label: F1 ... F24
Default action: F1 ... F24
CHAPTER 4 ADVANCED CONFIGURATION
FOR 5250, 3270, AND HP 2392,
DIRECT TO HOST USING
TELNET
ADVANCED CONFIGURATION FOR 5250, 3270, AND HP 2392, DIRECT TO HOST USING TELNET 4
Overview..................................................4-3
Host Connection Options.........................................4-3
Emulation Options For 5250 Emulation and 3270 Emulation. . . . . . . . . . . . . . . . .4-3
Function Key Remap for 5250 Emulation and 3270 Emulation . . . . . . . . . . . . . . .4-4
Emulation Options for 2392 Emulation.............................4-4
Features .............................................4-5
Passthru Printing.........................................4-8
Screen Options..............................................4-9
Font Advanced.........................................4-10
Legacy Font Code Mapping.............................4-10
Font Cycle ......................................4-11
Video..............................................4-11
Colours.............................................4-12
Default Colours....................................4-12
Remap Colours....................................4-12
Status Line...........................................4-12
Lock-B.........................................4-12
Lock-H ........................................4-12
Unlocked.......................................4-13
Advisory Field ....................................4-13
Hey-you Field.....................................4-13
Highlight Current Field.....................................4-14
Characters Options...........................................4-14
Field Matching.........................................4-14
Settings.............................................4-15
Tests Options ..............................................4-16
Features Options............................................4-17
Local Process .........................................4-18
Scanner Options.............................................4-19
4 - 2 TekTerm Client Configuration Guide
Fields Options..............................................4-20
Runtime Edit Modes and Associated Cursor Movement ..................4-20
5250 Enhanced Edit Mode...................................4-20
Field Numbering........................................4-21
Options Settings........................................4-21
Ports Options...............................................4-23
Printer..............................................4-23
Serial Port............................................4-23
Serial In Function Key.....................................4-25
Panning Options.............................................4-25
Anchor View...........................................4-26
Programmable Keys Options......................................4-26
Label a Programmable Key..................................4-26
Set the Action Sequence for a Programmable Key.....................4-27
Settings.............................................4-27
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 3
Overview
This chapter describes all the advanced settings that are available for the 5250, 3270, 2392 and TESS emulations on a direct to host connection. Also the ports used for the Telnet connection are configured.
Host Connection Options
Setting Description
Auto Host Port Yes: Port 23 is used.
Host Port The host port when Auto Host Port is not selected.
No: The port defined in Host Port is used.
Default: Yes.
Default: 9999.
Emulation Options For 5250 Emulation and 3270 Emulation
Setting Description
WEC The type of WEC (Write Error Code). Options are:
• Advisory: When the host sends a WEC command, a TESS advisory
message is generated.
• Screen: When the host sends a WEC command, the keyboard and
screen are locked for this session.The message contained in the WEC
command is displayed on the screen at the line specified by the host.
The session is unlocked using the function key that is mapped to
RESET.
Default: Advisory.
International EBCDIC Yes: The International EDCBIC character set is used.
No: The International EDCBIC character set is not used.
Default: No.
Nulls in Fields Yes: Characters such as - (hyphen) and . (period) can occupy
empty fields.
No: These characters are not allowed in empty fields.
Default: Yes.
4 - 4 TekTerm Client Configuration Guide
Setting Description
Ter m Ty p e The type of terminal to be emulated by the session.
5250 emulation:
Values: IBM-5252-11, IBM-5555-B01, IBM-3179-2
Default: IBM-5252-11
3270 emulation:
Values: IBM-3278-2, IBM-3278-2-E
Default: IBM-3278-2
Virtual Dev Enabled Yes: The session can negotiate a specific device name for itself.
No: The device name is supplied by the host.
Default: No.
Virtual Dev Session Letter Yes: The device name has a maximum length of 10 characters. This
consists of a maximum of 9 fixed characters with an incrementing
session letter appended to them. If the requested name is not available
on the host, the session letter increments until a successful connection
is established.
No: a virtual device session letter is not used.
Default: No.
Virtual Dev Name When Virtual Dev Enabled is selected, this is the name that the session
uses as a device name. This field can contain up to 10 upper-case
alphanumeric characters.
Default: None.
Function Key Remap for 5250 Emulation and 3270 Emulation
When a function key is pressed, a character string is sent to the host. The menu items in the list enable you to
define this string for each function key.
Emulation Options for 2392 Emulation
Setting Description
Send CR with FKEY Yes: A carriage return (CR) is appended to the character string
generated by a function key.
No: A carriage return is not appended.
Default: No.
Features
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 5
Setting Description
Clear Entry Fields Yes: An entry field filled with spaces is replaced by an empty
entry field.
No: An entry field filled with spaces is not replaced.
Default: No.
AIAG Character 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 screen. 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.
Barcode Character 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.
4 - 6 TekTerm Client Configuration Guide
Setting Description
Serial I/O Character The decimal value of the special character (ASCII) used to tag a field
to use serial 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.
Fixed Field Overhead The maximum number of characters allowed between two fixed fields
which still allows the TekTerm Client to join them into one field.
Sometimes the TekTerm Client will join two adjacent fixed fields and
then send them as one field. This reduces the overhead on the
radio link.
For example, if two fields were 4 characters apart and this parameter
was 5, then these fields would be joined into one.
This feature affects fields with the Normal display attribute only.
Values: 0 to 80
Default: 5
Enable Alarm Yes: Mobile devices beep when the word ALARM appears on the
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.
No: There is no alarm beep.
Default: No.
Command Region Up The row where the upper left corner of the command region resides.
Values: 0 to 24
Default: 0 (zero).
Command Region Down The row where the lower right corner of the command region resides.
Values: 0 to 24
Default: 0 (zero).
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 7
Setting Description
Command Region Left The column where the upper left corner of the command
region resides.
Values: 0 to 80
Default: 0 (zero).
Command Region Right The column where the lower right corner of the command
region resides.
Values: 0 to 80
Default: 0 (zero).
AIAG Mode Values
The mode character is derived by starting with the decimal value 48—ASCII character 0 (zero)—and adding
the appropriate value from the table below.
Code Description
1 Prevent the AIAG prefix from being displayed.
2 Prevent the AIAG prefix from being sent to the host.
4 Cause a transmission to the host when all AIAG fields with this mode set are filled. The
transmission is sent by a Function 0 (F0) code.
8 Allow overwriting of previously entered data.
16 Start the search for a matching AIAG field at the current cursor position. Otherwise, the
cursor starts at the top of the page.
For example, the @ symbol is used to apply the cursor matching function, since adding 16 to 48 results in
decimal value 64, which is the ASCII value for the character @.
Match Characters
Match
Character
# Match a number
& Match a letter (either case)
^ Match an upper case letter
_ Match a lower case letter
Use
| Match an alphanumeric character
" Match a letter, number or space
? Match a punctuation character
' Match any character
4 - 8 TekTerm Client Configuration Guide
Match
Character
: Match all character positions in the field with the preceding character
; Match any remaining characters, but not necessarily the remainder of the field, with
Passthru Printing
Passthru printing
When passthru printing is enabled, any screen the starts with the string PASSTHRU is sent directly to the serial
port by the session.
Alternate printing
In alternate print mode, part of the screen from the host is displayed, and part of the screen is sent to the serial
port and not displayed.
A row and column position is defined on the screen. When the start sequence occurs after this position, all text
received until the end sequence is encountered, is sent to the serial port. Any following text is displayed on the
screen.
Setting Description
Enabled Yes: Host data is sent directly to the serial port.
Use
the preceding character
No: Host data is displayed on the screen.
Default: No.
Alternate Print Enabled Yes: Alternate print is enabled, if Enabled = Yes.
No: Alternate print is not enabled.
Applies only to 5250 Emulation and 3270 Emulation.
Default: No.
Alternate Print Start Row The row where the session starts looking for a start sequence.
Applies only to 5250 Emulation and 3270 Emulation.
Default: 2.
Alternate Print Start Column The column where the session starts looking for a start sequence.
Applies only to 5250 Emulation and 3270 Emulation.
Default: 0.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 9
Setting Description
Alternate Print Start Sequence The sequence that starts the output to the serial port.
Alternate Print End Sequence The sequence that ends the output to the serial port.
Screen Options
Setting Description
Screen Size Host screen size.
Applies only to 5250 Emulation and 3270 Emulation.
Default: d7 d9 d5 7a 00 00 00.
Applies only to 5250 Emulation and 3270 Emulation.
Default: 7a d7 d9 d5 00 00 00.
If the page size received from the host is larger than this size,
TekTerm Client trims the host page to this size.
If the size is larger than the session screen size, scrolling and panning
are used to view the screen on the mobile device. For information on
setting the session screen size see Configure the Screen Size and
Font for the Session on page 1-6.
Default: 24 rows x 80 columns.
Block Cursor Yes: The cursor is a flashing block.
No: the cursor is a flashing underline character.
Default: Yes.
Pages Saved The maximum number of pages that are stored by TekTerm Client.
Storing frequently used page data on the mobile device reduces the
need for the TekTerm Server to retransmit complete data pages over
the radio link. Retransmitting data can reduce the system response
time. Increasing the number of saved pages decreases the available
memory for other functions.
Default: 16.
Origin Scroll Yes: The display window moves to the origin (upper-left corner) after
LOCK-H or LOCK-B messages.
No: The cursor does not move.
Default: No.
4 - 10 TekTerm Client Configuration Guide
Setting Description
Field Scroll Yes: The display window moves to the left after entering a new entry
field.
No:The window does not move.
Default: No.
Application Parameter Applies only when the host is running a TSDK application.
Sent to the host system as part of the response to the TESS
Parameter Query command.
Default: 0 (zero).
Font Advanced
Setting Description
Font name The name of the font used for this session. Select from the
drop-down list.
Normal font weight A number defining the weight of non-bolded text. The larger the
Bold font weight A number defining the weight of bolded text. The larger the number,
Ignore host commands Yes: Use the font name and font weights defined for this session. If
Legacy Font Code Mapping
The Font Codes parameters are used to define how legacy font codes are handled when received as part of a
font change command from the host. If a font code is not explicitly handled, the result depends on the screen
size available to the application.
Default selects the default font defined for the mobile device the
TekTerm Client is running on.
Default: Default.
number, the heavier the text.
Default: 500.
the heavier the text.
Default: 700.
the host sends font change requests these are ignored.
No: The host can change the font name and the font weights.
Default: No.
Setting Description
Font Code 1 Default: 0.
Font 1 Default: 17x30.
Font Code 2 Default: 1.
Font 2 Default: 22x30.
Setting Description
Font Code 3 Default: 2.
Font 3 Default: 13x20.
Font Code 4 Default: 3.
Font 4 Default: 34x48.
Font Code 5 Default: 4.
Font 5 Default: 9x15.
Font Cycle
When the operator of the mobile device cycles through the font sizes while running the TekTerm Client session,
this is the list of font sizes that can be selected.
Setting Description
Font 1 First font size in cycle.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 11
Video
Default: 17x30.
Font 2 Second font size in cycle.
Default: 22x30.
Font 3 Third font size in cycle.
Default: 13x20.
Font 4 Fourth font size in cycle.
Default: 34x48.
Font 5 Fifth font size in cycle.
Default: 9x15.
These settings specify the video attributes to be displayed on the mobile device, when a video setting is
received in the data from the host. The choices are:
• Normal—display as normal text.
• Bold—display as bold text.
• Blink—display as blinking text.
• Reverse—display in reverse video.
• Underline—display as underlined text.
Setting Description
Normal Default: Normal.
Bold Default: Bold.
Blink Default: Blink.
4 - 12 TekTerm Client Configuration Guide
Setting Description
Reverse Default: Reverse.
Underline Default: Underline.
Colours
Default Colours
These settings specify the foreground and background screen colours for this session. Use Remap Colours to
set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for this session.
Default: Black.
Background Select the screen background colour for this session.
Default: White.
Remap Colours
Remap Colours gives access to the colour definitions for the colours that can be selected as the foreground
and background colours for this session. When you select a colour from the menu, you can set its RGB values.
Status Line
The status line is displayed at the bottom of the screen during the session.
Lock-B
These settings specify the foreground and background screen colours for the status line when the session is in
Lock-B status. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Lock-H
These settings specify the foreground and background screen colours for the status line when the session is in
Lock-H status. Use Remap Colours to set the colour definitions for these colours.
Default: Black.
Default: Red.
Unlocked
These settings specify the foreground and background screen colours for the status line when the session is in
unlocked status. Use Remap Colours to set the colour definitions for these colours.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 13
Setting Description
Foreground Select the screen foreground colour for the status line.
Default: Black.
Background Select the screen background colour for the status line.
Default: Yellow.
Setting Description
Enabled Yes: The status line is displayed when the session is in unlocked
status.
No: The status line is not displayed when the session is in unlocked
status.
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Advisory Field
These settings specify the foreground and background screen colours for the status line when an advisory
message is received. Use Remap Colours to set the colour definitions for these colours.
Setting Description
Acknowledge key The keyboard key that is used to clear the advisory message.
Foreground Select the screen foreground colour for the status line.
Background Select the screen background colour for the status line.
Default: No.
Default: Black.
Default: Green.
Default: F0.
Default: Black.
Default: White.
Hey-you Field
These settings specify the foreground and background screen colours for the status line when a hey-you
message is received. Use Remap Colours to set the colour definitions for these colours.
4 - 14 TekTerm Client Configuration Guide
Setting Description
Acknowledge key The keyboard key that is used to clear the hey-you message.
Default: F0.
Foreground Select the screen foreground colour for the status line.
Default: White.
Background Select the screen background colour for the status line.
Default: Black.
Highlight Current Field
These settings specify the foreground and background screen colours for the current field. Use Remap
Colours to set the colour definitions for these colours.
Setting Description
Enabled Yes: The current field is highlighted.
Foreground Select the screen foreground colour for the highlighted field.
Background Select the screen background colour for the highlighted field.
Characters Options
Field Matching
The field matching function permits the TekTerm Client to perform some checks on the entered data before it is
sent to the host. If the data entered by the operator does not match a data string preloaded by the host, the
mobile device generates an input error, and the cursor remains in the same field. However, if the operator
ignores the input error, the data is accepted and sent to the host. It is then up to the host system to resolve the
mismatched data.
The input error generated can be a sound and/or a vibration. For options see the Input Error settings in User
Feedback on page 9-3.
Match Fields
No: The current field is not highlighted.
Default: No.
Default: Black.
Default: Yellow.
The host application can specify an exact character-by-character match, using field match characters; or, it can
use special characters in the preloaded string to specify a more general match requirement, using field match
strings.
The host application can specify whether the preloaded match string should be displayed to the terminal operator (visible match field) or not (hidden match field). Data is returned to the host from match fields in the same
way as from normal entry fields.
Set the Visible Match Character or the Hidden Match Character to the character that begins the match field.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 15
If the first character of an update to an entry field is one of the match characters, the rest of the update is
loaded as a match string. The entire string is displayed if the character matches the Visible Match Character, or
hidden if it matches the Hidden Match Character.
For example, if the Visible Match Character is set to v, the string v15abcde sent from the host specifies a
visible match for field1 of abcde.
Since the leading match character occupies field space, the entry field size must be specified as one character
larger than the expected data.
The preloaded match string remains in effect until the host clears the field or loads a different string.
Field Match Strings
Use the following special characters in match strings to specify non-exact matching:
• # to match a number (0123456789).
• & to match a letter, either case (AaBbCc...Zz).
• ^ to match an upper case letter (ABCDE...Z).
• _ (underscore) to match a lower case letter (abcde...z).
• | to match an alphanumeric character.
Settings
• " to match a text character (letter, number, or space).
• ? to match a punctuation character (.,;:?!...).
• ' to match any character.
• : to match all character positions in the field with the preceding character.
• ; to match any remaining characters entered with the preceding character, but not necessarily with the
remainder of the field.
For example, the match string &&-## will match on AA-67, GH-01, and so on. If the match string is shorter
than the field size, the characters not specified by the match string are not checked (unless : or ; is used).
Setting Description
Bidirectional Text Applies to Arabic text and Hebrew text.
Yes: Text direction is set by the host.
No: All text is left to right.
Default: No.
Assume Right-To-Left Applies to Arabic text and Hebrew text.
Yes: Assume that the first message from the host is to be displayed
from right to left. This message may precede a text direction setting
from the host.
No: All text is left to right.
Default: No.
4 - 16 TekTerm Client Configuration Guide
Setting Description
Visible Match Character The decimal value of the character (ASCII) that begins a visible
match field.
A value of 0 (zero) disables this feature.
Default: 0 (zero).
Hidden Match Character The decimal value of the character (ASCII) that begins a hidden
match field.
A value of 0 (zero) disables this feature.
Default: 0 (zero).
Fill Character The ASCII decimal representation of the character that fills empty
entry fields. Commonly used values are:
• 95 for underline character fill
• 46 for period character fill
Some systems may use the space character with the host using
reverse video attributes to mark entry fields.
Upper Case Yes: Lower case input is converted to upper case.
Tests Options
Setting Description
Auto Repeat Function Key The function key sent to the host in auto reply mode.
Auto Repeat Timeout The time (in seconds) between the mobile device being unlocked and the
Default: 46.
No: Lower case is not converted.
Default: No.
After sending this key, the mobile device locks and waits for the host to
unlock it.
0 (zero) represents F0, 1 represents F1...
Default: 0 (zero).
next transmission of the function key specified in Auto Repeat
Function Key.
0 (zero) disables auto reply mode.
Default: 0 (zero).
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 17
Features Options
These settings apply to printing from the session.
Queueing Mode
In some sessions, queueing mode can decrease the lock time. In queueing mode, the host computer may send
several pages to a unit without waiting for a response. These pages are stored in a queue within the device.
The operator completes the entries on the first page and then, presses a function key. The mobile device
simultaneously transmits to the host and displays the next page in the queue. The computer does not lock,
allowing the operator to enter data on the next page immediately. This continues as long as there are pages in
the queue.
Queueing mode is used for repetitive tasks, and the queued screens look identical. The device displays a Next
message indicating that a new page is on the display. Next messages also contain information about radio
communications: NEXT-B indicates that the unit has data to transmit to the base station. NEXT-H indicates that
the base station has acknowledged a transmission. Unlike lock messages, Next messages do not lock the
keyboard. Keying is allowed while Next messages are displayed.
While queueing mode may improve apparent response time, it can present difficulties to hosts that are oper-
ating in real time. It should only be used after careful consideration of the host environment. Queueing = Yes
must be set for the session.
Setting Description
Binary Print Yes: The page displayed on the mobile device is spooled to the printer
unchanged except for white space removal.
No: Each line of the displayed page is preceded by a line feed character
(LF) and followed by a carriage return character (CR).
Default: No.
Remap Passthru Yes: Passthru data is remapped from the host character set to the port
character set.
No: Passthru data is sent to the port with no remapping.
Default: No.
Queueing Yes: Queueing mode is enabled. It also enables TESS procedures to be
loaded onto the mobile device.
This setting should be enabled if local procedures and the ability to
switch between hosts within a TESS session are required.
No: Queueing mode is not enabled.
Changes to this setting take effect only after the mobile device is reset.
Default: Yes.
Send Milestone Yes: A milestone is sent to the host after a hey-you command.
No: A milestone is not sent to the host.
Default: No.
4 - 18 TekTerm Client Configuration Guide
Setting Description
Next X Yes: Next messages are enabled in queueing mode.
No: Next messages are not enabled.
Default: No.
Keyboard Locked Yes: If the keyboard is locked the following keys still function:
• Function keys
•Arrow keys
• Enter key
The mobile device emits an error beep, if a character is rejected because
the keyboard is locked.
No: The keyboard is not locked.
Changes to this setting take effect only after the mobile device is reset.
Default: No.
Disable Beep Yes: The beep generated by the o, G, and # TESS commands is turned
Local Process
Local procedures are downloaded to the session by the host. They are intended to be run locally on the mobile
device when there is no radio signal. At runtime, these procedures are selected from the Local Menu screen.
Each procedure is associated with a function key. This function key association is only active while the Local
Menu is displayed, and does not affect any other function key mappings.
Once data entry for a procedure is completed, the data is placed in a queue for transmission to the host. This
data is transmitted as a background task when there is a radio link to the host.
Setting Description
Enabled Yes: Local procedures are enabled.
Save on Reset Yes: Data entered into local procedures on the mobile device is saved
off.
No: The beep is not turned off.
Default: No.
No: Local procedures are not enabled.
Default: Yes.
when the device is reset.
No: Data entered into local procedures on the mobile device is lost when
the device is reset.
Default: No.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 19
Scanner Options
Setting Description
Continue in Next Field Yes: Barcodes that are longer than the field length flow into the next field.
Append Enter Yes: An Enter is appended to the barcode. The Enter completes the
Append F0 Yes: An F0 is appended to the barcode. The F0 completes the entry of
Applies only to string data entry.
No: Barcodes do not flow into the next field.
Default: Yes.
barcode and moves the cursor to the next field.
No: An Enter is not appended to the barcode.
Default: Yes.
the barcode.
No: F0 is not appended to the barcode.
Default: No.
Mixed AIAG Yes: AIAG labels are always accepted and processed–even if mixed with
keyboard input. The AIAG label can replace the partially entered
keyboard data.
No: AIAG labels are rejected if keyboard entry is in progress.
Default: No.
Reject if Alpha Yes: Barcodes containing alphabetic characters are rejected when the
cursor is in a numeric field.
No: These barcodes are not rejected.
Default: No.
Beam Lockout Yes: The scanner cannot be used when the session is in LOCK-H mode.
No: The scanner can be used in Lock-H mode.
Default: No.
4 - 20 TekTerm Client Configuration Guide
Fields Options
Runtime Edit Modes and Associated Cursor Movement
Edit Mode
Field mode Press Ctrl, f Once data entry into
Fcursor mode Press Ctrl, u Once data entry into
Insert mode Press Ctrl, i Data can be entered
Enter this
Mode
Description
a field has been
completed, the entry
cannot be changed
without retyping the
entire field.
a field has been
completed, the entry
cannot be changed
without retyping the
entire field.
between two
existing characters.
Cursor Movement
Enter On Arrow = Yes
The Right Arrow key
and the Left Arrow key
do not perform any
functions.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous or
next field.
The Up Arrow key, the
Down Arrow key, the
Left Arrow key, and the
Right Arrow key move
the cursor
between fields.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Cursor Movement
Enter On Arrow = No
The Right Arrow key
and the Left Arrow key
do not perform any
functions.
The Up Arrow key, the
Down Arrow key, the
Left Arrow key, and
the Right Arrow key
move the cursor
between fields.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Replace mode Press Ctrl, r Data can be
5250 Enhanced Edit Mode
In Enhanced Edit mode, the cursor can be moved freely about the terminal screen with the arrow keys. In the
normal edit mode, a cursor can be moved among the entry fields using the up and down arrow keys.
entered over
existing characters.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous, or
next, field.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
The Up Arrow key and
the Down Arrow key
complete the entry field
and move the cursor to
the previous, or
next, field.
The Right Arrow key
and the Left Arrow key
move the cursor right
and left within a field.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 21
When an AID key is pressed the terminal would then return the row and column positions of the cursor, in addition to user data.
When Enhanced Edit Mode is enabled, replace mode and insert mode are the only edit modes available.
Field Numbering
The way that the cursor moves between fields is determined by one of the following:
• The location of the field on the screen.
• The field numbers assigned by the host. Any field, fixed or entry, can have a field number assigned to it.
Field numbers have two uses:
• They associate data moving between the host and terminal with specific fields.
• When Field Order is set to Yes, in the following edit modes the arrow keys send the cursor to the field with
the next number no matter where the field is on the screen:
- Field mode
- Fcursor mode
- 5250 enhanced edit mode
Options Settings
Setting Description
Field Order Yes: The cursor moves according to the field locations on the screen.
Enter to F0 Yes: Enter is interpreted as F0, and it starts a transmission from
Enter on Arrow Yes: The Up Arrow key and the Down Arrow key can be used to
No: The cursor moves according to the numeric order of the
field numbers.
Default: Yes.
For more information see Field Numbering on page 4-21.
the session.
No: Enter moves the cursor to the next field.
Default: Yes.
complete data entry into a field, and start a transmission from
the session.
No: The arrow keys do not start transmission from the session.
Default: Yes.
All Field Video Yes: Video attributes apply to the entire entry field, including spaces.
No: Video attributes apply only to text in the entry field.
Default: Yes.
4 - 22 TekTerm Client Configuration Guide
Setting Description
Entry Mode Select the data entry edit mode.
Options:
• Field
• Replace
• Insert
•Fcursor
Default: Field.
For more information see Runtime Edit Modes and Associated Cursor
Movement on page 4-20
Open for Function Keys Only Yes: The cursor is not positioned on the screen, and only the function
keys are available for entry.
No: The cursor is positioned in a data entry field.
Default: No.
Ignore Barcode Only Yes: Fields that are defined as barcode only accept keyboard input
as well.
No: Barcode only fields do not accept keyboard input.
Default: No.
Enhanced Edit Mode Applies only to 5250 emulation.
Yes: Enhanced edit mode is enabled.
No: Enhanced edit mode is not enabled.
Default: No.
For more information see 5250 Enhanced Edit Mode on page 4-20.
Valid Numerics Up to 39 characters that are to be considered as valid in a numeric field.
There is no need to include the numerals from 0 to 9.
Default: +-%*/.,$
Touch Macro A string that is sent to the host as keyboard input when the operator taps
a field.
Default: None.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 23
Ports Options
Printer
Setting Description
Printer Select the printer port used by this session The options are:
Character Set Select the character set for use with the printer on this port.
• None
• Private Port
• Shared Port 1
• Shared Port 2
• Shared Port 3
• Shared Port 4
Default: None.
Serial Port
Setting Description
Serial Port Select the serial port that this session uses for serial I/O.
Character Set The character set to use with the device on this port. Select from a list.
Serial Out Yes: The serial port output fields are enabled.
Serial In Yes: The serial port input fields are enabled.The session has exclusive
Default: IBM PC 437 USA
Default: None.
Default: IBM PC 437 USA.
No: The serial port output fields are not enabled.
Default: Yes.
use of the serial port.
Acceptance of data in a SI field is determined by the Serial In prefix and
Serial In suffix.
No: The serial port input fields are not enabled
Default: No.
4 - 24 TekTerm Client Configuration Guide
Setting Description
Serial In Mode Field: Data received through the serial port is displayed in the serial input
fields.
Command: Data received through the serial port is transmitted as
passthru data to the host. At the host this data can only be processed if
the host application is using TSDK or TTH; otherwise, the host
application discards it.
Default: Field.
Serial In prefix The start of message character on serial input. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no prefix.
Default: 10.
Serial In suffix The end of message character on serial input. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no suffix.
Default: 13.
Serial in CRC Yes: A packet is rejected if its CRC is not valid. Also, every DLE
character is removed and the character following it is replaced by its 1s
complement.
No: A packet is not rejected if its CRC is not valid.
Default: No.
Serial Out prefix The start of message character on serial output. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no prefix.
Default: 0a 00 00 00 00 00 00 00.
Serial Out suffix The end of message character on serial output. Enter the numeric
representation of an ASCII character between 0 and 255.
0 (zero) indicates that there is no suffix.
Default: 0d 00 00 00 00 00 00 00.
Serial Out CRC Yes: A CRC16 is appended to the serial output message. Also for each
control character in the serial output stream, a DLE is inserted before the
control character, and the control character is replaced by its 1s
complement.
No: A CRC16 is not appended to the serial output message.
Default: No.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 25
Serial In Function Key
Setting Description
Use Function Key Yes: A function key is appended to the serial input.
Function Key Number When Use Function Key is set to Yes, this is the number of the function
Panning Options
These are the screen panning setting for the session.
No: A function key is not appended to the serial input.
Default: No.
key that is to be appended to the serial input.
Entering 0 appends F0, entering 1 appends F1, entering 2 appends F2...
Data is transmitted as soon as the function key is appended.
Default: 0 (zero).
Setting Description
Row Increment The number of rows that the screen pans on each time Alt, Up Arrow, or
Alt, Down Arrow, is entered.
Default: 1
Column Increment The number of columns that the screen pans on each time Alt,
Left Arrow, or Alt, Right Arrow, is entered.
Default: 1
Touch Panning Touch panning allows the operator to drag the screen.
Yes: Touch panning is enabled.
No: Touch panning is not enabled.
Default: Yes
Display Shift Display shift shifts the application screens so that there are no empty
columns on the left-most side of the display.
Yes: Display shift is enabled.
No: Display shift is not enabled.
Default: Yes
4 - 26 TekTerm Client Configuration Guide
Anchor View
Setting Description
Enabled Yes: The display is locked at a specific location on the screen.
No: The display is not locked at a specific location on the screen.
Default: No.
X origin The column where the upper left corner of the screen is locked.
Default: 1
Y origin The row where the upper left corner of the screen is locked.
Default: 1
Programmable Keys Options
Programmable keys are soft keys that you can configure for the session. 24 programmable keys are available
for each session. Each of these keys can have a sequence of up to 20 actions defined. You can also give each
key a label.
Runtime use of programmable keys
The operator can toggle the display of the programmable keys on the screen. When displayed they look
like this:
In this example the labels on Key 1, Key 2, and Key 3 have been changed from the default labels. All 24
programmable keys are available as onscreen softkeys, if you can fit them onto the two lines of keys on the
display of your mobile device.
At runtime Key 1 through to Key 10 are also selected by the following keyboard shortcuts:
Ctrl, n
where n is a digit between 0 and 9. Ctrl, 1 selects Key 1.Ctrl, 2 selects Key 2. Ctrl, 9 selects Key 9. Ctrl, 0
selects Key 10.
Label a Programmable Key
You can set the onscreen label for a programmable key as follows:
1. Double click the label item for the key on the menu.
The label item looks like this:
Key 1 (Ctrl-1): F1
2. Enter the new label in the dialog box.
Advanced Configuration for 5250, 3270, and HP 2392, Direct to Host Using Telnet 4 - 27
Set the Action Sequence for a Programmable Key
For each key that you want to define:
1. Expand the key menu item.
A list of 20 action items is displayed.
2. Select each action item that you want to configure.
You can configure one of the following for each item:
• A keyboard character.
• The code for a Unicode character.
• A function key, a keyboard navigation command, or an emulation command, selected from the
drop-down list.
Settings
Setting Description
On-screen (Top Row) Number of programmable key labels displayed on the top row.
Valid values are 0 to 12.
0 (zero): No keys are displayed on this line.
Default: 5.
On-screen (Bottom Row) Number of programmable key labels displayed on the bottom row.
Valid values are 0 to 12.
0 (zero): No keys are displayed on this line.
Default: 5.
Key 1 ... Key 24 Programmable key settings. An onscreen label and up to 20 actions for
each key.
Default label: F1 ... F24
Default action: F1 ... F24
CHAPTER 5 ADVANCED CONFIGURATION
FOR VT USING 802.IQ AND
NARROW BAND
ADVANCED CONFIGURATION FOR VT USING 802.IQ AND NARROW BAND 5
Overview..................................................5-3
Screen Options..............................................5-3
Font Advanced..........................................5-3
Legacy Font Mode Mapping..............................5-4
Font Cycle .......................................5-5
Video...............................................5-5
Colours..............................................5-6
Default Colours.....................................5-6
Remap Colours.....................................5-6
Transmit Modes..............................................5-6
Block Mode Settings.......................................5-8
Keyboard Modes ............................................5-10
Special Keys in Local Echo Mode ..............................5-12
Edit Modes................................................5-12
Ports...................................................5-13
Ports Options..........................................5-13
Primary Port..........................................5-14
Secondary Port.........................................5-14
Host Character Set...........................................5-15
Panning Options.............................................5-15
Anchor View..........................................5-16
Programmable Keys Options......................................5-16
Label a Programmable Key..................................5-17
Set the Action Sequence for a Programmable Key.....................5-17
Settings.............................................5-17
Loading...