Skip to content

Instantly share code, notes, and snippets.

@ejlp12
Last active January 17, 2023 19:24
Show Gist options
  • Save ejlp12/4509af49d83551c03087 to your computer and use it in GitHub Desktop.
Save ejlp12/4509af49d83551c03087 to your computer and use it in GitHub Desktop.

Hercules - the Mainframe 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.

Website: http://www.hercules-390.org/

My system info:

uname -a
Darwin ejlp-macbook 14.3.0 Darwin Kernel Version 14.3.0: Mon Mar 23 11:59:05 PDT 2015; root:xnu-2782.20.48~5/RELEASE_X86_64 x86_64

First, trying installing it from the source but I had no luck, it was failed.

cd ~/playground
wget http://www.hercules-390.org/hercules-3.07.tar.gz
tar xvzf ../hercules-3.07.tar.gz
cd hercules-3.07

./util/cvslvlck
./configure

Got error:

hscutl.c:729:26: error: use of undeclared identifier 'SOL_TCP'
    rc = setsockopt(sfd, SOL_TCP, TCP_KEEPINTVL, &optval, sizeof(optval));
                         ^
hscutl.c:737:26: error: use of undeclared identifier 'SOL_TCP'
    rc = setsockopt(sfd, SOL_TCP, TCP_KEEPCNT, &optval, sizeof(optval));
                         ^
2 errors generated.
make[2]: *** [hscutl.lo] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2

There is a binary package for Mac OSX, so I decided to use it.

wget http://www.hercules-390.org/hercules-3.07-tiger.dmg
open hercules-3.07-tiger.dmg

After installation, run it:

hercules -f hercules.cnf

Find a 3270 terminal emulator for OS-X, and found x3270

wget http://prdownloads.sourceforge.net/x3270/suite3270-3.4ga9-src.tgz?download
mv suite3270-3.4ga9-src.tgz?download suite3270-3.4ga9-src.tgz
tar zxvf suite3270-3.4ga9-src.tgz
cd suite3270
./configure

Once again, I had no luck. I got following error:

configure: error: 'Cannot find X utilities or libraries'
configure: error: ./configure failed for x3270

Trying to solve by setting PATH:

PATH=/usr/X11R6/bin:${PATH};export PATH

Still got the same error. So I decided to find another 3270 terminal emulator software.

Found https://www.brown.edu/cis/tn3270/ and it has binary package for OS-X 10.3.9 and later Download the installer:

wget https://www.brown.edu/cis/tn3270/tn3270_X_3.4.0.dmg

Searching google for Z/OS: https://www.google.co.id/webhp?q=Z110SA+ZOS#safe=off&q=Z110SA+ZOS

and found this http://brinovec.net/Public/downloads/IBM%20ZOS%201.10/

Searching torrent file, and found these:

magnet:?xt=urn:btih:e1826ac07c6b87a30fc33122a473be4a83c7bb57&dn=zOS110&xl=17271833584&dl=17271833584&tr=udp://tracker.openbittorrent.com:80/announce
magnet:?xt=urn:btih:MD3UK2UG7RX66BJXX3RMESC2TBPEBVMV&dn=IBM+ADCD+Z%2FOS+1.10&tr=udp://tracker.publicbt.com:80/announce

Download the file, it is around 16 GB size.

@ejlp12
Copy link
Author

ejlp12 commented Dec 2, 2015

Mac OSX Installer:
image

Running hercules:
image

Try press "ESC" button in your keyboard to switch to semi graphical console that shows memory registers & systems information:
image

Try to open http://localhost:8081
image

tn3270 Package:
image

Run tn3270:
image

Click "Special" and change port number to 3270:
image

tn3270 connected to Hercules:
image

@brakmic
Copy link

brakmic commented Feb 10, 2020

Hi,

First, many thanks for the tutorial.

Regarding x3270, I was able to compile it for macOS Catalina 10.15.3.

I think you also need a window system like XQuartz
XQuartz can be installed with brew cask install xquartz

image_mvs

Regards,

@WolfTown0907
Copy link

The torrent exipred, where can I find a new one?

@r-r-p
Copy link

r-r-p commented Apr 12, 2021

Try this torrent:
magnet:?xt=urn:btih:60f7456a86fc6fef0537bee2c2485a985e40d595&dn=IBM%20ZOS%201.10&tr=udp%3a%2f%2ftracker.publicbt.com%3a80%2fannounce

@r-r-p
Copy link

r-r-p commented Apr 12, 2021

Also, this is different from the previous described distribution. See
http://s390soft.ru/_fr/0/zos_110_winter2.pdf

@rachejazz
Copy link

Thanks for this!

@Beheadedstraw
Copy link

The torrents are no longer working, can someone post a DDL or another working torrent?

@r-r-p
Copy link

r-r-p commented Feb 15, 2022

The magnet I left above seems to be active.

@Beheadedstraw
Copy link

Ah yea, I wasn't using a DHT compatible client. WTB seeders though =\

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment