Transcript WireLess TelNet

Tn52 (5250 / 3270)
Tutorial
Common cases of configuration
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
1
Define the emulation 52 / VT
WTn52 -> emulation 5250 / 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)
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
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
2
Table of contents
License activation
Configuring the emulator
IBM Family 5250 / 3270
Keyboard mapping
Touch screen actions
Display configuration
Barcode reading
Error messages
Advanced configuration
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
3
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
4
License activation
Demo mode:
Document
Telnet sessions disconnect itself after 5 minutes.
License activation guide
License activation may be performed using a desktop PC
or directly with the PDA if the device has internet connection availability
Options:
• On-line, by Internet connection.
• E-mail license request.
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
5
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
6
How to configure the emulator?
Emulator configuration is stored in files on the PC.
At each modification they will be copied to the PDA
1
• Access to the emulator configuration
3
Start >
Download configuration
to the PDA
WireLess TelNet WCE 5250 >
TelNet Clients - Default Profile > (PDA model)
Configuration
Configuration
download by
ActiveSync
2
Change the configuration, i./e.:
[TN52_EMULATION]
DragDisplay = Yes
WireLess TelNet 52 – Tutorial - Common cases of configuration
4
Restart the program to
read new configuration
www.softogo.com
7
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
8
Family 5250 or 3270
5250 (SNA LU 6.2)
5251-11, 5292-2, etc.
AS400 / iSeries / i5 (OS/400)
Configuration (Generic File)
[SESSION_0]
TTypePreferred=5292-2
EmulationTylpe=5250.
3270 (SNA LU 3)
3278-2, 3279-2, etc.
IBM/3090 S/390 (System/370)
Configuration (Generic File)
[SESSION_0]
TTypePreferred=3278-2-E
EmulationTylpe=3270.
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
9
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
10
Keyboard Mapping
How-to configure the keyboard mapping?
In the 5250 configuration
On-line help
TIP! -> In the configuration file
5250 actions ( AID, Function, Control,
Cursor, Signal) are grouped by topic:
520 Action
SCANCODE of the key
to be mapped
[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)
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
11
Keyboard Mapping
It is possible to map any keystroke to any 5250 action
You need to:
Configuration
Identify the 'scancode‘ of the key or keystroke to be
mapped to a 5250 action
The changes are done in the
configuration file.
Access it from installation
page.
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’
On-line help
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
12
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
On-line help
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 = F16
Configuration (5250 file)
[TN52_KEY_MAP]
Allow mapping from one key to another key (instead of
5250 actions).
On-line help
Example:
Mapping characters that are not in the PDA keyboard.
Press “Esc+5” to make a “-” (minus)
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
13
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
14
Touch screen actions
With the touch screen, the stylus or the fingers, it is possible to perform actions
Available features
On-line help
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.
Cursor by tapping
Move blinking cursor between input fields.
Operation
Configuration (5250 file)
[TN52_EMULATION]
DragDisplay = Yes
It allows to change the input cursor position with the
stylus by pressing directly on the input field.
Configuration (5250 file)
[TN52_EMULATION]
CursorByTap = Yes
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
15
Touch screen actions
With the touch screen, the stylus or the fingers, it is possible to perform actions
Available features
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.
Configuration (5250 file)
[TN52_EMULATION]
FunctionByTap = Yes
On-line help
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
16
Touch screen actions
With the touch screen, the stylus or the fingers, it is possible to perform actions
Available features
Double Tap
With a double tap on the screen, you can generate
any keystroke, which also can be a function.
On-line help
Example of use
It is possible to configure the “double tap” to launch
the virtual keyboard (SIP Panel) on the screen.
Operation
• SipScanCode
Touch two times the screen in the same place, then
remove the stylus.
(Use the same code than DoubleTap – 00FF for
example)
Configuration
It is also possible to generate:
(5250 file)
• Functions
[TN52_EMULATION]
• Enter
DoubleTap=00XX (scan code of the key)
• Letters / digits
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
17
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
18
Display configuration
Configure it by changing the font size in the current session
On-line help
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
1. Try the different sizes in the active
session
[DISPLAYFONT]
FullName=
Size=
• In the active session, on the menu “Tools”, with “Text Size +”
and “Text Size –” is possible to dynamically change the font
size.
WireLess TelNet 52 – Tutorial - Common cases of configuration
On-line forum
On-line help
www.softogo.com
19
Display configuration
Configure it by changing the number of visible rows / columns on screen
On-line help
Font and size
1. Test it in the PDA
TIP
• Connect emulator to Host.
Font Examples
Example 1 Example 2
• 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 help
• Indicator shows rows and columns
following the selected configuration
• Try different layouts with different fonts
and sizes.
Warning.
On-line forum
WireLess TelNet 52 – Tutorial - Common cases of configuration
Prefer fixed width fonts
(monospaced)
www.softogo.com
20
Display colors
Show colors in the PDA as you see in the PC
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
WireLess TelNet 52 – Tutorial - Common cases of configuration
On-line forum
www.softogo.com
21
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
22
Split the barcode
Read a barcode, then split or truncate it to fill one or some input fields
CONFIGURATION (5250 file)
Configure the action to perform with the barcode read.
Configuration option
[TN52_BARCODES]
BcInField
Aide on-line
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).
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
23
ENTER instead of FieldExit
Read a barcode, then send [ENTER] instead of [Field Exit]
• 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).
CONFIGURATION
Warning
(5250 file)
Configure the action to perform after barcode reading.
Do not add suffixes to barcode!
Configuration option
[TN52_BARCODES]
Aide on-line
PostAction
WireLess TelNet 52 – Tutorial - Common cases of configuration
Use prefixes and suffixes only to add
text.
www.softogo.com
24
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
25
Message line
It is possible to show the 5250 bottom message line as a Pop-Up message
CONFIGURATION (5250 file)
[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
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
26
Avoid end of session
Editing barcode reads
Sending PDA name
Connecting a serial scanner
Macros
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
27
How-to avoid end of session?
PDA configuration
Options to configure wait timeouts and simulate a dialog
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)
On-line help
[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.
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
28
How-to avoid end of session?
AS400 Configuration
There are options to configure timeouts
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)
AS400 Timeout
Configuration
• Modify the AS400 timeouts as shown in the following PDF, to adapt it to use portable
terminals with WiFi.
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
29
Editing barcode reads
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.
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.
Configuration (generic file)
• Add characters:
[BC_EDIT_X]
On=<Yes/No>
Ex: (****013****)
On-line help
WireLess TelNet 52 – Tutorial - Common cases of configuration
*=Keep the char
NNN=Adds a char.
www.softogo.com
30
Sending the PDA name
You can send the PDA name to AS400 host (workstation ID)
CONFIGURATION (5250 file)
Aide on-line
[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.
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
31
Connecting a serial scanner
On-line help
Configuration options to connect a serial scanner
CONFIGURATION
(generic file)
TIP!
3 powerful options
Configuration option
[SCANSERIAL]
On=<Yes/No/OnOff>
Remind to configure a suffix (terminator) in the
serial scanner to perform the code transmission.
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.
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
32
Macros
Simulate a keystroke sequence or texts, to automatically fill inputs
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
CONFIGURATION (5250 file)
1.
Create a macro in a text file.
2.
Define the key to launch the macro.
3.
Download the file into the terminal.
• Macro map
• Macro configuration
Example of a macro that sends text
and function keys
WireLess TelNet 52 – Tutorial - Common cases of configuration
www.softogo.com
33