*************************************** * Mocha ActiveX TN3270 version 1.7 * * Copyright (C) MochaSoft * * All Rights Reserved * *************************************** This is the README.TXT file for Mocha ActiveX TN3270 Mocha ActiveX TN3270 is a Windows 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. 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 *** - 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) SSL : Use SSL/TLS layer from Windows OS for the session 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 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 , keep_alive : 1 -> connect - advanced - keep alive 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 (****) 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 <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 # # <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. version 1.1 010918 - new thread model. Could prevent some IE crash version 1.2 011012 - keypad / and * did not work - If using a Microsoft IIS Server (Web server) it is possible to configure it not to make IE 5.5/6.x not to cache files. It created problems for our EBCDIC and keyboard layout files. IE removed these just after download! This version copy the files to a non cache area. version 1.3 020724 - solved problem with temporary directory and NT 4. First tn3270 will use environment variable TEMP value for temporary directory. If this also fails, tn3270 will try to save the keyboard and EBCDIC files in system folder\TEMP. If TEMP does not exist it will be created. If this fails, an error message will be displayed version 1.4 040102 - fixed problem with many tn3270 windows in a single IE browser. - User Temp directory is used as storage for temporary files version 1.4 040727 - updated the Verisign certificate version 1.5 110811 - updated code to mocha w32 tn3270 v 7.1 level (fixed bugs) version 1.6 110818 - problem with file version number in 1.5 version 1.6.1 131028 - signed with an updated certificate version 1.7 26 may 2015 - added SSL/TLS - new help system *** 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