************************************ * Mocha Dos TN5250 version 1.4 * * Copyright (C) MochaSoft * * All Rights Reserved * ************************************ This is the README.TXT file for Mocha Dos TN5250 Mocha Dos TN5250 is a DOS application. It makes it possible to connect to an AS/400 Mainframe and emulate a 5250 type terminal This program also contains the TCP/IP stack Mocha W32 TN5250 Features: Supports all standard 5250 emulation features Screen size (24x80 or 27x132) User defined functions keys Device name support 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 TN5250 can be used as a cheap 5250 terminal together with FreeDOS (www.fredos.org), or as a backup environment in a thin client network. Tn5250 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:\tn5250 - Edit file TN5250.INI with a normal ASCII editor. You must define IP : IP Address for this PC , or ignore this line and tn5250 will use DHCP to get an IP address for the PC NETMASK : Netmask for the IP Address (see ip and DHCP) We will also recommend HOST : IP Address for the AS/400. It can also be given as a parameter to program TN5250.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 tn5250.exe Possible parameters: TN5250.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 TN5250.INI CONFIG_FILE : As default the program uses TN5250.INI as configuration file PORT_NUMBER : Host port number. As default 23 is used *** Limitations *** The 5250 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 TN5250 runs on top of a packet driver. Ethernet card ------------------------------- Packet Driver ------------------------------- Mocha Dos TN5250 Before loading the TN5250 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 tn5250 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 5250-Key PC-Key 5250-Key ------------------------------- ----------------------------------- f1 f1 alt f1 Attn f2 f2 alt f2 SysReq f3 f3 alt f3 INSERT f4 f4 alt f4 ERASE INPUT f5 f5 alt f5 DUP f6 f6 alt f6 - f7 f7 alt f7 f11 f8 f8 alt f8 f12 f9 f9 alt f9 f23 f10 f10 alt f10 f24 f11 f11 alt f11 - f12 f12 alt f12 - PC-Key 5250-Key PC-Key 5250-Key ------------------------------- ------------------------------------ shift f1 f13 alt shift f1 HELP shift f2 f14 alt shift f2 CLEAR shift f3 f15 alt shift f3 shift f4 f16 alt shift f4 - shift f5 f17 alt shift f5 - shift f6 f18 alt shift f6 - shift f7 f19 alt shift f7 - shift f8 f20 alt shift f8 LAST shift f9 f21 alt shift f9 BEGIN shift f10 f22 alt shift f10 END shift f11 f23 alt shift f11 REAL- shift f12 f24 alt shift f12 REAL+ PC-Key 5250-Key ---------------------------------------- HOME Record (Home) END End of the field PAGE UP Page Up (Roll Down) PAGE DOWN Page Down (Roll Up) INSERT Insert ESC Reset (open keyboard) RETURN Enter Shift RETURN NewLine Shift ENTER NewLine SHIFT TAB Previous Field TAB Next Field Left CTRL Reset Right CTRL NewLine DEL Delete character at cursor position BACKSPACE Delete character to the left of the cursor Keypad - Field - Keypad + Field Keypad Enter Field Exit ALT H HELP ALT P Hardcopy to Matrix Printer 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.dk. *** Change list *** version 1.0 : Dec 2001 First version. version 1.1 : 020509 - NONDISPLAY text in a screen would give wrong display, and old screen elements could be displayed in the next screen. version 1.2 : 031117 - DHCP support - X-HELP dialog can be ignored with parameter ASK_HELP in the configuration table - removed DOS version check at start up. - listed colors in configuration file tn5250.ini version 1.3 21 September 2006 - a % character in a 5250 screen could give a crash version 1.4 28 September 2006 - Added BLUE color to the tn5250.ini file The Mocha Dos TN5250 package consists of the following files. README.TXT Introductory information TN5250.EXE TN5250 emulator + TCP/IP stack KEYS52.TXT Keyboard mapping file TN5250.INI Configuration file LICENSE.TXT license agreement/warranty disclaimer REGISTER.TXT Order form ebcdic52.map EBCDIC <-> ASCII table US (ASCII file) ebcdic52.ita EBCDIC <-> ASCII table Italy (ASCII file) ebcdic52.ger EBCDIC <-> ASCII table Austria/Germany (ASCII file) ebcdic52.spa EBCDIC <-> ASCII table Spain (ASCII file) ebcdic52.fr EBCDIC <-> ASCII table French (ASCII file) ebcdic52.uk EBCDIC <-> ASCII table United Kingdom (ASCII file) ebcdic52.rus EBCDIC <-> ASCII table Russian (ASCII file) ebcdic52.fin EBCDIC <-> ASCII table Finland/Sweden (ASCII file) ebcdic52.ice EBCDIC <-> ASCII table Iceland (ASCII file) ebcdic52.dk EBCDIC <-> ASCII table Danish/Norway (ASCII file) ebcdic52.cz EBCDIC <-> ASCII table East Europe (**) (ASCII file) ebcdic52.grk EBCDIC <-> ASCII table Greek (ASCII file) ebcdic52.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.dk, or check www.mochasoft.dk