Mocha TN5250 user guide


Mocha TN5250, for Windows Mobile powered Phone/PDA with 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 can not 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:Give an error, if FIELD+ or FIELD- 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.
  • Landscape to the right:When tapping the landscape icon in the menu bar, the screen can turn 90 or 270 degrees.
  • Full Screen display: Use this option to toggle the title bar


Scroll and Zoom

   Next to the Menu is a set of icons:
  • N: Move cursor to the Next field
  • E: ENTER key
  • Landscape: Swap between portrait and landscape mode
  • Zoom: Swap between the font size selected in menu - font and the largest possible font size
  • Scroll: If enabled , moving the pen at the screen , will scroll the 5250 terminal
  • State: State for the 5250 terminal.

    • X: WAIT , wait on a response from the AS/400
    • E: ERROR , is displayed if typing in a protected field, or the field type is limited, such as numeric only
    • H: HELP , is displayed if the terminal is in Help mode. Either use menu - keys - X-HELP to get more information, or menu - keys - RESET to ignore the state. The Help option can be disabled in menu - settings - Use X-Help


Hotspots

   If the terminal is not in scroll mode, it is possible to click grey F1-F24 for function keys F1 - F24 and URL fields to load the default Web browser on the phone.


5250 - Menu - Keys

  
  • 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.
  • PGUP: Send page up command
  • PGDOWN: 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 tap icon N in the menu bar
  • PREVIOUS FIELD: Move the cursor to the previous field
  • RESET: Clears the keyboard state. Only useful if in the X-Help mode state.


5250 - Menu - Fxx

   Sends keys F1 - F24 to the AS/400


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 Zoom icon in the menu bar.


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


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.