# Telnet/tn3270 Console How-To for Hercules Version 4

Hercules Version 4 has been used with the following tn3270 and telnet applications. Click on each name to view settings and other considerations for using that application with Hercules.

- x3270 / c3270 / wc3270 tn3270 - Windows, Linux; no license fee
- Tn3270 for the Macintosh - OS X (multiple versions); no license fee
- Vista tn3270 - Windows; nominal license fee
- ZOC Terminal - Windows, OS X; nominal license fee
- PuTTY Telnet - Windows, Linux; no license fee

- Linux telnet - The default Linux telnet client works well OOTB
- Windows Telnet - Windows has been used, others are likely to work
- Windows NT Telnet - Windows NT only

The above list is neither an endorsement of those products nor a recommendation to use them. If wish to share your experience with a different telnet and/or tn3270 application, please post that experience to the Hercules-390 discussion group. Other telnet client applications that comply with the following RFCs should work.

Remember that local echo needs to be set on for telnet connections.

Telnet |  | tn3270
--- | --- | ---

- RFC854 Telnet Protocol Specification
- RFC855 Telnet Option Specifications
- RFC1091 Telnet terminal-type option
- RFC1143 The Q Method of Implementing TELNET Option Negotiation
- RFC1572 Telnet Environment Option
- RFC1571 Telnet Environment Option Interoperability Issues

- RFC856 Telnet Binary Transmission
- RFC885 Telnet end of record option
- RFC1576 TN3270 Current Practices
- RFC2355 TN3270 Enhancements

#### x3270 / c3270 / wc3270

The x3270 family of tn3270 applications are available without charge from x3270.bgp.nu. RPM's exist for many Linux distributions that use Redhat Package Manager files; check here for a list. It is also packaged for Debian and Ubuntu, and the .deb packages can often be used with other Debian-based Linux distributions. They are licensed under the BSD license as shown on the x3270 license page.

The packaged installation files available for Linux distributions are several minor releases older than the current stable release. You may wish to build x3270 from source even when an installation package exists for your Linux distribution. Build instructions for a variety of environments are in the Documentation - Miscelaneous page of the x3270 web site.

The x3270 family includes the following applications (there are additional applications in the family; visit the x3270 site):

- x3270 - tn3270 for X11 servers driving graphical displays
- c3270 - tn3270 for fixed-function character-mode terminals or telnet sessions
- wc3270 - native Windows tn3270 application

Start an x3270 session and connect to Hercules with the following.

>     Windows: "c:\Program Files\wc3270\wc3270" -port nnnn -model 32xx-x hostname

>     Linux:   x3270 -port nnnn -model 32xx-x hostname

Replace the port, model, and hostname options as follows.

-port nnnn | This must match the port named in the Hercules configuration file CNSLPORT statement.

-model 32xx-x

- 3278-2 (a good second choice)
- 3278-3
- 3278-4
- 3278-5
- 3279-2 (recommended)
- 3279-3

Unless you know that the application program running under Hercules to which you will attach supports large screen sizes, specify 3279-2 or 3278-2 to select a 24 x 80 screen size.

There's nothing wrong with a bit of trial and error here. Try other screen sizes to see what works. But start with a model 2.

hostname
001f@hostname
console@hostname

This identifies the ip address of the Hercules system and optionally the 3270 device in the Hercules configuration to which this session should connect.

You can specify a host name, IPv4 address, or IPv6 address. Most commonly, you'll use localhost for the host name.

If a hexadecimal number is provided before the host name, the session will try to connect to that address in the Hercules configuration.

If a groupname is provided, the session will try to connect to any available 3270 device that names that group.

If no name or number is provided before the host name, the session will connect to any available 3270 device.

Example x3270 session startup command

>     Windows: "c:\Program Files\wc3270\wc3270" -port 3270 -model 3229-2 localhost

>     Linux:   x3270 -port 3270 -model 3229-2 localhost

Return to top of page

#### tn3270 for the Macintosh

