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

The emulator will keep focus on the cursor. This is a good idea with most AS/400 programs


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

Gives details about version and license status


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 support@mochasoft.dk

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

www.mochasoft.dk

FAQ

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

www.mochasoft.dk/faq.htm


How to buy

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

www.mochasoft.dk/buy.htm

MochaSoft can offer 2 types of license:

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.

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

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.