Wx3270/Help/ConnectionEditor

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

Sections

Profile

New in 1.2

When a new connection is being created (versus editing an existing connection), a Profile section is present at the top of the window. This gives the option of adding the new connection to the selected, existing profile, or creating a new profile that will contain only this connection.

The reason for creating a new profile here is if you want different screen dimensions for this connection, but you do not want to change the screen dimensions for existing connections defined in the profile. There is a text box to enter the new profile name, a combo box to select the 3270 model, and fields to select oversize dimensions.

If a new profile is created, it will be a copy of your default profile (usually called Base), minus any connections it may contain, with the selected 3270 model and oversize.

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, or whatever title is specified in the profile settings.

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 this window in the browser, or (new in 1.2) starts the tour of this window.