                     ************************************
                     *  Mocha W32 TN5250 version 4.03   *
                     *     Copyright (C) MochaSoft      *
                     *       All Rights Reserved        *
                     ************************************
 
This is the README.TXT  file for Mocha W32 TN5250

Mocha W32 TN5250 is an Windows 95/NT application. It makes it 
possible to connect to an IBM host via TCP/IP with the TN5250 protocol
and emulate a 5250 Information Display System

*** Order ***
    
    Visit www.mochasoft.dk for latest information. You can order with
    Credit card or check/postal money order.

*** Installation ***

    - unpack files with a zip utility, into a temporary directory.
    - load program setup.exe and follow instructions.

    Remark it is possible to pre-install parameters in config52.txt.

    If setup.exe is started with parameter /SILENT the installation
    will be without user interaction

    If problems with the installation, copy all files to a new
    directory and rename setup.exe to mtn5250.exe. Start Mocha W32
    TN5250 with loading mtn5250.exe.

*** Uninstallation ***

    Use Windows tool "Add/Remove Programs" in the Control Panel. Select
    Mocha W32 TN5250 and click Add/Remove.

*** Documentation ***

    The documentation has been included in the Window Help
    system. Select Help in the menu.

*** Bugs ***

  If any bugs are observed, or ideas for improvement of the product,
  please to not hesitate to contact frydendal@mochasoft.dk.

*** Change list ***

version 1.0 : 970909

  First version.

....

Version 1.7.5 980811
  - If field+ was pressed in a NON numeric field, it would report 
    X_WRONG INPUT, if the field included a - character
  - Added time stamps to trace file
  - Reset key will also turn Insert mode off
  - Included a delay (500 ms) in typeahead, as the AS400 will sometimes split
    screen data in 2 data frames. If typeahead data were inserted
    into fields in the first frame, which would be overwritten 
    in the second data frame, typeahead data would be lost.
  - Possible to define Backspace key as left arrow. 

Version 1.7.6
  - typeahead delay timer (from 1.7.5) has been removed
  - keyboard was opened if a SF command was received. Could give
    problems in some typeahead situations.


Version 1.7.7 980910
  - menu - edit - reset terminal did not reset pre-help state
  - frame copied to the clipboard had always CRLF appended.
  - Insert Cursor order was ignored in a multi WTD packed from the as400
  - Backspace as left arrow, would not jump to previous field if at 
    the first position of a field.
  - Default green text has been changed to a brighter color

Version 1.7.8 980929
  - A Write Error code command from the AS400, could overwrite elements in
    the field table, which as a result would change fields at 
    the error line (default line 23) to bypass fields

Version 1.7.9 981030
  - If only Field-exit is used for a right adjust blank fill field, 
    the Read MDT command would return only SBA row column. Some AS400 
    programs needs blanks to work correct.

Version 2.0 981121
  - Shows underscore "," without underscore. This will make it easier
    to see the difference between "." and ","
  - Leftdelete (backspace) at a multi-line field, has been corrected
  - Better syntax check of keyboard mapping file
  - A field defined as AUTOENTER + FIELDEXIT REQUIRED will now
    ignore the autoenter request 
  - New compiler and MFC from Microsoft (c++ 6.0)
  - At installation the directory c:\mochasoft was created even if
    a different directory was selected.
  - Better language selection in dialog "mapping files"
  - More space between underscores and characters on the screen
  - New option in menu - settings - keyboard layout. Now it is 
    possible to enable field exit required check.
  - New functions keys:
       Shift ENTER  : Newline
       Shift RETURN : Newline
       CTRLP        : Hardcopy of the screen
 
    These keys can be remapped in menu - settings - keyboard Layout
  - New functions: Record (menu settings - record)
                   Play script (ALT 0 - 9)
    These functions makes it possible to record a sequence of 
    keyboard data to a file (mtn5250.x , where x is between 0 - 9). With
    keys ALT 0 - 9 an earlier recorded script can be played.
  - New function : menu - edit - table format. Possible to paste
    data from the clipboard in a table format.
  - Double-clicks of the left mouse button gives ENTER
  - New option in connect dialog: Auto reconnect and Exit on session
    termination.
  - Possible to pre-install configuration in config52.txt file

