Hercules 4.0 Hyperion


This web page provides information regarding the SoftDevLabs (SDL) version of Hercules 4.0, code named Hyperion.

The official Web Site for the SDL version of Hyperion:

The official web site for the SDL version of Hercules 4.0 Hyperion can be reached at the following URL:
Online documentation for the SDL version of Hercules 4.0 Hyperion
The above web site contains reference documentation for the SDL version of Hercules 4.0 Hyperion, which contains features, functionality and fixes that are neither in the current spinhawk production version of Hercules nor in the original 4.0 Hyperion version of Hercules.

PDF Manuals:

Some people find it more convenient for their reference documentation to be in the form of PDF manuals rather than via online web pages.

The following are links to PDF manuals containing technical information pertaining to the original 4.0 Hyperion version of Hercules (not the SDL version):
Note: the above PDF manuals might not exactly match the online documentation for the SDL version of Hercules, but for the time being they should be very close. The online documentation for my version however should always be correct. Please let me know if you discover it's not.

Issue Tracker:

Should you discover any bugs or have any issues using the SDL version of Hercules 4.0 Hyperion, you can directly report them by adding a new entry to SDL's GitHub Issue issue tracker database at the following URL:

Community Wiki:

GitHub, which hosts the source code repository for my version of Hercules 4.0 Hyperion, provides a Wiki feature that allows you the users to participate in helping make this version an even better version than it already is. Please consider helping out by contributing your knowledge to the effort.
The SoftDevLabs Hercules 4.0 Hyperion Wiki     (Please help by contributing your knowledge!)
The SoftDevLabs Hercules 4.0 Hyperion Wiki is intended to provide additional documentation such as Tips and Tricks that may be of interest to its user community. I strongly encourage users to help the user community (and themselves!) by contributing to the Wiki.  It will only ever be as good as you help make it!

Source Code Repository:

The complete source code for the SDL version of Hercules 4.0 Hyperion is maintained in a git project source code repository hosted on GitHub:

Building the SDL version of Hercules 4.0 Hyperion

If you wish to build the SDL version of Hercules 4.0 Hyperion for yourself from its distributed source code you can easily do so by simply following the build instructions on the following web page:
Building the SDL version Hercules from Source

Pre-built Binaries:

