                     ************************************
                     *  Mocha Dos TN5250 version 1.0    *
                     *     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
        NETMASK : Netmask for the IP Address

        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 TCP/IP stack included has some limitations:

      - No support for DHCP. You must define an IP
        address for the PC in TN5250.INI

    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.net.

*** Change list ***

version 1.0 : Dec 2001

  First version.


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.net, or check www.mochasoft.dk
