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...

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

( 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:

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