GC28-0667-' File No. S370-34 OS/VS2 Planning Guide for Systems Release 2 Program Number 5742-020 VS2 Release 2 Second Edition (November, 1973) This is a major revision of, and obsoletes, GC28-0667-0. See the Summary of Amendments following the Contents. Changes or additions to the text and illustrations are indicated by a vertical line to the left of the change. This edition applies to Release 2 of OS/VS2 and to all subsequent releases until otherwise indicated in new editions or Technical Newsletters. Changes are continually made to the information herein; before using this publication in connection with the operation of IBM systems, consult the latest IBM System/360 and System/370 Bibliography, GA22-6822, for editions that are applicable and current. Requests for copies of IBM publications should be made to your IBM representative or to the IBM branch office serving your locality. A form for readers' comments is provided at the back of this publication. If the form has been removed, comments may be addressed to IBM Corporation, Publications Development, Department D58, Building 706-2, PO Box 390, Poughkeepsie, N.Y. 12602. Comments become the property of IBM. © Copyright International Business Machines Corporation 1973 Preface This publication contains planning information for OS/VS2 Release 2. It is intended for installation managers and system programmers responsible for assessing the effort required to install an OS/VS2 Release 2 system. Readers should have a background in programming and maintaining computer operating systems such as OS/MVT or OS/VS2 Release l. This publication is for planning purposes only. The functions and capabilities described reflect the information that is currently available. This information is subject to change before the availability of OS/VS2 Release 2. Throughout this publication the term MVS is used interchangeably with VS2 Release 2. MVS refers to the mUltiple virtual storage concept of this release. This manual contains the following independent chapters: • Introduction -- The Introduction highlights the major points that should be considered in planning for the installation and implementation of VS2 Release 2. • Defining the System -- This chapter provides preliminary planning information for defining the type of system that an installation needs. For example, the chapter describes the VS2 Release 2: --procedures and macro instructions for system generation. --procedures and parameters for system initialization. --system libraries and data sets. For each topic, a summary of the major changes from both MVT and VS2 Release 1 is provided. • Directing the Use of System Resources -- This chapter describes some of the new VS2 Release 2 facilities that allow an installation to control the distribution of system resources among system users. It provides planning information that helps assess the effort involved in implementing these facilities. • System Integrity -- This chapter discusses integrity in a multi-user computer system. It includes recommendations for maintaining, in any control program extensions or modifications, the same level of system integrity as that of the VS2 Release 2 system. • Conversion Considerations -- This chapter presents preliminary descriptions of some of the most significant differences between VS2 Release 2 and MVT or VS2 Release 1. It provides the information to assess the extent of the modifications required for existing data sets, cataloged procedures, programs, data reduction routines, and operational procedures, to install VS2 Release 2. • Appendix A: Virtual Storage Map -- This appendix shows the layout of virtual storage in VS2 Release 2. • Glossary -- The glossary describes VS2 terms. Preface 3 The following items are described in this publication strictly for advance planning purposes and will not be available with the initial release of VS2 Release 2: • lES] job entry subsystem. • Virtual telecommunications access method (VT AM). Additional information about these items will be available later. Availability dates for the support of the items may be obtained from th{! local IBM branch offices .. Prerequisite Publication IBM System/370 Introduction to VS2 Release 2, GC28-0661 This publication describes VS2 Release 2 features and facilities, design coneepts, and basic hardware requirements. Related Publications Introduction to Virtual Storage in System/370, GR20-4260 This publication provides an overview of the advantages and concepts of virtual storage systems. IBM Data Processing Glossary, GC20-1699 This publication defines terms and concepts used in IBM publications. OS/VS Virtual Storage Access Method (V SAM) Planning Guide:, GC26-3799 This publication contains a detailed description of the virtual storage access method (VSAM). IBM System/370 OS/VSl Planning and Use Guide, GC24-S090 This publication describes OS/VSl. It can assist installation personnel in selecting and evaluating VS 1 and can assist system programmers in implementing, modifying, and extending the capabilities of the VS 1 control program. IBM System/370 OS/VS2 Planning and Use Guide, GC28-0600 This publication describes OS/VS2 Release 1. It introduces VS2 concepts and provides planning information for users planning to have VS2 Release 1 installed. Introduction to VTAM, GC27-6987 This publication describes the functions and capabilities that an installation needs to know to plan for installing the virtual telecommunications access method (VTAM). 4 OS/VS2 Planning Guide for Release 2 Contents Summary of Amendments . 9 Introduction . 11 VS2 Release 2 Highlights 12 Multiprocessing 12 Job Entry Subsystems. 12 Data Set Handling . 12 System Resources Management 13 System Activity Measurement Facility 13 Allocation . 13 Multiple Virtual Address Spaces 13 MVS Planning Considerations 14 Functions Not Supported 15 Unsupported Type I Programs 17 Defining the System . 19 System Generation Procedures . 20 The VS2 Release 2 Starter System 21 Minimum Configuration . 21 Physical Addresses for Devices 21 Stage I Macro Instructions 22 Job Entry Subsystem Generation 23 JES2 Generation 24 JES3 Generation 25 RMTGEN 25 System Generation Changes 26 Initializing the New System Data Sets 28 Adding Installation-Written Members to System Libraries 28 Unsupported VS2 Release 1 Stage I Macro Instructions 29 System Initialization. 30 MVS System Parameters . 30 Changes to System Parameters for MVS . 36 Changes to VS2 Release 1 System Parameters 36 Unsupported VS2 Release 1 System Parameters 37 Unsupported MVT System Parameters 38 System Parameter Specification. 39 System Parameter Library (SYS1.PARMLlB) 39 Changes to SYS I.PARMLIB Lists . 40 IBM-Created Lists. 41 Installation-Created Lists. 45 System Libraries and Data Sets. 47 Required Libraries and Data Sets 47 Optional Libraries and Data Sets 48 Changes to VS2 Release 1 System Libraries and Data Sets 49 Changes to MVT System Libraries and Data Sets . 50 Adding Paging Space to the System . 50 Creating Temporary Data Sets in External Page Storage Using Virtual I/O 51 Directing the Use of System Resources 53 System Resources Management. 54 Workload Management Routines 54 Resource-Use Routines . 54 Control Function. 56 Workload Management Concepts 56 Transaction. 57 Performance Variable 57 Service. 57 Service Rate 57 System Workload . 58 Installation Performance Specification. 58 Performance Groups. 58 Performance Objectives . 59 Associating a Transaction With a Performance Objective 61 The Relationship Between Workload Levels and Service Rates 61 System Resources Manager Parameters 65 IPS Parameters (IEAIPSxx) ................ 65 Contents 5 Tuning Parameters (IEAOPTxx) 67 System Activity Measurement Facility (MF /1) 68 MF /1 Operation . 68 MF/l Reports and Tracing Records 70 CPU Activity Report 70 Paging Activity Report. 70 Workload Activity Reports . 71 Performance Group Period Report 71 Performance Group Report 71 System Summary Report 72 Channel Activity Report . 72 I/O Device Activity Reports 72 SMF Recording . 72 Tuning with MF/l . 73 Tuning Example 73 System Integrity . 79 Installation Responsibility 80 Areas of Concern . 81 User-Supplied Addresses for User Storage Areas 81 User-Supplied Addresses for Protected Control Blocks 81 Resource Serialization . 82 Resource Identification . 83 SVC Routines Calling SVC Routines . 84 Control Program and User Data Accessibility 84 Control Program Extensions. 85 Installation Procedural Responsibilities 86 Convers:ion Considerations . 89 Job Entry Subsystem Considerations 90 The JES2 Job Entry Subsystem 90 JES2 Job Flow . 91 MVS Operational Changes . 93 JES2/HASP Compatability . 95 The JES3 Job Entry Subsystem 96 JES3 Scheduling Features 98 Job Definition 98 JES3 Job Flow . 99 Device Scheduling. lOO Job Selection and Scheduling 101 JES Operational Environment 102 The Role of the JES3 Operator 103 The Operator's Console . lO3 Initialization, Control Statements, and Commands 104 JES3/ ASP Compatability .......... lO4 SMF Considerations. lO6 Differences From VS2 Release t System Management Facilities. lO6 Differences From MVT System Management Facilities . lO6 SMF Record Differences for VS2 Release 2 lO6 New System Resources Manager Data . 109 SMF Recording Replaced by MF /1 109 New Storage Data. 109 Job Entry Subsystem Statistics . 110 MUltiprocessing Data . 110 Virtual Storage Access Method Data 110 Time Sharing Record Elimination. llO Changes to SMF Exits for VS2 Release 2 llO Job Control Language . t 12 Changes to VS2 Release 1 JCL 114 Performance Group Specification 114 Assigning Job Selection Priority 114 Specifying