Mocha 5250

Posted on by

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. Download - Mocha TN5250 TN3270 TELNET LPD SSH VNC 5250 3270.

File Menu

Edit/New Session

  • Name: A session can be given any name, which will make it easier to remember it. The session name is also shown in the title bar, when the session is active
  • Host name: Name of the AS/400. Either a TCP/IP address as 155.22.11.2 or a DNS name.
  • Port number:Port number for the session. As default TN5250 uses port 23 and with SSL port 992
  • SSL: Enable SSL encryption
  • Terminal size: 2 types of terminals are supported:
    IBM-3477-FC : 27x132 color display
    IBM-3179-2 : 24x80 color display
  • Device name: Some AS/400 systems may require this name for a session. It is possible to use %U , which will be replaced with the user name , and %C , which will be replaced with the PC name. A device name is always in uppercase, and cannot include space characters.
  • Auto Login:Use these fields to define an user id and a password for the Sign On screen on the AS/400.
    Notice there is not much security involved doing it! It could be an idea to contact the system administrator to verify it is your company politic to have open access to the system without any password security.
  • Exit on session termination:If the AS/400 terminates the session, Mocha TN5250 will close without any notification.
  • Confirm exit:If mocha TN5250 is terminated (maybe with ALT F4), and a session is active, an exit confirm box will be shown.
  • Send keep alive:The TCP layer is designed to keep the connection alive, but with network problems, this option can be used to send extra keep alive packets with 10 second intervals.
  • Connect to this host at program start: If enabled, a session will be started, when the program is loaded.

Connect

A list with the already configured sessions are shown, and one can be selected.

Disconnect

Use this command to disconnect the existing session with the Host.

Page Setup

Opens the Windows Print Setup dialog.

The selected Portrait or Landscape mode will be remembered in the programs configuration file

Print

Send the current screen to the printer. Font size and margins, can be defined in menu - tools - options.

Print Preview

Displays a small preview screen for the print. Use it when selecting the best font size, or if not sure, if landscape mode should be used.

Mail

Copies the current screen to the default mail program for the computer.

Exit

Close Mocha TN5250. It may be easier to press ALT+F4

Edit Menu

Copy

Copies selected text from the TN5250 Window to the Clipboard in Text and CSV (Excel data) mode.

Paste

Pastes the contents of the Windows clipboard to the Host as keyboard data.

Paste in Excel (CSV) format

Pastes the contents of the Windows clipboard to the Host as keyboard data. This function is only enabled, if data in CSV (Excel) format can be found in the Clipboard.
The CSV file format is supported by almost all spreadsheets and database management systems.

Cut

Delete the selection, and put it into the clipboard

Append

Appends selected text from the TN5250 Window to the Clipboard.

Select All

Selects the full screen.

Ctrl c+v+x as copy/paste/cut

removed in v 2.0

View Menu

Status bar

Toggles the status bar on and off.

Tool bar

Toggles the tool bar on and off. Can also be controlled with program parameter /T

Tools Menu

Options

Fonts: Select a font name. The list is the monospaced fonts available in your system. Monospaced fonts are typefaces in which every glyph is the same width.

The screen will be scaled to the font, giving a display of 24*80 or 27*132 characters.

Fixed width: If the width of a character should be increased when the 5250 window width is changed. This option solves a problem seen in a few cases, where the extraspace font option fails.

Colors

Text, background, Cursor and Select colors can be changed with this dialog. Click one of the color elements to get a color picker dialog.

It is the AS/400 program, which defines the text colors to use in a screen. The AS/400 can as an example, request a red text, and the color red can be configured in this dialog.

Select, is the color used when selecting an area of the screen with the mouse. The selected area can hereafter be copied to the clipboard.

Language

The language Category lets you change the code page used to display data received from the host. The code page must be the same as on the AS/400

It can be recommended to use the default Windows OS encoding. Only in a multi language environment, an encoding should be selected from the list.

Printer

Fonts: Select a font name. The list is the monospaced fonts available in your system.

Size: Size of the font. Use menu - file - Print Preview, to experiment with different sizes.

Left margin: Left margin on the print in inches

Top margin: Top margin on the print in inches

Some printers may not write to the edge of the paper, and therefore you may see a difference between these margins and the real print.

Show printer selection box for every print job: As default the printer dialog box is shown when activating the print icon in the tool bar. This option will assume the user wants to send print to the Windows OS default printer.

Mocha 5250

Terminal

Allow Sound: On wrong data input, 5250 will indicate problems with a sound. To run in a silence environment, turn this option off.

