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

The crucial addition is the "ARCHMODE".