ConnectionSettings

Gets or sets properties related to the session connection. Setting any of the below properties must be done with use of a Before-Connect macro to be effective for the active session.


Syntax

FlexSession.ConnectionSettings


Properties - All Emulation Types


HostNameIP

String



IP Address or fully qualified host name for the host system to connect to.


Port

Integer



TCP listening port for the host.


TimeOutSec

Integer



Number of seconds to wait for the host connection to be established.


AutoReconnect

Boolean



When set to True, FlexTerm will attempt to reconnect the session if it is timed out, is unexpectedly disconnected, or if the host is unavailable when the initial connection is attempted. Set to False to disable.


ScrollBackBufferSize

Integer



Set to 0 to disable, or an integer between 24 and 100,000 to enable.


KeepAliveSeq

Integer



 See FlexKeepAliveSeqs for available values.


KeepAliveTimeoutMin

Integer



Specifies the interval at which FlexTerm will send a timing signal. May be any value between 1 minute and 1440 minutes (1 day).


HllapiAutoSelect 

Boolean



When set to True, the HLLAPI Short Name and Long Name is automatically assigned by FlexTerm. Set to False to manually specify using HllapiShortName and HllapiLongName properties.


HllapiShortName

Character



With HllapiAutoSelect set to False, assign a Short Name using a single alphabetic character (A - Z).


HllapiLongName 

String



With HllapiAutoSelect set to False, assign a Long Name using a string of up to 8 alphanumeric characters.


HotBackupList

List of strings



Allows alternate IP host names and TCP ports to be specified, in the event the primary connection attempt fails.


 Example:

   Sub Main()
      Dim hosts(2)
      hosts(0) = "localhost:2222"
      hosts(1) = "127.0.0.1:2222"
      FlexSession.ConnectionSettings.HotBackupList = hosts
   End Sub


Properties - VT Only


Lines 

Int



Sets the number of lines to display on the screen, where the valid range is 24 to 144.


Columns 

Int



Sets the number of columns to display on the screen, where the valid range is 80 to 132.


OperatingMode 

Integer



Set the appropriate VT operating mode.


See FlexOperatingModes for available values.


TerminalID

String



Set the terminal type exchanged during telnet negotiation, which is automatically set based on the selected OperatingMode. This property provides a way to override the automatic setting with a different value.


HostEncoding

Integer



Set the translation tables used to convert text characters between the host and the local PC.


Valid values:

    IBM 437 = 437
    Windows 1252 = 1252
    ISO 8859-1 = 28591
    ISO 8859-15 = 28605
 

Example:

FlexSession.ConnectionSettings.HostEncoding = 1252


NRCharset

Integer



Set the National Replacement Character set, which provide characters sets for many European languages.


See FlexNRCharsets for available values.


Example

Sub Main()

 FlexSession.ConnectionSettings.HostNameIP = "my.hostnameip"

 FlexSession.ConnectionSettings.AutoReconnect = True

 FlexSession.ConnectionSettings.ScrollBackBufferSize = 2000

End Sub