The current pre-built ready to run Windows binaries for the SoftDevLabs version of Hercules 4.0 Hyperion may be downloaded using the below links (the x64 links are for 64-bit Windows and the x86 links are for 32-bit Windows). The MD5 and SHA256 hashes for all SoftDevLabs downloads can be found on the downloads page.
  • Hercules-4.0.0.8873-SDL-ga36e0bbc-x64.zip   (2017-07-08)
  • Hercules-4.0.0.8873-SDL-ga36e0bbc-x86.zip   (2017-07-08)

    NOTE: snapshot 8873-SDL-ga36e0bbc contains a 6 year old bug that new code unintentionally trips causing Hyperion to crash if your configuration file contain an httpport or httproot statement. The bug has already been fixed and will appear in the next pre-built snapshot. To work around the bug, simply change your httpport and httproot statements (which have been deprecated) to the new http format instead.

    The above snapshot contains the following changes since the previous snapshot (listed in reverse order, most recent to least recent):

    • LCS: checksum offloading fix
    • QETH/OSA: 'iface', 'ipaddr' and 'netmask' are now all REQUIRED parameters
    • QETH/OSA: validate MTU and limit to iface maximum
    • Fix minor(?) qeth/osa multicast bug
    • Fix QETH initialization return code SNAFU
    • QETH: report dropped packets and implement finer grained debugging
    • Fix HSCH (Halt Subchannel) similarly to earlier CSCH fix
    • OSA/OSD: synonym for QETH device type
    • 'osa' = synonym for 'qeth' command + fix qeth command itself
    • Support for device custom sense bytes formatting
    • CTCI-WIN 'TUNSETDEBUG' ioctl support
    • ECPS 1.84; fix LRA assist bug with 2K page sizes (Bob Polmanter)
    • Fix qeth initalization return code SNAFU
    • qeth/osa: 'iface', 'ipaddr' and 'netmask' are required on Windows
    • Fix minor(?) qeth/osa layer 3 ipv4 multicast bug
    • Define "osa" as synonym for "qeth" command
    • Define OSA/OSD device equates for QETH devices
    • Define additional QETH command mask values (e.g. 'dropped')
    • QETH MTU fix
    • OSA/OSD may be specified on device statement instead of QETH
    • QETH/OSA device: report dropped packets ('qeth' command)
    • 'qeth' debugging command: define addtional mask options
    • QETH/OSA device statement: invalid 'mtu' option fix/workaround
    • TRACEOPT 'NOCH9OFLOW' option
    • New Hyperion terminal logo, just for fun!
    • Windows QETH fix
    • QETH/OSA/QDIO fixes (Ian Shorter)
    • Add help for 'qeth' debugging command
    • Fix Hyperion QETH Clear Subchannel issue
    • LCS source MAC fix (Ivan Warren)
    • Panel command recall depth increased to 255 maximum

  • Hercules-4.0.0.8845-SDL-g15c01ddb-x64.zip   (2017-06-06)
  • Hercules-4.0.0.8845-SDL-g15c01ddb-x86.zip   (2017-06-06)

    The above snapshot contains the following changes since the previous snapshot (listed in reverse order, most recent to least recent):

    • STIDP (Store CPU ID) fixes
    • Add optional arguments to 'cpu' and 'qcpuid' commands
    • ECPS:VM v1.83: DISP2 fixes (Bob Polmanter)
    • Limited automatic updating of LPARNUM and CPUIDFMT setting
    • Fix hdl_dlopen basename bug causing rare segfault at startup on some systems
    • QETH IPA_CMD_SETVMAC fix for Windows CTCI-WIN
    • ECPS:VM v1.82: LRA (Bob Polmanter)
    • Fix ltdl.h header include issue (Peter Coghlan)
    • Fix hthreads compile error on some systems (Peter Coghlan)
    • LCS Multicast Support
    • Fix numcpu/maxcpu and is/are cpus started bugs
    • Runtest fixes
    • Rexx rewrite. Many bugs uncovered and fixed.
    • Fix shcmdopt + diag8cmd handling
    • Improved printer device support
    • Fix logmsg routing/capturing to work as designed
    • C11 atomics fix
    • punch/printer append fix
    • Stub entries for STCCTM et al (Ivan Warren)
    • Minimum Windows Platform is now Windows Vista
    • CCKD config stmt/cmd 'nosfd' option
    • Remove OPTION_SHOWDVOL1 build option
    • ECPS:VM command processing fixes (Jurgen Winkelmann)
    • QETH handle IPv6 addresses better (Ian Shorter)
    • QDIO STORCHK: add key 14 special case (Ivan Warren)
    • Stricter DASD PSF PRSD parameter bytes validation (Mark Gaubatz)

  • Hercules-4.0.0.8775-SDL-g8fd17afd-x64.zip   (2017-02-21)
  • Hercules-4.0.0.8775-SDL-g8fd17afd-x86.zip   (2017-02-21)

    The above snapshot contains the following changes since the previous snapshot (listed in reverse order, most recent to least recent):

    • Full (almost) ECPS:VM support
    • QDIO thin interrupts support fix
    • Support for Read Subsystem Data suborder Query Host Access
    • Fix 'make check' for out-of-source debug builds
    • Add debug builds of all external packages to repository too
    • Fix dynamic version design to be more reliable/seemless
    • Hercules Automatic Operator (HAO) fixes
    • Fix for compiling on platforms with inttypes.h but no stdint.h
    • Fix for compiling with NO_IEEE_SUPPORT
    • Improve external package build instructions

  • Hercules-4.0.0.8745-SDL-ga014f9c-x64.zip   (2017-01-31)
  • Hercules-4.0.0.8745-SDL-ga014f9c-x86.zip   (2017-01-31)

    The above snapshot contains the following changes since the previous snapshot (listed in reverse order, most recent to least recent):

    • Additional ECPS:VM fixes and enhancements
    • Completely remove SYNCIO
    • Add VS2015 (MSBUILD) RunJobs support
    • Build missing ckd2cckd, cckd2ckd, fba2cfba and cfba2fba utilities
    • Add message# to usage/syntax messages for some more utilities
    • Fix git revision count bug
    • Fix for ECPS:VM second level LCTL bug
    • Add architecture levels 370, ESA, and 390
    • Remove never used "HelpMessage" function
    • Convert crypto to External Package and move dyncrypt to root dir
    • Document both old and new "fcb=" option formats
    • Add new "cctape=" carriage control tape option
    • Add BZIP2 compressed HET tape file and adjust test case
    • Define many more runtest pre-defined variables
    • Fix telnet client connection libtool abort on Linux
    • Fix SEGFAULT when invalid modpath given
    • VS2015 BuildLog s/b .txt, not .htm
    • Convert telnet to External Package

  • Hercules-4.0.0.8701-SDL-g151b31b-x64.zip   (2016-12-23)
  • Hercules-4.0.0.8701-SDL-g151b31b-x86.zip   (2016-12-23)

    The above snapshot contains the following changes since the previous snapshot (listed in reverse order, most recent to least recent):

    • Fix 'help' command to not truncate command names.
    • Identify "SDL" Hyperion in version string.
    • Update DASDLS utility to match 3.12's options.
    • Add message# to utility usage/syntax messages
    • Adjust earlier caching fix to accommodate DASD utilities.
    • Remove unused 'cache' command
    • Remove Legacy CMPSC code (altcmpsc.dll)
    • Minor runtest enhancements.
    • Test harness changes: add more crypto cases and verify against real iron.
    • Fix dyncrypt for VS2008 compatibility
    • Crypto KMCTR instruction fixes.
    • Save MODPATH as absolute path
    • Fix runtest self re-append bug
    • Restore HDL_DEPENDENCY_SECTION