Enable message waiting sound:If a message is waiting in the AS/400 message system, a sound will be given. Also M is shown in the status line

Swap , and , on the keypad. If NumLock is enabled, the key Del will either transmit '.' or ','. Use this option to change the value.

Mouse wheel: If enabled the mouse wheel works as page up/down keys

Enable hotspots:TN5250 can display all Fx and Fxx objects on the 5250 screen as buttons, which can be clicked with the left mouse key. Also URL's will be shown as click object, and a click will start the default browser with the given URL.

Show column separators as dots A field can be defined as with column separator, meaning spaces in the fields should be shown as dots. If this option is not selected, the separator dots will not be shown.

Always paste in CSV(Excel format): The clipboard can include data in different formats. As default 'Paste' will use the Text format, but with this option the CSV (comma separated data) will be used if possible.

Use ; as clipboard separator (CSV format): CSV data is separated with the ',' character, but in some countries a ';' is used.

Shift + arrow = select area for clipboard: Holding down shift and moving the cursor with the arrow keys, will select data.

Type ahead: Use this command to define, if it should be legal to enter data for the next screen, without waiting for the host to send a response. In the status line after X-WAIT, a number is shown, telling the number of data in the buffer. The buffer is unlimited. Notice not all AS/400 program can handle a type ahead situation.

Cursor type: Normal or as a cross hair. Using the cross hair option will make the screen update work slower. The default keyboard layout has key [Pause/Break] as toggle key between the modes.

Cursor size: Different sizes can be tried. Default is full.

Double left click: Either double clicking the mouse will, a) be ignored, b) work as if ENTER is pressed at the cursor position, or c) the word below the mouse will be selected, and can now be copied to the clipboard with the 'copy' function.

Cursor blink. Defines if the cursor should blink on request from the AS/400 and the speed

Check for field exit key required: Rejects the operator if Field exit is not used in a field-exit required field. X-FER will be shown in the status line.

Ignore PreHelp error state: The AS/400 program can bring the 5250 terminal into a Help state. Hereafter the user must either press RESET to continue or HELP, to get more details. With this option TN5250 ignores the Help state.

In VT mode, return key sends CRLF (default is LF): If TN5250 is connected to an old proxy host, which request a user id/password before allowing a session with the AS/400 host, this option can be used to define the value for the Return key.

MAPI mail: As default tn5250 uses mailto when sending a screen copy to a local mail client on the PC. Such a mail is restricted in size, and will give problems, if the screen is 27x132 characters. The MAPI option uses an other interface to the mail client, allowing larger data, but may not work with all types of mail clients and OS types.

Always focus: When the 5250 window is without focus, and a user click the window, should the window only get focus, or also position the cursor at the click point.

Customize Toolbar

Use this dialog to change the layout for the tool bar. Click on an element and use Add and Remove to move elements to and from the tool bar

Keyboard Layout

Double Click on a key in the list to change, and the following dialog is shown:

Most of the keys on a standard PC keyboard can be configured to either work as a 5250 function key, or transmit a simple set of characters.

License

After ordering Mocha TN5250 from MochaSoft, a license key will be received. Enter the key together with the Company Name given on the order. As there is link between the Company name and license key it is important to enter both very careful.

Configuration

The configuration is stored in a file named user.config.

Mocha 5250 Linux

Export: Copy the current configuration to a file

Import: Read data from a user.config configuration file to the program.

Reset: Reset the configuration to the default values.

Details: Shows program and configuration file locations.

Save shortcut

Use this dialog to make one or more shortcuts to Mocha TN5250.

Make shortcut to programs: Make a shortcut to Windows Programs folder, which is selected from [Start]

Make shortcut to desktop: Make a shortcut to the current users private desktop.

Log Traffic

Use this function to log a trace file. Can be useful when reporting a problem to Mochasoft.

If this option is enabled, a warning will be shown, when a session is started, as to make sure nobody logs data without a valid reason.

Macro record

It is possible to record a set of keyboard stokes into a macro, which later can be played. Macros will be stored in the users MochaSoft application folder in files named tn5250.x, with x between 0 and 999.

Mocha 5250

A macro should be given a name, which makes it possible to remember the function.

It is possible to copy macro files from one user to another. Next time tn5250 is started, the users application folder, is scanned for macro files, and the list of possible macro to play, will be updated.

Stop recording with a click on status bar text [recording] or use menu - tools - macro - stop recording

Macro edit

It is possible to edit the macro.

To change a character in the macro just, put the cursor on the line in the macro file, and type a character on the keyboard.

