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


HostType

Integer



See FlexHostTypes for available values.


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, Flex Terminal Emulator 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 Flex Terminal Emulator 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 Flex Terminal Emulator. 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 - TN3270 Only


ExtAttributes

Boolean



Set to True to enable extended attributes, which includes seven-color display, underline, reverse video and more.


CustomRows

Integer



With Dynamic selected as the model, enter an integer between 24 and 72 to set the desired number of rows.


CustomCols

Integer



With Dynamic selected as the model, enter an integer between 80 and 160 to set the desired number of columns.


ResponseSupport

Boolean



Set to True to enable TN3270E Response Support, which provides more accurate response information for application-based monitoring tools, compared to TN3270 connections.


ContentionResolution

Boolean



Set to True to enable the Contention Resolution option, which improves communication between the client and host application regarding which owns the send state.


Properties - TN3270 and TN5250


Model

Integer



See FlexModels for available values.


EnhancedMode

Boolean



When set to True, enhanced terminal emulation is used, which provides support for connection to a specific LU or LU Pool.


ConnectMethod

Integer



See FlexConnectMethods for available values.


ResourceName

String



Enter the name of a specific LU or LU pool. This field is required when Specific is selected for the Connection Method.


NameOverride

String



Enter a text string to override the device type that is automatically generated by the Screen Size and Extended Attributes settings.


HostCodePage

Integer



Set to one of the available host code pages that your host system uses. These are the translation tables used to convert text characters between the host and the local computer. The default is 1140 US/Canada Euro.


Properties - VT/SCOANSI/WYSE


Lines 

Integer



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


Columns 

Integer



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