Skip to content

Configuring a Host Session

Use the Session Setup or the New Model dialog box to connect to a host and specify emulation options. To open the Session Setup dialog box, click Session Setup on the Connection menu.

Note

You can open the Session Setup dialog box if you have not connected it to a host session. Otherwise, this option is unavailable. Use the Connection Properties dialog box to review settings after you are connected.

The options in the Session Setup dialog box vary according to the values you select for session type and transport type. Click one of the following for more information:

Once you have set up the options in this dialog box, you can click Connect to connect immediately, or click OK to close the dialog box. If you click OK, you can always connect later. Connection settings can be saved to a settings file (.dtool) with other configuration information.

Configuring a 3270 Terminal Session

The following options are available in the Session Setup or New Model dialog box.

After you connect, you can review these settings in the Connection Properties dialog box.

Options Description
Session Type Specifies the type of session to configure.
Model ID Specifies the terminal (also known as a display station) you want the Design Tool to emulate.
Transport Type This setting specifies the transport type being used to connect to the host. You can use Telnet, Telnet Extended, SSH, or NS/VT transport types as well as Secure Socket Layer (SSL) and Transport Layer Security (TLS) security protocols. Telnet is available for 3270,5250, VT, and HP session types, while Telnet Extended is only available for IBM 3270 session types. Choose SSH to connect to a VT host using SSH security protocols. NS/VT is available for HP session types.
Use SSL/TLS See Using SSL/TLS
Host Name or IP Address Use this box to identify the host to which you want to connect. You can either select a host from the drop down list or type one into the host name field. When you start the Design Tool without a value for this setting, the Design Tool looks for the Hosts file in the same folder as Wsock32.dll. If you are using third-party TCP/IP software, your Hosts file may be in another location. When it finds a Hosts file, the Design Tool changes the value of this setting.
Port Number Specifies the host port or socket number that the Telnet session should use. You can enter any number between 0 and 65,535 in this field. You can configure Port in either the Session Setup or View Settings dialog boxes. The default port number for Telnet is 23.
Device Name Specifies the Device name (also known as LU name) to which to connect. Supports up to 32 characters. You can map the Device Name setting to a model variable in the Model menu > Variables. This allows a different setting for each server runtime session. If a model variable is mapped to the Device Name setting, the Device Name configured in Session Setup will be used as a default unless changed by a session pool model variable list or a Host Integrator API SetModelVariable method.

More information

Advanced 3270 Telnet and Telnet Extended dialog boxes

You can configure the following options in these dialog boxes:

Option Description
Terminal ID In a 3270 session with a Telnet transport type, this setting overrides the Model ID selected in Session Setup. It allows you to specify a Terminal Model that Host Integrator does not implicitly support (but might work with), such as Fujitsu. For best results, specify one of the Terminal Models available in Session Setup and leave the Terminal ID box empty. When the Terminal ID box is empty, the Design Tool uses the Model ID defined in Session Setup by default. Only specify a Telnet Terminal ID, if after experimenting with other available Terminal Models IDs in Session Setup, you still cannot connect to the host. If you must define a Telnet Terminal ID, specify a string you know is acceptable to the host. Otherwise, you may experience problems connecting to the host and emulation problems after connecting to the host. Typically, these types of problems occur if the host is not configured to recognize the terminal specified in the Telnet Terminal ID string.
Telnet Location Specifies where the connection originated. Can also be used to provide informational messages to the host from the computer. You are not required to enter anything in this box. Supports up to 260 characters. You cannot change this value while you're connected to a gateway.
Send Keep Alive packets To become aware of connection problems as they occur, you can configure your model to Send Keep Alive packets.
Keep Alive Timeout The interval between the keep alive requests sent by the Design Tool. The range of values is 1-9999 seconds, and the default is 600 seconds.

Configuring a 5250 session

The following options are available in the Session Setup or New Model dialog box.

After you connect, you can review these settings in the Connection Properties dialog box.

Options Description
Session Type Specifies the type of session to configure.
Model ID Specifies the terminal (also known as a display station) you want the Design Tool to emulate.
Transport Type This setting specifies the transport type being used to connect to the host. You can use Telnet, Telnet Extended, SSH, or NS/VT transport types as well as Secure Socket Layer (SSL) and Transport Layer Security (TLS) security protocols. Telnet is available for 3270,5250, VT, and HP session types, while Telnet Extended is only available for IBM 3270 session types. Choose SSH to connect to a VT host using SSH security protocols. NS/VT is available for HP session types.
Use SSL/TLS See Using SSL/TLS
Host Name or IP Address Use this box to identify the host to which you want to connect. You can either select a host from the drop down list or type one into the host name field. When you start the Design Tool without a value for this setting, the Design Tool looks for the Hosts file in the same folder as Wsock32.dll. If you are using third-party TCP/IP software, your Hosts file may be in another location. When it finds a Hosts file, the Design Tool changes the value of this setting.
Port Number Specifies the host port or socket number that the Telnet session should use. You can enter any number between 0 and 65,535 in this field. You can configure Port in either the Session Setup or View Settings dialog boxes. The default port number for Telnet is 23.
Device Name Specifies the Device name (also known as LU name) to which to connect. Supports up to 32 characters. You can map the Device Name setting to a model variable in the Model menu > Variables. This allows a different setting for each server runtime session. If a model variable is mapped to the Device Name setting, the Device Name configured in Session Setup will be used as a default unless changed by a session pool model variable list or a Host Integrator API SetModelVariable method.

