                     *************************************
                     *  Mocha ActiveX Telnet version 1.2 *
                     *     Copyright (C) MochaSoft       *
                     *       All Rights Reserved         *
                     *************************************
 
This is the README.TXT  file for Mocha ActiveX Telnet

Mocha ActiveX Telnet is an Windows 95/2000/NT application. It makes it 
possible to connect to a host via TCP/IP with the Telnet or SSH1 
protocol and emulate a VT220 terminal.

Mocha ActiveX Telnet should be installed on a web server and downloaded
to a workstation running Internet Explorer 4.0 or better.
Some combinations of old IE 4.0 and Windows DLL files can give problems.
We must recommend the latest version of IE from Microsoft.
Mocha ActiveX Telnet cannot run on in a Netscape Browser environment.

It is a cost effective solution, as it is not necessary to
install anything on the workstations. Compared to a Java applet solution
this product offer a better user interface, but it is restricted to only 
run on Windows workstations.

SSH1 is a function to log into another computer over a network. 
Mocha ActiveX Telnet supports some of the functionality in SSH1, 
which makes it possible to encrypt User ID, Password and data. 

Mocha ActiveX Telnet does not support redirection of ports and the 
RSA-authenticates. 

RSA-authenticates are used in places where high security is needed. 
With RSA- authenticates the Client can validate it has a session with 
the real UNIX host, and it can prevent Trojan horses (by routing or 
DNS spoofing). As to keep Mocha ActiveX Telnet small and simple to use, 
we have selected not to support this security option. We believe the 
security functionality most users wants, are encrypted passwords and 
user data.

Redirection of ports, means a way to allow other programs, as an example
a mail client , to use the secure session mocha w32 telnet creates to 
the UNIX host.


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

    Company License     : 350 USD

    Check also file register.txt

*** Limitations ***

    - Only support for Internet Explorer 4.0 or better. No support
      for the Netscape browser.
      Some combinations of old IE 4.0 and Windows DLL files can give 
      problems. We must recommend the latest version of IE from Microsoft.
      It is possible to use IE 3.0 , but we cannot give support for this 
      platform version.
    - The program is not designed to be used as a component in a non
      Internet Explorer environment. 

*** Installation ***

    - unpack files with a zip utility, into a directory on the 
      web server.
    - From a workstation select the TELNET.HTM page 
      Notice the telnet.htm page include a version number after
      the MATELNET.CAB statement. If a new version of Mocha ActiveX
      Telnet has to be installed this version number must be changed, 
      to force Internet Explorer to download a new copy of the program 
      to the hard disk.

*** How to remove Mocha Active Telnet from Internet Explorer

    - In IE select menu - Tools - Internet Options - General -
      "Temporary Internet Files" Settings - View Objects.
      Select "Matelnet Control" and use toolbar option "Delete"
      or menu - file - delete.

*** Documentation ***

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

