Skip to content

Set Up Backup Connection Settings Dialog Box

How do I get to this dialog box?
  1. Open the Settings window.

    The steps depend on your user interface mode.

    User Interface Mode Steps
    Ribbon or Reflection Browser With a session open in Reflection, from the Quick Access Toolbar, click .
    TouchUx Tap the Gear icon and then select Document Settings.
  2. Under Host Connection, select Set up Backup Connection Settings.

From this dialog box, you can specify the settings for one or more backup TN5250 connections. If your primary connection fails, these connections will be tried next, in the order they are listed.

Backup Hosts

Add a host to the Backup Host list by clicking the Add button. Use the Move Up and Move Down buttons to change the order in which the hosts are tried.

Setting Description
Host Name/IP address Identify the host to which you will connect. Type the host name, alias, or numeric IP address.

Note: Both IPv4 addresses (in the form and IPv6 addresses (in the form 2001:0db8:3c4d:0015:0000:0000:abcd:ef12) are accepted.
Port Type the host port or socket number that the session should use. This field accepts any number between 0 and 66,535 (default = 23).
Device name Specify the terminal device name (also called the display name or the workstation ID) that the IBM System i should use for your session. If you leave this box blank, the IBM System i creates a device to use for your session.

The device name can be up to ten characters long. You can include any of the following characters as part of the value in the Device name box.

- * is replaced by "A", "B", "C", and so on. If the entire alphabet is used, the generated device names continue with "AA", "AB", "AC", and so on.

- % is replaced by P for printer sessions and S for display sessions.

- = is replaced by 1,2, 3, and so on to create a unique device name.

- &COMPN Replaced by the local workstation name; left-trimmed if the generated name exceeds 10 characters.

- &USERN Replaced by the local user name; left-trimmed if the generated name exceeds 10 characters.

- + Specifies right-trimming instead of left-trimming. Use with &COMPN or &USERN. This character can be placed anywhere in the string.


  • You can use only one string in combination with these characters. If you use separated strings, the second string is dropped. For example, %MyDevice= is valid. However, %My=Device is not valid, and will be treated by the system as if it were &My=.
  • You cannot use both &COMPN and &USERN in the same string.
  • To have Reflection generate unique device names automatically based on the special characters described above, the Generate Device Names setting must be enabled. In printer sessions, this setting is off by default. To enable it, see the Generate Device Names topic.

Connection Options

When you enter more than one backup host, the connection options for each host are listed on a separate tab.

Setting Description
Generate device names When selected, Reflection automatically generates device names based on the value specified in the Device name field.

For example, if the specified device name is %ABC=, Reflection generates the device name SABC1 for a display session. If SABC1 is already in use, Reflection tries SABC2, SABC3, and so on.

Setting the device name to %123* generates the device name S123A for the first display session, S123B for the second session, and so on.

When cleared, if the specified device name is in use, the session does not connect.
Model ID Specify the terminal (also known as a display station) you want to emulate.
Security Settings Secure data communications with SOCKS or SSL/TLS.

More information