Admin Production rocket
Current Publication
Reflection Desktop .NET API Guide V18.0 Get Started Create a New Session

Create a New Session

Reflection Desktop .NET API Guide V18.0
Created:
Last Uploaded:January 9, 2025 6:45 pm
Last Updated:
Initial Upload:December 31, 2024 7:59 pm
tag Reflection Desktop
tag 18.0
tag Developer
tag Reference
tag No Download
Rocket® Reflection Desktop (formerly a product of Micro Focus or formerly a product of Open Text) documentation that was created prior to Rocket Software's acquisition of certain products from OpenText may contain outdated references to "Micro Focus” or “OpenText”, which are trademarks of OpenText. Rocket Software is not affiliated with Micro Focus or OpenText and has rebranded these products as Rocket® products.
Create a New Session
In This Topic

This sample program creates a completely new host session that is visible in the workspace

To create a new session

  1. In Visual Studio, create a new Console Application project and add references for the following Reflection assemblies. (Depending on your version of Visual Studio, these can be found either on the .NET tab or under Assemblies | Extensions.)
    Attachmate.Reflection.Framework
    Attachmate.Reflection.Emulation.IbmHosts
    Attachmate.Reflection.Emulation.OpenSystems
    Attachmate.Reflection
  2. If you are using an ALC, UTS, or T27 terminal, create a session path. This sample uses the following path IDs:
    ALC: UPDFRAD
    UTS: INT1_1
    T27: TCPA_1
  3. Replace all the code in the Program.cs file with the following code for the terminal you are using.
  4. If you are using OpenSystems, change the placeholder value "YourHostName" to the host name or IP address for your system.

    Create a new session
    Copy Code
    		 
    using System;
using System.Collections.Generic;
using System.Text;
using Attachmate.Reflection.Framework;
using Attachmate.Reflection.Emulation.IbmHosts;
using Attachmate.Reflection.UserInterface;

namespace CreateASession
{

    class Program
    {
        static void Main(string[] args)
        {
            //Start a visible instance of Reflection or get the instance running at the given channel name
            Application app = MyReflection.CreateApplication("myWorkspace", true);

            //Create a terminal for an Ibm 3270 session
            IIbmTerminal terminal = (IIbmTerminal)app.CreateControl(new Guid("{09E5A1B4-0BA6-4546-A27D-FE4762B7ACE1}"));

            //Specify the host name or IP address
            terminal.HostAddress = "demo:ibm3270.sim";


            //To create a 5250 terminal, use the following lines to get a terminal and specify the host name
            //IIbmTerminal terminal = (IIbmTerminal)app.CreateControl(new Guid("{AF03A446-F278-4624-B9EF-C896DF2CA1CA}"));
            //terminal.HostAddress = "demo:ibm5250.sim";

            //Specify the port number and connect
            terminal.Port = 623;
            terminal.Connect();

            //Create a View to make the session visible                
            IFrame frame = (IFrame)app.GetObject("Frame");
            frame.CreateView(terminal);
        }
    }
}
    Create a new session
    Copy Code
    		 
    using System;
using System.Collections.Generic;
using System.Text;
using Attachmate.Reflection.Framework;
using Attachmate.Reflection.Emulation.OpenSystems;
using Attachmate.Reflection.UserInterface;

namespace CreateASession
{
    class Program
    {
        static void Main(string[] args)
        {
            //Start a visible instance of Reflection or get the instance running at the given channel name
            Application app = MyReflection.CreateApplication("myWorkspace", true);

            //Create a terminal for an Open Systems session
            ITerminal terminal = (ITerminal)app.CreateControl(new Guid("{BE835A80-CAB2-40d2-AFC0-6848E486BF58}"));

            //Specify the connection type, host name (or IP address), and connect.
            IConnectionSettingsTelnet conn = (IConnectionSettingsTelnet)terminal.ConnectionSettings;
            conn.HostAddress = "yourHostName";
            terminal.Connect();

            //Create a View to make the session visible                
            IFrame frame = (IFrame)app.GetObject("Frame");
            frame.CreateView(terminal);
        }
    }
}

    To test this project

    • Press F5 to run the project and verify that the session opens.

      • Related Content