The iTunnel component is implemented as an in-process COM component. It provides a basic interface of methods for handling the emulation session.

The iTunnel component will be launched on request from a COM container such as Microsoft Internet Explorer. There will be a single instance of WinCom2000 running to serve multiple iTunnel COM clients. At the same time, the WinCom2000 session can be operated as an ordinary emulation session.

The COM component can be implemented in any language, such as C++, VB, Delphi, C++ Builder, etc.

Such an interface allows for integration into many browser based applications that require 2 way communication between the html page contain data for input to the mainframe. The return data coming from the host is then placed back to appropriate fields on the html page.


HTML Interface

The iTunnel is an in-proc COM component. In order to achieve communication with the emulator, the COM client needs to be instantiated by a container object such as IE or a VB application. The example below uses IE to display an HTML page which uses the iTunnel component to talk to a WinCom2000 session.


  1. StartSession
    This method is used to request iTunnel to establish a host emulation session.
  2. SendText
    This method is used to request iTunnel to send a buffer of data to the host. To send PF keys or other special keys, the COM client just needs to specify the command key value, for example ^0xff` is the enter key.
  3. SendTextXY
    This method is used to request iTunnel to send text at a required screen (x,y) location.
  4. GetTextXY
    This method is used to retrieve the screen data from the emulator.
  5. TerminateSession
    This method is used to request iTunnel to close the connection to the current emulation session.
  6. SetFocus
    This method is used to place focus back onto the emulator.
  7. Wait
    This method is used to wait a certain amount of time before proceeding.
  8. WaitTextXY
    This method is used to poll the emulation session at a specified position to check if a text string matches. It will return the text on a match, otherwise it will retry the wait until it has reached the specified retry count. At the end of the retry count, the text at position X,Y will be returned.


Screen Shots

click image to enlarge 

Copyright © Client Software 2012