Hercules 4.0 (Hyperion)
You will need to amend the configuration file hercules.cnf to reflect your device layout and intended mode of operation (S/370, ESA/390, or z/Architecture). See the Hercules Configuration File page for a complete description. How to run Debian under Hercules would definitely be on-topic here, since Hercules is a software emulation of the hardware on which Debian for s390x was designed to run. If your question regards how to run Debian in a virtual machine under z/VM, that would also be on topic. But questions about how to run z/VM under Hercules are not on topic. You will need to amend the configuration file hercules.cnf to reflect your device layout and intended mode of operation (S/370, ESA/390, or z/Architecture). See the Hercules Configuration File page for a complete description. The Hercules mainframe emulator is a mainframe in software, and it runs all IBM mainframe operating systems, such as OS/360, OS/390, the z/OS family, and mainframe Linux. If you want to try out OS/390 or the current z/OS releases, good luck, because they have restrictive licenses that.
This is official web page for Hercules version 4.0, working titled 'Hyperion', the development version of Hercules. Hyperion is developed and supported by a small group of volunteers.
Hercules is an open source software implementation of the mainframe System/370 and ESA/390 architectures, in addition to the latest 64-bit z/Architecture. Hercules runs under Linux, Windows, Solaris, FreeBSD, and macOS. Hercules is licensed under the terms of the Q Public Licence. The Q Public License is certified as an open source license by the Open Software Initiative.
Using Hercules to Emulate a Mainframe
To emulate a mainframe using Hercules, you will need a few things:
- A suitable host computer.
- Hercules Installation and Setup Instructions
- Mainframe software, most often an operating system.
- Documentation for the software you plan to use.
Prior experience programming or supporting a mainframe operating operating system is not required but is very helpful.
Host Computer Capability
Hercules will run just fine on most modern desktop or laptop computers. Performance will depend on what you do with Hercules. Emulating a mainframe running DOS/360, one of IBM's oldest mainframe operating systems and one that would run in 16KiB of mainframe core memory, will require far fewer host system resources than, say, a more modern MVS 3.8j configured with 16MiB of emulated core and running a number of batch jobs. One of the mainframe ports of Linux will require still more resources.
On x86-based systems, Hercules will work on 32-bit and 64-bit systems. Hercules does not require hardware-based virtualization capabilities and runs fine on operating systems that are themselves running in a virtual environment such as Oracle Virtualbox.
Muliple cores on the host system are helpful when emulating a mainframe configured with multiple CPUs, but multiple cores are not a requirement.
Suitable Host platforms
- Windows: Windows XP x64 or Windows Server 2003 R2 or greater. Windows Vista or newer 32-bit or 64-bit will work.
- UNIX-like systems: Linux-based systems and FreeBSD. Solaris is supported when you build Hercules from source using CMake.
- macOS: Limited testing; feedback encouraged.
The above list is limited by the systems available to developers; we cannot afford to have one of everything. That said, we welcome feedback and issues from people who try to install on other platforms. One Hercules developer has installed on an emulated Raspberry Pi using QEMU.
Hercules Installation and Setup Instructions
Select the installation procedure appropriate for your system.
- Building Hercules for Windows Systems (Recommended). Uses CMake to build from source.
- Building Hercules for UNIX-like Systems (Recommended). Uses CMake to build from source.
- Hercules Installation for macOS Systems (Recommended). Uses CMake to build from source.
- Installation Using Legacy Tools. Uses makefile.bat/NMake (Windows) or GNU Autotools (UNIX-like systems and macOS) to build from source. Includes Windows binaries installation instructions. Useful if you encounter problems using CMake to build from source.
Most of the mainframe system web sites below include configuration instructions, sample configuration files, and in some cases, pre-built emulated DASD files. Some do not. The following links can be used to complete the setup of a Hercules emulated mainframe system.
- Configuration File. Create a configuration file that defines the system configuration including I/O devices.
- Creating DASD. Create emulated DASD volumes for attachment to an emulated mainframe.
- Compressed DASD Emulation. Create emulated DASD volumes using compression to reduce host computer disk space needs.
- Telnet/tn3270 Console How-To. Connect to an emulated mainframe 3270 device, 3270 operator console, and/or 1052 or 3215 printer-keyboard.
- Operating Procedures. Hercules command line parameters, panel commands, keyboard use, and the Hercules Automatic Operator (HAO).
Mainframe Software
You have a number of choices, and you are not limited to the packages listed here. IBM DOS/VS and IBM DOS/360 pre-date and bear absolutely no resemblance to PC-DOS or MS-DOS.
Note that if you run mainframe software within Hercules, you must respect the terms and conditions of the software license for that software.
- IBM MVS. Jay Moseley has a very complete tutorial for installing and running MVS 3.8j, IBM's last release of MVS.
- Turnkey MVS systems. There are at least two. Each includes its own copy of Hercules. If a Turnkey system suits you, with its pre-installed mainframe operating system, there is no need to install Hercules from this site.
- Volker Bandke's MVS Tur(n)key System
- Jürgen Winkelmann's TK4-
- IBM OS/360 MVT, a non-virtual storage operating system. Jay Maynard has a good installation procedure at Introduction to Generating and Running OS/360 on Hercules
- IBM DOS/VS. See Yahoo user ceo1944's 2314DOS.zip. This link downloads a zip archive of JCL and instructions from the Yahoo group H390-DOS/VS; free registration required.
- IBM DOS/360. There are at least four installation procedures available. The first three are in the H390-DOS/VS Yahoo group (free registration required) and the fourth is a stand-alone web site.
- Bill Carlborg's DOS360-2314.zip (downloads a .zip archive).
- Ben Huntsman's DYI-DOS360.zip (downloads a .zip archive).
- Kevin Leonard's DOS-360 26.2
- https://sites.google.com/site/dos360install/. This site is loosely modeled on Jay Moseley's MVS 3.8j site noted above.
- IBM VM/370. See the VM/370 R6, page on the cbttape.org site. Turnkey versions of VM/370 are available on David Wade's G4UGM's Vintage and Classic Computer pages
- Linux. Mainframe versions exist for the following. Some of these are not open source, and installation generally requires configuration of a mainframe Channel-to-Channel adapter to enable network connectivity for installation and/or post-install security updates.
- Debian Download a s390x CD or DVD.
- Fedora. Scroll down the page until you reach 's390x Architecture' at the bottom of the page.
- Gentoo. The s390x is included under '(experimental)' for 'Experimental architectures'. You know what that means.
- Red Hat. Paid license or 30-day trial only. Red Hat supports Fedora as its open source alternative.
- SUSE Enterprise Server. Paid license or 60-day trial only.
- Michigan Terminal System (MTS). The Michigan Terminal System Archive includes a turnkey distribution that has been tailored for use with Hercules. Additional helpful information may be found at https://try-mts.com/why-try-mts/
- SATK. Harold Grovesteen's Stand Alone Tool Kit offers a collection of tools for creating mainframe assembly language programs on your computer for later execution within Hercules. The binary floating point test programs and scripts were created using SATK and serve as examples for the assembler's capabilities and use.
- TXXOS. Tommy Sprinkle's 'Bare Metal Programming for the IBM 370 Mainframe' web site walks you step-by-step from IPL'ing a simple listing program through building a disk-resident operating system.
See Frequently Asked Questions, starting with question 2.01 Can it run z/OS, z/VM, z/VSE? for more details on available operating systems and licensing matters.
Mainframe Software Documentation
Installing Z Vm On Hercules Tv
Documentation for the Linux distributions, the Michigan Terminal System, SATK, and TXXOS may be found on their respective web sites.
Documentation for the IBM operating systems is a different matter; much of it was published before the Internet existed. The Bitsavers site and its mirrors contain a repository of scanned, and in some cases, OCR'd, IBM hardware and software reference manuals. The DOS360Install site has a couple of essential DOS/360 manuals that are not on Bitsavers.
Bitsavers is organized first by manufacturer, then by machine. Within machine one can find operating system documentation. Use the following shortcuts to the Bitsavers site. And explore...one can find very useful information in unexpected places on Bitsavers.
- System/360 hardware & software manuals
- System/370 hardware & software manuals
- MVS software manuals. Also see OS/VS2 software manuals. OS/VS2 was IBM's original name for MVS.
Hercules Documentation and Useful Links
Z/vse
The Web/HTML documentation is in a 'how-to' style with examples. The downloadable PDFs are comprehensive reference documentation.
Installing Z Vm On Hercules Poirot
Web/HTML | Downloadable PDFs |
---|
Additional helpful links
About Hercules
Hercules was created by Roger Bowler.Jay Maynard ('the Tron Guy') was the maintainer from 2000 to 2012.Jan Jaeger designed and implemented many of the advanced features ofHercules, including dynamic reconfiguration, integrated console,interpretive execution and z/Architecture support. A dedicated crew ofprogrammers is constantly at work implementing new features and fixing bugs.
What people are saying about Hercules
'Never in my wildest dreams did I expect to see MVSrunning on a machine that I personally own.Hercules is a marvelous tool. My thanks to you all for a jobvery well done.'
—Reed H. Petty
'I do miss my mainframe a lot, and playing with Herc sure brings backmemories. Just seeing the IBM message prefixes, and responding toconsole 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 interestingtime on my PC lately.'
—IBM Large Systems Specialist
Installing Z Vm On Hercules Mulligan
'Such simulators have been available for a long time. One of the mostcomplete (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 sourcedevelopers with an 'itch to scratch', to come to the S/390 tableand 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 gotme 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 hardor whatever, I came home from work one day and my 13 year old 8thgrade son had MVS running under VM under Hercules on Linux. He hadgotten all the information about how to do this from the Internet.When he complained about MVS console configuration and figuring outhow to get it to work with VM, I knew he had felt all the pain heever 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 withsome demo applications, both batch and on-line. It does bring backsome 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 anunderstatement. 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 athttp://www.tech-news.com/another/ap200601b.html
Read Moshe Bar's BYTE.com article about Hercules athttp://web.archive.org/web/20010712143133/http://www.byte.com/documents/s=429/BYT20000801S0002/
For eighteen months, the IBM RedbookSG24-4987 Linux for S/390 athttp://www.redbooks.ibm.com/abstracts/sg244987.htmlcontained a chapter written by Richard Higsondescribing how to run Linux/390 under Hercules.Then suddenly, all mention of Hercules was mysteriouslyremoved from the online edition of the book!Read the story of the disappearing Redbook chapter athttp://www2.marist.edu/htbin/wlvtype?LINUX-VM.25658
View the foils from Jay Maynard's presentation given atSHARE Session 2880in San Francisco on 20 August 2002as a PDF file (815K) fromhttp://linuxvm.org/Present/SHARE99/S2880JMa.pdf
If you have any questions or comments please consider joining the hercules-390 discussion group athttp://groups.yahoo.com/group/hercules-390.
Bug reports for either release (together with your diagnosis of the fault, please)may be reported to either thehercules-390 discussion groupor entered into the appropriate Github issue tracker:
- Issues with the spinhawk version of Hercules
Other Hercules-related sites
- http://www.softdevlabs.com
Windows GUI for Hercules 4.0 Hyperion and other Hercules related software. - http://www.bsp-gmbh.com/hercules/index.shtml
Volker Bandke's ready-to-run MVS 3.8J turnkey system and all things MVS. - 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.clueful.co.uk/mbeattie/hercules/tso.html
Malcolm Beattie's MVT/TSO documentation - http://www.ibiblio.org/jmaynard
Jay Maynard's S/360 and S/370 public domain software archive - http://www.shedlock.org/Shedlock/Hercules/index.html
George Shedlock's archive of DOS/VS Release 34 and VM/370 software, books, and information - http://www.smrcc.org.uk/members/g4ugm/VM370.htm
Dave Wade's VM/370 archive - http://perso.wanadoo.es/rptv2005/en/index.html
Rafael Pereira's Standalone Programs and 1401 simulator project - http://timpinkawa.net/hercules/
Tim Pinkawa's Hercules Page - http://www.lightlink.com/mhp/2703/
Max Parke's Hercules 2703 Page - TTY, TCAM, 3705 and more - https://github.com/s390guy/SATK
Harold Grovesteen's Stand-Alone Tool Kit (SATK)
IBM, System/370, ESA/390, and z/Architecture are trademarks orregistered trademarks of IBM Corporation.Other product names mentioned here are trademarks of other companies.
Hercules 4.0 (Hyperion)
This is official web page for Hercules version 4.0, working titled 'Hyperion', the development version of Hercules. Hyperion is developed and supported by a small group of volunteers.
Hercules is an open source software implementation of the mainframe System/370 and ESA/390 architectures, in addition to the latest 64-bit z/Architecture. Hercules runs under Linux, Windows, Solaris, FreeBSD, and macOS. Hercules is licensed under the terms of the Q Public Licence. The Q Public License is certified as an open source license by the Open Software Initiative.
Using Hercules to Emulate a Mainframe
To emulate a mainframe using Hercules, you will need a few things:
- A suitable host computer.
- Hercules Installation and Setup Instructions
- Mainframe software, most often an operating system.
- Documentation for the software you plan to use.
Prior experience programming or supporting a mainframe operating operating system is not required but is very helpful.
Host Computer Capability
Hercules will run just fine on most modern desktop or laptop computers. Performance will depend on what you do with Hercules. Emulating a mainframe running DOS/360, one of IBM's oldest mainframe operating systems and one that would run in 16KiB of mainframe core memory, will require far fewer host system resources than, say, a more modern MVS 3.8j configured with 16MiB of emulated core and running a number of batch jobs. One of the mainframe ports of Linux will require still more resources.
On x86-based systems, Hercules will work on 32-bit and 64-bit systems. Hercules does not require hardware-based virtualization capabilities and runs fine on operating systems that are themselves running in a virtual environment such as Oracle Virtualbox.
Muliple cores on the host system are helpful when emulating a mainframe configured with multiple CPUs, but multiple cores are not a requirement.
Suitable Host platforms
- Windows: Windows XP x64 or Windows Server 2003 R2 or greater. Windows Vista or newer 32-bit or 64-bit will work.
- UNIX-like systems: Linux-based systems and FreeBSD. Solaris is supported when you build Hercules from source using CMake.
- macOS: Limited testing; feedback encouraged.
Hercules Installation and Setup Instructions
Select the installation procedure appropriate for your system.
- Building Hercules for Windows Systems (Recommended). Uses CMake to build from source.
- Building Hercules for UNIX-like Systems (Recommended). Uses CMake to build from source.
- Hercules Installation for macOS Systems (Recommended). Uses CMake to build from source.
- Installation Using Legacy Tools. Uses makefile.bat/NMake (Windows) or GNU Autotools (UNIX-like systems and macOS) to build from source. Includes Windows binaries installation instructions. Useful if you encounter problems using CMake to build from source.
Most of the mainframe system web sites below include configuration instructions, sample configuration files, and in some cases, pre-built emulated DASD files. Some do not. The following links can be used to complete the setup of a Hercules emulated mainframe system.
- Configuration File. Create a configuration file that defines the system configuration including I/O devices.
- Creating DASD. Create emulated DASD volumes for attachment to an emulated mainframe.
- Compressed DASD Emulation. Create emulated DASD volumes using compression to reduce host computer disk space needs.
- Telnet/tn3270 Console How-To. Connect to an emulated mainframe 3270 device, 3270 operator console, and/or 1052 or 3215 printer-keyboard.
- Operating Procedures. Hercules command line parameters, panel commands, keyboard use, and the Hercules Automatic Operator (HAO).
Mainframe Software
You have a number of choices, and you are not limited to the packages listed here. IBM DOS/VS and IBM DOS/360 pre-date and bear absolutely no resemblance to PC-DOS or MS-DOS.
Note that if you run mainframe software within Hercules, you must respect the terms and conditions of the software license for that software.
- IBM MVS. Jay Moseley has a very complete tutorial for installing and running MVS 3.8j, IBM's last release of MVS.
- Turnkey MVS systems. There are at least two. Each includes its own copy of Hercules. If a Turnkey system suits you, with its pre-installed mainframe operating system, there is no need to install Hercules from this site.
- Volker Bandke's MVS Tur(n)key System
- Jürgen Winkelmann's TK4-
- IBM OS/360 MVT, a non-virtual storage operating system. Jay Maynard has a good installation procedure at Introduction to Generating and Running OS/360 on Hercules
- IBM DOS/VS. See Yahoo user ceo1944's 2314DOS.zip. This link downloads a zip archive of JCL and instructions from the Yahoo group H390-DOS/VS; free registration required.
- IBM DOS/360. There are at least four installation procedures available. The first three are in the H390-DOS/VS Yahoo group (free registration required) and the fourth is a stand-alone web site.
- Bill Carlborg's DOS360-2314.zip (downloads a .zip archive).
- Ben Huntsman's DYI-DOS360.zip (downloads a .zip archive).
- Kevin Leonard's DOS-360 26.2
- https://sites.google.com/site/dos360install/. This site is loosely modeled on Jay Moseley's MVS 3.8j site noted above.
- IBM VM/370. See the VM/370 R6, page on the cbttape.org site. Turnkey versions of VM/370 are available on David Wade's G4UGM's Vintage and Classic Computer pages
- Linux. Mainframe versions exist for the following. Some of these are not open source, and installation generally requires configuration of a mainframe Channel-to-Channel adapter to enable network connectivity for installation and/or post-install security updates.
- Debian Download a s390x CD or DVD.
- Fedora. Scroll down the page until you reach 's390x Architecture' at the bottom of the page.
- Gentoo. The s390x is included under '(experimental)' for 'Experimental architectures'. You know what that means.
- Red Hat. Paid license or 30-day trial only. Red Hat supports Fedora as its open source alternative.
- SUSE Enterprise Server. Paid license or 60-day trial only.
- Michigan Terminal System (MTS). The Michigan Terminal System Archive includes a turnkey distribution that has been tailored for use with Hercules. Additional helpful information may be found at https://try-mts.com/why-try-mts/
- SATK. Harold Grovesteen's Stand Alone Tool Kit offers a collection of tools for creating mainframe assembly language programs on your computer for later execution within Hercules. The binary floating point test programs and scripts were created using SATK and serve as examples for the assembler's capabilities and use.
- TXXOS. Tommy Sprinkle's 'Bare Metal Programming for the IBM 370 Mainframe' web site walks you step-by-step from IPL'ing a simple listing program through building a disk-resident operating system.
See Frequently Asked Questions, starting with question 2.01 Can it run z/OS, z/VM, z/VSE? for more details on available operating systems and licensing matters.
Mainframe Software Documentation
Installing Z Vm On Hercules Tv
Documentation for the Linux distributions, the Michigan Terminal System, SATK, and TXXOS may be found on their respective web sites.
Documentation for the IBM operating systems is a different matter; much of it was published before the Internet existed. The Bitsavers site and its mirrors contain a repository of scanned, and in some cases, OCR'd, IBM hardware and software reference manuals. The DOS360Install site has a couple of essential DOS/360 manuals that are not on Bitsavers.
Bitsavers is organized first by manufacturer, then by machine. Within machine one can find operating system documentation. Use the following shortcuts to the Bitsavers site. And explore...one can find very useful information in unexpected places on Bitsavers.
- System/360 hardware & software manuals
- System/370 hardware & software manuals
- MVS software manuals. Also see OS/VS2 software manuals. OS/VS2 was IBM's original name for MVS.
Hercules Documentation and Useful Links
Z/vse
The Web/HTML documentation is in a 'how-to' style with examples. The downloadable PDFs are comprehensive reference documentation.
Installing Z Vm On Hercules Poirot
Web/HTML | Downloadable PDFs |
---|
Additional helpful links
About Hercules
Hercules was created by Roger Bowler.Jay Maynard ('the Tron Guy') was the maintainer from 2000 to 2012.Jan Jaeger designed and implemented many of the advanced features ofHercules, including dynamic reconfiguration, integrated console,interpretive execution and z/Architecture support. A dedicated crew ofprogrammers is constantly at work implementing new features and fixing bugs.
What people are saying about Hercules
'Never in my wildest dreams did I expect to see MVSrunning on a machine that I personally own.Hercules is a marvelous tool. My thanks to you all for a jobvery well done.'
—Reed H. Petty
'I do miss my mainframe a lot, and playing with Herc sure brings backmemories. Just seeing the IBM message prefixes, and responding toconsole 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 interestingtime on my PC lately.'
—IBM Large Systems Specialist
Installing Z Vm On Hercules Mulligan
'Such simulators have been available for a long time. One of the mostcomplete (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 sourcedevelopers with an 'itch to scratch', to come to the S/390 tableand 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 gotme 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 hardor whatever, I came home from work one day and my 13 year old 8thgrade son had MVS running under VM under Hercules on Linux. He hadgotten all the information about how to do this from the Internet.When he complained about MVS console configuration and figuring outhow to get it to work with VM, I knew he had felt all the pain heever 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 withsome demo applications, both batch and on-line. It does bring backsome 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 anunderstatement. 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 athttp://www.tech-news.com/another/ap200601b.html
Read Moshe Bar's BYTE.com article about Hercules athttp://web.archive.org/web/20010712143133/http://www.byte.com/documents/s=429/BYT20000801S0002/
For eighteen months, the IBM RedbookSG24-4987 Linux for S/390 athttp://www.redbooks.ibm.com/abstracts/sg244987.htmlcontained a chapter written by Richard Higsondescribing how to run Linux/390 under Hercules.Then suddenly, all mention of Hercules was mysteriouslyremoved from the online edition of the book!Read the story of the disappearing Redbook chapter athttp://www2.marist.edu/htbin/wlvtype?LINUX-VM.25658
View the foils from Jay Maynard's presentation given atSHARE Session 2880in San Francisco on 20 August 2002as a PDF file (815K) fromhttp://linuxvm.org/Present/SHARE99/S2880JMa.pdf
If you have any questions or comments please consider joining the hercules-390 discussion group athttp://groups.yahoo.com/group/hercules-390.
Bug reports for either release (together with your diagnosis of the fault, please)may be reported to either thehercules-390 discussion groupor entered into the appropriate Github issue tracker:
- Issues with the spinhawk version of Hercules
Other Hercules-related sites
- http://www.softdevlabs.com
Windows GUI for Hercules 4.0 Hyperion and other Hercules related software. - http://www.bsp-gmbh.com/hercules/index.shtml
Volker Bandke's ready-to-run MVS 3.8J turnkey system and all things MVS. - 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.clueful.co.uk/mbeattie/hercules/tso.html
Malcolm Beattie's MVT/TSO documentation - http://www.ibiblio.org/jmaynard
Jay Maynard's S/360 and S/370 public domain software archive - http://www.shedlock.org/Shedlock/Hercules/index.html
George Shedlock's archive of DOS/VS Release 34 and VM/370 software, books, and information - http://www.smrcc.org.uk/members/g4ugm/VM370.htm
Dave Wade's VM/370 archive - http://perso.wanadoo.es/rptv2005/en/index.html
Rafael Pereira's Standalone Programs and 1401 simulator project - http://timpinkawa.net/hercules/
Tim Pinkawa's Hercules Page - http://www.lightlink.com/mhp/2703/
Max Parke's Hercules 2703 Page - TTY, TCAM, 3705 and more - https://github.com/s390guy/SATK
Harold Grovesteen's Stand-Alone Tool Kit (SATK)
IBM, System/370, ESA/390, and z/Architecture are trademarks orregistered trademarks of IBM Corporation.Other product names mentioned here are trademarks of other companies.
Hercules 4.0 (Hyperion)
This is official web page for Hercules version 4.0, working titled 'Hyperion', the development version of Hercules. Hyperion is developed and supported by a small group of volunteers.
Hercules is an open source software implementation of the mainframe System/370 and ESA/390 architectures, in addition to the latest 64-bit z/Architecture. Hercules runs under Linux, Windows, Solaris, FreeBSD, and macOS. Hercules is licensed under the terms of the Q Public Licence. The Q Public License is certified as an open source license by the Open Software Initiative.
Using Hercules to Emulate a Mainframe
To emulate a mainframe using Hercules, you will need a few things:
- A suitable host computer.
- Hercules Installation and Setup Instructions
- Mainframe software, most often an operating system.
- Documentation for the software you plan to use.
Prior experience programming or supporting a mainframe operating operating system is not required but is very helpful.
Host Computer Capability
Hercules will run just fine on most modern desktop or laptop computers. Performance will depend on what you do with Hercules. Emulating a mainframe running DOS/360, one of IBM's oldest mainframe operating systems and one that would run in 16KiB of mainframe core memory, will require far fewer host system resources than, say, a more modern MVS 3.8j configured with 16MiB of emulated core and running a number of batch jobs. One of the mainframe ports of Linux will require still more resources.
On x86-based systems, Hercules will work on 32-bit and 64-bit systems. Hercules does not require hardware-based virtualization capabilities and runs fine on operating systems that are themselves running in a virtual environment such as Oracle Virtualbox.
Muliple cores on the host system are helpful when emulating a mainframe configured with multiple CPUs, but multiple cores are not a requirement.
Suitable Host platforms
- Windows: Windows XP x64 or Windows Server 2003 R2 or greater. Windows Vista or newer 32-bit or 64-bit will work.
- UNIX-like systems: Linux-based systems and FreeBSD. Solaris is supported when you build Hercules from source using CMake.
- macOS: Limited testing; feedback encouraged.
The above list is limited by the systems available to developers; we cannot afford to have one of everything. That said, we welcome feedback and issues from people who try to install on other platforms. One Hercules developer has installed on an emulated Raspberry Pi using QEMU.
Hercules Installation and Setup Instructions
Select the installation procedure appropriate for your system.
- Building Hercules for Windows Systems (Recommended). Uses CMake to build from source.
- Building Hercules for UNIX-like Systems (Recommended). Uses CMake to build from source.
- Hercules Installation for macOS Systems (Recommended). Uses CMake to build from source.
- Installation Using Legacy Tools. Uses makefile.bat/NMake (Windows) or GNU Autotools (UNIX-like systems and macOS) to build from source. Includes Windows binaries installation instructions. Useful if you encounter problems using CMake to build from source.
Most of the mainframe system web sites below include configuration instructions, sample configuration files, and in some cases, pre-built emulated DASD files. Some do not. The following links can be used to complete the setup of a Hercules emulated mainframe system.
- Configuration File. Create a configuration file that defines the system configuration including I/O devices.
- Creating DASD. Create emulated DASD volumes for attachment to an emulated mainframe.
- Compressed DASD Emulation. Create emulated DASD volumes using compression to reduce host computer disk space needs.
- Telnet/tn3270 Console How-To. Connect to an emulated mainframe 3270 device, 3270 operator console, and/or 1052 or 3215 printer-keyboard.
- Operating Procedures. Hercules command line parameters, panel commands, keyboard use, and the Hercules Automatic Operator (HAO).
Mainframe Software
You have a number of choices, and you are not limited to the packages listed here. IBM DOS/VS and IBM DOS/360 pre-date and bear absolutely no resemblance to PC-DOS or MS-DOS.
Note that if you run mainframe software within Hercules, you must respect the terms and conditions of the software license for that software.
- IBM MVS. Jay Moseley has a very complete tutorial for installing and running MVS 3.8j, IBM's last release of MVS.
- Turnkey MVS systems. There are at least two. Each includes its own copy of Hercules. If a Turnkey system suits you, with its pre-installed mainframe operating system, there is no need to install Hercules from this site.
- Volker Bandke's MVS Tur(n)key System
- Jürgen Winkelmann's TK4-
- IBM OS/360 MVT, a non-virtual storage operating system. Jay Maynard has a good installation procedure at Introduction to Generating and Running OS/360 on Hercules
- IBM DOS/VS. See Yahoo user ceo1944's 2314DOS.zip. This link downloads a zip archive of JCL and instructions from the Yahoo group H390-DOS/VS; free registration required.
- IBM DOS/360. There are at least four installation procedures available. The first three are in the H390-DOS/VS Yahoo group (free registration required) and the fourth is a stand-alone web site.
- Bill Carlborg's DOS360-2314.zip (downloads a .zip archive).
- Ben Huntsman's DYI-DOS360.zip (downloads a .zip archive).
- Kevin Leonard's DOS-360 26.2
- https://sites.google.com/site/dos360install/. This site is loosely modeled on Jay Moseley's MVS 3.8j site noted above.
- IBM VM/370. See the VM/370 R6, page on the cbttape.org site. Turnkey versions of VM/370 are available on David Wade's G4UGM's Vintage and Classic Computer pages
- Linux. Mainframe versions exist for the following. Some of these are not open source, and installation generally requires configuration of a mainframe Channel-to-Channel adapter to enable network connectivity for installation and/or post-install security updates.
- Debian Download a s390x CD or DVD.
- Fedora. Scroll down the page until you reach 's390x Architecture' at the bottom of the page.
- Gentoo. The s390x is included under '(experimental)' for 'Experimental architectures'. You know what that means.
- Red Hat. Paid license or 30-day trial only. Red Hat supports Fedora as its open source alternative.
- SUSE Enterprise Server. Paid license or 60-day trial only.
- Michigan Terminal System (MTS). The Michigan Terminal System Archive includes a turnkey distribution that has been tailored for use with Hercules. Additional helpful information may be found at https://try-mts.com/why-try-mts/
- SATK. Harold Grovesteen's Stand Alone Tool Kit offers a collection of tools for creating mainframe assembly language programs on your computer for later execution within Hercules. The binary floating point test programs and scripts were created using SATK and serve as examples for the assembler's capabilities and use.
- TXXOS. Tommy Sprinkle's 'Bare Metal Programming for the IBM 370 Mainframe' web site walks you step-by-step from IPL'ing a simple listing program through building a disk-resident operating system.
See Frequently Asked Questions, starting with question 2.01 Can it run z/OS, z/VM, z/VSE? for more details on available operating systems and licensing matters.
Mainframe Software Documentation
Documentation for the Linux distributions, the Michigan Terminal System, SATK, and TXXOS may be found on their respective web sites.
Documentation for the IBM operating systems is a different matter; much of it was published before the Internet existed. The Bitsavers site and its mirrors contain a repository of scanned, and in some cases, OCR'd, IBM hardware and software reference manuals. The DOS360Install site has a couple of essential DOS/360 manuals that are not on Bitsavers.
Bitsavers is organized first by manufacturer, then by machine. Within machine one can find operating system documentation. Use the following shortcuts to the Bitsavers site. And explore...one can find very useful information in unexpected places on Bitsavers.
- System/360 hardware & software manuals
- System/370 hardware & software manuals
- MVS software manuals. Also see OS/VS2 software manuals. OS/VS2 was IBM's original name for MVS.
Hercules Documentation and Useful Links
The Web/HTML documentation is in a 'how-to' style with examples. The downloadable PDFs are comprehensive reference documentation.
Web/HTML | Downloadable PDFs |
---|
Additional helpful links
About Hercules
Hercules was created by Roger Bowler.Jay Maynard ('the Tron Guy') was the maintainer from 2000 to 2012.Jan Jaeger designed and implemented many of the advanced features ofHercules, including dynamic reconfiguration, integrated console,interpretive execution and z/Architecture support. A dedicated crew ofprogrammers is constantly at work implementing new features and fixing bugs.
What people are saying about Hercules
'Never in my wildest dreams did I expect to see MVSrunning on a machine that I personally own.Hercules is a marvelous tool. My thanks to you all for a jobvery well done.'
—Reed H. Petty
'I do miss my mainframe a lot, and playing with Herc sure brings backmemories. Just seeing the IBM message prefixes, and responding toconsole 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 interestingtime on my PC lately.'
—IBM Large Systems Specialist
'Such simulators have been available for a long time. One of the mostcomplete (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 sourcedevelopers with an 'itch to scratch', to come to the S/390 tableand 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 gotme 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 hardor whatever, I came home from work one day and my 13 year old 8thgrade son had MVS running under VM under Hercules on Linux. He hadgotten all the information about how to do this from the Internet.When he complained about MVS console configuration and figuring outhow to get it to work with VM, I knew he had felt all the pain heever 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 withsome demo applications, both batch and on-line. It does bring backsome 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 anunderstatement. 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 athttp://www.tech-news.com/another/ap200601b.html
Read Moshe Bar's BYTE.com article about Hercules athttp://web.archive.org/web/20010712143133/http://www.byte.com/documents/s=429/BYT20000801S0002/
For eighteen months, the IBM RedbookSG24-4987 Linux for S/390 athttp://www.redbooks.ibm.com/abstracts/sg244987.htmlcontained a chapter written by Richard Higsondescribing how to run Linux/390 under Hercules.Then suddenly, all mention of Hercules was mysteriouslyremoved from the online edition of the book!Read the story of the disappearing Redbook chapter athttp://www2.marist.edu/htbin/wlvtype?LINUX-VM.25658
View the foils from Jay Maynard's presentation given atSHARE Session 2880in San Francisco on 20 August 2002as a PDF file (815K) fromhttp://linuxvm.org/Present/SHARE99/S2880JMa.pdf
If you have any questions or comments please consider joining the hercules-390 discussion group athttp://groups.yahoo.com/group/hercules-390.
Bug reports for either release (together with your diagnosis of the fault, please)may be reported to either thehercules-390 discussion groupor entered into the appropriate Github issue tracker:
- Issues with the spinhawk version of Hercules
Other Hercules-related sites
- http://www.softdevlabs.com
Windows GUI for Hercules 4.0 Hyperion and other Hercules related software. - http://www.bsp-gmbh.com/hercules/index.shtml
Volker Bandke's ready-to-run MVS 3.8J turnkey system and all things MVS. - 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.clueful.co.uk/mbeattie/hercules/tso.html
Malcolm Beattie's MVT/TSO documentation - http://www.ibiblio.org/jmaynard
Jay Maynard's S/360 and S/370 public domain software archive - http://www.shedlock.org/Shedlock/Hercules/index.html
George Shedlock's archive of DOS/VS Release 34 and VM/370 software, books, and information - http://www.smrcc.org.uk/members/g4ugm/VM370.htm
Dave Wade's VM/370 archive - http://perso.wanadoo.es/rptv2005/en/index.html
Rafael Pereira's Standalone Programs and 1401 simulator project - http://timpinkawa.net/hercules/
Tim Pinkawa's Hercules Page - http://www.lightlink.com/mhp/2703/
Max Parke's Hercules 2703 Page - TTY, TCAM, 3705 and more - https://github.com/s390guy/SATK
Harold Grovesteen's Stand-Alone Tool Kit (SATK)
IBM, System/370, ESA/390, and z/Architecture are trademarks orregistered trademarks of IBM Corporation.Other product names mentioned here are trademarks of other companies.