Amdahl Universal Time- Sharing System
=====================================
The files contained in this directory appear to be from an early port of the
V7 Research UNIX onto an IBM 370 mainframe environment. At the time of this port
the system would ONLY run under the VM operating system as a guest OS.

The tarball files are as follows:

Amdahl_UTS2.aws.bz2  The original installation tape loaded by CMS to bootstrap.
                     This image is from https://github.com/moshix/UTS

doc.tar.bz2          /usr/doc from the installed system. Useful for both historical
                     background and to actually use the system. See "doc/out/beg" 
                     for the "beginners guide" for issues around handling exotic 
                     characters such as {}[]\ on real 3270 terminals.

src.tar.bz2          /usr/src from the installed system. This includes the
                     utility commands [a limited set by today's standards], man 
                     pages and the full, compilable, kernel source code. The 
                     running system can completely rebuild itself from this code. 

etc.tar.bz2          /etc. This contains, amongst other things, the "rc" 
                     startup script and the "iogen" shell script to rebuild the 
                     kernel if devices are added/removed.

CMS_Install.txt      Extract of the first three files from the installation 
                     tape image. These detail how a VM admin bootstraps UTS.


Running UTS Today
=================
This system is fully installable and once installed operates just as it would have
back in the early 1980s.

I extracted the original tape images from Moshix's website [see reference below] 
onto a Raspberry Pi5 and had the system running in a couple of hours - the video 
guides referenced by Moshix was invaluable in getting started.

In simple terms the process was as follows.

i)   Install the IBM 370 Hercules emulator along with a 3270 xterm environment.

ii)  Install VM370 using the DASD [disk] images from the VM370 Community Edition.

iii) Create a UTS Virtual Machine using the CMS maint user on VM370.

iv)  Create an empty 3330 DASD [150] under Hercules and attach it to VM370.

v)   Read the UTS install tape using the CMS operating system via the Hercules 
     virtual tape reader. The first tape file is in CMS TAPE format and provides
     the CMS "Install Exec" required to get the second tape file [CMS DDR
     Format] loaded on to the empty DASD as a bootable UTS system.

vi)  Start the UTS Guest and use a 3270 emulator to connect to VM370 at 
     127.0.0.1:3270 and then "dial UTS" to login => root/root.


REFERENCES
==========
Many thanks are due to the following Open Source sites whose work I have used
to explore this wonderful bit of history from the early 1980s and build a
fully usable UTS system.

The original inspiration and disk/tape images were found at:
 https://github.com/moshix/UTS

Installation tape files: 
 https://github.com/moshix/UTS/blob/main/Amdahl_UTS2.aws.bz2

VM370 DASD image containing the runnable UTS system with source code:
 https://github.com/moshix/UTS/blob/main/uts.150.bz2

Moshix's Readme reference to The Unix Heritage Society background to this port:
 https://www.tuhs.org/Archive/Distributions/IBM/370/

VM370 Community Edition required to host UTS:
 http://vm370.org/

Hercules IBM 370 emulator, used to host VM370, background information:
 https://sdl-hercules-390.github.io/html/

Hercules, 370 emulator, built from source code for Raspberry Pi using:
 https://github.com/wrljet/hercules-helper/blob/master/README.md


CONTACT ME
==========
Any questions I can be found at

 u t s m a n  @  g a d s b y  .  m e  .  u k 

Andrew Gadsby.
January 2026