# 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), Solaris, FreeBSD, 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: #### Web documentation: 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 #### PDF manuals: Hercules General Information Hercules Reference Summary Hercules Installation Guide Hercules User Reference Guide Hercules Messages and Codes ### To download the current release version, use the following links: Source tarball: hercules-3.06.tar.gz Linux: hercules-3.06-1.i686.rpm: Intel RPM hercules-3.06-1.src.rpm: Source RPM (if you want to build RPMs yourself) Windows native program: hercules-3.06-native.msi: Windows Installer package hercules-3.06-native.exe: Binaries only self-extracting archive hercules-3.06-native.zip: Binaries only archive Note: Installing the .msi Windows Installer package ensures the required Microsoft Runtime components are installed and also provides convenience shortcuts in the programs menu. If the required components are already present and the shortcuts are not needed on the target system, the self-extracting or .zip archive may be used instead. The required component for this build is the x86 version of the C runtime at level 8.50727.762. Mac OS X: hercules-3.06-tiger.dmg: Mac OS X 10.4 (Tiger) universal binary version, 32-bit version only hercules-3.06-leopard.dmg: Mac OS X 10.5 (Leopard) universal binary version, 32-and 64-bit ### 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 “ I am running a fully graphical Centos z/Linux environment on my desktop. The Hercules emulator is an amazing feat of engineering. I just wanted to send my compliments to the team for an excellent job! Thanks much for making this product part of the open-source community! ” — Roby Gamboa “ I have DOS and DOS/VS running on Hercules with some demo applications, both batch and on-line. It does bring back some good memories. My compliments go to the Hercules team. Thank you. ” — Bill Carlborg “ This is stunning piece of work. To say that I am blown away is an understatement. I have a mainframe on my notebook!!!!!! P.S. Now if I can just remember my JCL ” — Roger Tunnicliffe Read Hesh Wiener's Technology News article about Hercules at http://www.tech-news.com/another/ap200601b.html 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://www2.marist.edu/htbin/wlvtype?LINUX-VM.25658 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.com. 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: 2009/01/09 15:23:50 $ $Revision: 1.63 $