5250/Telnet Host Configuration. Zebra Software
ಜಾಹಿರಾತು
ಜಾಹಿರಾತು
CHAPTER 3 5250/TELNET HOST
CONFIGURATION
5250/TELNET HOST CONFIGURATION
TESS Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5
HTML/HTTP Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
5250 Telnet Terminal Naming Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
3
5250/Telnet Host Configuration 3 - 3
Overview
The TekTerm Server can emulate multiple TN5250 sessions. The emulation software inside the TekTerm
Server converts the IBM-5294 data transparently to and from TESS or HTTP data which is then sent to and from the Psion devices. The connection between the TekTerm Server and its base stations, access points, and devices is transparent to the IBM host.
General Host Options Screen
Field
Name
Enabled
Emulation and protocol
Description
The unique name of the host.
Default: Unnamed Host
When selected the host task is started when the
TekTerm Server starts.
Emulation and protocol combination for this host.
Select: 5250/Telnet
3 - 4 TekTerm Server Software User Manual
Field
Terminal range
Auto terminal number assignment (not supported by Direct
TCP)
Description
Terminal number range that communicates with this host.
Range: 1 to 3840. For S900L range is 1 to 50.
Default: 1 to 32
For information on selecting the terminal range see
Numbers on the General Host Options Screen”
When selected, TekTerm Server assigns terminal numbers to all mobile devices that use this session.
When not selected, terminal numbers must be assigned on the mobile devices.
Default: Selected.
Emulation Options Screen
5250 Options
Field
Write Error Code
Use International
EBCDIC
Allow null character in fixed fields
Terminal Protocol
IBM3179-2 Default
Color
Description
Advisory text
: Error codes are sent to the mobile device as advisory text. This is written at the bottom of the screen. Default.
Screen text
: Error codes are sent to the mobile device as regular screen text.
Default: Advisory text
When selected the TekTerm Server uses the international EBCDIC character set, the positions of the ! and ] characters are swapped.
Default: Not selected.
When selected, empty fields show video attributes properly when using
5250 emulation.
Default: Selected.
The protocol used for the connection between the mobile devices and the
TekTerm Server. Options are:
TESS/BCM
: This uses the TekTerm Server data caching, and page saving, features.
HTML/HTTP
: This uses the Communication Server HTTP server. The browser on the mobile devices must connect to port 80 on the TekTerm Server.
Default: TESS/BCM
The default colour for the mobile device.
Green
: Default.
TekTermDefined
: The green attribute is remapped to the TESS Default attribute.
5250/Telnet Host Configuration 3 - 5
TESS Options
Field
Field Underline
Remapping
Alarm
Clear
Passthru
Description
This is how the
TekTerm Server
renders underlined fields sent from the host.
Values: None, Blink, Bold, Reverse.
Default: None.
When selected, 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.
Default: Not selected.
When selected, the
TekTerm Server that is filled with spaces.
creates an empty entry field for an entry field
Default: Not selected.
When selected, the
TekTerm Server
allows the host to send data directly to the serial port of the mobile device. This is commonly used for printing.
Preparing Host Screens for Pass-Through:
On the screen to be sent through the mobile device serial port, the word
PASSTHRU
has to appear on the first line, starting in the second column. The actual data to be sent to the mobile device may start anywhere below the first line.
Attributes occupy a position in the screen buffer. An attribute placed between column 2 and the end of the word PASSTHRU pushes all following characters one position to the right. Therefore, any required attributes should occupy column
1 of the first line (just preceding the word PASSTHRU).
For example: where @ is an attribute.
When the TekTerm Server finishes sending the data to the printer attached to the mobile device, it sends a packet containing only a Record Separator (0x1e) character to the host. The host must wait for this packet before sending any more screens (including other PASSTHRU screens) to the mobile device.
Refer to the user manual for the mobile device for information about setting parameters on the mobile device for pass-through.
Default: Not selected.
3 - 6 TekTerm Server Software User Manual
Field
Procedures
Local
Enable TekTerm
Screen Formatter
Remote Print
Pages
Description
Legacy setting. The last device to support this is the 7030.
When selected, the TekTerm Server can send TESS procedures to the mobile devices. A TESS procedure is a group of TESS commands that can be executed by the TESS execute procedure command.
Default: Not selected.
Legacy setting. The last device to support this is the 7030.
When selected, the TekTerm Server can provide pages to be loaded as local
TESS procedures in the mobile devices.
The local procedures are selected from a menu on the mobile device. The mobile device can perform these procedures when it is offline. Later when the mobile device is online, it sends the results of these functions to the host.
Procedures
must also be selected.
Default: Not selected.
When selected, the
TekTerm Server
uses TekTerm Screen Formatter. TekTerm
Screen Formatter was previously known as TSF/0.
Default: Not selected.
When enabled, the TekTerm Server sends the print page to a mobile device whenever the mobile device requests it (by sending the F17 function key from the mobile device, or the PRINT key on older mobile devices). The TekTerm Server sends the function response back to the host.
Support for printing must be enabled on the mobile device; refer to the appropriate user manual for the mobile device for more information.
Default: Not selected.
The number of host screens (or pages) stored on the mobile device.
The TekTerm Server maintains an image of each page stored on the mobile device. After receiving an application screen, the TekTerm Server tries to match the screen with a stored page.
If a similar page is already in the mobile device memory, the TekTerm Server instructs the mobile device to re-display its copy of the page; only the necessary changes are sent from the TekTerm Server. If no match is found, the complete page is sent to the mobile device.
There is a corresponding parameter on the mobile device itself, and the actual number of saved pages is the smaller of the two values.
A value of 1 (one) disables this feature.
Values: 1 to 79
Default: 8
Field
Host Print
5250/Telnet Host Configuration 3 - 7
Description
When selected, an application can send data to the display on the mobile device as well as to its attached printer.
The text that is passed to the printer is formatted into a 24 x 80 application screen.
If the host can initiate the print operation, the text is printed. The TekTerm Server identifies the additional text as a print page by the presence of the string PRINT beginning in the 2nd column of line 13 on the 24 x 80 screen. PRINT should be defined as display-only text.
The print page is positioned below the display page of the mobile device (see the following diagram). The size of the print page is always the same as the display page of the mobile device (assuming that in the mobile device configuration, the page length is less than 12 lines).
When Host Print is enabled, the TekTerm Server passes the print page to the mobile device after receiving the application screen from the host.
Unlike with the Passthru option, when using Host Print no escape commands can be sent to the printer.
Support for printing must be enabled on the mobile device; refer to the appropriate user manual for the mobile device for more information
Default: Not selected.
3 - 8 TekTerm Server Software User Manual
Field
Transmit Line
AIAG
Description
When enabled, all modified data on the mobile device is automatically transmitted when the operator enters data into an entry field on or above this line.
The value in this text box specifies the line on the screen which is designated as the transmit line. The last entry field on or above the transmit line on the screen is identified as the field which will cause all modified data to be sent to the host. Any entry fields that exist on lines below the transmit line will not cause the screen to be transmitted.
A value of 0 (zero) disables this feature.
A value of 24 causes the last entry field on each application screen to be defined as transmit-upon-entry.
Values: 0 to 24
Default: 0.
The decimal value of the special character (ASCII) used to tag a field to use
AIAG mode.
When barcode data is entered on a mobile device, the mobile device searches for
AIAG fields on the current page. These fields can accept the special barcode data. The data preloaded into the AIAG field by the application program determines whether a barcode is accepted. The format of the preloaded data is:
<mode><AIAG prefix>
The application program distinguishes an entry field as AIAG by preceding the entry field with this special AIAG character.
A value of 0 (zero) disables this feature.
Values: 0 to 255
Default: 0.
For the AIAG mode character table see AIAG Mode Values on page 3-12
.
Field
Visible Match
Character
5250/Telnet Host Configuration 3 - 9
Description
The decimal value of the special character (ASCII) used to tag a field to use visible match mode.
With field matching, the host computer preloads data into an entry field. Now the mobile device operator can make an entry that matches this preloaded data. For visible match fields, the preloaded data is displayed in the entry field on the mobile device.
The application program distinguishes an entry field as a match field by preceding it with a special character.
The special character is entered as the decimal character code for one of the first
127 ASCII characters.
For example, assume that the > character (ASCII decimal character code 62) is defined for visible match fields. This character must immediately precede the entry field:
Part #>_______
The field: Part #> includes the character > and is followed by the part number entry field on the screen. If any other character was chosen as the last character of the text, the entry field would not be a match field.
The preloaded data sent to a mobile device may consist of the exact characters, special match characters or a combination of the two.
For example, suppose you wish to preload an entry field with a part number. If the exact part number is known, you may preload the field with that part number. If more flexibility is required, and part numbers always begin with two alphabetic characters followed by a hyphen character and four digits, then the match string for the field could be: &&–####.
If an entry is different from the preloaded data, the entry is displayed, the mobile device beeps and the cursor is in the first position of the match field.
Now either another entry in the match field can be made, or the cursor can be moved to a new field. When an entry (even if it does not match the host preloaded data) is made in a match field, this entry is sent to the host as part of the modified data from the mobile device during the next transmission.
A value of 0 (zero) disables this match field feature.
Values: 0 to 255
Default: 0.
For the match characters see
.
3 - 10 TekTerm Server Software User Manual
Field
Hidden Match
Character
Serial I/O
Print Line
Print Form Length
Barcode
Description
The decimal value of the special character (ASCII) used to tag a field to use hidden match mode.
A special character is used to mark Hidden Match fields in a TESS screen. This character precedes the field contents of the Hidden Match field. In hidden match fields, as opposed to visible match fields, the preloaded entry is not displayed in the entry field on the mobile device.
A value of 0 (zero) disables this feature.
Values: 0 to 255
Default: 0.
For the match characters see
.
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.
The starting line number of the print page on the application screen.
A value of 1 (one) causes the display page to be printed. A value of 0 (zero) disables this feature.
Values: 0 to 24
Default: 0.
The printer form length, in lines.
Values: 0 to 24
Default: 0.
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.
5250/Telnet Host Configuration 3 - 11
Field
Entry Line
Field Overhead
Command Region
Description
The number of the first line displayed if there is no entry field above this line on the screen and if an entry field is at or below this line.
The Entry Line parameter allows an automatic offset within the host screen.
Normally, Psion mobile devices only display the upper left corner of the application screen because of their smaller display size.
Values: 0 to 24
Default: 0.
The maximum number of characters allowed between two fixed fields which still allows the TekTerm Server to join them into one field.
Sometimes the TekTerm Server 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
These two pairs of text boxes define a region of the host screen which the
TekTerm Server examines for the presence of reserved commands. The first text box of each pair contains the row number; the second contains the column number.
These four numbers represent the row and column addresses of the upper left corner and the lower right corner of the command region. To define the last two lines of the host screen as the command region, enter 23, 1 - 24, 80
The only commands supported in the command region are ALARM and FONT:
• When the word ALARM is placed anywhere within the command region, the
TekTerm Server
sends a TESS beep command to the mobile device.
• When the word FONT is placed anywhere within the command region, and followed by a number (the font code), the
TekTerm Server
sends the appropriate
TESS Change Font command to the mobile device.
For font codes see Font Code List for Open TekTerm on IngenuityWorking.
Font codes are only required for versions of OTT before version D.
Rows: 0 to 24
Columns: 0 to 80
Default: 0,0 - 0,0
3 - 12 TekTerm Server Software User Manual
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.
5250/Telnet Host Configuration 3 - 13
HTML/HTTP Options
Field
Enable TekTerm
Screen Formatter
Description
Enable Colour Support When selected, when an application fills a field with spaces, an empty entry field is displayed.
Default: Not selected.
Foreground Colour This is the foreground colour for the text that the TekTerm Server HTTP server sends to mobile devices connecting via HTTP. The choices are the 16 predefined
HTML colour names.
Background Colour
Values: Aqua, Black, Blue, Fuchsia, Gray, Green, Lime, Maroon, Navy, Olive,
Purple, Red, Silver, Teal, White, Yellow
Default: Black
This is the background colour, the colour of the HTML page, that the TekTerm
Server HTTP server sends to mobile devices connecting via HTTP. The choices are the 16 predefined HTML colour names.
User Data Font Size
Values: Aqua, Black, Blue, Fuchsia, Gray, Green, Lime, Maroon, Navy, Olive,
Purple, Red, Silver, Teal, White, Yellow
Default: Silver
This is the value for the HTML font size attribute that is applied to user data on the browser screen.
Values: 1, 2, 3, 4, 5, 6, 7
Default: 3
Function Key Font Size This is the size of the font that is used on the function key buttons on the browser screen.
Values: 4pt, 6pt, 8pt, 10pt, 12pt, 14pt
Default: 8pt
When selected, the TekTerm Server uses TekTerm Screen Formatter. TekTerm
Screen Formatter was previously called TSF/O.
Default: Selected.
3 - 14 TekTerm Server Software User Manual
5250 Telnet Protocol Options Screen
Field
Terminal Type
Host Port
Maximum Sessions per Terminal
First Local Terminal
Port
Local IP Address to
Bind
First Terminal Listen
Port
Description
The type of terminal to be emulated by the TekTerm Server.
Values: IBM-5252-11, IBM-5555-B01, 3179-2
Default: IBM-5252-11
The port number on the host for this connection.
Values: 1 to 32767
Default: 23
The maximum number of Telnet connections that can originate from each mobile device.
Values: 1 to 127
Default: 4
If Enable Telnet Enhancements (previously called Enable Virtual Device Names) is not selected, all the sessions use device names supplied by the host.
If Enable Telnet Enhancements (previously called Enable Virtual Device Names) is selected, the TekTerm Server supplies device names for all sessions and one of the following occurs:
• If the maximum number of sessions is greater than 1 (one), flexible device names are used. Flexible device names have a session letter appended to the fixed portion of the device name.
• If this maximum number of sessions is equal to 1 (one), device names are fixed:
No session letter is appended.
For more information see Enable Telnet Enhancements on page 3-16
.
The port number from which the TekTerm Server makes a Telnet connection for the first terminal. Additional Telnet sessions are assigned higher port numbers.
Values: 1 to 32767
Default: 10000
The IP address of the TekTerm Server interface that connects to this host. It is used with the local port numbers to create a unique socket for each mobile device session.
Default: 0.0.0.0
The lowest port number on which the TekTerm Server listens for Telnet connections initiated by the host.
When set to 0 (zero) this option is disabled.
Values: 0 to 32767
Default: 0
5250/Telnet Host Configuration 3 - 15
Field
Actively Negotiate with
Host
Auto-telnet/login
Enable
Auto-telnet Host
Auto-telnet Without
User Action
Custom Device Names
Device Name Prefix
Description
When selected, the TekTerm Server performs advanced negotiations with the host during Telnet connection.
Default: Not selected.
When enabled, the host connection is automatically selected by the Auto-telnet
Host
parameter.
When disabled, Telnet sessions from the mobile devices must be manually initiated.
Values: DISABLE, AUTO-TELNET
Default: DISABLE
The name or the IP address of the host to which auto-Telnet requests are directed.
Any host name which can be used at the TCP> prompt on the mobile device may be used here.
Default: None.
Note:
The host name must be resolvable by the TekTerm Server: The TekTerm Server must be able to obtain an IP address for it. For example, the host name may correspond to an entry in the TekTerm Server host table, or the TekTerm Server may be able to query a domain name server.
When selected, the TekTerm Server attempts to connect to the host as soon as a mobile device initializes, and it attempts to reconnect if the Telnet session closes.
Default: Selected.
Click
Configure
to open the
5250 Telnet Terminal Naming Screen
.
For more information see 5250 Telnet Terminal Naming Screen on page 3-17
.
A prefix for the TekTerm Server-generated virtual device name. The device name sent to the host starts with the prefix, followed by the terminal number, which may be followed by a session letter. For example, if the virtual device name prefix is
PTX, the first session on terminal number 2 receives a virtual device name of PTX0002A.
For this setting to be active, Enable Telnet Enhancements must be selected.
The prefix can include uppercase letters A to Z, numbers 0 to 9, and the special characters $, # and @. Lower case letters are accepted and translated to uppercase characters. The prefix must not begin with a number.
Values: 1 to 5 characters
Default: None.
3 - 16 TekTerm Server Software User Manual
Field
Enable Telnet
Enhancements or
Enable Virtual Device
Names
Display Emulation
Support (Code page,
Character Set,
Keyboard Type)
Description
When selected, the TekTerm Server requests a specific virtual device name from the host for each mobile device session.
When not selected, the host assigns a device name to each session.
Virtual device names are configured through the 5250 Telnet Terminal Naming
Screen
or using the Device Name Prefix.
When this feature is selected, the following sequence is used to assign virtual device names:
1 If a full device name has been specified for a terminal using the 5250 Telnet
Terminal Naming Screen
, that name is assigned.
2 If the Device Name Prefix is configured, this prefix is used to generate a device name for the terminal.
3 The host assigns a device name.
Device names can be either fixed or flexible.
Flexible device names are created when the maximum number of sessions is configured to be greater than 1 (one). In this case, each 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.
Fixed names are created when the maximum number of sessions is set to 1
(one). In this case, each device name has a maximum length of 10 fixed characters. There is no session letter appended. If the requested name is not available on the host, the mobile device displays a message instructing the user to contact the system administrator.
Default: Not selected.
For more information see
5250 Telnet Terminal Naming Screen on page 3-17
and
Device Name Prefix on page 3-15 .
The codepage and keyboard type that are configured on the host or server. Select from the drop-down list. This setting must be identical to the host setting so that the correct characters are sent to the host application.
Default: 037 USA,Canada(37,697,USB)
5250/Telnet Host Configuration 3 - 17
5250 Telnet Terminal Naming Screen
Field
Terminal number
Terminal name
Description
The number of the terminal which receives the name in Terminal name.
Values: 1 to <number of configured terminals>
Default: 1
A virtual device name for the terminal. It can include uppercase letters A to Z, numbers 0 to 9, and the special characters $, # and @. Lower case letters are accepted and translated to uppercase characters. The prefix must not begin with a number.
When using flexible device names (maximum number of sessions is greater than
1), the maximum length for the terminal name is 9 characters. More characters results in a validation error.
Values: 1 to 10 characters.
Default: None.
Buttons
Button
Show/Set
Delete
OK
Description
Displays the virtual device name associated with the terminal number.
If you have just entered a terminal number and virtual device name, press this button to add the terminal number and virtual device name to the list of configured terminals.
Note:
If a name disappears from the Terminal Name text box after the Show/Set button has been pressed, the last terminal number entered has not been registered by the TekTerm Server system, and the name has been saved to the previous terminal number.
It is recommended that the terminal names be frequently checked during entry through the Terminal Names screen.
Deletes the currently-displayed terminal number and virtual device name from the list.
Saves changes to the database and returns to the 5250 Telnet Protocol
3 - 18 TekTerm Server Software User Manual
Button
Validate
Show Terminals
Description
Validates, with the option to save, the changes to the TekTerm Server database.
On the Validation Results screen, after reviewing any error messages, you can click one of the following:
• Cancel: Returns to the Configuration Main Menu Screen.
• Commit: Commits the entire database and returns to the Configuration Main
Menu
screen.
• Undo: Discards all database changes since the last database commit, and returns to the Configuration Main Menu screen.
Displays the list of currently-configured terminal names.
Function Key Mappings Options Screen
Use the function key list boxes to select a code that is sent to the host when the corresponding function key is pressed on the mobile device.
Typical Host Configuration
Line Description
Parameter
Line description
Option
Category of line
Resource name
Online at IPL
Vary on wait
Network controller
Local adapter address
Exchange identifier
Ethernet standard
Maximum controllers
Error threshold level
Text
Option
Category of line
LIND
RSRCNAME
ONLINE
VRYWAIT
ADPTADR
EXCHID
MAXCTL
ENETLINE
*BASIC
*ELAN
LIN021
*YES
*NOWAIT
RFCTRLENET
08005AB7C3FD
05629A5A
*ALL
40
*OFF
*APPN
*ELAN
Parameter
Link speed
Cost/connect time
Cost/byte
Security for line
Propagation delay
User-defined 1
User-defined 2
Autocreate controller
Source Service Access Points
SSAP
AA
Controller Description
Parameter
Controller description
Option
Category of controller
Attached line
Online at IPL
Text
TCP/IP Link
Parameter
Line description
Internet address
Link type
Auto start link
Maximum Frame
1496
CTRD
ONLINE
DEVD
5250/Telnet Host Configuration 3 - 19
10M
0
0
*NONSECURE
*LAN
128
128
*NO
Type
*NONSNA
RFCTRLENET
*BASIC
*NET
ENETLINE
*YES
*BLANK
ENETLINE
50.0.1.1
*ELAN
*YES
ಡೌನ್ಲೋಡ್ ಮಾಡಿ
ಸಾರ್ವಜನಿಕ ಲಿಂಕ್ ನವೀಕರಿಸಲಾಗಿದೆ
ನಿಮ್ಮ ಚಾಟ್ಗೆ ಸಾರ್ವಜನಿಕ ಲಿಂಕ್ ಅನ್ನು ನವೀಕರಿಸಲಾಗಿದೆ. You may view and manage your chat links after registration here.
ದಾಖಲೆಯ ಸಾರ್ವಜನಿಕ ಲಿಂಕ್
ಜಾಹಿರಾತು
