Using the IBM Terminal User Control
The Reflection IBM Terminal User Control can be embedded in your Windows applications to provide a terminal screen on a Windows form along with another application or a different data source. This control renders a terminal emulator session within a given windows form application.
Note: When creating applications on a 64-bit machine and using Reflection 2011 "Terminal Controls", make sure the application target is set to "x86" instead of "Any CPU" or "x64". This is required because a 64-bit application does not work directly with 32-bit controls. If the build target (Platform) is not set to "x86", the "COMException: class not registered" error is displayed during runtime.
To set up the IBM terminal User Control
- In the Visual Studio New Project wizard, create a "Windows Form Application."
- If you are using Visual Studio 2005 or 2008, you will need to add the Attachmate Terminal controls to your Toolbox as follows:
- On the Toolbox, right click on the the General tab and then select Choose Items.
- In the Choose Toolbox Items dialog box, select the .NET Framework Components tab, and then type Attachmate in the Filter text box.
- Select the Attachmate Terminal controls and click OK.
- In Form Design view, drag and drop the IbmTerminalControl from the Toolbox to Form1.
Note: The required assemblies are automatically added to the project references after you add the control to the form.
- In Form designer, double-click on Form1. This adds the default Form event handler, which is the Load event. Then add a call to InitInstance. This call initializes the terminal control ibmTerminalControl1, with a new host type or a session file. The following example code creates a new 3270 session file.
private void Form1_Load(object sender, EventArgs e)
- Back in the Form designer, select the ibmTerminalControl1 control you added and then in the Properties view, set the Dock property to Fill. This allows the control to fill the Form. Resizing of the form resizes the contained terminal control at runtime. This is ideal for resizing the Terminal view, but not required.
- Double-click on the ibmTerminalControl1 control. This adds an event handler for the ibmTerminalControl1 TerminalInitializedEvent event. This event is fired after the terminal is initialized from the InitInstance call (made after the form loads).
- In code view for Form1.cs, add the event handler code as follows. The following code will set the host address and connect to that host.
private void ibmTerminalControl1_TerminalInitializedEvent(object sender, AsyncCompletedEventArgs e)
ibmTerminalControl1.IbmTerminal.HostAddress = "yourHostName";
Note: For details on the IbmTerminal object returned from the IbmTerminal control, see the Reflection .NET API Help.
- Build and run the solution. At runtime, you should get a form that renders a terminal host.
Note: If you are developing an application with Visual Studio 2010 that is targeted to the .NET 4.0 framework, you may see the following compiler warning:
Warning A reference was created to embedded interop assembly 'c:\Windows\assembly\
GAC_MSIL\Reflection\184.108.40.206__13bff1b6907eadcf\Reflection.dll' because of an indirect reference to that assembly created by assembly 'c:\Program Files\Attachmate\Reflection\Programmer Interfaces\Attachmate.Reflection.UserControl.IbmHosts.dll'. Consider changing the 'Embed Interop Types' property on either assembly.
The simplest way to resolve this warning is to set the Embed Interop Types property of the Reflection Reference to False. For more about how to resolve this warning, see Technical Note 2579.