Allocate a session using a dedicated Telnet resource

Technical Note USA12001
Created 12-Dec-2005

Applies To
Synapta Services Builders for 3270 & 5250

Goal

Allocate a session using a dedicated Telnet resourceProgrammatically specify a dedicated Telnet resource for Task execution

Fix

The Telnet Resource can be a pool-wide setting; that is, it is global with respect to all of the sessions within a single pool configuration. This option can be used if all of the pool's sessions will be connecting to the same Telnet resource (typically a Telnet resource pool). This is configured through the MCS Console under:

Products ==> Services Builder for Screens ==> Servers ==> [Server Name] ==> Configure ==> Pools (tab) ==> [Pool Name] ==> NavMap (item) ==> Resource/device field
Programmatic solutions:

Three programmatic examples are provided below. In either case, make sure that the Pool's initial sessions parameter is set to zero ( 0 ) in the Runtime Pool configuration. This will ensure that a session is not allocated to a dynamically assigned LU.
Using the generated Java Bean:

  String lu = "LU." + strMyDeviceName;
  {
testBean.setInstanceName(lu); // set Telnet resource name
  }
Using the IConnectorAccess interface:

Concatenate the “?instance=LU.{Telnet Resource Name}” string onto the Task file name in the Open() method. The following C# example uses the ScreenConnector.dll:

  String taskFile = “c:\myDesignerProject.xml”;
  ScreenConnector connector = new ScreenConnector();
  connector.open( taskFile + “?instance=LU.D163” );
  connector.execute( “Login”, ScreenInputs><Input>myInput</Input></ScreenInputs> );
When using an Attachmate Designer Studio generated .NET Web Service, set the InstanceName field in the ScreenInputs object reference:

     MyProjectNameService webService = new MyProjectNameService();
     MyTaskNameScreenInputs inputs = new MyTaskNameScreenInputs();
     inputs.InstanceName = "LU.D163”;
     ...
     MyTaskNameScreenOutputs outputs = webService.MyTaskName( inputs );     

Additional Notes: The IConnectorAccess interface is the underlying API for the COM bridges (ScreenConnector.dll & ScreenConnectorProxyService). The ScreenConnectorProxyService is the default COM bridge used in the Attachmate Designer-generated Microsoft .NET Web Services.