************************************ * Mocha Dos TN3270 version 1.1 * * Copyright (C) MochaSoft * * All Rights Reserved * ************************************ This is the README.TXT file for Mocha Dos TN3270 Mocha Dos TN3270 is a DOS application. It makes it possible to connect to an IBM Mainframe and emulate a 3270 type terminal This program also contains the TCP/IP stack Mocha W32 TN3270 Features: Supports all standard 3270 emulation features Screen size 24x80 User defined functions keys Hardcopy of screen to Matrix Printer on LPT1/LPT2 Free upgrades to new versions of the product Low cost : Single User license 25 USD or 250 USD for a Company License. Mocha Dos TN3270 can be used as a cheap 3270 terminal together with FreeDOS (www.fredos.org), or as a backup environment in a thin client network. Tn3270 together with DOS, can easily be installed on a single Floppy or downloaded to a disk less PC. *** Order *** Visit www.mochasoft.dk for latest information or see file REGISTER.TXT *** Installation *** - unpack files with a zip utility, into an empty directory. As an example c:\tn3270 - Edit file TN3270.INI with a normal ASCII editor. If DHCP is not used, you must define IP : IP Address for this PC NETMASK : Netmask for the IP Address We will also recommend HOST : IP Address for the IBM Mainframe. It can also be defined as a parameter to program TN3270.EXE - As default the configuration is for a US EBCDIC codepage and a MS-DOS ASCII 837 codepage on the PC. The program include a set of other codepages. The MS-DOS 850 codepage is normally used in Europe. - Start a packet driver for the Ethernet card. See section packet driver. - run tn3270.exe Possible parameters: TN3270.EXE IP_ADDRESS [CONFIG_FILE | PORT_NUMBER] IP_ADDRESS : can be of format 152.1.1.1 or a DNS name, if DNS is defined in TN3270.INI CONFIG_FILE : As default the program uses TN3270.INI as configuration file PORT_NUMBER : Host port number. As default 23 is used *** Limitations *** The TCP/IP stack included has some limitations: The 3270 emulator has following limitations: - Only support for 24*80 screen mode - Underscore is not supported System: - Minimum 486 25 MHZ - Dos 5.0 or later or FreeDOS version 7.0 (www.freedos.org). Notice FreeDOS can have some problems with keys F11 and F12. - Cannot run at a MS-DOS prompt in Windows - VGA For other hw/sw configurations, we cannot promise a good result, but give it a try!. *** Packet Driver *** Mocha Dos TN3270 runs on top of a packet driver. Ethernet card ------------------------------- Packet Driver ------------------------------- Mocha Dos TN3270 Before loading the TN3270 program, the packet driver must be installed. See your Ethernet card documentation for details. Also notice the software interrupt vector value must be defined: 126 (0x7e). This vector is used from the tn3270 program to get access to the packet driver. Example: pcipkt 0x7e where pcipkt is the package driver for the Ethernet card. Your packet driver could/will have another name, and the syntax for the 0x7e value could be another. Check your Ethernet card documentation. *** Keyboard Configuration *** The keyboard configuration is in file keys52.map. It can be edited with a normal ASCII Editor. The Default layout: PC-Key 3270-Key PC-Key 3270-Key ------------------------------- ----------------------------------- f1 f1 alt f1 PA1 f2 f2 alt f2 PA2 f3 f3 alt f3 PA3 f4 f4 alt f4 HOME f5 f5 alt f5 INSERT f6 f6 alt f6 ERASE FIELD f7 f7 alt f7 ERASE INPUT f8 f8 alt f8 CLEAR f9 f9 alt f9 ATTN f10 f10 alt f10 SYSREQ f11 f11 alt f11 - f12 f12 alt f12 - PC-Key 3270-Key PC-Key 3270-Key ------------------------------- ------------------------------------ shift f1 f13 alt shift f1 DUP shift f2 f14 alt shift f2 FM shift f3 f15 alt shift f3 NL shift f4 f16 alt shift f4 - shift f5 f17 alt shift f5 - shift f6 f18 alt shift f6 - shift f7 f19 alt shift f7 F11 shift f8 f20 alt shift f8 F12 shift f9 f21 alt shift f9 F23 shift f10 f22 alt shift f10 F24 shift f11 f23 alt shift f11 shift f12 f24 alt shift f12 PC-Key 3270-Key ---------------------------------------- HOME Start of Field END Erase to end of field PAGE UP Previous Field PAGE DOWN Next Field INSERT Insert ESC Reset (open keyboard) RETURN Enter SHIFT TAB Previous Field TAB Next Field Left CTRL Reset Right CTRL Enter DEL Delete character at cursor position BACKSPACE Delete character to the left of the cursor Keypad Enter New Line (NL) ALT P Hardcopy to Matrix Printer ALT C Clear Notice F11 and F12 may not work correct with FreeDOS *** 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 : Dec 2001 First version. version 1.1 Jan. 2004 - added DHCP - a % character on the screen could give a program crash The Mocha Dos TN3270 package consists of the following files. README.TXT Introductory information TN3270.EXE TN3270 emulator + TCP/IP stack TNKEYS.MAP Keyboard mapping file TN3270.INI Configuration file LICENSE.TXT license agreement/warranty disclaimer REGISTER.TXT Order form ebcdic32.map EBCDIC <-> ASCII table US (ASCII file) ebcdic32.ita EBCDIC <-> ASCII table Italy (ASCII file) ebcdic32.ger EBCDIC <-> ASCII table Austria/Germany (ASCII file) ebcdic32.spa EBCDIC <-> ASCII table Spain (ASCII file) ebcdic32.fr EBCDIC <-> ASCII table French (ASCII file) ebcdic32.uk EBCDIC <-> ASCII table United Kingdom (ASCII file) ebcdic32.rus EBCDIC <-> ASCII table Russian (ASCII file) ebcdic32.fin EBCDIC <-> ASCII table Finland/Sweden (ASCII file) ebcdic32.ice EBCDIC <-> ASCII table Iceland (ASCII file) ebcdic32.dk EBCDIC <-> ASCII table Danish/Norway (ASCII file) ebcdic32.cz EBCDIC <-> ASCII table East Europe (**) (ASCII file) ebcdic32.grk EBCDIC <-> ASCII table Greek (ASCII file) ebcdic32.tur EBCDIC <-> ASCII table Turkish (ASCII file) ANSI_850.TXT ANSI <-> MSDOS 850 Codepage mapping (Latin 1) ANSI_437.TXT ANSI <-> MSDOS 850 Codepage mapping (US) If you did not receive all these files please contact support@mochasoft.net, or check www.mochasoft.dk