Skip to content

5250 Terminal Document Settings Dialog Box

How do I get to this dialog box?
  1. Open the Create New Document dialog box

    The steps depend on your user interface mode.

    User Interface Mode Steps
    Ribbon or Reflection Browser From the Quick Access Toolbar, click the New Document button.
    TouchUx Tap the Folder icon and then under File, select New.
  2. From the Create New Document dialog box, select a 5250 terminal session template, and then click Create.


Enter Host (or System) Name or IP Address

Identify the host to which you will connect. Type the host name, alias, or numeric IP address.


Both IPv4 addresses (in the form and IPv6 addresses (in the form 2001:0db8:3c4d:0015:0000:0000:abcd:ef12) are accepted.


Type the host port or socket number that the session should use. This field accepts any number between 0 and 66,535 (default = 23).


For SSL sessions, the port defaults to 992.

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.

Character Usage
* Replaced by A, B, C, and so on to create a unique device name. If the entire alphabet is used, the generated device names continue with AA, AB, AC, and so on.
% Replaced by P for printer sessions and S for display sessions.
= 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.

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.


Setting Description
Model ID Specify the terminal (also known as a display station) you want to emulate.
Host code page Select the language and associated host code page to be used by your session. If you are not sure which language and code page to use, check with your system administrator. The default is US English, code page 037.
Keyboard map Specify the keyboard map to use with this session.
Configure additional settings Select to open a page from which you can customize host connection, terminal configuration, and other settings for this session. When selected, the session does not auto-connect. This allows you to modify settings before connecting to the session.