


		MVS38j Sysgen with 3375, 3380 and 3390 mods

		Version 00.09		April 22, 2002

		Author: James M. Morrison
			jmorrison@ameritech.net


This file, and the remaining contents of the archive containing it
are released to the public domain.

This code is supplied AS-IS, and no warranties are provided or implied.



		Introduction
		------------


Welcome to the MVS38j 3375, 3380 and 3390 system modifications.

The biggest changes to this version are new 3375 support, and further splits
of the doc that used to be in readme.txt into the doc subdir.  There are two 
main tasks that are documented here:

	1) Install the SMP4 usermods to provide 3375, 3380, and 3390 support.
	   See doc/smp4-install.txt

	2) Generate a new MVS38j system residence volume
	   See doc/sysgen.txt

Each task is treated separately in it's own document, since many of you have
your own sysgen procedures.  If you're already SMP4-literate, you can just
have at the usermods, in which case it's unlikely you'll need any more doc
than what's provided in this file (and precious little of that).  I recommend 
you review 

	doc/mcs-sum.txt 

before you begin, then you can be on your way.

	Important notice:

>   Previous versions of these mods attempted to allow the removal of
>   the SYS2.MVS5xx.AGENLIB dataset from your STAGE1 assembly such that
>   the 3380 and 3390 mods could easily be removed.  This is no longer true
>   with the switch to SMP4 packaging.  Once you run the SMP4 ACCEPT for
>   the 3380/3390 mods, you're THERE.  You have updated your DLIB and there's
>   really no going back without restoring your SMP4 environment (or playing
>   games with SMP4, which I don't cover).  Backing up your DLIB and sysres 
>   volume before beginning this install is an extremely good idea.

This version is in line with the "Release Early and Often" philosphy.  
The 3380 stuff is fairly well behaved, the 3390 stuff isn't too bad either.  
As I write this, the 3375 support is being developed.

To see the change history, and what's new in this version, see 

	doc/changes.txt

For details on what works and what doesn't, see 

	doc/results.txt

See also Jay Moseley's 3380 mods page, which probably includes some 
things that work that I've missed:
http://www.jaymoseley.com/hercules/installmvs/mod3380.htm

The supplied samples specify a full sysgen onto a 3350 sysres (MVS5xx).
It is assumed you have a DLIB volume (MVSDLB) which is fully populated
and capable of being used to generate a functional MVS38j system.  It is
also assumed you have a functional MVS38j sysres with which to to run 
the installation activities.

This process (and my documentation) is not for the faint of heart.  If you 
haven't done a sysgen before, this is probably not the place to learn how.
At this stage of the game, this process is for the roll-your-own crowd.
However, that's about to change, as Volker Bandke is incorporating the
3380/3390/3375 mods into his Turnkey system.  And of course Jay Moseley already 
has a less brutal approach to building a system with the 3380 mods than mine.

Word to the wise: read the JCL, etc. before running either the jobs or 
commands.  They may require modification for your environment.  These
jobs run (well, ran) in my environment, but my environment changes pretty
frequently.

IEHPROGM is used to delete & uncatalog several datasets.  It's probably not
a problem if it gets a return code 8 (usually happens when trying to delete
and/or uncatalog dataset that doesn't yet exist).

In the instructions, "->" indicates commands you are to execute.


		Installation environment
		------------------------


Review hercxxxx.cnf for the device addresses.  With the advent of
Greg Price's IMON370, I am switching the way I lay out my S/370 channels,
which is reflected in the Stage1 provided here.  

My PC has 4 ATA/66 IDE ports, and 4 ATA/100 IDE ports (provided by an 
Abit KT7-RAID motherboard), with the ATA/100 attachments mostly used 
for Hercules.  I plan on giving each of the 4 ATA/100 IDE ports their
own S/370 channel, so I can see how they perform using Greg's IMON370
(or MF/1).  This channel layout seems subjectively faster, but I've
not yet measured anything.  MVS38j still IPLs faster than I can
respond to the prompts.  Zoom!

IMON370 is available for MVS38j from:
http://www.prycroft6.com.au/vs2sw/imon370.zip
as well as other cool stuff at:
http://www.prycroft6.com.au

Watch http://groups.yahoo.com/group/H390-MVS/messages for the latest 
and greatest updated info on IMON370.  Which also tends to be where I 
announce stuff about the mvs3380+3390 mods.

During the development of the SMP4 packaging, I also made use of Greg Smith's
compressed CKD dasd support.  This seemed to deliver better performance than
the native Hercules CKD support, although I have yet to quantify this.


		Reference material
		------------------


DASD volumes stored in /herc[1|2|3]/mvs/dasd:

		SPOOL0	3330	MVS38j jes2 spool
		SPOOL1	3330	2nd spool volume
		WORK01	3330	work  
		WORK02	3330	work 
		WORK03	3330	work
		STOR01	3330	storage 
		PAGI01	3330	paging (live)			
		PAGI02	3330	paging (live)			
		PAGI03	3330	paging (live)			
		PAGJ01	3330	paging (target)				<---
		PAGJ02	3330	paging (target)				<---
		PAGJ03	3330	paging (target)				<---

		MVSDLB	3350	MVS38j SMP DLIB
		MVS508	3350	MVS38j sysres (live)		
		MVS509	3350	MVS38j sysres (target)			<---
		LOC509	3350	MVS38j sysres extension (target)	<---

		MVS709	3375	test volume				<---
		MVS809	3380	test volume				<---
		MVS909	3390	test volume				<---

Catalogs:

		SYS1.IMASTCAT	live system catalog			<---
		SYS1.JMASTCAT	target system catalog			<---


Distribution tape:	j9xxxx.het is Standard Label (virtual) tape, and contains:

		01	SMPMCS
		02	SMP RELFILE (IEBCOPY unload) of MACRO: 
				IHADVCT2
		03	SMP RELFILE (IEBCOPY unload) of ASM:
				USRDDT00
				UTRKCALC
				UTRK3390

<end>


