MOCHA TN3270 for Android
USER GUIDE
Contents
1.0 Screen
- Tap the screen = put cursor at the position
- Tap 2 times = put cursor at position, and send a 3270 Enter command
- Move finger on the screen = scroll the screen
- 2 finger pinch on the screen = Zoom in/out
- Hold finger down on the screen for 1 second = Enter window mode. Move finger
up/down to move the 3270 window
1.1 Clipboard
From the menu, click select, and the top menu change to Cancel,Copy
and Copy all. Move the finger on the screen to select an area to copy,
and hereafter click Copy. If using a hardware keyboard, shift + arrow can
be used to select an area to copy. Ctrl+c is copy and ctrl+v is paste.
Red status line
- Cursor y,x : is the cursor position.
- X-WAIT : Waiting on IBM mainframe.
- X-ERROR : Typing in protected area
- Numeric only : field is numeric only
- Ins: Insert mode.
1.2 Menu bar
- ABC: Will pop up the normal keyboard.
- KEYS: 3270 keys.
- Zoom: Zoom the screen out.
- Select: Enter clipboard select mode.
- Paste: Paste clipboard data at cursor position.
- Disconnect: Close the connection.
- Barcode scanner: Use the build in camera as a barcode scanner.
- Voice input: Use the OS build in voice to text function
- Full screen: enter full screen mode. Exit full screen mode with the
back key, or a 3 finger tap.
There is not space on the title bar for all menu elements. The hidden elements can
be selected either with a click on the 3 dots icon , or on some devices the "menu"
button.
1.3 Wireless keyboard
- f1 - f12 = f1 - f12
- shift + f1 = f13
- shift + f2 = f14
- shift + f3 = f15
- shift + f4 = f16
- shift + f5 = f17
- shift + f6 = f18
- shift + f7 = f19
- shift + f8 = f20
- shift + f9 = f21
- shift + f10 = f22
- shift + f11 = f23
- shift + f12 = f24
- Insert = Insert
- Delete = Delete character at cursor position
- Shift + Delete = Delete all data in the current field
- Page up = Previous field
- Shift + Page up = FM
- Page down = next field
- Shift + Page down = Dup
- End = Move cursor to the end of a field
- Shift + End = Clear
- Home = Move cursor to the start of a field
- Keypad Enter = 3270 Enter
- Shift + Keypad Enter = Newline
- Return = 3270 Enter
- Shift + Return = Newline
- Tab = Jump to the next field
- shift + Tab = Jump to the previous field
- Esc = Reset
- Left Ctrl = Reset
1.4 Menu - Configure
A list of already configured IBM mainframe sessions is shown. Select + in the titlebar
to create a new configuration.
- IBM server IP Address: Name of the IBM mainframe. Either a TCP/IP address as 155.22.11.2 or a DNS name.
-
Alias Name: Give the session configuration a name, as it is easier to remember
than the IP address. This is only useful if more than one host configuration
will be used.
- Port number:Port number for the session. As default TN3270 uses port 23 and with SSL port 992
- SSL/TLS: Enable SSL encryption. Certificates are not supported. Android OS 4.0 only supports TLS 1.0, new OS types includes TLS 1.2
- 24x80 or 32x80: Type of screen. A TN3270 terminal always start in 24x80 and hereafter the mainframe application can request another size
- TN3270E: Use TN3270E protocol. Allows fixed LU-Name for the session and SYSREQ will work.
- LU name: Only used with TN3270E.
-
User and Password: These are optional. Use these fields to define an user id and a password
for the Sign On screen on the server.
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.
- Send keep alive : If TN3270 should send extra keep alive frames at Telnet protocol level.
- EBCDIC codepage : Must be the same as used on the IBM mainframe.
1.5 Menu - Settings - Network
- Show telnet negotiation: Use it if problems, to view the low level
negotiation
- Keep WIFI online: Tell the OS to keep the network alive, when TN3270
is running
- Stay connected: If TN3270 is send to the background, it can either
close an active session with the IBM mainframe or keep it alive
1.6 Menu - Settings - Terminal
- Key banner speed: How fast the key banner should scroll when swiping
the keys.
- Show 2 key banners: Either display one or 2 key banners at he top
of the screen.
- Key banner: Select which keys should be in the banner and the position.
- Menu: Select which Menu elements should be shown, and the position.
- Fxx keys in portrait mode: On a large screen, use the extra space
between the QWERTY keyboard and telnet window, to display all the VT220 keys.
- Lock screen:: Selected, and the screen will not change orientation,
when in a 3270 session.
- Use full height in portrait: Either the screen can zoom out to use
the full height or width when in portrait. In landscape the height is always
used
- Should TN3270 check numeric fields: Limit input in fields defined
as numeric only
- Using Zxing: Older versions used the Zxing app to read barcodes.
This tn3270 version can use the Android OS for the task.
- Sound up key: Function used when the sound up key is pressed
- Sound down key: Function used when the sound down key is pressed
- Scroll speed:How much a scroll gesture move the screen
- Barcode Enter: Send Enter key value after a barcode scan. Works only if using camera as scanner.
- Barcode next: Jump to next field after a barcode scan. Works only if using camera as scanner.
- Keep Display on:The power saver will not be activated, when a TN3270
session is active
- Confirm close session:A confirm dialog will pop up, if back key is
pressed.
1.7 Menu - Settings - Colors
Text, background and Cursor colors can be changed with this 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.
2.0 Import/Export a configuration
In menu - configure - top menu is an option "export configuration". It can build
an URL, which includes the full configuration for the first server in the list +
all settings values.
This URL can later be used to import the data, either
using a mail client or a web page. You cannot click example below from a
PC browser, only the web browser on an Android device.
Example
A QR code with the URL configuration, can be scanned with the camera,
and imported to TN3270.
A large QR code can give problems to read for some camera
types, therefore try to make the data in the URL as small as possible.
2.1 Using a standard Bluetooth barcode scanner
As default a standard BT barcode scanner is seen as a physical keyboard, and it
will block the screen keyboard. In Android Settings - Language and Input - Physical
keyboard, enable option Show virtual keyboard. This will keep the screen
keyboard on, while a physical keyboard or barcode scanner is active.