                     ************************************
                     *  Mocha W32 TN5250 version 1.7.6  *
                     *     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 catalog.
    - load program setup.exe and follow instructions.

    If problems with the installation, copy all files to a new
    catalog 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 BETA:

  First version.

version 1.1 971015
 
  - Possible to configure following extra keys:
     Key           Default
     ========================
     right ctrl  : Enter key
     scroll lock : CLEAR
     Pause       : Reset
     Backspace   : Moves cursor 1 left and delete character
     Del         : Delete character at cursor position

  - Corrected bug for field exit and right adjust.
  - Correxted bug for Dup key
  - Corrected bug for CLear Unit All command
  - Uninstalltion did not remove shotcut 
  - Possible to use CTRL C and V to COPY and PASTE text
  - Possible to start in security/restricted mode (parameters S1 and R1)
  - Possible to abort a hanging connection with left mouse key

version 1.2  971021

  - added EBCDIC - ASCII mapping file for Italy
  - fixed problem with a field starting in position 1,1

version 1.3 971023

  - A screen without cursor position commands, would not always
    define the cursor to the first input field on the screen.
  - A field cleared with FIELDEXIT was not reported to the host
  - Start Field marks overwritten with a normal character must be
    ignored. Seen for AS400 in System-36 mode.
  - Insert mode did not move cursor 1 position right.

version 1.3.1 971027

  - possible to overwrite a field with Order Repeat to Address

version 1.3.2 971029

  - problem with save/restore function. Last field on a screen
    was not saved. 
  - SOH did not clear the format table.
  - key TAB at a screen without fields 

version 1.3.3 971105
  - added typeahead option in the menu Settings
  - added Austria/Germany Ebcdic table

version 1.3.4 971106
  - added support for /N name as parameter. "name" will be displayed
    at first position of the Title bar
  - Added keys:
      ctrl f9 : BEGIN : goto start of a field
      ctrl f10 : END  : goto last position of a field
  - Reset key will work in Prehelp Error State. (solved in 1.3.3)

version 1.3.5 971110
  - added key:

    ctrl f8 : LAST : goto postition after last character in a field.

version 1.3.6 971113
  - added new fucntion keys:
    LEFT CTRL + ENTER  (id is CENTER in tn52keys.map)
    LEFT CTRL + RETURN (id is CRETURN in tn52keys.map)
  - added new function:  NEWLINE
    As default : Left ctrl + enter  = NEWLINE
                 Left ctrl + return = NEWLINE
  - ATTN and SYSREQ keys did not display correct ID in status line.

version 1.3.7 971114
  - Sometimes the screen would be filled with ?, when
    a connection to the host was created.

version 1.3.8 971117
  - Could not exit a screen with a field of type Mandatory + Bypass

version 1.3.9
  - added spanish ebcdic table
  - if the host sends a signed field with MDT on and the field
    ends on non 0x0, the emulator
    would translate the field to a negative number. Some applications
    could send fields ending with charater '+'.
  - problem with save/restore screen functions.

version 1.4 971121
  - added menu: settings EBCDIC Translation
  - added menu: settings Keyboard layout
  - added menu: settings Bell on/off
  - added menu: settings Cursor Blinking on/off
  - faster cursor blinking frequent
  - on a 640*480 screen 1/2 character was missing
  - MDT bit was always on at right adjust fields 

version 1.4.1 971125
  - Empty Right adjusted fields were send to the host, as fields
    of spaces.
  - Handling of error line not correct
  - Hiden fields could be viewed in invers mode

version 1.4.2 971126
  - Possible to use normal +- in a Numeric only field.
  - A numeric only Right adjust field, returns full size of the field

version 1.4.3 971127
  - added cursor position in the status line
  - possible to configurate font size for screen mode 24*80 and 27*132
  - if cursor at a non field and TAB was pressed, the cursor would jump
    to first field on the screen. Now it jumps to next field on the screen.

version 1.4.4 971128
  - The cc operation in read commands from the host was executed before
    the user had pressed the key. In some applications the keyboard would
    therefore enter a wrong state (LOCK).

version 1.4.5 971129
  - A save/restore screen operation with different screen sizes could
    result in a crash. Save/restore is normal used when selecting help
    screens or pressing SYSREQ/ATTN
  - Added new functionality: If LEFT CTRL key is pressed together with 
    an arrow key, the cursor will move 3 places instead of one.
  - /S1 option will disable more elements in the settings menu

version 1.4.6 971210
  - /S1 option will disable log traffic, as to security reasons

versison 1.4.7 971212
  - possible to delete data at bypass fields. 
  - TAB could jump to a bypass field

version 1.4.8 971224
  - If blinking cursor or blink fields on the screen, there could be
    some flicker as the screen was updated
  - A underscore in position 80, would not always be deleted.
  - Better handling of screens containing double bytes.
  - Handling of undocumented order 0x1f

version 1.4.9 980128
  - not possible to ignore mandatory fields with Fx keys
  - added Danish/Norway ebcdic table
  - added Menu short-cut keys  

version 1.5.0 980129
  - added support for non legal character 0x1f in write commands!

version 1.5.1 980130
  - Auto-enter fields did not work correct.

version 1.5.2 980206
  - setup installs German ebcdic table 
  - field separator can be configurated in the ebcdic mapping file. (element 1)
    Use menu settings - ebcdic translation, to define the character.
  - A screen restore command without any fields, did not reset the current
    field table list. The result was unexpected fields on the screen.
  - Possible to remap LEFT CTRL. As default it is defined as RESET. This
    key will only work if ctrl-c/ctrl-v option in menu edit is deactivated.

