1 wireless telnet 52 – tutorial - common cases of configuration tn52 (5250 / 3270) tutorial...

1WireLess TelNet 52 – Tutorial - Common cases of configuration www.softogo.com

Tn52 (5250 / 3270)Tutorial

Common cases of configuration


WTn52 -> emulation 5250 / 3270

Define the emulation 52 / VT

5250 (SNA LU 6.2)

5251-11, 5292-2, etc. AS400 / iSeries / i5 (OS/400)

3270 (SNA LU 3)

3278-2, 3279-2, etc. IBM/3090 S/390 (System/370)

WTnVT -> emulation VT, ANSI, SSH Not in this document!

Telnet VT

VT100, VT220, ANSI, etc. Win2000-2008/UNIX

SSH

Xterm, VTxxx, etc. UNIX / Linux

Open the WTnVT (UNIX / Windows) Tutorial


License activation

Configuring the emulator

IBM Family 5250 / 3270

Keyboard mapping

Touch screen actions

Display configuration

Barcode reading

Error messages

Advanced configuration

Table of contents


Options:

• On-line, by Internet connection.

• E-mail license request.

Demo mode:

Telnet sessions disconnect itself after 5 minutes. Document

License activation guide

License activation

License activation may be performed using a desktop PC or directly with the PDA if the device has internet connection availability


• Access to the emulator configuration

Start >

WireLess TelNet WCE 5250 >

TelNet Clients - Default Profile > (PDA model)

Emulator configuration is stored in files on the PC. At each modification they will be copied to the PDA

How to configure the emulator?

Change the configuration, i./e.:

[TN52_EMULATION]

DragDisplay = Yes

Download configuration to the PDA3

1

Restart the program to read new configuration

4

Configuration

Configuration download by ActiveSync

2


Family 5250 or 3270

5250 (SNA LU 6.2)

5251-11, 5292-2, etc. AS400 / iSeries / i5 (OS/400)

3270 (SNA LU 3)

3278-2, 3279-2, etc. IBM/3090 S/390 (System/370)

Configuration (Generic File)[SESSION_0]TTypePreferred=5292-2EmulationTylpe=5250.

Configuration (Generic File)[SESSION_0]TTypePreferred=3278-2-EEmulationTylpe=3270.


How-to configure the keyboard mapping?

Keyboard Mapping

In the 5250 configuration

SCANCODE of the key to be mapped

520 Action

TIP! -> In the configuration file

5250 actions ( AID, Function, Control, Cursor, Signal) are grouped by topic:

[TN52_AID_KEYS]5250 Functions(They generate transactions with the host)

[TN52_CONTROL_KEYS](They can -or cannot- generate host transactions)

[TN52_CURSOR_KEYS]Cursor movements(They do not generate host transactions)

On-line help


You need to:

Identify the 'scancode‘ of the key or keystroke to be mapped to a 5250 action

It is possible to map any keystroke to any 5250 action

Keyboard Mapping

TIP! -> Identify the scan code:

In the “Keyboard Test” dialog on the PDA it is possible to check the scan code generated by any key.

Configuration > Keyboard Test‘To->5250’ / ‘To->3270’

Configuration

The changes are done in the configuration file.

Access it from installation page.

On-line help


Keyboard Mapping

Warning. Unless you know exactly what you are doing, please do not modify this section.

[TN52_SIGNAL_KEYS]Specific AS400 diagnostic control actions

Advanced configuration

Other keys Mapping

Configuration (5250 file)[TN52_KEY_MAP]

Allow mapping from one key to another key (instead of 5250 actions).

Example:Mapping characters that are not in the PDA keyboard.

Press “Esc+5” to make a “-” (minus)

TIP! -> Some examples

One finger:In some keyboards it is needed to use both hands to enter F1. It is possible to avoid this by a customized keystroke mapping.

F16 How-to enter F16?. This key does not exist in my PDA keyboard!Suggestion, map as:

Control+D = F16On-line help

On-line help


With the touch screen, the stylus or the fingers, it is possible to perform actions


Display scroll

Scroll the display in the virtual screen by moving the stylus.

Allow to scroll the visible part of the emulated screen in the display to view all the content.

Configuration (5250 file)

[TN52_EMULATION]

DragDisplay = Yes

Available features

Cursor by tapping

Move blinking cursor between input fields.

Operation

It allows to change the input cursor position with the stylus by pressing directly on the input field.


[TN52_EMULATION]

CursorByTap = Yes

On-line help




5250 Functions at screen

Send a function key to the AS400 Host by touching the screen.

Using the stylus you can touch any "Fx“ text on the screen.

(x= is the function number). i./e.: if the text reads “F5”, when touching over this text, emulator sends PF5 function to Host.


[TN52_EMULATION]

FunctionByTap = Yes

Available features

On-line help




Available features

Double Tap

With a double tap on the screen, you can generate any keystroke, which also can be a function.

Operation

Touch two times the screen in the same place, then remove the stylus.

Configuration

(5250 file)

[TN52_EMULATION]

DoubleTap=00XX (scan code of the key)

Example of use

It is possible to configure the “double tap” to launch the virtual keyboard (SIP Panel) on the screen.

• SipScanCode (Use the same code than DoubleTap – 00FF for example)

It is also possible to generate:

• Functions

• Enter

• Letters / digits

On-line help


Configure it by changing the font size in the current session


2. See the resulting configuration in the PDA

Go to configuration dialog and see the currently selected size and font.

3 .Make the configuration persistent

• Change the configuration on the PC.

On the 5250 configuration file

[DISPLAYFONT]FullName=Size=

On-line help

1. Try the different sizes in the active session

