Index of /topics/it-us/tn3270
*************************************
* Mocha ActiveX TN3270 version 1.0 *
* Copyright (C) MochaSoft *
* All Rights Reserved *
*************************************
This is the README.TXT file for Mocha ActiveX TN3270
Mocha ActiveX TN3270 is a Windows 98/2000/NT application. It makes it
possible to connect to an IBM host via TCP/IP with the TN3270 protocol
and emulate a 3270 Information Display System
Mocha ActiveX TN3270 should be installed on a web server and downloaded
to a workstation running Internet Explorer 4.0 or better.
Some combinations of old IE 4.0 and Windows DLL files can give problems.
We must recommend the latest version of IE from Microsoft.
Mocha ActiveX TN3270 cannot run on in a Netscape Browser environment.
It is a cost effective solution, as it is not necessary to
install anything on the workstations. Compared to a Java applet solution
this product offer a better user interface, but it is restricted to only
run on Windows workstations.
*** Order ***
Visit www.mochasoft.dk for latest information. You can order with
a credit card or a check.
Site License : 350 USD
With a Site license this program can run (be download to) on any number
of workstations as long as the IBM host(s), and the Web Server from
where Mocha ActiveX TN3270 is downloaded from, are part of a single
company. A workstation does not have to be part of the given company.
Check also files license.txt and register.txt
*** Limitations ***
- Only support for Internet Explorer 4.0 or better. No support
for the Netscape browser.
Some combinations of old IE 4.0 and Windows DLL files can give
problems. We must recommend the latest version of IE from Microsoft.
It is possible to use IE 3.0 , but we cannot give support for this
platform version.
- The program is not designed to be used as a component in a non
Internet Explorer environment.
*** Installation ***
- unpack files with a zip utility, into a directory on the
web server. It is not a requirement the web server should
be an IBM host.
- From a workstation select the TN3270.HTM page
Notice the TN3270.HTM page include a version number after
the MATN3270.CAB statement. If a new version of Mocha ActiveX
TN3270 has to be installed this version number must be changed,
to force Internet Explorer to download a new copy of the program
to the hard disk.
*** How to remove Mocha Active TN3270 from Internet Explorer
- In IE select menu - Tools - Internet Options - General -
"Temporary Internet Files" Settings - View Objects.
Select "Matn3270 Control" and use toolbar option "Delete"
or menu - file - delete.
*** Documentation ***
The documentation has been included in the Window Help
system. Select Help in the menu.
*** Parameters to the ActiveX program in the HTML file ****
See also file TN3270.HTM
localsave : 1 and the user can save configuration to the local
registry on exit. The local registry values will
overrule configuration in WEB page. (**)
0 : User cannot save the configuration
licname : License name (received when you make an order)
lickey : License key
host_name : IP name or address for the IBM host
port : TN3270 port address (default is 23)
autoconnect : 1 -> Make a session to the IBM host when the
program is started
security_connect :
Only the IBM host given in the parameter
host_name can be used
auto_login : 0 -> not used
1 -> use parameter auto_user and auto_password
auto_user : user name
auto_password:
password on the IBM host. Notice there is not much
security using this option!
termtype : Terminal type
0 = IBM-3278-2E (24*80) color display)
1 = IBM-3278-3E (32*80) color display)
keys : Keyboard mapping file (see below (****) for syntax)
ebcdic : EBCDIC mapping file: (see below (***) for syntax)
ebc_us.txt : EBCDIC <-> ASCII table US
ebc_ita.txt : EBCDIC <-> ASCII table Italy
ebc_ger.txt : EBCDIC <-> ASCII table Austria/Germany
ebc_spa.txt : EBCDIC <-> ASCII table Spain
ebc_fr.txt : EBCDIC <-> ASCII table French
ebc_uk.txt : EBCDIC <-> ASCII table United Kingdom
ebc_rus.txt : EBCDIC <-> ASCII table Russian
ebc_fin.txt : EBCDIC <-> ASCII table Finland/Sweden
ebc_ice.txt : EBCDIC <-> ASCII table Iceland
ebc_dk.txt : EBCDIC <-> ASCII table Danish/Norway
ebc_cz.txt : EBCDIC <-> ASCII table Czech
ebc_grk.txt : EBCDIC <-> ASCII table Greek
color_bg : Background color (*)
color_cursor: color cursor(*)
color_select: clipboard area (*)
color_fields: unprotected fieldss background color. Only valid if
parameter "show_unprotected" = 1 (*)
color_red : color red (*)
color_blue : color blue (*)
color_pink : color pink (*)
color_green : color green (*)
color_turquoise: color turquoise (*)
color_yellow: color yellow (*)
color_white : color white (*)
font_weight : 0 -> normal
1 -> bold
font_italic : 0 -> normal
1 -> Italic
fontsize : Font size
font_name : Name of the text font
pfontsize : Printer font size
pfont_weight: 0 -> normal (printer)
1 -> bold
pfont_italic: 0 -> normal (printer)
1 -> Italic
pfont_name : Printer font name
use_cv : 1 -> enable ctrl c and ctrl v as copy/paste
proxy_host : IP address for the proxy server
proxy_enable: 1 -> use proxy protocol
proxy_port : Proxy port
proxy_syntax: Proxy syntax
proxy_socks_enable:
1 -> enable SOCKS protocol
proxy_return: Sequence RETURN key send when in session with proxy server
Is only used if proxy_socks_enable = 0.
blink_cursor: 1 -> Cursor blink
cursortype : 0 -> Half cursor
1 -> Full cursor
2 -> Underscore cursor
cross_cursor: 1 -> Cross hair cursor
typeahead : 1 -> type ahead enabled
negotiate_display:
1 -> debug information for the Telnet protocol is displayed
tablepaste : 1 -> When a newline is reached in a paste operation,
Mocha TN3270 will default continue to copy data
to the next field. If <Tablepaste> option is enabled,
the program will continue to insert data on the next
line, at the same column location where the paste
was started.
bell : 1 -> Makes a beep if illegal input or if the IBM host
application ask TN3270 to use the bell.
swap_del : 1 -> The Numlock Del key swaps between . and ,
If a single IBM Host should be used and it has IP address MYIBM,
a reasonable parameter setting could be:
localsave = 1 (or 0 if you wants to prevent the user from
saving any configuration on the Workstation)
host_name = MYIBM
port = 23
autoconnect = 1
security_connect = 1
(*) a color value is written as a decimal number. Example: To use
RGB value 210,55,17 translate these to hex values
0xd2,37,11 or 0xd23711. In decimal this value is 13776657.
(MS Windows includes a calculator, which can use hex values)
(**)
Notice if localsave is 1, the user can in menu - "Save configuration"
save the configuration in the local users registry:
HKEY_CURRENT_USER\Software\MochaSoft\MATN3270
(***) EBCDIC MAPPING FILE SYNTAX:
An IBM Host uses an EBCDIC codepage. In most cases it should be possible
to select one of the national mapping files included with this product.
It is also possible to customize a mapping file. As our mocha w32 tn3270
product includes a user friendly interface for working with EBCDIC
files it could be an idea to use this product for the task.
The syntax for the EBCDIC files are the same to the two TN3270 products.
The syntax of the file is :
# This is a comment
<ebcdic value> <ascii value>
Example:
# part of a file
40 20
81 a
82 b
83 c
84 d
Remark it is possible to write ASCII value either as a 2 digit hex number
or an ASCII character. In the example a hex value 0x83 from the Host is
translated to ascii character 'c'.
If identical ASCII values are defined for more than one ebcdic character,
the last will be valid, when translating from ASCII to ebcdic.
If as an example ebcdic 0x50 should be translated to an ASCII space it is
important to put the line
0x50 0x20
before
0x40 0x20
Otherwise Users input when pressing the space bar will be wrong. A value
of 0x40 should be expected.
(****) KEYBOARD MAPPING FILE SYNTAX:
All function keys can be customized in the keyboard mapping file.
It is possible to edit the keyboard file with a normal ASCII editor,
as notepad.exe
The syntax of the file is
# is a comment
<keyname> <3270 key>
Possible keyname:
HOME HOME key
END END key
PGUP Page Up key
PGDN Page Down key
ESC ESC key
RETURN RETURN key
ENTER Enter key
CTRL Right Ctrl key
PAUSE Pause key
SCROLL Scroll Lock key
BACKSPACE <-- key
DELETE Del (Delete) key
f1 - f20 function key f1 - f20
F1 - F20 function key f1 - f20 + SHIFT
cf1 - cf20 function key f1 - f20 + CTRL
CF1 - CF20 function key f1 - f20 + SHIFT + CTRL
PLUS Numeric keypad +
MINUS Numeric keypad -
CTRLC Left Ctrl + C
CTRLP Left Ctrl + P
MINUS Numeric keypad -
PLUS Numeric keypad +
MULTIPLY * key on the keypad
HARDCOPY Copy the screen to the printer
SHIFTESC Shift Escape key
Possible 3270 keys:
PF1 - PF24 3270 function keys
PA1 - PA3 3270 function keys
INSERT INSERT key. (is also mapped to pc key Ins)
ERASEF Erase Field
ERASEINPUT Erase all input fields
CLEAR Send CLEAR to IBM Host, and delete the screen
STARTF Goto start of the field
ENDF Goto the end of the field
BTAB Goto previous field
TAB Goto next field
NL Goto first field on next line
RESET Open keyboard (can also be called from edit menu)
ENTER Send ENTER key to IBM Host
ERASEEOF Erase from cursor to end of a field.
DELETENOMOVE Delete character at cursor, and keep the cursor position
LEFTDELETE Character to the left of the cursor is removed
HOME Move to the first field on the screen
SYSREQ Sends Telnet IP command (FF F4). This is not universally supported on all Hosts
ATTN Sends Telnet BREAK command (FF F3). This is not universally supported on all Hosts
REAL+ Normal + key
REAL* Normal * key
REAL/ Normal / key
REAL- Normal - key
HARDCOPY Copy the screen to the printer
Example:
# TN3270 keymap
# f1 = f1 key , F1 = shift F1
# cf1 = f1 + ctrl CF1 = shift f1 + ctrl
#
# <pc - key> <3270 key>
f1 PF1
f2 PF2
f3 PF3
*** Bugs ***
If any bugs are observed, or ideas for improvement of the product,
please to not hesitate to contact support@mochasoft.net
*** Change list ***
version 1.0 010701
First version.
*** List Of Files ***
The Mocha ActiveX TN3270 package consists of the following files.
README.TXT Introductory information
TN3270.HTM HTML example file
MATN3270.CAB ActiveX component in a signed CAB archive
KEYS.TXT Function key mapping (ASCII file)
LICENSE.TXT license agreement/warranty disclaimer
REGISTER.TXT order form
EBC_US.TXT EBCDIC <-> ASCII file US
EBC_ITA.TXT EBCDIC <-> ASCII file Italy
EBC_GER.TXT EBCDIC <-> ASCII file Austria/Germany
EBC_SPA.TXT EBCDIC <-> ASCII file Spain
EBC_FR.TXT EBCDIC <-> ASCII file French
EBC_UK.TXT EBCDIC <-> ASCII file United Kingdom
EBC_RUS.TXT EBCDIC <-> ASCII file Russian
EBC_FIN.TXT EBCDIC <-> ASCII file Finland/Sweden
EBC_ICE.TXT EBCDIC <-> ASCII file Iceland
EBC_DK.TXT EBCDIC <-> ASCII file Danish/Norway
EBC_CZ.TXT EBCDIC <-> ASCII file Czech
EBC_GRK.TXT EBCDIC <-> ASCII file Greek
If you did not receive all these files please contact
support@mochasoft.net, or check www.mochasoft.dk
![[ICO]](/icons/blank.gif){kind=icon}
![[DIR]](/icons/back.gif){kind=icon}
![[TXT]](/icons/text.gif){kind=icon}
![[ ]](/icons/unknown.gif){kind=icon}