*** Parameters to the ActiveX program in the HTML file ****

    See also telnet.html


      licname     : License name (received when you make an order)
      lickey      : License key
      host_name   : IP name or address for the UNIX host
      port        : Telnet port address (default is 23)
      termtype    : Terminal type (TERM value in UNIX environment)
      keys        : Keyboard mapping file
      localsave   : 1 and the user can save configuration to the local
                    registry on exit. The local registry values will 
                    overrule configuration in WEB page.
                    0 : User cannot save the configuration
      security_connect :
                    Only the UNIX host given in the parameter 
                    host_name can be used
      ssh         : 0 -> no SSH
                    1 -> SSH protocol is used. Port number should be 22
      ssh_encryption :
                    0 -> DES
                    1 -> 3-DES
                    2 -> BLOWFISH
      color_fg    : Foreground color (*) 
      color_bg    : Background color (*)
      color_cursor: Cursor color (*)
      color_bold  : Bold text color (*)
      fontsize    : Font size
      font_weight : 0 -> normal
                    1 -> bold
      font_italic : 0 -> normal
                    1 -> Italic
      term_size   : Terminal width in characters (80 or 128)
      font_name   : Name of the text font
      pfontsize   : Printer font size
      pfont_weight: 0 -> normal (printer)
                    1 -> bold
      pfont_italic: 0 -> normal (printer)
                    1 -> Italic
      pfont_name  : Printer font name
      use_cv      : 1 -> enable ctrl c and ctrl v as copy/paste
      ignore_app  : 1 -> ignore request for application mode from the UNIX host
      autoconnect : 1 -> Make a session to the Unix host when program is started
      
      proxy_host  : IP address for the proxy server
      proxy_enable: 1 -> use proxy protocol
      proxy_port  : Proxy port
      proxy_syntax: Proxy syntax
      proxy_return: Sequence RETURN key send when in session with proxy server
                    Is only used if proxy_socks_enable = 0. 
      proxy_socks_enable:
                    1 -> enable SOCKS protocol
      
      auto_search1: Used in auto login 
      auto_search2: Used in auto login
      auto_response1:
                    Used in auto login
      auto_response2:
                    Used in auto login
      
      myid        : Enq. reply string for the VT220 Terminal

      blink_cursor: 1 -> Cursor blink
      cursortype  : 0 -> Half cursor
                    1 -> Full cursor
                    2 -> Underscore cursor

      local_echo  : 1 -> Use local echo
      host_echo   : 1 -> Use host echo. Host can overrule your local_echo value
      auto_wrap   : 1 -> Use auto wrap
      new_line    : 1 -> LF -> CRLF
      scroll_bar  : 1 -> Display scroll bar
    
  (*) a color value is written as a decimal number. Example: To use
      RGB value 210,55,17 translate these to hex values 
      0xd2,37,11 or 0xd23711. In decimal this value is 13776657.
      (MS Windows includes a calculator which can use hex values)
  
  Notice if localsave is 1, the user can in menu - "Save configuration"
  save the configuration in the local users registry:

    HKEY_CURRENT_USER\Software\MochaSoft\MATELNET

*** keyboard layout ***

PC-Key        VT220-Key                      PC-Key          VT220-Key
-------------------------------      -----------------------------------    
  f1              f1                         crtl f1              PF1          
  f2              f2                         ctrl f2              PF2          
  f3              f3                         ctrl f3              PF3          
  f4              f4                         ctrl f4              PF4          
  f5              f5                         ctrl f5              -
  f6              f6                         ctrl f6              -
  f7              f7                         ctrl f7              -
  f8              f8                         ctrl f8              -
  f9              f9                         ctrl f9              -            
  f10            f10                         ctrl f10             -           
  f11            f11                         ctrl f11             -           
  f12            f12                         ctrl f12             -           
                                                 
 PC-Key         VT220-Key                    PC-Key          VT220-Key
-------------------------------      ------------------------------------    
  shift f1        f11                        crtl shift f1        -            
  shift f2        f12                        ctrl shift f2        -            

  shift f3        f13                        ctrl shift f3        -            
  shift f4        f14                        ctrl shift f4        -            
  shift f5        f15                        ctrl shift f5        -            
  shift f6        f16                        ctrl shift f6        -            
  shift f7        f17                        ctrl shift f7        -            
  shift f8        f18                        ctrl shift f8        -            
  shift f9        f19                        ctrl shift f9        -            

  shift f10       f20                        ctrl shift f10       -           
  shift f11       f11                        ctrl shift f11       -           
  shift f12       f12                        ctrl shift f12       -           
                                         
                                                 

Editing keys:

PC-Key     VT220-Key   

---------------------------------------- 

HOME        FIND
END         SELECT
PAGE UP     PREV SCREEN
PAGE DOWN   NEXT SCREEN
INSERT      INSERT HERE
DELETE      REMOVE


*** 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 010611

  First version.

version 1.1 010918
   - new thread model. Could prevent some IE crash

version 1.2 020419
   - solved problem with ALTgr key

*** List Of Files ***

The Mocha ActiveX Telnet package consists of the following files.

    README.TXT          Introductory information
    MATELNET.CAB        ActiveX component in a signed CAB archive
    KEYS.TXT            Function key mapping (ASCII file)
    LICENSE.TXT         license agreement/warranty disclaimer
    REGISTER.TXT        order form


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