Mochasoft 5250

 admin

Mocha TN5250 is a 5250 emulator written in java, which makes it possible from a java enabled browser, to connect an AS/400 server. The AS/400 - also called the 'IBM iSeries,' is a midrange server from IBM, designed for the business world. 1.1 Functionality Supports all standard 5250 emulation features. Mocha TN5250 for Android provides TN5250 emulation for AS/400 terminal access. Try the free LITE version before making an order. The paid version removes the 5 minutes session limit. Existing Users Log In Here: User ID: You attempted to access a protected resource without logging in. TN5250 - Download a free 30 days trial. Client for AS/400 access The AS/400 - also called the 'IBM iSeries,' is a midrange server from IBM, designed for the business world. TN5250 is a terminal emulator which provides access to an AS/400. Mocha TN5250 for Android provides TN5250 emulation for AS/400 terminal access. Try the free LITE version before making an order. The paid version removes the 5 minutes session limit.

Contents

1.0 Product overview

Mocha TN5250 is a 5250 emulator written in java, which makes it possible from a java enabled browser, to connect an AS/400 server. The AS/400 - also called the 'IBM iSeries,' is a midrange server from IBM, designed for the business world.

1.1 Functionality

  • Supports all standard 5250 emulation features
  • Alternate screen size (24x80 or 27x132)
  • SSL/TLS , if the AS/400 certificate is not using MD5.
  • Clipboard.
  • User defined functions keys.
  • Autologin.
  • Many trim parameters.
Mochasoft 5250

Mochasoft 5250 Windows 10

1.2 Clipboard

Use the mouse to select an area, or 2 x click a word on the screen. Use ALT+C to copy, ALT+V to paste. ALT+A to select all. CTRL+C+V and X can also be used.

1.3 Connect

It is possible to connect to a host from the File menu. A pop-up window is shown. Enter a host name and a port number . The port number for TN5250 is default 23, and SSL/TLS 992.

Another solution is to give the ip and port address in the HTML file loading the TN5250 applet.

1.4 Function keys

Function keys can be used from the keyboard, or the toolbar

1.5 Focus

If keyboard focus, the cursor will be shown. On some browsers, focus must be clicked after a dialog box, such as the connect dialog has been closed.

1.6 Status line

  • Connection state:
    • ONLINE : A session is active with an AS/400.
    • OFFLINE : No active session. Click here to make a new connection.
    • ASCII : Telnet session has not yet entered the 5250 mode.
  • State:
    • X-WAIT : Waiting on AS/400.
    • X-HELP : prehelp state. Press keys Reset or Help (*) to continue.
    • X-LOCK : AS/400 has requested the keyboard to be locked.
    • X-FER : Use Fieldexit to leave this field. It is possible to disable this function in menu - options - require fieldexit (or with parameter fieldexit to the applet).
  • Last function key pressed.
  • Insert mode.
  • M if a message has been received (AS/400 mail system uses this option).
  • Cursor position (y,x).

1.7 Known problems with Applets

  • Mac OS X does not allow a web browser to be started from an Applet. URL hotspots will not be possible
  • Using Mac OS X and pressing ESC or F1-F16 keys, the ctrl and shift keys cannot be used, until a normal key is pressed
  • SSL/TLS can only be used, if the AS/400 certificate is not using MD5. A self signed certificate may use MD5.
  • Mac OS X will not give focus to the Applet on load. Click the 5250 window.
  • Only Microsoft Windows and Mac OS X are supported. Linux is not supported.

2.0 Parameters

Parameters to Mocha TN5250 is given in the HTML file loading the java application. Nothing is stored on the users workstation.

2.1 HTML page

An applet is defined in a HTML page with label <APPLET>. See other source of information for how to write HTML. An example of a HTML page: CODE parameter must always be 'TN5250.class'. It is the name of the master file for the binary Mocha TN5250 product. To use the full width use '100%'

Each parameter is build of a name and a value. In the example above parameter host is given value myas400. It is very important to remember <> around each line, and the value must be surrounded with '.
As to give keyboard focus to the applet when loaded add a small script:

Mochasoft Tn5250 Windows 10

2.2 Parameter keylayout

It is possible to define a keyboard mapping, such as what shift + f5 should do in a customized file. If 'default' is used, a default file included in the jar file will be used. If a filename as 'keys52' is given, this file must exist in the same folder on the Web server, as the TN5250.jar file.

Syntax:
name=keylayout value='<a file name>'

2.3 Parameter license

Name of the company using Mocha TN5250. Should only be included together with parameter 'license_key'.

