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/session type:

General

Host Type
This is a read only property, which displays the type of host for the current session and is TN5250 Printer for an IBM System i (TN5250) printer connection.


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, 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.

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


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

Enhanced

Connection Method
Select Generic to connect using an unnamed 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%.

5250 Printer

Message Queue
The name of the queue to which operational messages for a printer device will be sent. The default is QSYSOPR.


Message LIbrary
The name of the message library in which the message queue is located. the default is *LIBL.


Host Font
Font identifier used for the AS/400 print file. The default is Courier 10.


Forms Mode
Forms mode used for the AS/400 print file. The default is Autocut mode.


Host Print Transform
Enable this option to transform print data to ASCII format in the AS/400 according to the make and model of the printer to be used.

Host Print Transform

Printer Model
Select the PC printer model to use.


Custom Name
The custom name that contains the information to be used for the printer.


Custom Library
The custom library that contains the information to be used for the printer.

Sources

Paper Source 1

Select the size of paper loaded in the primary paper source. The default is MFRTYPMDL.


Paper Source 2

Select the size of paper loaded in the secondary paper source.


Envelope Source

Select the size of paper loaded in the envelope source.


ASCII Code Page 899

Enable this option if your printer supports ASCII code page 899 symbols.

Security

Encryption
By default set to None. When Implicit or Explicit SSL/TLS is enabled, the connection between Flex Terminal Emulator 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, Flex Terminal Emulator 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 Flex Terminal Emulator 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 Flex Terminal Emulator.

HLLAPI

Automatic Selection
When enabled, the HLLAPI Short Name and Long Name is automatically assigned by Flex Terminal Emulator. 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. Otherwise, disable to assign a specific HLLAPI Short Name.


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


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

Miscellaneous

Before-Connect Action

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


On-Connect Action

Automatically execute an action after a host connection is successfully established.


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 an action after disconnecting the session.


Note: for each of the above, only the following actions are available for TN5250 Printer sessions:


Flex Terminal Emulator Commands

    • FileNewWorkspace
    • FileOpenWorkspace
    • FileSaveWorkspace
    • FileSaveWorkspaceAs
    • FileSaveWorkspaceAsLink
    • FileSaveAll
    • FileNewSession
    • FileSaveSession
    • FileSaveSessionAs
    • FilePageSetup
    • FileOptions
    • FileWorkspaceSettings
    • FileLockdown
    • FileAbout
    • FileToggleRibbon
    • FileHelp
    • CommunicationSetup
    • FlexFtp
    • ViewRibbonBar
    • ViewStatusBar
    • ViewShortName
    • ViewExtensionsCustomize
    • ViewExtensions
    • OptionsEmulation
    • ViewTheme


External

Select to run an external application.