version  1.5.3 980227
  - added Finland/Sweden/French ebcdic tables
  - better support for full screen mode
  - now possible to delete -+ in a number field
  - wrong delete of last character in a field, when Field-exit or
    Field+/- were pressed
  - wrong jump to next field when typing last character in a 
    numeric only field. 

Version 1.5.4 980307
  - added new functions: REAL+ and REAL-. Can be used to map keypad
    -/+ from default FIELD-/FIELD+ to normal -/+ keys
  - In some situations, the cursor was not placed at first input field
    when a new screen was displayed. Cursor was at position (1,1), and the
    user had to press TAB to continue.

Version 1.5.5 980312
  - cursor at last position of a numeric field, and field+ was pressed,
    would delete the character "under" the cursor.
  - new function key PRINT. Will default be mapped to PC key Print

Version 1.5.6 980313
  - Characters with screen attribute Nondisplay, were shown on a
    paper print (hardcopy of the screen)

Version 1.5.7 980330
  - Mandatory fill fields did require the operator to enter data
  - new browse dialog in installation

Version 1.5.8 980409
  - Copy to clip-board could include nondisplay fields
  - Cursor turns off blink mode when in motion

Version 1.5.9 980416
  - Restore Screen command from host would always open keyboard. The 
    result could be a wrong position of the cursor

Version 1.6.0 980424
  - Problem if AS400 program includes Magnetic Stripe Reader Features


Version 1.6.1 980430
  - If undocumented field control word 0x8280 was included in
    a resequencing field, the read response to the AS400 would be wrong

Version 1.6.2 980504
  - Auto-enter fields did not check if a Read command (42) had been send
    from the as400. As a result data returned to the host could containd SBA
    orders, which some old RPG programs could not accept
  - If on last position of a non Field-exit field or non signed numeric
    field and key field exit was pressed, the character under the cursor would
    not be deleted.

Version 1.6.3 980507
  - Read Input command on a signed field (not negative) was 1 byte short

Version 1.6.4 980508
  - Added UK ebcdic table
  - Return key now sends CRLF if in ASCII mode. (used if manual logging in via
    a proxy server). Also better scroll of screen in ASCII mode

Version 1.6.5 980511
  - Fields with format: Auto Enter and Right Adjust blank fill, 
    did not right adjust if Field-exit key was used.

Version 1.6.6 980520
  - added new option in menu - settings - proxy configuration. It is
    now possible to select the value of return key, when in ASCII mode. This
    option is used at manual login to a proxy server. As default Return
    key sends CR LF. Some proxy servers wants a single LF (\012).

Version 1.6.7 980526
  - better support for handling the situation with cursor at the end
    of a field and field exit/field+- are selected. A new check box
    has been added to dialog box Keyboard layout.
  - new menu option: Settings : Mouse control of cursor. Use this function
    to select if in the case the tn5250 window is inactive, and the left
    mouse key is used, also the cursor position will be changed.
  - Now also shift + an arrow key will move the cursor fast. 
  - Pressing NEWLINE key outside a field, did not move the cursor
    to the next field.
  - new check box in keyboard layout. As defult NumLock "," will send "." 
    This function will not work on all keyboards. 
  - It was possible to use the backspace key  on non input fields

Version 1.6.8 980529
  - As some national keyboards has NumLock key Del defined as "." and other
    "," the check box in keyboard layout (version 1.6.7) will now make
    it possible to swap between "." and ","

version 1.6.9 980618
  - If a mandatory fill field was left with nulls, the program 
    would report invalid input.
  - Fields of type right adjustm were right adjusted if a non fieldexit 
    key was pressed

version 1.7.0 980629
  - The print screen function (hardcopy) did not print the last line 
    of the screen
  - Faster character input when in non INSERT mode.

version 1.7.1 980701
  - Problem with numeric fields and field- key has been solved
  - Possible to pre-install license key into the package. Include
    a file named LIC5250 with the package with following contents:

     name=<company name>
     key=<license key>

     <> should not be included. 

version 1.7.2 980702
  - added new feature: Possible in settings menu to define if a message
    indicator from the AS400 also should sound the alarm.
  - Company name in LIC5250 file (see 1.7.1) could not include space
    characters

Version 1.7.3 980707
  - Support for SOCKS Version 4 protocol. This protocol can be used 
    with a Telnet Proxy Server solution.
  - New feature: Device name support. Possible to add a device name in
    menu - settings - termtype.
  - Changed the sound value of the bell. Now the sound "Exclamation" is used
  - If a Telnet Message light request is received, the "Asterisk" sound
    will be displayed.
  - A select operation with the mouse, would move the cursor to the position
    where the left mouse key was released.
  - A linefeed in the paste buffer will move the cursor to the next field

Version 1.7.4 980710
  - If a Telnet Message light request is received, the "Asterisk" sound
    will always be given. In version 1.7.3 no sound was given if message light
    was already on.
  - If in error state (X-HELP in status line) and a write command was send
    from the host, tn5250 would exit the error state and open the keyboard.

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.

The Mocha W32 TN5250 package consists of the following files.

    README.TXT          Introductory information
    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.fin        EBCDIC <-> ASCII table Finland/Sweden (ASCII file)
    ebcdic52.dk         EBCDIC <-> ASCII table Spain (Danish/Norway)
    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