Syntax:
name=license value='<name of a company>'

2.4 Parameter license_key

When ordering Mocha TN5250, an encrypted license code will be received. Use this together with parameter 'license' to remove the time limit for a session. The license key for the Java version start with 'E'. A license key for another MochaSoft product cannot be used.

Syntax:
name=license_key value='<encrypted key>'

2.5 Parameter user and password

Use these two options to perform auto login, when the applet is loaded. Of course it can not be recommended to include a secret login and password in a HTML page, as everyone can read the source from a browser.

Syntax:
name=user value=<userid>
name=password value=<password>
Example:
name=user value='joe'
name=password value='password'

2.6 Parameter ebcdic

The EBCDIC codepage should be the same as on the AS/400. Following values are supported
  • US (37)
  • Italy (280)
  • Austria/German (273)
  • Spain (284)
  • French (297)
  • United Kingdom (285)
  • Finland/Sweden (278)
  • Danish/Norway (277)
  • Belgium (274)

Syntax:
name=ebcdic value='codepage number'
Example:
name=ebcdic value='277'

2.7 Parameter hotspots

If it should be possible to click on keys displayed on the screen, such as F3=exit. Also URLS starting with www. , http:// or https:// can be clicked
Syntax:
Mochasoft 5250 name=hotspots value='true false'
Default is false.

2.8 Parameter show-f1-f12

If toolbar should include keys f1 - f12
Syntax:
name=show-f1-f12 value='true false'
Default is true.

2.9 Parameter show-f13-f24

If toolbar should include keys f13 - f24
Syntax:
name=show-f13-f24 value='true false'
Default is false. Press shift and f1-f12 becomes f13-f24.

2.10 Parameter show-extra

If toolbar should include extra 5250 keys, such as page up/down
Syntax:
name=show-extra value='true false'
Default is true.

2.11 Parameter 2xclick

A double click put the cursor at the position, and send a 5250 ENTER command to the server.
Syntax:
name=2xclick value='true false'
Default is true.

2.12 Parameter nodialog

A click on menu - connect or toolbar connect icon, will not display the dialog for the IP address and other information, but a new session is started to the as/400 using the IP address from the HTML page.

Syntax:
name=nodialog value='true false'
Default is false.

Mochasoft 5250

2.13 Parameter ignorexhelp

If 5250 should accept pre-help state. If this is the case, the user must press help or reset to continue the session

Syntax:
name=ignorexhelp value='true false'
Default is true.

Mocha Tn5250 Free Download

2.14 Parameter fieldexit

If tn5250 should require field+/- to be used, when the AS/400 program request it.

Syntax:
name=fieldexit value='true false'
Default is false.

2.15 Parameter beep

if messages and bell function should give a sound.

Syntax:
name=beep value='true false'
Default is true.

2.16 Parameter hideviewmenu

If the menu bar element 'view' should be displayed.

Syntax:
name=hideviewmenu value='true false'
Default is false.

2.17 Parameter hideoptionmenu

If the menu bar element 'options' should be displayed.

Syntax:
name=hideoptionmenu value='true false'
Default is false.

2.18 Parameter smallconnectdialog

If the connect dialog should only have ip, port and ssl/tls option displayed

Syntax:
name=smallconnectdialog value='true false'
Default is false.

2.19 Parameter tool_bar

Defines if the toolbar below the menu bar should be shown.

Syntax:
name=tool_bar value='true false'
Default is true.

2.20 Parameter menu_bar

Defines if the menu bar should be shown.

Syntax:
name=menu_bar value='true false'
Default is true.

2.21 Parameter show_fxx

Defines if the f1 - f24 and extra keys keys should be in the tool bar.

Syntax:
name=show_fxx value='true false'
Default is true.

2.22 Parameter color_bg

The color of the background can be defined with this parameter.

Syntax:
name=color_bg value='#rrggbb'
where

  • rr is red color in hex (0-FF).
  • gg is green color in hex (0-FF).
  • bb is blue color in hex (0-FF).

The syntax is the same as used in the HTML language.

Example:

name=color_bg value='#20f030'

2.23 Parameter color_xxx

The colors the as/400 program request, can be defined with this parameter. Mochasoft 5250 emulator

Syntax:
name=color_red value='#rrggbb'
name=color_blue value='#rrggbb'
name=color_pink value='#rrggbb'
name=color_green value='#rrggbb'
name=color_turquoise value='#rrggbb'
name=color_yellow value='#rrggbb'
name=color_white value='#rrggbb'
where

  • rr is red color in hex (0-FF).
  • gg is green color in hex (0-FF).
  • bb is blue color in hex (0-FF).

