From the Home ribbon tab, choose Setup from the Communication tab group. To modify any of the connection settings here, you must first disconnect the session using the Connect/Disconnect button.


The Connection Setup screen provides the following options, which will vary depending on the emulation type:

General

Host Type
This is a read only property, which displays the type of host for the current session and is TN3270 Display for an IBM Z (mainframe) display session.


Host Name/IP
Enter the IP Address or fully qualified host name for the host system to connect to.

Host Port
Enter the TCP listening port for the host.

Auto Reconnect
When enabled, 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.

Time out (seconds)
Number of seconds to wait for the host connection to be established. If a successful connection is not made within this time period and Auto Reconnect is disabled, a Timed Out message will display. Otherwise, if Auto Reconnect is enabled, FlexTerm will retry the connection attempt


If there are alternate host names or IP Addresses configured in the Hot Backup List, then an attempt to connect to those will be made after the time out value has been reached.


Extended Attributes

Enables extended attributes, which includes seven-color display, underline, reverse video, etc.


Host Code Page

Select from 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.

Emulation

Screen Size

Model
Select one of four standard sizes to automatically set the number of rows and columns, or select Dynamic to manually set the number of rows and columns.


Rows
When a standard model is selected, the number of rows are automatically set. Select Dynamic as the model to manually enter the desired number of rows to display. Enter an integer between 24 and 72.


Columns
When a standard model is selected, the number of columns are automatically set. Select Dynamic as the model to manually enter the desired number of columns to display. Enter an integer between 80 and 160.

Enhanced

Enhanced Mode
When enabled, enhanced TN3270 terminal emulation mode is used, otherwise standard TN3270 is used.


Connection Method
Select Generic to connect using a pool of Logical Units (LUs) from the server, or select Specific to connect to a named LU pool, or a dedicated LU.


Resource Name
Enter the name of a specific LU or LU pool. This field is required when Specific is selected for the Connection Method. Windows environment variables enclosed in percent sign characters are supported, i.e. %COMPUTERNAME%.

Security

Encryption
By default set to None. When Implicit or Explicit SSL/TLS is enabled, the connection between FlexTerm and the host is encrypted using SSL or TLS.  Select Explicit to negotiate Transport Layer Security (TLS) through Telnet. Otherwise, select Implicit to request SSL/TLS immediately without Telnet negotiation.


Normally, Implicit SSL/TLS is sufficient for most environments where SSL/TLS is configured on the host for a specific TCP port. Otherwise, if the host is configured with both secure and non-secure on a single port, Explicit should be used.


SSL/TLS

SSL/TLS Protocol

Specify the SSL/TLS protocol to use for encryption, where Default will negotiate the highest level available on the host system. If a specific protocol is required, choose from the list. Note that SSL 3 and lower are considered obsolete due to vulnerabilities and should not be used unless required by the host.

Server Authentication

Accepted Certificates

Determines which certificate types to accept:


Self-Signed

Enable to accept a self-signed server certificate that was not acquired through a certificate authority. (These are common in test environments.)


Expired

Enable to accept a server certificate that has expired.


Not Yet Valid

Enable to accept a server certificate that has a future starting date.


Invalid

Enable to accept a server certificate that is invalid for any reason other than the date or signature. With this option enabled, FlexTerm will not check the validity of the server certificate.


Name Mismatch

Enable to accept certificates where the name provided when the certificate was created does not match the host name. Host names may be either an IP address or a fully qualified DNS name.


Not Accepted Action

Determines how FlexTerm will respond to any items above that are disabled. Items above that are enabled will ignore this option and allow the certificate.


Choose one of the following actions:

    • Ignore and Connect
    • Prompt
    • Do Not Connect
Client Authentication

Enable

When enabled, a client certificate will be used to establish an encrypted connection with the host. A local certificate must be specified in order to use this option.


Client Certificate

Select the certificate to use for client authentication from the list of installed certificates. Certificates must be imported to the Microsoft Windows "Personal" Certificate Store before they are available to use with FlexTerm.


HLLAPI

