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.

Last updated 29 April 2005. See the Updates page for the details.


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

10.7 Installing the WTO hook: I06WTO2

10.8 Installing the TSO hooks: I07HTSO

10.9 Applying generation parameters: P01GEN

10.10 Applying the MVT retrofit: P02RFIT

10.11 Applying user modifications: P03UMODS

10.12 Assembling HASP: P04ASMnn

10.13 Linking the HASP SVC: P05LSVC

10.14 Linking HASP: P06LHASP

10.15 Bringing up HASP

10.16 Operating HASP

10.17 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

14. Updates


Jay Maynard, jmaynard@conmicro.cx

Last updated 29 April 2005