To add or replace a 5250 function, such as an ENTER in the macro, select [Edit line] or double click the line.

Macro play

To play a previous recorded macro, click the macro icon in the tool bar, or use menu - tools - macro - play macro.

Help

Help

: Shows the online help system

Show keyboard mapping

Display the current keyboard layout. The real keyboard keys Shift and Ctrl can be pressed to show different layouts.

Use as a virtual keyboard: If selected, clicks on the keys, will be send to the 5250 terminal.

About

Shows program details, such as version and license state.

Key [Release Notes] includes the latest informations about this version, such as bugs fixed in this release.

Mocha TN5250 user guide

Mocha TN5250 for Windows Mobile powered smartphone (phones without a touch screen) provides TN5250 emulation for AS/400 terminal access.
Normal screen mode
Landscape mode

Contents

Connect window

  • AS/400 IP Address: Name of the AS/400. Either a TCP/IP address as 155.22.11.2 or a DNS name.
  • Port number:Port number for the session. As default TN5250 uses port 23 and with SSL port 992
  • SSL: Enable SSL encryption
  • Device name: Some AS/400 systems may require this name for a session. A device name is always in uppercase, and cannot include space characters.
TN5250 can use 5 different configurations. The title in the dialog shows the session in use. Use menu - load session to change the active session.

Menu - Load session

TN5250 can use 5 different configurations.
Each session can have private data:
  • AS/400 IP Address and port
  • Device name
  • Auto login user name and password
On program start the last session will be used.

Menu - Auto login

Use these fields to define an user id and a password for the Sign On screen on the AS/400.
Notice there is not much security involved doing it! It could be an idea to contact the system administrator to verify it is your company politic to have open access to the system without any password security.

Menu - Code Page

The language Category lets you change the code page used to display data received from the host. The code page must be the same as on the AS/400

It can be recommended to use the default Windows OS encoding. Only in a multi language environment, a font encoding should be selected from the list.

Menu - Screen follows cursor

Menu - Colors

Text, background and Cursor colors can be changed with this dialog. Click one of the color elements to get a color picker dialog.

It is the AS/400 program, which defines the text colors to use in a screen. The AS/400 can as an example, request a red text, and the color red can be configured in this dialog.

Menu - Network

The Windows Mobile OS can be configured with different networks. It is recommend to use the automatically detect settings option, but it is possible with this menu to force TN5250 to use another network interface.

Network exclusive: Specifies whether the connection is exclusive or not. If this parameter is enabled, this connection cannot be shared with other applications. On session close, the network will close after a delay. The delay depend on the configuration for the network. If this parameter is not enabled, some GRPS networks may not close down, but stay active, event if TN5250 has been terminated.

Notice the network parameters are only valid for dial up/GRPS networks. Using Wifi, the Wifi must be enabled before loading TN5250.

Menu - License

After ordering Mocha TN5250 from MochaSoft, a license key will be received. Enter the key together with the License Name given on the order. As there is link between the name and license key it is important to enter both very careful.

Menu - About

Menu - Settings

  • Use X-Help: The AS/400 program can bring the 5250 terminal into a Help state. Hereafter the user must either press RESET to continue or HELP, to get more details. With this option TN5250 ignores the Help state.
  • Check field exit:Rejects the operator if Field exit is not used in a field-exit required field.
  • Beep on error: Use this to give a silent mode. Notice the Enter key on a smartphone will always make a beep. This cannot be overruled.

5250 - Menu - Scroll

Either the arrow keys can scroll the screen, or move the cursor. Use this option to toggle the mode.

5250 - Menu - Keys

  • Page up: Send page up command
  • Page down: Send page down command
  • Delete input: Delete all characters typed in the current screen
  • CLEAR: Send Clear command
  • X-Help: If the terminal is in Help mode, this command will give more details
  • ATTN: Send ATTN command. Your AS/400 session profile may be configured to ignore it
  • SYSREQ: Send SYSREQ command. Your AS/400 session profile may be configured to ignore it
  • Next Field: Move cursor to the next field. It is easier to use the left key marked 'next field'
  • Previous field: Move the cursor to the previous field
  • RESET: Clears the keyboard state. Only useful if in the X-Help mode

5250 - Menu - F1 - F10

Sends keys F1 - F10 to the AS/400

5250 - Menu - F11 - F20

Sends keys F11 - F20 to the AS/400