Automatic Selection
When enabled, the HLLAPI Short Name and Long Name is automatically assigned by FlexTerm. The first session started will be assigned the Short Name of A, while the Long Name will be SessionA. Opening additional sessions will continue to assign HLLAPI Short and Long Names using B, C, etc.


Short Name
Disable the Automatic Selection to manually assign a Short Name using a single alpha, numeric, or special character. HLLAPI applications use the short name to identify the specific FlexTerm session to communicate with.


Long Name
Disable the Automatic Selection to manually assign a Long Name using a string of up to 8 alphanumeric characters.

Advanced

Hot Backup List
Allows alternate IP host names and TCP ports to be specified, in the event the primary connection attempt fails. Press the + button to add an item to the list, which will prompt to enter the Host Name/IP and Host Port (port defaults to 23). Press the - button to remove an item from the list.


Enable Scroll Back Buffer

Activates the history log which stores lines of host data that are no longer displayed on the live host screen. Use the scroll bar on the right side of the FlexTerm window or the scroll wheel on the mouse to view previous host screens.


Scroll Back Buffer Size (lines)

Enter an integer between 24 and 100,000, where 256 is the default.


Keep Alive Sequence

Enable to send a periodic timing signal to the host to ensure that the connection is not idle long enough to be terminated. Choose between two timing signal options:


  • NOP
    Periodically sends a No Operation command to the host.
  • Timing Mark
    Periodically sends a Timing Mark command to the host.


Keep Alive Timeout (min)
This value specifies the interval at which FlexTerm will send a timing signal. The default is 15 minutes, but may be any value between 1 minute and 1440 minutes (1 day).


Note: The Keep Alive Timeout value should be set to a value that is less than what the host is configured to terminate idle sessions. For example, if sessions are disconnected by the host after 10 minutes of idle time, the timeout value in FlexTerm should be set to 9 minutes or less.


Device Type Override

Enter a text string to override the device type that is automatically generated by the Screen Size and Extended Attributes settings. For example, if screen size Model 5 and Extended Attributes are enabled, the device type string "IBM-3278-5-E" is generated in accordance with the IETF RFC 2355 specification. However, some TN3270 servers will interpret this incorrectly and may need the device type "IBM-3279-5-E" entered into the Device Type Override field.


Non-SNA Command Chaining

Enable this option when connecting through a Visara controller.


Clear Screen Buffer On Disconnect

Enable to clear the screen when the session is disconnected. If the session times out due to inactivity, or is otherwise disconnected by the host or due to a network related issue, the session will also be set to a disconnected state. Otherwise, when disabled, the text from the most recent host screen is displayed and the user must manually disconnect the session before reconnecting.

Miscellaneous

Before-Connect Action

Automatically execute any of the available actions before an attempt is made to connect to the host. This action is not executed for auto-reconnects.


The following FlexTerm commands are not available as a before-connect action, as they could cause undesired results, or are not applicable:


  • CommunicationConnect
  • CommunicationTrace
  • EditCut
  • EditCopy
  • EditPaste
  • EditPasteContinue
  • EditSelectAll
  • FileCloseSession
  • FileExit


On-Connect Action

Automatically execute any of the available actions after a host connection is successfully established.


The following FlexTerm commands are not available as a before-connect action, as they could cause undesired results, or are not applicable:


  • CommunicationConnect
  • CommunicationTrace
  • EditCut
  • EditCopy
  • EditPaste
  • EditPasteContinue
  • EditSelectAll
  • FileCloseSession
  • FileExit

Run When Reconnecting

Enable to allow the On-Connect Action to execute even when the session has been disconnected by the host and reconnected. The Auto Reconnect option must be enabled to utilize this option. If disabled, the On-Connect Action will only execute when the initial connection is made.


On-Disconnect Action

Automatically execute any of the available actions after disconnecting the session.


The following FlexTerm commands are not available as an on-disconnect action, as they could cause undesired results, or are not applicable:


  • CommunicationConnect
  • CommunicationTrace
  • EditCut
  • EditCopy
  • EditPaste
  • EditPasteContinue
  • EditSelectAll
  • FileCloseSession
  • FileExit
  • MacroPlay
  • TransferFile