More information

Advanced 5250 Telnet dialog box

You can configure the following options in this dialog box:

Option Description
Telnet location Specifies to the host where the connection originated. Can also be used to provide informational messages to the host from the computer. You are not required to enter anything in this box. Supports 260 characters.You cannot change this value while you're connected to a gateway.
Username Enter your username for the AS/400 Sign On screen if you want to bypass being prompted for it at connection time. You'll also need to enter your password.
Password Enter your password for the AS/400 if you want to bypass being prompted for it at connection time. You'll also need to enter your username.
Auto SignOn Select this option to have the transport protocol automatically log you on to the host as soon as you establish a connection in the Design Tool. By default, this check box is not selected.
Send Keep Alive packets To become aware of connection problems as they occur, you can configure your model to Send Keep Alive packets.
Keep Alive Timeout The interval between the keep alive requests sent by the Design Tool. The range of values is 1-9999 seconds, and the default is 600 seconds.

Configuring a VT Session

The following options are available in the Session Setup dialog box.

Some of these options are dependent on the transport type you are using, either Telnet or SSH.

Options Description
Session Type Specifies the type of session to configure.
Terminal Type Specifies the terminal (also known as a display station) you want the Design Tool to emulate.
Transport Type This setting specifies the transport type being used to connect to the host. You can use Telnet, Telnet Extended, SSH, or NS/VT transport types as well as Secure Socket Layer (SSL) and Transport Layer Security (TLS) security protocols. Telnet is available for 3270,5250, VT, and HP session types, while Telnet Extended is only available for IBM 3270 session types. Choose SSH to connect to a VT host using SSH security protocols. NS/VT is available for HP session types.
Host Name or IP Address Use this box to identify the host to which you want to connect. You can either select a host from the drop down list or type one into the host name field. When you start the Design Tool without a value for this setting, the Design Tool looks for the Hosts file in the same folder as Wsock32.dll. If you are using third-party TCP/IP software, your Hosts file may be in another location. When it finds a Hosts file, the Design Tool changes the value of this setting.
Port Number Specifies the host port or socket number that the SSH session should use. You can enter any number between 0 and 65,535 in this field. You can configure Port in either the Session Setup or View Settings dialog boxes. The default port number for SSH is 22.
Device Name Specifies the Device name (also known as LU name) to which to connect. Supports up to 32 characters. You can map the Device Name setting to a model variable in the Model menu > Variables. This allows a different setting for each server runtime session. If a model variable is mapped to the Device Name setting, the Device Name configured in Session Setup will be used as a default unless changed by a session pool model variable list or a Host Integrator API SetModelVariable method.

See Customizing the VT Terminal for Advanced Telnet and SSH Configurations.

After you connect, you can review these settings in the Connection Properties dialog box.

Configuring an HP Session

On an HP terminal, with the Transport Type set to Telnet or NS/VT, the following options are available in the Session Setup and New Model dialog box.

After you connect, you can review these settings in the Connection Properties dialog box.

Options Description
Session Type Specifies the type of session to configure.
Model ID Specifies the terminal (also known as a display station) you want the Design Tool to emulate.
Transport Type This setting specifies the transport type being used to connect to the host. You can use Telnet, Telnet Extended, SSH, or NS/VT transport types as well as Secure Socket Layer (SSL) and Transport Layer Security (TLS) security protocols. Telnet is available for 3270,5250, VT, and HP session types, while Telnet Extended is only available for IBM 3270 session types. Choose SSH to connect to a VT host using SSH security protocols. NS/VT is available for HP session types.
Host Name or IP Address Use this box to identify the host to which you want to connect. You can either select a host from the drop down list or type one into the host name field. When you start the Design Tool without a value for this setting, the Design Tool looks for the Hosts file in the same folder as Wsock32.dll. If you are using third-party TCP/IP software, your Hosts file may be in another location. When it finds a Hosts file, the Design Tool changes the value of this setting.
Port Number Select one of the following depending on which transport type you selected in the Session Setup or New Model dialog box; Telnet or NS/VT.The default port number for Telnet is 23. The default port number for NS/VT is 1570.

See Customizing HP for advanced HP Telnet configuration information.

More informationi