Hercules

2018-01-31T12:29:11Z

Mstram: Added links to MTS / MULTICS / DosVS / APL/360

From the Hercules site:

<blockquote>
''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.''
</blockquote>

That's right! Get a [[System/360]], [[System/370]] or [[System/390]] emulator on your home PC!

Furthermore, there's a variety of public domain software from the 1960s and 1970s which will run under Hercules:

* [[MVS]]
* [[OS/360]]
* [[MUSIC/SP]]
* [[VM/370]]
* [[MTS]]
* [[MULTICS]]
* [[DosVS]]
* [[APL/360]]

== External links ==
* [http://www.hercules-390.eu/ Official Hercules Emulator website]
* [https://curlie.org/Computers/Emulators/IBM_Mainframe/Hercules/ Hercules links], at [https://curlie.org Curlie], formerly [http://dmoztools.net DMOZ]
* [http://www.demorton.com/Tech/$OSTL.pdf IBM Mainframe Operating Systems: Timeline and Brief Explanation For the IBM System/360 and Beyond] by Dave Morton

{{stub}}
[[Category:Emulators]]

Installing VM/370 on Hercules

2010-05-19T15:52:51Z

Mstram: /* boot 3 */

In this tutorial we are going to install [[VM/370]] into the [[Hercules]] emulator. Sadly I really don't know how to use the OS, and I've just gotten it to install but I wanted to write down my notes before I forget...

== Requirements ==

*I am going to use Hercules version 3.03 for Windows, namely the version found [http://www.bsp-gmbh.com/hercules/distarchs/index_msvc.html here].

You will need the following files for the OS install:

*[http://www.cbttape.org/ftp/vm6/vm370r6-essentials.tar.gz vm370r6-essentials.tar.gz]
*[http://www.cbttape.org/ftp/vm6/CPR6L0.ddr.aws.bz2 CPR6L0.ddr.aws.bz2]
*[http://www.cbttape.org/ftp/vm6/VMREL6.ddr.aws.bz2 VMREL6.ddr.aws.bz2]
*bzip2
*Some kind of 3270 emulator program... I use [[QWS3270]]. [[x3270]] is another great (free) emulator.

== Getting started ==
First pick a location for your emulator. I'm going to use c:\temp\herc. Run the [http://www.bsp-gmbh.com/hercules/distarchs/3.03_msvc/hercules-3.03_msvc_2.exe emulator], and it'll let you select a place to install the files..

Next extract the [http://www.cbttape.org/ftp/vm6/vm370r6-essentials.tar.gz vm370r6-essentials.tar.gz] file, in your 'setup' directory and it'll create an 'essentials' sub directory.

Finally decompress both [http://www.cbttape.org/ftp/vm6/CPR6L0.ddr.aws.bz2 CPR6L0.ddr.aws.bz2] & [http://www.cbttape.org/ftp/vm6/VMREL6.ddr.aws.bz2 VMREL6.ddr.aws.bz2] into the 'essentials' directory.

With all of these in place we next create a configuration file as the supplied one will not work with 'new' versions of Hercules.

I am going to use the configuration file here:
<pre>
CPUSERIAL 000777 # CPU serial number
CPUMODEL 3158 # CPU model number
MAINSIZE 2 # Main storage size in megabytes
XPNDSIZE 0 # Expanded storage size in megabytes
CNSLPORT 3270 # TCP port number to which consoles connect
NUMCPU 1 # Number of CPUs
LOADPARM 0120.... # IPL parameter
OSTAILOR VM # OS tailoring
PANRATE FAST # Panel refresh rate

#missing
ARCHMODE S/370

# .-----------------------Device number
# | .-----------------Device type
# | | .---------File name and parameters
# | | |
# V V V
#--- ---- --------------------
#0009 3270
000C 3505
000D 3525 punch00d.txt ascii
000E 1403 print00e.txt crlf
001F 3215
0040 3270
0041 3270
0580 3420 dmkddr.aws
0581 3420 VMREL6.ddr.aws
0582 3420 CPR6L0.ddr.aws
0131 3330 VMREL6.3330-1
0132 3330 CPR6L0.3330-1
</pre>
Save the file to '370.cnf'
The crucial addition is the "ARCHMODE".

== Setup the DASD ==
Run the following commands in the 'essentials' directory (we will run all commands from there for now on.).
<pre>
..\dasdinit CPR6L0.3330-1 3330 CPR6L0 404
..\dasdinit VMREL6.3330-1 3330 VMREL6 404
</pre>

Now with everything in place we can kick off the tape install.

== boot 1 ==
Run the emulator like this:
<pre>
..\hercules.exe -f 370.cnf
</pre>

You will get a screen with a '==>' prompt. Next run your 3270 terminal program, and attach to the localhost port 3270. Back at the Hercules console type in:
<pre>
ipl 580
</pre>

With any luck you'll see the following in your 3270 emulator:
<pre>
VM/370 DASD DUMP/RESTORE PROGRAM RELEASE 6
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS
ENTER:
</pre>

Type the following into the 3270 program:
<pre>
input 581 3420
output 131 3330 VMREL6
restore all
</pre>

When the command completes on the emulator you will see lines scrolling like crazy reading something like this:
<pre>
.....h....
HHCCP075I 0581:Stat=2600 Count=0001
HHCCP076I 0581:Sense=40220000 00C00300 00000000 00800100 010000FF FF000000
HHCCP077I 0581:Sense=INTREQ EOC WRI
HHCIN901I Releasing configuration
HHCCP048I 0581:CCW=0F004280 20000001=>0F004280 20000001 0F004288 20000001 ......
</pre>

Don't worry apparently the emulator isn't feeding the end of tape correctly to the emulator. Simply type in 'quit' to the emulator and hit enter, and you'll drop back to your command prompt.

== boot 2 ==
Now we re-run the emulator again, to load in the '2nd' tape image.

Run the emulator like this:
<pre>
..\hercules.exe -f 370.cnf
</pre>

You will get a screen with a '==>' prompt. Next run your 3270 terminal program, and attach to the localhost port 3270. Back at the Hercules console type in:
<pre>
ipl 580
</pre>

With any luck you'll see the following in your 3270 emulator:
<pre>
VM/370 DASD DUMP/RESTORE PROGRAM RELEASE 6
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS
ENTER:
</pre>

This time we enter:
<pre>
input 582 3420
output 132 3330 CPR6L0
restore all
</pre>

And just as last time our 'hint' that it completed was the emulator screen scrolling with errors like this:
<pre>
.....h....
HHCCP075I 0582:Stat=2600 Count=0001
HHCCP076I 0582:Sense=40220000 00C00300 00000000 00800100 010000FF FF000000
HHCCP077I 0582:Sense=INTREQ EOC WRI
HHCCP048I 0582:CCW=0F004280 20000001=>0F004280 20000001 0F004288 20000001 ......
</pre>

Type in quit at the emulator screen and press enter.

== boot 3 ==

The OS is now restored! Now to bring it up we run the emulator however we connect with a REGULAR telnet program on the localhost to port 3270. The default windows client runs fine.

Run the emulator like this:
<pre>
..\hercules.exe -f 370.cnf
</pre>

Then next start the telnet session:
<pre>
telnet localhost 3270
</pre>

( On the windows XP version of telnet, the default is for 'localecho' to be OFF, meaning you won't see what you type ! Press CTR-], then type 'set localecho' <return>)

Input the following command onto the emulator:
<pre>
ipl 131
</pre>

Then in your telnet session you should see:
<pre>
VM/370 VERSION 06 LEVEL 00 PLC 0029; 09/07/85 09:42:40

NOW 06:19:13 PST SUNDAY 10/18/09
CHANGE TOD CLOCK (YES NO) :HHCTE006A Enter input for console device 001F
</pre>

Answer NO

The telnet session will now look like this:
<pre>
VM/370 VERSION 06 LEVEL 00 PLC 0029; 09/07/85 09:42:40

NOW 06:19:13 PST SUNDAY 10/18/09
CHANGE TOD CLOCK (YES NO) :HHCTE006A Enter input for console device 001F
06:19:59 START ((COLD WARM CKPT FORCE) (DRAIN)) (SHUTDOWN) :HHCTE006A Enter inpu
t for console device 001F
</pre>

Answer COLD

Your telnet session will now look like this:
<pre>
VM/370 VERSION 06 LEVEL 00 PLC 0029; 09/07/85 09:42:40

NOW 06:19:13 PST SUNDAY 10/18/09
CHANGE TOD CLOCK (YES NO) :HHCTE006A Enter input for console device 001F
06:19:59 START ((COLD WARM CKPT FORCE) (DRAIN)) (SHUTDOWN) :HHCTE006A Enter inpu
t for console device 001F
06:20:41 AUTO LOGON *** OPERATOR USERS = 001 BY SYSTEM
DMKCPI957I STOR 02048K, NUC 180K, DYN 01712K, TRA 032K, FREE 0124K, V=R 00000K
06:20:41 FILES: NO RDR, NO PRT, NO PUN
</pre>

Finally type in:

ENABLE ALL

Your VM/370 session should now be running. Start a 3270 session (leave the telnet session running) and you should be greeted with:
<pre>
VM/370 ONLINE

VV VV MM MM
VV VV MMM MMM
VV VV MMMM MMMM
VV VV MM MM MM MM
3333333333 777777777777MMMM 00000000
333333333333 77777777777 MM 0000000000
33 VV33 77VV 77 00MM 00
V33 VV 77M 00MM 00
33 VV 77MM 00MM 00
3333VV VV 77 MM 00MM 00
3333 VVVV 77 MM 00MM 00
33 VV 77 MM 00MM 00
33 77 00 00
33 33 77 00 00
333333333333 77 0000000000
3333333333 77 00000000

RUNNING
</pre>

== Going from here ==

You can then issue the command 'log' on the regular telnet session. This will logout the operator user. Then on the 3270 session simply type in:
<pre>
l operator
</pre>
This will start the logon process for the operator user, and it's password is operator.

The other default userid password is MAINT/CPCMS.

== Shutting down ==

In the telnet session simply type in:

SHUTDOWN

And you should see:
<pre>
DMKCKP960I SYSTEM WARM START DATA SAVED

DMKCKP961W SYSTEM SHUTDOWN COMPLETE
</pre>

[[Category:Tutorials]]

Computer History Wiki - User contributions [en]

Hercules

Installing VM/370 on Hercules