Tn3270 for the Macintosh is available without charge from Brown University at https://www.brown.edu/cis/tn3270/. According to the web site as of May, 2016, the current version of this tn3270 application can be used with OS X 10.3.9 "Panther" through OS X 10.9 "Mavericks" on POWER PC and Intel-based systems.

Older versions of tn3270 exist for older Macintosh systems.

This author does not have access to a Mac and regrets being unable to provide configuration options.

Return to top of page

#### Vista tn3270

Vista tn3270 is a Windows application written and maintained by Tom Brennan, and is used by members of the Hercules community. You can learn more about it at Tom Brennan Software. The screenshots are worth a look.

Complete installation and setup instructions are included in the Hercules Installation Guide for Hercules Version 4 starting on page 123.

Return to top of page

#### ZOC Terminal

ZOC Terminal, available for Windows and Macintosh, is offered by Emtec Innovative Software and is used by members of the Hercules community. You can learn more about it at the ZOC Terminal web site. The screenshots are worth a look.

This author does not have access to a Mac and regrets being unable to provide configuration options.

Return to top of page

#### PuTTY Telnet

PuTTY version 0.67 has been tested on Windows and version 0.63 has been tested on Debian 8.4. Other recent versions of PuTTY should work as well.

PuTTY source and Windows builds are available without charge and can be obtained from putty.org. RPM's exist for many Linux distributions that use Redhat Package Manager files; check here for a list. It is also packaged for Debian and Ubuntu, and the .deb packages can often be used on other linux distributions based on Debian. It is distributed under the MIT license, as shown on PuTTY's license page.

The following options must be set for correct operation. Click on the page name to open a screen shot in a new browser window:

> Page | Setting | Value needed for Hercules
> --- | --- | ---
> Session | Port | Must match nnnn in the CNSLPORT statement in the Hercules configuration file
> Connection type | Select "Telnet"
> Terminal | Local echo | Select "Force on"
> Local line editing | Select "Force on"
> Connection - Data | Terminal-type string | Must be set to "ANSI"

Other options may be set as you wish. Because mainframes that used printer-keyboards used continuous forms, and "scrolling back" through the console log meant thumbing through a stack of continuous forms paper, you may wish to set the size of the window and the lines of scroll back on the Windows page to accomodate your preferences.

Return to top of page

#### Linux telnet

Virtually all Linux distributions come with a default telnet client that should work well out of the box. No special configuration should be needed.

#### Windows Telnet

The Telnet client included with Windows is known to have been used successfully with Hercules Version 4. The telnet clients included with Windows XP, Vista, 7, 8, 8.1 and 10 appear to all be the same program, so the you should be able to set up a connection using the information below. Please post any difficulties to the Hercules-390 discussion group, noting the symptoms, Windows version and error messages.

One settings change is needed to use the Windows Telnet client with Hercules Version 4: 'set localecho'. The defaults for the remaining settings should work. Refer to the sample session below:

Window size and scroll-back are controlled by the command prompt window that Telnet is running in. You can use the set logfile and set logging commands to record the Telnet session to a file.

It is difficult to set up a connection profile to pre-define the localecho setting, the window size, and scroll-back. For this reason, PuTTY is probably a better choice.

Return to top of page

#### Windows NT Telnet

There are many reasons not to use Windows NT Telnet to connect to Hercules. Specifically:

- There are better solutions. PuTTY for example.
- Windows NT Telnet is licensed by Microsoft for use only when you have a valid Windows NT license. If you find a copy floating around on the Internet, it's not properly licensed.
- If you do find it on the Internet, beware of the "gifts" that may have been added to the code.
- If you copy it from your NT installation CD, help does not work on Windows 10. And Hercules is not supported on Windows NT.

If, after all that, you decide to crank up your NT workstation to Telnet to Hercules on a more modern system, here's how you do it:

> Host Name: You can use "@ccuu" following the host name to connect to a specific printer-keyboard address in the Hercules configuration file. Example:

>                     localhost@001f

> Port: must match the value of the CNSLPORT statement in the Hercules configuration file. Although a drop-down box is shown, you can just type in a port number

> TermType: must be ANSI.

> | Local echo must be checked under Terminal Options. VT100/ANSI must be selected for Emulation.

Return to top of page