Installing VM/370 on Hercules
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...
Contents
Requirements
- I am going to use Hercules version 3.03 for Windows, namely the version found here.
You will need the following files for the OS install:
- vm370r6-essentials.tar.gz
- CPR6L0.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 emulator, and it'll let you select a place to install the files..
Next extract the vm370r6-essentials.tar.gz file, in your 'setup' directory and it'll create an 'essentials' sub directory.
Finally decompress both CPR6L0.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:
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
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.).
..\dasdinit CPR6L0.3330-1 3330 CPR6L0 404 ..\dasdinit VMREL6.3330-1 3330 VMREL6 404
Now with everything in place we can kick off the tape install.
boot 1
Run the emulator like this:
..\hercules.exe -f 370.cnf
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:
ipl 580
With any luck you'll see the following in your 3270 emulator:
VM/370 DASD DUMP/RESTORE PROGRAM RELEASE 6 ENTER CARD READER ADDRESS OR CONTROL STATEMENTS ENTER:
Type the following into the 3270 program:
input 581 3420 output 131 3330 VMREL6 restore all
When the command completes on the emulator you will see lines scrolling like crazy reading something like this:
.....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 ......
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:
..\hercules.exe -f 370.cnf
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:
ipl 580
With any luck you'll see the following in your 3270 emulator:
VM/370 DASD DUMP/RESTORE PROGRAM RELEASE 6 ENTER CARD READER ADDRESS OR CONTROL STATEMENTS ENTER:
This time we enter:
input 582 3420 output 132 3330 CPR6L0 restore all
And just as last time our 'hint' that it completed was the emulator screen scrolling with errors like this:
.....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 ......
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:
..\hercules.exe -f 370.cnf
Then next start the telnet session:
telnet localhost 3270
Input the following command onto the emulator:
ipl 131
Then in your telnet session you should see:
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
Answer NO
The telnet session will now look like this:
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
Answer COLD
Your telnet session will now look like this:
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
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:
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
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:
l operator
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:
DMKCKP960I SYSTEM WARM START DATA SAVED DMKCKP961W SYSTEM SHUTDOWN COMPLETE