Wx3270/Help/ConnectionEditor

From The x3270 Wiki
< Wx3270‎ | Help
wx3270 connection editor

This window is used to create a new host session, or edit an existing one.

Sections

Connection type

Host
The connection defines a network connection to a host.
Local process
The connection defines a process that will be started on the workstation, with its standard input and standard output connected to wx3270.

Basic parameters

Profile
The name of the profile that this connection is defined in. This field cannot be modified.
Session name
The optional name of the connection, which will be displayed on the connect menu, profile window and profile menu. If this is field is not specified, the name will come from the host name or command.
Host name
The DNS name of the host, or its IPv4 or IPv6 numeric host address. This field is valid only if the connection type is host.
Port
The optional TCP port to use to connect to the host. It defaults to 23, the TELNET port. This field is valid only if the connection type is host.
LU names
An optional set of logical unit (LU) names to request connections to on the host. Each name is tried in the order specified. This field is valid only if the connection type is host.
Accept hostname
An alternate name that will be accepted from the host's TLS certificate. Normally the host name is used for this validation. This field is valid only if the connection type is host.
Client certificate name
The optional name of a certificate to be presented to the host during TLS negotiation. This field is valid only if the connection type is host.
Command
The pathname of the program to run as a local process. This field is valid only if the connection type is local process.
Command-line options
The optional command-line options for the program to run as a local process. This field is valid only if the connection type is local process.
Login macro
An optional list of actions to execute as soon as the connection is established.
Description
An optional string describing the session. This is displayed in the profile window when the mouse cursor is hovered over the connection.
Window title
An optional string to use as the title for the window. The default is the session name.

Options

These options modify the behavior of the connection. They are available only if the connection type is host.

Create TLS tunnel
Causes wx3270 to create a TLS tunnel to the host, as soon as the TCP session is connected.
Accept STARTTLS
Allows wx3270 to accept the STARTTLS TELNET negotiation.
Verify host certificate
Requires that wx3270 validate the host's TLS certificate. It generally a bad idea to turn this off; however it is sometimes necessary to do this in order to inspect the host's certificate, to see why wx3270 is unable to validate it.
NVT mode
Forces wx3270 to behave strictly as a TELNET Network Virtual Terminal, disabling 3270 option negotiation. Changes the terminal type reported to the host to xterm.
Accept TN3270E
Allows wx3270 to negotiate the TN3270E protocol.
Wait for login screen
Causes wx3270 to wait for the host to paint a login screen before applying any login macro or allowing keyboard input.
Use TELNET
Enables support for the TELNET protocol. Without this option, wx3270 simply shuttles text back and forth with the host without any special interpretation.
Prefix and resource equivalents
Option Prefix if checked Prefix if cleared Resource if checked Resource if cleared
Create TLS tunnel L:
Accept STARTTLS startTls true startTls false
Verify host certificate Y:
NVT mode A:
Accept TN3270E N:
Wait for login screen C:
Use TELNET T:

There are also options available to set host name prefixes that are not covered by other options.

When profile is loaded

Defines wx3270's behavior when this profile is loaded.

Do not make this connection
Do nothing.
Make this connection
Create this connection.
Keep making this connection
Create this connection, and if the connection is broken, re-connect.

If more than one connection in a profile is marked with make this connection or keep making this connection, only one of them will be connected (and there is no guarantee which one it will be).

Host type for file transfers

Defines the default host type for file transfers. The IND$FILE command takes different arguments depending on what kind of host it is run on; this setting helps define the options available on the file transfer tab of the actions window.

3287 printer session

Defines the type of 3287 printer session (if any) to create when this connection is established.

None
Do not create a printer session.
Associate with interactive session
Create a printer session that is associated with the interactive terminal session. This mode works only if the host negotiates TN3270E mode.
Specific LU
Create a printer session that is associated with a particular Logical Unit (LU).

No-TELNET input mode

Defines how keyboard input is handled when the session is not in TELNET mode (the Use TELNET option is cleared).

Line
Input is gathered until the Return key is pressed. Keystrokes are echoed locally, and backspace and line-kill (Ctrl-U) processing is performed.
Character
Each keystroke is passed to the host without any further processing. Keystrokes are not echoed locally.
Character with CR/LF translation
The same as character mode, but CR characters (0x0d) are translated to the LF characters (0x0a).

Lower Buttons

Connect
Saves the session definition and connects to the host. (This button appears only when creating a new session.)
Connect+⏺
Saves the session definition, connects to the host, and starts the macro recorder for the purpose of creating a login macro. (This button appears only when creating a new session.)
Cancel
Reverts all changes and closes the window.
Save
Saves the changes and closes the window.
? (Help)
Opens a browser window on this page.