Installing VM/370 on Hercules

In this tutoral we are going to install VM/370 into the Hercules emulator.

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.

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.