version 2.1 990113
  - Correct error in ebcdic52.fin
  - An insert cursor command from the AS/400 would
    open the keyboard. It could give problems in a 
    typeahead situation

version 2.2 990113
  - Problem in version 2.1 with Insert cursor, created a new problem
    with the cursor position.
  - DUP will now also move cursor to the next field

version 2.3 990201
  - A wrong WTD from the AS/400 when in prehelp error mode (X_HELP)
    will not delete the error message
  - Possible to use ATTN and SYSREQ if keyboard is locked

version 2.4 990202
  - An unlucky combination of WTD commands from
    the as/400 could move the cursor to the
    first field on the screen, and not the requested cursor position

version 2.5 990208
  - A "Cancel Invite" at RFC 1205 level, would lock the keyboard,
    and a later WSF command could therefore get a wrong cursor
    position. 

version 2.5.1 990208
  - Clear format table did not lock the keyboard. Some special 
    as/400 applications as telnet would have a wrong cursor position

version 2.5.2 990210
  - Another cursor problem was created in version 2.3. It has been
    corrected in this version.
  - Included support for EBCDIC table from Iceland

version 2.5.3 990215
  - a WTD command from the AS/400 with characters below 0x1f,
    which should not be send, if the AS/400 program follows the
    AS/400 manual SA21-9247-6, can result in a wrong display !.

Version 2.5.4 - 2.5.6
  - Cursor problems 


Version 3.0
  - New Design of Connect dialog. 
  - Added Confirm Exit option 
  - New font dialog box. Now the screen and fonts can be controlled
    with a change of the terminal window size.
  - Better screen display with full use of the screen.
  - Full screen mode will survive between program loads
  - New function keys:

      key         mapped as default:
    =================================
      TAB         NEXT     (field)
      SHIFTTAB    PREVIOUS (field)
      MULTIPLY    REAL*    (only for keypad *) 
      DIVIDE      REAL/    (only for keypad /)

  - New function in menu Edit: Select all : Copy screen to clipboard
  - Setup.exe will test if a keyboard file exist, and give a warning
  - SysReq command can accept user data
  - Column separator is copied to the clipboard as a space.
  - Possible to select different cursor types (including Crosshair)
  - Security Warning if program is started in log mode.
  - RESET key will clear the typeahead buffer.
  - Problem with cursor position has been solved
  - Moved option "Show Negotiation" to Log Traffic dialog box.
  - Back TAB in a field moves cursor to the first position of
    the field. Back TAB at the first position of a field moves
    the cursor to the previous field on the screen.
  - Right mouse has been changed to a context menu, making it 
    easier to use the clipboard.
  - Better handling of record/play scripts. Possible to select
    scripts from right mouse click menu
  - New feature. Possible to configure the toolbar buttons.
  - If setup.exe is started with parameter /SILENT, there will
    be no user dialog in the installation process.
  - If a screen is send as an attached file (e-mail), it 
    will be named as400.txt.
  - At first use of parameter /C2-9 , the configuration will be
    copied from the default registry /C1 configuration.
  - New option in menu - settings- printer. It is now possible
    to ignore the print selection dialog.

Version 3.0.2 990406
  - Cursor bug. Move Cursor order was ignored if also an Insert
    cursor order in a 5250 screen.

Version 3.0.3 990407
  - Correction in version 3.0.2 would change the IC position, and
    as a result the cursor position would be wrong at a HOME key
    action.

Version 3.0.4 990408
  - Large default fonts in win-95 would result in  
    4 pixels of all buttons in the toolbar were missing.

Version 3.0.5 990415
  - Field-exit function would add spaces on a non fill field

Version 3.0.6 990416
  - Copy to clipboard of fields of type column separator would
    give a blank character field
  - If typeahead is used and RESET is pressed the keyboard
    buffer could loop, giving a repeat of old input
  - Around 35 shifts between 24*80 and 27*132 mode could result
    in a hanging application.
  - Using a large icon font would not result in large buttons on the
    toolbar
  - Change of text on first button on the toolbar could result in
    very small buttons.
  - Cursor would not always be shown after focus was given to the
    program