5250 - Menu - F21 - F24 - f+-

  • F21-F24: Sends keys F21 - F24 to the AS/400
  • INSERT : Toggle the Insert mode. INS is shown in the title
  • FIELD+ : Justify a Field (also called FIELDEXIT)
  • FIELD- : Justify a Field, and make the right field element a negative value.

5250 - Menu - Type text line

Use this dialog to write a text. When Done is selected the text is send to the 5250 screen as normal keyboard data. It is not possible to include function keys in the data stream.
It is possible to store 20 different text strings for later use. The text is stored in the registry for the Phone.

Use Menu - Add to history and Menu - remove from history to work with the data

5250 - Menu - Font

Use this dialog to change the font size.
It can be recommended to use a small font size, and when text must be read press Menu - 0 (zoom) to toggle zoom mode on/off.

5250 - Menu - Disconnect

Close the active connection and return to the connect dialog window.

5250 - Menu - Exit

Close the active session and terminate the 5250 program

5250 - Menu - Zoom

Toggle zoom mode between the largest font and the font defined in menu - fonts

Keyboard overview

Below is a table of keys to press on a phone, to use 5250 function keys
f1 Menu - 31
f2 Menu - 32
f3 Menu - 33
f4 Menu - 34
f5 Menu - 35
f6 Menu - 36
f7 Menu - 37
f8 Menu - 38
f9 Menu - 39
f10 Menu - 30
f11 Menu - 41
f12 Menu - 42
f13 Menu - 43
f14 Menu - 44
f15 Menu - 45
f16 Menu - 46
f17 Menu - 47
f18 Menu - 48
f19 Menu - 49
f20 Menu - 40
f21 Menu - 51
f22 Menu - 52
f23 Menu - 53
f24 Menu - 54
INSERT Menu - 55
FIELD+ Menu - 56
FIELD- Menu - 57
Pageup Menu - 21
PageDown Menu - 22
Delete inputMenu - 23
CLEAR Menu - 24
X-HELP Menu - 25
ATTN Menu - 26
SYSREQ Menu - 27
NEXT FIELDMenu - 28
PREVIOUS FIELD Menu - 29
RESET Menu - 20

Configuration and registry

The configuration is stored on the Phone in the registry at element
HKEY_CURRENT_USER/Software/MochaSoft/TN5250

License

End-User License Agreement for Mocha TN5250 for Windows Mobile Copyright (c) 2007 MochaSoft Aps

Please read the following terms and conditions before using this software. If there is any questions, do not hesitate to contact MochaSoft

EVALUATION PERIOD. You may use an evaluation copy of the Software for 30 days in order to determine whether to purchase the Software.

SINGLE USER LICENSE. One user may install the software on one or more computers, but only one computer must run the software at a time.

COMPANY LICENSES. You may make, install, and use additional copies of this Software on any number of computers, as long as the users belong to a single company in a single country. If there are branch offices or home workstations, a single company license will be valid.

PROHIBITIONS. This Software is licensed to you and/or a company. You are not obtaining title to the Software or any copyrights. You may not sublicense, rent, lease, convey, modify, translate, convert to another programming language, decompile, or disassemble the Software for any purpose. Permission must be obtained before mirroring or redistributing the evaluation copies of the Software.

LIMITED WARRANTY. THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD 'AS IS' AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. Because of the various hardware and software environments into which Mocha TN5250 may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.

Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.

GOVERNING LAW. This agreement shall be governed by the laws in Denmark.

MochaSoft Aps, Denmark

Support

You can contact Mochasoft technical support via e-mail at [email protected]

Please remember to add full product name and version number, as we sell many different products.

MochaSoft will try to respond to any question within 24 hours, but mail send outside our normal business hours may take a little longer. We are open Monday - Friday 10 - 16, time zone GMT+1

It can be recommended always to use the latest version, which can be downloaded from

FAQ

The MochaSoft FAQ (Frequently Asked Questions) can be found on our web site at:

How to buy

Mocha 5250 Emulator

For the latest information on how to order, please visit:

MochaSoft can offer 2 types of license:

  • Single User license, 25 USD
  • Company license, 250 USD

Mocha As400

A company license can be used by a single company. If there are branch offices or home workstations, a single company license will be valid. For a multi-national company, we must ask for a company license for each country.

Mocha 5250 Free Download

With a company license it is possible to install the product on an unlimited number of work-stations. Adobe animate lottie.

A single user license allow one user to use the product.

Unlimited free product updates. A license key is valid for any future release of the product.

As soon as your credit card has been processed and approved (takes less than a minute) , the license name/ registration number can be printed from the screen, and you will also receive an e-mail with your registration number which will remove the 30 day demo limit.