The syntax is the same as used in the HTML language.

2.24 Parameter color_select

The color used to mark an area for clipboard copy can be defined with this parameter.

Syntax:
name=color_select value='#rrggbb'
where

  • rr is red color in hex (0-FF).
  • gg is green color in hex (0-FF).
  • bb is blue color in hex (0-FF).

The syntax is the same as used in the HTML language.

2.25 Parameter color_cursor

The color of the cursor can be defined with this parameter.

Syntax:
name=color_cursor value='#rrggbb'
where

  • rr is red color in hex (0-FF).
  • gg is green color in hex (0-FF).
  • bb is blue color in hex (0-FF).

The syntax is the same as used in the HTML language.

2.26 Parameters host and port

These parameters defines which host to connect, when the applet is loaded. The default port number for TN5250 is 23 and SSL/TLS 992.

Syntax:
name=host value=<a host name>
name=port value=<number>
The host name can either be a name or an Internet address as 198.66.23.11. There is not a real server at this address!

2.27 Parameter SSL

Mocha TN5250 can use SSL/TLS layer from the SUN Java layer. SSL/TLS can only be used, if the AS/400 certificate is not using MD5. A self signed certificate may use MD5.

Syntax:
name=SSL= value='true false'
Default is false

2.28 Parameter autoconnect

Mocha TN5250 can make a connection when the applet has been loaded.

Syntax:
name=autoconnect= value='true false'
Default is false

2.29 Parameter 27x132

Mocha TN5250 screen size can be 24x80 or 27x132. TN5250 will always start in 24x80 mode, but an AS/400 application can request for 27x132 mode, if this parameter is true.

Mochasoft Dk Tn5250 Msi

Syntax:
name=27x132 value='true false'
Default is false

2.30 Parameter font and font style

Possible to define the display font

Syntax:
name=font value='font name'
name=fontstyle value='style'
Default is Courier. To see the font names possible to use, start mocha TN5250 in a browser, and select menu - settings - font.
Possible font styles are :Plain,Bold, Italic and Bold Italic.

2.31 Parameter keepalive

TN5250 can send keep alive frames at 10 second intervals.

Syntax:
name=keepalive= value='true false'
Default is true

2.32 Parameter margin

Margin to be used around a screen print

Syntax:
name=margin= value='36'
Default is 36

2.33 Parameter devicename

Device name for the session. In most cases this parameter should not be used, as an AS/400 only allows one session with a given device name

Syntax:
name=devicename value='<a devicename in upper case>'

2.34 Parameter separator

If TN5250 should display the separator attribute

Syntax:
name=separator= value='true false'
Default is true

3.0 Keyboard mapping

As it is individual how to map the keyboard, all function keys has been made changeable. If parameter 'keylayout' is not used or defined as default, a standard keyboard mapping file from the TN5250.jar file will be used. See 3.1
Mochasoft 5250


The package includes an example keyboard file keys52, which can be used with parameter 'keylayout'.


Syntax for file 'keys52':

  • Comments starts with #
  • <pc-key> <5250-key>

Mochasoft 5250

Following keys can be defined:
The pc-key's are:
fxx : xx is 1 .. 24 (function key f1 - f12)
Fxx : xx is 1 .. 24 (shift + function key f1 - f12)
cfxx : xx is 1 .. 24 (ctrl + function key f1 - f12)
CFxx : xx is 1 .. 24 (shift + ctrl + function key f1 - f12)
HOME
END
PGUP
PGDN
ESC
RETURN
SCROLL
PAUSE
INSERT
CTRL
KEYPADPLUS
KEYPADMINUS
KEYPADENTER


The 5250 keys are:
pf1 - pf24
insert
erase(erase all input fields)
record (record Backspace (Home)
fieldexit
field-
field+
pgup (roll down)
pgdn (roll up)
help (send help request to the host)
attn
systreq
dup
clear (send clear request to the host)
reset (reset keyboard)
enter


Example of a 'keys' file:

3.1 Default keyboard

The default file 'keys52', contains following mapping of the keyboard:


4.0 License System

The license system for Mocha TN5250 is very user friendly. The encrypted parameter 'license_key', together with parameter 'license' gives a check for legal use. It is not possible to change the company name in 'license', without requesting a new key from MochaSoft.

If parameter 'license_key' is not given, the program will run in Demo mode, and a session is restricted to 180 seconds