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.

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

back

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):

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:

Windows Telnet settings

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:

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:

Windows NT Telnet connect dialog

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.

Windows NT Telnet terminal preferences dialog

Local echo must be checked under Terminal Options.

VT100/ANSI must be selected for Emulation.

Return to top of page


back