• In the active session, on the menu “Tools”, with “Text Size +” and “Text Size –” is possible to dynamically change the font size.

On-line forum

On-line help


Configure it by changing the number of visible rows / columns on screen


Font and size

• Try different layouts with different fonts and sizes.

Warning.

Prefer fixed width fonts (monospaced)

Font ExamplesExample 1 Example 2

Font ExamplesExample 1 Example 2

TIP1. Test it in the PDA• Connect emulator to Host.

• With the menu “Go” / “main“, go back to main menu.

• Go to [configure] / [Display Configuration], change the value in the combo-box, then click on [select].

2. Make the configuration persistent

Configuration option (generic file)

[DISPLAYFONT]FullName=Size=

On-line forum

• Indicator shows rows and columns following the selected configuration

On-line help

On-line help


Show colors in the PDA as you see in the PC

Display colors

Explanation:

Color display varies following the emulated terminal model. 5251-11 (monochrome) and 5292-2 (color).

CONFIGURATION (generic file)

[SESSION_1]

TtypePreferred=5292-2

On-line help On-line forum


Read a barcode, then split or truncate it to fill one or some input fields

Split the barcode

CONFIGURATION (5250 file)

Configure the action to perform with the barcode read.

Configuration option

[TN52_BARCODES]

BcInField

Options

• The 'S‘ setting SPLITS the barcodes exceeding the current input field width. That action allows to fill the following fields.

• By default, the configuration is 'T‘. This setting TRUNCATES the exceeding data and always fills only one field (the current one).

Aide on-line


CONFIGURATION

(5250 file)

Configure the action to perform after barcode reading.


[TN52_BARCODES]

PostAction

Read a barcode, then send [ENTER] instead of [Field Exit]

ENTER instead of FieldExit

• The FieldExit function performs a “Field Adjust“ then moves to the next field (if any).(That action performs an ENTER if the field is AUTO-ENTER).

• The ENTER function performs a “Field Adjust" then send screen data to Host (AID key).

Aide on-line

Warning

Do not add suffixes to barcode!

Use prefixes and suffixes only to add text.


It is possible to show the 5250 bottom message line as a Pop-Up message

Message line


[TN52_ERROR_MSG]

NoMsgLine

Options

• Yes= Do not show the message line as a pop-up.

• No= Show the message line as a pop-up

On-line help


Avoid end of session

Editing barcode reads

Sending PDA name

Connecting a serial scanner

Macros


Options to configure wait timeouts and simulate a dialog

How-to avoid end of session?PDA configuration

Explanation:

The XS Timeout message indicates that the AS400 host is not responding to emulator requests in the PDA.

If the PDA was turned off, probably the AS400 has closed the session. At wake-up time it makes a transaction, but the AS400 has closed the session and do not responds.

PDA CONFIGURATION (5250 file)

[TN52_EMULATION]

XSTimeOut

• It is possible to modify the response wait time (in seconds) to adapt it to slow systems. You can either increase it or set it to zero to make it infinite.

[TN52_TELNET]

DoTcpAlive = YES

• The PDA can perform a periodical “ping” to the host and simulate a dialog to keep the session alive.

On-line help


There are options to configure timeouts

How-to avoid end of session? AS400 Configuration

Explanation:

AS400 system is configured by default to dialog with continuous connected peripherals.It polls them periodically, and close the connection if the device is not responding immediately (as a sleeping PDAs turned off).

HOST CONFIGURATION (AS400 specific)

• Modify the AS400 timeouts as shown in the following PDF, to adapt it to use portable terminals with WiFi.

AS400 Timeout

Configuration

AS400 Timeout

Configuration


Editing barcode reads

Configuration (generic file)

[BC_EDIT_X]

On=<Yes/No>

TIP! -> What can you do?

• Process following read length

• Process following barcode type

• Filter to suppress or keep:

Ex: (NNYYYYNNYYYN)Y=keep the char.N=Suppress the char.

• Add characters:

Ex: (****013****)

*=Keep the charNNN=Adds a char.

On-line help

Barcode reads can be modified by an edit processing before sending them to input fields.

How does it work?

1. Evaluate processing conditions.

2. Filter the reading to keep or suppress characters.

3. Add characters.


You can send the PDA name to AS400 host (workstation ID)

Sending the PDA name


[TN52_TELNET]

TelOpEnvTerm=Yes

•This option allows to send information by the Telnet “Environment” option and to transmit the workstation ID.

CONFIGURATION (generic file)

[SESSION_0]

DevName=MONDEVICE[0IP]

• Set here the PDA name. It is possible to add an index by IP address.

Aide on-line


Connecting a serial scanner

TIP!

3 powerful options

WakeUp

Restart connection at PDA wake-up.

RestartBtn

Shows ComKbd button. Close and reopen the COMX: port by a click(useful for Bluetooth ports).

RestartKey

Key to restart (close and open) the COMx: port.

Configuration options to connect a serial scanner

CONFIGURATION

(generic file)


[SCANSERIAL]

On=<Yes/No/OnOff>

Remind to configure a suffix (terminator) in the serial scanner to perform the code transmission.

On-line help


Simulate a keystroke sequence or texts, to automatically fill inputs

Macros

Example:

To make easy a repetitive operations, it is possible to map a key to generate keystrokes or texts: * A text* FieldExit * Other text * F4


1. Create a macro in a text file.

2. Define the key to launch the macro.

3.Download the file into the terminal.

Example of a macro that sends text and function keys

• Macro map

• Macro configuration

1 wireless telnet 52 – tutorial - common cases of configuration tn52 (5250 / 3270) tutorial...

Documents