Installation of MVS/380

Obtain TK3 CD

run setup

option 1, standard setup

no, don't want hercules

no, don't want gui

yes, want cygwin [regardless if you don't normally use it,
 or even if you already have a later version installed]

yes, want c3270

change target directory to c:\mvs380 (I don't use the progra~1)
avoiding progra~1 means that you don't need to be an administrator
either, i think. Also, someone reported that they needed to
put the drive letter in uppercase, ie C:\mvs380, but that is not 
my experience. You should now set an environment variable, MVS380, 
equal to c:\mvs380 (or whatever you chose). Failure to do so means
that scripts will start failing. So go to Control
Panel, System and Maintenance, System, Advanced System Settings,
Environment Variables, System Variables (New). It is highly
recommended that you update your "PATH" environment variable at
the same time, to include c:\mvs380 and c:\herc380. On Windows/XP 
the setting is in Control Panel, System, Advanced Tab, Environment 
Variables. Or you can just "remember" to set it manually (or in a 
batch file) before running any of these scripts.

hit enter on dasd

choose "y" for mvs source, hit enter for smp, cbt, starter

hit enter for 3270, 3505, 8081

change hostname to the "localhost" option.

enter to continue installation

if you're not an administrator, you'll probably get some
"permission denied" messages, but they appear to be harmless.
I think you'll get an error about c:\tmp not existing at
this point, which can also be ignored

hit enter on 3270, 3215, 3270, socket
(be warned - if you chose simple instead of standard, the
default of socket will be "N", which likely cause you grief
later).

enter on terminal options

type in "secret"

hit enter

Now TK3 is installed.
two directories are created - c:\mvs380 and c:\usr
close this window and open a new one


Now install the S/380 version of Hercules, ie Hercules/380
cd\
md herc380
cd herc380
unzip INSTALL_FROM\hercules380-3_06-4_0 (or later).
Note that Unix users will need to recompile Hercules/380 
themselves, after applying the patch file as per the 
instructions in the README.S380 in the Hercules/380 archive.


Install MVS/380 proper

now go to c:\mvs380 and type:
unzip -o INSTALL_FROM\mvs380-1_0
Remember to put in the "-o" to overwrite any old tk3 files
If you don't have unzip, you can use pkunzip or Winzip
etc instead.

then:
unzip -o INSTALL_FROM\shadow.zip
where shadow.zip (probably has a different name) is a build 
of 1.0 that you or someone else has done. The base MVS/380 is 
at time of writing only supplied in source form, so you need 
to have found someone who has built executables based on the 
build instructions in the build directory (or have done
that yourself). There's probably only shadow files in that
archive, but since the products one may wish to install is
constantly changing, they may have updates to something
else, so let theirs overwrite anything here.


Double-check that you have set the MVS380 environment variable by
going:
echo %MVS380%
and making sure that it reports c:\mvs380 (or whatever).

next:
startmvs coldjes

runmvs source\misc\fixparms.jcl temp.txt

(note to maintainers - we would need to ship a cold-formatted 
JES2 spool if we wanted to ship this - or use sys1.parmlib instead
of sys1.jes2parm)


startmvs ipl148

wait for the system to quieten down (30-60 seconds)

devinit 00c jcl/comppdp.jcl eof

This will compile the example C program. The compiler is
31-bit, but the compile will probably happen far too quickly
for you to see "31" displayed on Hercules, but nevermind.
Check the output in prt\prt00e.txt
Ignore the fact that it says 0 bytes, it isn't.

devinit 00c source/misc/memtest.jcl eof

This will run a real live 31-bit z/OS executable that
allocates a large chunk of memory and does some calculations
so that you can see the 31-bit indicator for longer.


quit

make a copy of your entire mvs380 directory so that you have
a good fallback.



Now you have MVS/380 installed, you probably want
to get a terminal up and running so that you can
log on to TSO. There are quite a lot of options for
this. There is an old c3270 on the TK3 disk, but it
is probably better if you go to www.cygwin.com and
install Cygwin and check the c3270 option which is
in the "net" section (called "c3270"). Once that is
installed, do the following:

startmvs
wait 10 seconds
on another window:
startterm
back to the original window (where Hercules should be running)
ipl 148
/r 00,clpa

After a while you will get a TSO screen and you can either
log on to herc01 by typing "herc01" or to herc02 by typing
"herc02" and then entering a password of "cul8tr". herc02
has access to some datasets/facilities that herc01 doesn't.
Both will automatically invoke rpf. PF3 exits and you can
type "logoff" to log off. Refer to TK3 documentation for
things like this as this is not changed in MVS/380.
