http://mainframed767.tumblr.

com/post/40836059586/instructions-to-installing-zosin-hercules
IDentification DIVISION.
PROGRAM-ID. PROGADD.
DATA DIVISION.
WORKING-STORAGE SECTION.
01 NUM1 PIC 9(2) VALUE 10.
01 NUM2 PIC 9(2) VALUE 10.
01 OUT1 PIC 9(4) VALUE ZEROS.
01 OUT2 PIC 9(4) VALUE ZEROS.
01 OUT3 PIC 9(4) VALUE ZEROS.
PROCEDURE DIVISION.
PROCESS-PARA.
ADD NUM1 TO OUT1.
ADD NUM1, num2 TO OUT2.
ADD NUM1 NUM2 GIVING OUT3.
DISPLAY ' RES1 :' OUT1.
DISPLAY ' RES2 :' OUT2.
DISPLAY ' RES3 :' OUT3.
STOP RUN.
7.009999999999999787
7.010000228881835938
========= ==========
=====
=====
========= ============ ======
======
===
=== ====
===== =====
===
=========
====== ====== INSTALLIN' THAT SWEET SWEET
===
========
============= BIG IRON ON YOUR LINUX LAPTOP
===
=========
============= OR SERVER - BY MR. SKILLFULL
===
=== ====
=== === ===
========= ============ ===== = =====
========= ==========
=====
=====
THE GOOD FOLKS OVER AT THE HERCULES MAILING LIST WILL NEVER SHARE THIS. THATS WH
Y IVE DECIDED TO PUT TOGETHER INSTRUCTIONS TO INSTALL ZOS ON YOUR DEBIAN MACHINE
USING HERCULES. FOR THE PEOPLE. ILL TRY TO MAKE THIS AS EASY AS POSSIBLE BUT YO
URE ALL NEW TO ZOS SO IT WILL TAKE SOME TIME. GET A DEBIAN OR UBUNTU SYSTEM SPUN
UP BECAUSE THIS GUIDE WILL BE BEST FOLLOWED IN EITHER OF THOSE.
STEP 1: DOWNLOAD ZOS.
GET THE "IBM ZOS 1.10" TORRENT: magnet:?xt=urn:btih:653a0697533b42b495c1
8c0e06222a7b2e9af2c3
STEP 2: WHILE YOU WAIT FOR THE 16GB DOWNLOAD TO FINISH INSTALL GIT REXX C3270 AN
D BUILD-ESSENTIALS IN DEBIAN
sudo apt-get install git build-essential libtool automake autoconf libre
gina3-dev screen c3270
STEP 3: GET HERCULES 4.00 RUNNING
git clone https://github.com/hercules-390/hyperion.git
cd hercules-390
./autogen.sh
./configure --enable-cckd-bzip2 --enable-regina-rexx
make
sudo make install
STEP 4: TEST YOUR HERCULES

/usr/local/bin/hercules
THEN IN ANOTHER TERMINAL WINDOW
c3270 localhost:3270
IT SHOULD LOOK LIKE THIS:
/=======================================================================
\
|
|
| Hercules Version : 4.00
|
| Host name

: MS

| Host OS

: DEBIAN

|
|
| Host Architecture : x86
|
| Processors

: MP=2

| LPAR Name

: HERCULES

| Device number

: 0:001F

| Subchannel

: 0004

|
|
|
|
|
|
| HHH

HHH

The S/370, ESA/390 and z/Architecture

| HHH

HHH

Emulator

| HHH

HHH

| HHH

HHH EEEE RRR

|
|
|
CCC U U L

EEEE SSS

|
| HHHHHHHHHHHHHHHH E

R R C

U U L

| HHHHHHHHHHHHHHHH EEE RRR C

U U L

EEE

|
SS

|
| HHHHHHHHHHHHHHHH E
R R C
U U
LINES 38, 39 AND 40 REPLACE "/home/ehrocha/hercules/images/Z110/
" WITH "/home/<your user>/MAINFRAME/"
LINE 115 REPLACE "0E20.2 LCS 10.0.1.20" WITH "0E20.2 3088 CTC
I /dev/net/tun 1500 192.168.0.210 192.168.0.211 255.255.255.255" SUBSTITUTING YO
UR OWN NETWORK SUBNETS INSTEAD OF 192.168.0
OPTIONAL: CNSLPORT DEFINES THE PORT TO BE USED YOU CAN CHANGE TO
WHATEVER. THE CURRENT SETTING IS 23
STEP 6: LAUNCH ZOS
sudo /usr/local/bin/hercules -f /home/<your user>/MAINFRAME/CONF/ADCD_LI
NUX.CONF
IN A SEPERATE TERMINAL CONNECT WITH c3270
c3270 localhost:23

NOW BACK TO THE HERCULES WINDOW AND TYPE:

ipl a80
BACK TO YOUR c3270 WINDOW AND WAIT AS THE ZOS ENVIRONMENT BOOTS. IF IT L
OOKS LIKE IT STALLS OR SAYS WAITING JUST WAIT FOR A BIT AND IT WILL CONTINUE ON
ITS OWN. COULD TAKE 15 MINUTES OR MORE
ONCE ITS ALL DONE OPEN A THIRD WINDOW AND CONNECT TO 'localhost' AGAIN.
THIS MIGHT LOOK LIKE THE ORIGINAL HERCULES WINDOW. IF SO JUST CLOSE THAT CONNECT
ION AND WAIT A BIT LONGER.
IT SHOULD LOOK LIKE THIS
/=======================================================================
========\
|
|
| Mainframe Operating System
z/OS V
1.10
|
|
|
|
|
|
|
|
|
|
DDD U U ZZZZZ AAA
|
|
D D U U
Z A A
|
|
D D U U Z AAAAA
|
|
D D U U Z
A A
|
|
DDD
UUU ZZZZZ A A
|
|
|
|
|
|
|
|
Welcome to DUZA Mainframe System!
|
|
|
|
|
| TSO
- Logon to TSO/ISPF
SA
- System Automation
|
| CICS
- CICS System
TWS
- Workload Scheduler
|
| IMS
- IMS System
|
|
|
| Enter your choice==>
|
| Enter one of above commands in red

|
|
|
47

| Your IP(
|
|

), SNA LU(LCL702 )

01/17/13 03:55:

|
\=======================================================================
========/
STEP 7: LOGGING ON
AT THE "==>" PROMPT ENTER "TSO". YOULL BE ASKED FOR A USER ID ENTER "IBM
USER". YOULL THEN BE ASKED FOR THE PASSWORD ENTER "SYS1".
EVENTUALLY YOULL SEE 'ispf' FOLLOWED BY '***'. HIT ENTER.
WELCOME TO ZOS!
YOU DID IT, THATS ALL THERE IS TO IT REALLY. NOW GO LEARN HOW TO INSTALL GCCMVS
OR HOW TO COMPILE C PROGRAMS IN OMVS (HINT: AT THE Command ===> PROMPT TYPE "TSO
OMVS" FOR SOME UNIX GOODNESS)
**** OPTIONAL BUT RECOMMENDED ****
STEP 8: GETTING NETWORKING GOING
FROM THE ISPF MENU SCREEN TYPE "3.4"
REPLACE "IBMUSER" WITH "DUZA" AND HIT ENTER
HIT PAGE DOWN AND FIND "DUZA.TCPPARMS"
ON THAT SAME LINE THREE CHARACTERS TO THE LEFT FROM THE LETTER "D" IN "D
UZA" TYPE THE LETTER "E" AND HIT ENTER
ON THE FIRST BLANK LINE NEXT TO "PROFILE" TYPE THE LETTER "E" AND HIT EN
TER
PAGE DOWN TO LINE 90 WHICH WILL LOOK LIKE THIS:
000090
000091
000092
000093
000094
000095
000096
000097
000098
000099

DEVICE LCS1 LCS

E20
LINK ETH1 ETHERNET 0 LCS1
HOME
10.0.1.20

ETH1

GATEWAY
10.0.1.100 = ETH1 1500 HOST
DEFAULTNET 10.0.1.100 ETH1 1500 0

MAKE IT LOOK LIKE THIS:

000090
000091
000092
000093
000094
000095
000096
000097
000098
000099

DEVICE CTCA1 CTC e20

LINK CTC1 CTC 1 CTCA1
HOME
192.168.0.210 CTC1
GATEWAY
192.168.0.1 = CTC1 1492 HOST
DEFAULTNET 192.168.0.5 CTC1 1492 0

*****SPECIAL NOTE***** IF YOURE NOT ON A 192.168.0.* NETWORK JUST MATCH

UP THE FIRST IP ADDRESS TO BE THE ONE YOU SET IN THE .CONF FILE. THE SECOND IS Y
OUR ROUTER IP ADDRESS AND THE THIRD IS THE IP ADDRESS OF THE HERCULES HOST MACHI
NE
WHEN DONE ON THE 'Command ===>' LINE TYPE "SAVE" AND THEN "END"
GO BACK TO THE OTHER c3270 WINDOW AND TYPE "STOP TCPIP" AND THEN "START
TCPIP"
IN LINUX IN A NEW TERMINAL WINDOW RUN THE FOLLOWING AS ROOT:
echo "1" > /proc/sys/net/ipv4/conf/all/proxy_arp
echo "1" > /proc/sys/net/ipv4/conf/all/forwarding
THEN TRY TELNETING TO YOUR MAINFRAME: telnet 192.168.0.210 1023 (USER/PA
SS: IBMUSER/SYS1)
STEP 9: SHUTTING IT ALL DOWN
IN THE c3270 YOU OPENED FIRST TYPE "S SHUTSYS" AND AFTER A WHILE TYPE "Z
EOD"
WAIT A MINUTE OR TWO
IN THE HERCULES WINDOWS TYPE "exit"
TO BOOT AGAIN FOLLOW STEP 6
YOUR ALL SET NOW WELCOME TO THE WORLD OF BIG IRON.