Mocha TN3270 user guide


Mocha TN3270 for Windows Mobile powered smartphone (phones without a touch screen) provides TN3270 emulation for IBM Mainframe access.

Normal screen mode
Landscape mode


Contents


Connect window

  
  • IBM Mainframe IP Address: Name of the IBM Mainframe. Either a TCP/IP address as 155.22.11.2 or a DNS name.
  • Port number:Port number for the session. As default TN3270 uses port 23 and with SSL port 992
  • SSL: Enable SSL encryption
  • Screen size: This terminal can run in two modes. 24x80 or 32x80. Other sizes are not supported, and there is no such plans, as to the limited screen on a Phone.
TN3270 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

   TN3270 can use 5 different configurations.
Each session can have private data:

  • IBM Mainframe IP Address and port
  • SSL mode
  • Screen size
  • 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 IBM Mainframe.
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 IBM Mainframe

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 IBM Mainframe 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 IBM Mainframe program, which defines the text colors to use in a screen. The IBM Mainframe can as an example, request a red text, and the color red can be configured in this dialog.

Input Field: If menu - settings - show unprotected fields is enabled, the input fields will be shown with this background color.


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 TN3270 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 TN3270 has been terminated.

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


Menu - License

   After ordering Mocha TN3270 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

  
  • Beep on error: Use this to give a silent mode.
  • Hide input box: To make it easier to use a 10 key phone keyboard the input character is shown in upper left corner of the screen. This option can remove the character.
  • Full screen display: Toggle if the title bar should be displayed. The menu bar cannot be removed.
  • Show unprotected fields: Use this option to select if input areas on the screen should be displayed with another color.
  • Numeric field check:: The tn3270 terminal can check if the field is numeric only and give an error if other characters are typed.
  • Send kepp alive: The tn3270 emulator can send keep alive messages at Telnet level.
  • Left menu function: The left menu can either be
    • Next field: jump to next field on the screen
    • Zoom: Toggle between large and small font sizes
    • Scroll/cursor: Either the arrow keys can scroll the screen, or move the cursor.


3270 - Menu - Scroll

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


3270 - Menu - Keys

  
  • Delete input: Delete all characters typed in the current screen
  • CLEAR: Send Clear command
  • Previous field: Move the cursor to the previous field
  • ATTN: Send ATTN command. Your IBM Mainframe session profile may be configured to ignore it
  • SYSREQ: Send SYSREQ command. Your IBM Mainframe session profile may be configured to ignore it
  • Newline: Move cursor to the next line
  • Next Field: Move cursor to the next field. It is easier to use the left key marked "next field"
  • RESET: Clears the keyboard state.
  • ENTER: Send ENTER command to the IBM Mainframe.
  • Show unprotected fields: Use this option to select if input areas on the screen should be displayed with another color.


3270 - Menu - F1 - F10

   Sends keys F1 - F10 to the IBM Mainframe


3270 - Menu - F11 - F20

   Sends keys F11 - F20 to the IBM Mainframe


3270 - Menu - F21 - F24 - PA

  
  • F21-F24: Sends keys F21 - F24 to the IBM Mainframe
  • INSERT : Toggle the Insert mode. INS is shown in the title
  • PA1 : Send PA1 command to the IBM Mainframe
  • PA2 : Send PA2 command to the IBM Mainframe
  • PA3 : Send PA3 command to the IBM Mainframe
  • DUP : Insert a DUP character
  • FM : Insert a field mark character


3270 - Menu - Type text line

   Use this dialog to write a text. When Done is selected the text is send to the 3270 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


3270 - 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.


3270 - Menu - Disconnect

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


3270 - Menu - Exit

Close the active session and terminate the 3270 program


3270 - Menu - Zoom

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


3270 - Menu - Left menu function

   Use this dialog to change the function for the left key
  • Next field: jump to next field on the screen
  • Zoom: Toggle between large and small font sizes
  • Scroll/cursor: Either the arrow keys can scroll the screen, or move the cursor.


Keyboard overview

Below is a table of keys to press on a phone, to use 3270 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
PA1 Menu - 56
PA2 Menu - 57
PA3 Menu - 58
DUP Menu - 59
FM Menu - 50
Delete inputMenu - 21
CLEAR Menu - 22
NEXT FIELDMenu - 27
PREVIOUS FIELD Menu - 23
ATTN Menu - 24
SYSREQ Menu - 25
Newline Menu - 26
RESET Menu - 28
ENTER Menu - 29


Configuration and registry

The configuration is stored on the Phone in the registry at element

  HKEY_CURRENT_USER/Software/MochaSoft/TN3270


License

End-User License Agreement for Mocha TN3270 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 TN3270 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.