# The Hercules System/370, ESA/390, and z/Architecture Emulator

Hercules is an open source software implementation of the mainframe System/370 and ESA/390 architectures, in addition to the new 64-bit z/Architecture. Hercules runs under Linux, Windows (98, NT, 2000, and XP), and Mac OS X (10.3 and later).

Hercules is OSI Certified Open Source Software licensed under the terms of the Q Public Licence.

Hercules was created by Roger Bowler and is maintained by Jay Maynard. Jan Jaeger designed and implemented many of the advanced features of Hercules, including dynamic reconfiguration, integrated console, interpretive execution and z/Architecture support. A dedicated crew of programmers is constantly at work implementing new features and fixing bugs.

### To find out more about Hercules, follow these links:

- Hercules Installation and Operation
- Hercules Configuration File
- Hercules System Messages
- What's new in this release
- Release notes
- Hercules Frequently-Asked Questions
- Technical Support
- The Q Public Licence

### To download the current release version, use the following links:

- Source tarball:

  - hercules-3.03.1.tar.gz

- Linux:

  - hercules-3.03.1-1.i686.rpm: Intel RPM
  - hercules-3.03.1-1.src.rpm: Source RPM (if you want to build RPMs yourself)

- Windows native program:

  - hercules-3.03.1-native.exe: Self-extracting archive
  - hercules-3.03.1-native.msi: Windows Installer package

- Cygwin for Windows self-extracting archives:

  - hercules-3.03.1-cygwin-p4.exe: Pentium 4
  - hercules-3.03.1-cygwin-i686.exe: Pentium Pro, Pentium II, Pentium III, and AMD Athlon and up
  - hercules-3.03.1-cygwin-i586.exe: Pentium and AMD K6

- Mac OS X:

  - hercules-3.03.1-panther.dmg: Mac OS X 10.3 (Panther) version (without internationalization)
  - herucles-3.03.1-tiger.dmg: Mac OS X 10.4 (Tiger) version (with internationalization)

### What people are saying about Hercules

“ Never in my wildest dreams did I expect to see MVS running on a machine that I personally own. Hercules is a marvelous tool. My thanks to you all for a job very well done. ”
— Reed H. Petty

“ I do miss my mainframe a lot, and playing with Herc sure brings back memories. Just seeing the IBM message prefixes, and responding to console messages again was a wonderful bit of nostalgia! ”
— Bob Brown

“ I have installed your absolutely fantastic /390 emulator. You won't believe what I felt when I saw the prompt. Congratulations, this is a terrific software. I really have not had such a fascinating and interesting time on my PC lately. ”
— IBM Large Systems Specialist

“ Such simulators have been available for a long time. One of the most complete (up to modern 64-bit z/Architecture) is hercules. ”
— Michel Hack, IBM Thomas J. Watson Research Center

“ An apparently excellent emulator that allows those open source developers with an "itch to scratch", to come to the S/390 table and contribute. ”
— Mike MacIsaac, IBM

“ BTW grab a copy of Hercules and you can test it at home. It's a very good S/390 and zSeries (S/390 64bit) emulator.. ”
— Alan Cox

“ It works even better than I imagined. Hercules is a fine piece of software! ”
— Dave Sienkiewicz

“ Hercules is a systems programmer's dream come true. ”
— René Vincent Jansen

“ Aside from the electric trains my parents got me in 1953, this is the best toy I've ever been given, bar none.”
— Jeffrey Broido

“ Congratulations to you and your team on a fine piece of work! ”
— Rich Smrcina

“ Congratulations on a magnificent achievement! ”
— Mike Ross

“ For anyone thinking running Hercules is too much trouble or too hard or whatever, I came home from work one day and my 13 year old 8th grade son had MVS running under VM under Hercules on Linux. He had gotten all the information about how to do this from the Internet. When he complained about MVS console configuration and figuring out how to get it to work with VM, I knew he had felt all the pain he ever needed to feel about mainframes. ”
— Scott Ledbetter, StorageTek

Read Moshe Bar's BYTE.com article about Hercules at http://www.byte.com/documents/s=429/byt20000801s0002/

For eighteen months, the IBM Redbook SG24-4987 Linux for S/390 at http://www.redbooks.ibm.com/abstracts/sg244987.html contained a chapter written by Richard Higson describing how to run Linux/390 under Hercules. Then suddenly, all mention of Hercules was mysteriously removed from the online edition of the book! Read the story of the disappearing Redbook chapter at http://www.trustsec.de/deb390/print.php?sid=26

View the foils from Jay Maynard's presentation given at SHARE Session 2880 in San Francisco on 20 August 2002 as a PDF file (815K) from http://linuxvm.org/Present/SHARE99/S2880JMa.pdf

### The CVS source code repository

The complete source code for the current development version of Hercules is also available via anonymous access from our CVS source code repository. The CVS root is:

CVSROOT=:pserver:anonymous@cvs.hercules-390.org:/usr/cvs/hercules

Doing a checkout on module "hercules" will get you the source for all of Hercules. No password is required; just press enter when asked:

> `cvs login
> (Logging in to anonymous@hercules-390.org...)
> CVS password:
> cvs -z9 co hercules
> cvs server: Updating hercules
> `

Please note that this will get you the current development version of Hercules, which is not release quality and thus might not even work (since it's still under development). If you want the current, stable, release version of Hercules (i.e. one that is known to work properly), then use the previously mentioned links instead.

Please read the file `README.CVS` included with the source for additional and updated instructions for building the development cvs version.

### Other Hercules-related sites

- http://www.ibiblio.org/jmaynard/
  Jay Maynard's IBM S/360 and S/370 Public Domain Software Collection

- http://www.bsp-gmbh.com/hercules
  Volker Bandke's Hercules site. This is the site for users of Hercules on Windows, and here you can also obtain Volker's MVS 3.8J turnkey system.

- http://www.softdevlabs.com/Hercules/hercgui-index.html
  Fish's Hercules GUI for Windows.

- http://www.homerow.net/hax/
  A whole host of unofficial Hercules add-ons and patches by Leland Lucius

- http://cbttape.org/~jmorrison/
  Jim Morrison's downloads (includes 3380 support for MVS 3.8!)

- http://www.jaymoseley.com/hercules
  Jay Moseley's Hercules site - lots of Hercules and MVS information

- http://www.tommysprinkle.com/mvs
  Tommy Sprinkle's MVS 3.8 documentation

- http://hansen-family.com/mvs
  Bob Hansen's MVS 3.8 documentation

- http://www.schaefernet.de/hercules
  Wolfgang Schäfer's Hercules site - MVT/MVS tutorials and add-ons

- http://www.kiyoinc.com/herc390.html
  Cory Hamasaki's New Users Documentation Effort

- http://www.kiyoinc.com/herc3088.html
  Axel Schwarzer's 3088 howto documentation

- http://pweb.uunet.de/schwarzer.d/projects/hercules/
  Axel Schwarzer's Hercules Documentation

If you have any questions or comments please consider joining the hercules-390 discussion group at http://groups.yahoo.com/group/hercules-390.

Bug reports (together with your diagnosis of the fault, please) may be sent to me, Jay Maynard, at jmaynard @ conmicro.cx.

IBM, System/370, ESA/390, and z/Architecture are trademarks or registered trademarks of IBM Corporation. Other product names mentioned here are trademarks of other companies.

Last updated $Date: 2005/12/29 10:38:33 $ $Revision: 1.49 $