Version 3.0.7 990422
  - Field+ key in an empty right adjust zero fill field, should display
    a field with zero characters
  - A 5250 screen without any input fields, would not always put the
    cursor at position 1,1.
  - Status of toolbar and status bar was not saved between program
    sessions.
  - If Fixedsys font is selected in a small window, characters
    could be clipped. This problem would only be seen with font types
    where it is not possible to select a very small character size.

Verion 3.0.8 990430
  - Added Russian EBCDIC table
  - Better use of the screen in 600*800 mode

Version 3.1 990513
  - Support for different language scripts for the specified terminal or
    printer font
  - Faster screen update

version 3.2 990515
  - Support for long host names in the connect dialog box
  - Cross-hair cursor would not look correct on all screen sizes

Version 3.3 990730
  - If a Write error code from the AS/400 (help text) did not 
    start with an error code number, TN5250 would return a not so
    correct response, and the AS/400 would display a standard 
    help text.
  - Added Czech EBCDIC table 
  - Copy to clipboard for fields of type separator, was not correct.
  - On a 800*600 screen part of characters in position 80 could be
    missing. As a 800 width screen gives space for 79.5 characters
    the program must now select a smaller font. As this can give problems
    reading the text on old hardware,
    a new menu option (menu - view - ignore border) has been
    added for the customers who prefer a 79.5 character screen with
    large characters.

Version 3.4 990903
  - Seen an AS/400 application overwriting a field with FF. The
    FF should be ignored for some unknown reason. 
  - Some primitive ISDN routers will terminate a running
    telnet session. In connect -advanced, it is now possible
    to select a keep-alive option.

Version 3.5 991015
  - Early Windows-95-A versions had a bug in the toolbar handling. 
    (cannot handle text only buttons)
    This version of tn5250 has a workaround to this problem
  - Pen input only fields with  "Mandatory enter" type could not be used. 
    In this version the Mandatory request will be ignored for pen 
    input fields.
  - An AUTOENTER field with FIELDEXIT required option would ignore the 
    AUTOENTER request. The user had to press ENTER to continue.

Version 4.0 991118
  - Possible to start local windows-95 programs from the AS/400. To 
    start the notepad editor from the AS/400 command line:

      STRPCO
      STRPCCMD PCCMD('notepad mytest')

  - Selection of screen for Copy to clipboard could give a crash!
  - New parameter to the program

     /D device-name                

  - More fonts to choose from. See http://www.mochasoft.dk FAQ
    for an URL to the Andale Mono font.
  - New EBCDIC table : Greek
  - Possible to define function keys as comma and period. As an example
    define keypad * as a comma key.
  - On a NT the program will make the shortcut to the common program
    group
  - Possible to define 3 different shortcut's in the config52.txt file,
    which is used to customize the installation.
  - Auto login function in menu - settings. Possible to save
    an AS/400 user/password name (without much security!)

Version 4.01 991215
  - Increased the size for a PCCMD

Version 4.02 000112
  - A Repeat to address order, removing a field of numeric type
    could give a screen lock. (not very common!)
  - Bug in the German EBCDIC table for character @

Version 4.03 000125
  - Bug with transparent data (0x10 order). Not a very common order
    to use in AS/400 applications.

The Mocha W32 TN5250 package consists of the following files.

    README.TXT          Introductory information
    config52.txt        Default installation parameters (ASCII file)
    setup.exe           Installation program (*)
    mtn5250.hlp         Help file
    mtn5250.cnt         Index to help file
    tn52keys.map        Function key mapping (ASCII file)
    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 Czech (ASCII file)
    ebcdic52.grk        EBCDIC <-> ASCII table Greek (ASCII file)
    LICENSE.TXT         license agreement/warranty disclaimer
    REGISTER.TXT        order form
    FILE_ID.DIZ         brief description for bulletin boards

    (*) setup.exe will be renamed to
         
          mtn5250.exe : Mocha W32 TN5250 application
          mtn5250uninstall.exe : uninstallation program

    If you did not receive all these files please contact 
    frydendal@mochasoft.dk, or check www.mochasoft.dk
