Introduction to Generating and Running OS/360 on Hercules

This is an introduction to getting IBM's OS/360 operating system loaded and running on the Hercules emulator for the System/370, ESA/390, and z/Architecture systems. It assumes you have some familiarity with the 370, and with OS; in particular, you need to have some understanding of JCL, and of OS/360 (or later versions, like MVS or OS/390) usage and operation. It does not purport to be an introduction to the world of the 370.

Updated 21 Feb 2003: HASP does not work yet in this system, although others have succeeded in getting it running. SMF was added, but turned off, in order to fix one HASP problem. Updates will be posted to the OS/360 on Hercules web site as they become available.

Updated 10 Feb 2003: Completely overhauled. Many changes have happened to Hercules since this document was last revised in February 2000, and a rewrite was long overdue. In addition, many more resources have become available, including HASP, TSO/TCAM, and several classic modifications tapes. The stage 1 gen has been changed a bit, and configuration files written to work with previous versions of this document will need revision.


1. Overview

1.1 What is Hercules?

1.2 What is OS/360?

1.3 What are we trying to accomplish?

1.4 Overview of the process

2. Getting started

2.1 The host Linux system

2.2 Hercules

2.3 The OS/360 distribution

2.4 JCL and control files

2.5 Patience!

3. Building the driving system

3.1 Installing Hercules

3.2 Building the MFT IPL volume

4. Preparing to build MVT

4.1 Building the MVT DLIB volumes

4.2 Creating the MVT target and work volumes

5. Getting ready for stage 1

5.1 General information about running MFT

5.2 IPLing the driving system

5.3 Cataloging work datasets: CTLGWRK

5.4 Cataloging DLIBs: CTLG2314

5.5 Selecting the right IEAANIP: FIXNIP

5.6 Fixing GENLIB macros: FIXGENLB

5.7 Installing hooks for HASP: HASPHOOK

6. Running the stage 1 sysgen

6.1 A guided tour of STAGE1

6.2 Running STAGE1

7. Running the stage 2 sysgen

7.1 A guided tour of the stage 2 deck

7.2 Running the stage 2 deck

7.3 Stage 2 job error handling

8. Final MVT setup

8.1 MVT setup: MVTSETUP

8.2 Shutting down the driving system

9. IPLing MVT

10. Building and installing HASP

10.1 Overview

10.2 Allocating HASP datasets: I01ALCIN

10.3 Allocating SYS1.HASPACE: I02ALCSP

10.4 Loading the source: I03LOAD

10.5 Loading the JCL procs: I04PROCS

10.6 Installing the IOS hooks: I05IOSM

10.7 Installing the WTO hook: I06WTO2

10.8 Applying generation parameters: P01GEN

10.9 Applying the MVT retrofit: P02RFIT

10.10 Applying user modifications: P03UMODS

10.11 Assembling HASP: P04ASMnn

10.12 Linking the HASP SVC: P05LSVC

10.13 Linking HASP: P06LHASP

10.14 Bringing up HASP

10.15 Operating HASP

10.16 Shutting down HASP

11. Building and installing TSO/TCAM

11.1 Overview

11.2 TCAM and TSO JCL: TCAMPRCS

11.3 TSO parameters: TSOSETUP

11.4 TCAM stage 1: TCAMSTG1

11.5 TCAM stage 2: TCAMSTG2

11.6 Starting TCAM and TSO

11.7 Logging on to TSO

11.8 Shutting down TSO and TCAM

12. What's next?

13. Acknowledgments


Jay Maynard, jmaynard@conmicro.cx

Last updated 21 February 2003