------- - - ------- Virtual Machine/ ------ - - ------- ----- - , - System Product OrPeraftull1lg Systems un a Virtua~ Maclhune Release 3 Ijl t I 'I ,. • ' • • '\'I~ I Third Edition (September 1983) This edition, GCI9-6212-2, is a major revision of GCI9-6212-1, and applies to Release 3 of the Virtual Machine/System Product, program number 5664-167, (VM/SP) and to all subsequent releases and modifications until otherwise indicated in new editions or Technical Newsletters. Changes are made periodically to the information herein; before using this publication in connection with the operation of IBM systems, consult the latest IBM System/370 and 4300 Processors Bibligraphy, GC20-0001, for the editions that are applicable and current. Summary of Changes For a list of changes, see 'page iii. Changes or additions to the text and illustrations are indicated by a vertical line to the left of the change. References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM program product in this publication is not intended to state or imply that only IBM's program product may be used. Any functionally equivalent program may be used instead. Publications are not stocked at the address given below. Requests for 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, Programming Publications, Dept. G60, P.O. Box 6, Endicott, NY, U.S.A. 13760. IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 1980, 1982, 1983 Summary of Changes Summary of Changes to GC19-6212-2 for VM/SP Release 3 Programmable Operator Facility New: With the help of the Programmable Operator Facility, an installation can now use one operator to control all of the guest operating systems. Program Event Recording (PER) New: Problem determination is greatly extended by the new CP command PER. 3081 Processor Note: VM/SP Release 3 will support AP /MP and 3081 processor Unit Model D16 in the first quarter of 1984. Virtual Machine Options Changed: "Section 1. General Considerations" has undergone a minor structural change so that all Virtual Machine Options are now under one heading. 3088 Multi-system Channel Communication Unit New: The 3088 Multi-system Channel Communication Unit interconnects mUltiple systems. It is fully compatible with existing channel-to-channel adapters when attached to a blocked mUltiplexer channel, Generic Tenns New: This publication now uses the generic terms 'DOS', 'OS', 'VSE,' 'POWER,' 'VSE/POWER,' and 'OS/VS' throughout the book. (See the Preface for a complete listing.) Miscellaneous Changed: Technical and editorial changes have been made throughout this publication to improve the accuracy, clarity and usability. Give special attention to the old examples that have been updated and the new examples that are included in this edition. Summary of Changes to GC19-6212-1 for VM/SP Release 2 Device Support Facility New: The Device Support Facility (program number 5747-DSl) replaces the service routines IBCDADDI, SURFANAL and INITDISK.' CP Serviceability New: Problem determination capability is provided to service personnel and system programmers with the Trace Table Recording Facility. The facility uses the CP command CPTRAP. A CMS utility program, TRAPRED, is included as part of the CPTRAP facility. Summary of Changes iii 3081 Processor Note: VM/SP Release 2 will support AP /MP and 3081 Processor Unit Model D16 in the first quarter 1983. CP Dial Support for Remote 3270 Tenninal Changed: VM/SP Release 2 allows remote 3270 terminals to use the CP DIAL command to be logically connected to a multi-access operating system. Miscellaneous Changed: Various minor technical and editorial changes have been made throughout this publication to promote accuracy, clarity, and usability. Summary of Changes for GC19-6212-0 as Updated by GN25-0820 for VM/SP Service Level 101 3081 Processor Support New: VM/SP now supports the new IBM 3081 processor complex. Each 3081 processor complex includes a 3081 processor and 3082 processor controller. The monitoring and service support facility (MSSF) is an integral part of the processor controller. The support provided allows VM/SP to communicate with the MSSF to obtain system information for a virtual machine using the SCPINFO command and real machine support to physically reconfigure the system using VARY commands. VM/SP also uses the new 3081 hardware instruction TEST BLOCK to validate real storage at system load and initialization. For more information about these topics, see "Section 1. General Considerations. " Elimination of One-Megabyte Segments Changed: 3081 processors do not permit the use of one-megabyte segments. See "Section 1. General Considerations" for details. New: The IBM 4341 Model Group 2 offers intermediate system users expanded function and capacity. The 4341-2 features enhanced block multiplexer channel capability and increased data transfer rate. An optional Extended Control Program Support Expansion feature allows concurrent operation of ECPS:MVS and ECPS:Vlvi/370. 3033 Model Group S New: The IBM 3033 Model Group S processor complex offers large system installations a unique growth advantage within the 3033 processor family. The 3033-S uniprocessor features an increased instruction execution rate for additional processing capability, six channels, and four or eight megabytes of storage. Miscellaneous Changed: Various minor technical and editorial changes.have been made throughout this publication. iv VM/SP Operating Systems in a Virtual Machine Preface This publication is for people who run guest operating systems under the VM/SP I control program, for example, VSE/ AF, VS1/BPE, MVS/SP and VM/SP itself. Users of the control program (CP) should refer to the Virtual Machine/System Product CP Command Reference for General Users, SC 19-6211, and Virtual Machine/System Product Operator's Guide, SC19-6202. Users of the conversational monitor system (CMS) should refer to the Virtual Machine/System Product CMS User's Guide, SC19-6210. Users of the remote spooling communications subsystem (RSCS) should refer to the Virtual Machine Facility/3 70: Remote Spooling Communications Subsystem (RSCS) User's Guide, GC20-1816. Users of the IBM RSCS Networking Program Product (5748-XPl) should refer to the VM/SP RSCS Networking Program Reference and Operations Manual, SH24-5005. Users of the VM/Interative Problem Control System Extension Program Product (5748-SAl) should refer to the VM/IPCS Extension User's Guide and Reference, SC34-2020. Users of the interactive problem control system (IPCS) should refer to the IBM Virtual Machine Facility/370: Interactive Problem Control System (IPCS) User's Guide, GC20-1823. Note: The recommendations in the DOS and OS areas of this publication are meant to help an installation in generating operating systems to run more efficiently under VM/SP. It contains operational considerations or hints when using virtual machines. Many of these recommendations were suggested by VM/370 users and have not been submitted to any formal test by IBM. As a result, potential users should evaluate the applicability of the recommendations to their installation before implementation. Generic Terms Unless otherwise noted the following are the generic terms used throughout the book. 'OS' is generic for the OS/PCP, OS/MFT, OS/MVT, OS/VS1, VS1/BPE, OS/VS2 SVS, OS/VS2 MVS and MVS/SP operating systems. 'DOS' is generic for the DOS, DOS/VS, DOS/VS AF, DOS/VSE and VSE/ AF operating systems. 'VSE' is generic for DOS/VSE and VSE/AF. 'OS/VS' is generic for OS/VS1, VSl/BPE, OS/VS2 SVS, OS/VS2 MVS and MVS/SP. 'POWER' is generic for the POWER, POWER/VS, VSE/POWER Version 1 and 2 of VSE/POWER Version 2 DOS spooling subsystems. Preface v I 'VSE/POWER' is generic for Versions 1 and 2 of VSE/POWER. OrganiZlllion This publication contains these sections: • "Section 1. General Considerations" provides both introductory and general usage information. The introductory information briefly describes the features of VM/SP as they apply both to the virtual machine and to the guest operating system running in it. The general usage information discusses those aspects of running operating systems· under VM/SP common to all systems. This section also describes how to use VM/SP functions more efficiently when running guest operating systems under VM/SP. • "Section 2. VM/SP in a Virtual Machine" explains how to test and update a VM/SP system that is itself operating under VM/SP. • "Section 3. DOS in a Virtual Machine" provides operating information specific to running DOS in a virtual machine. It contains system planning considerations for using these systems under VM/SP, rather than stand-alone. • "Section 4. OS in a Virtual Machine" provides operating information specific to running these systems in a virtual machine. Tenninology In this publication, the following terminology is used: • "2305" refers to the mM 2305 Fixed Head Storage, Models 1 and 2. • "3270" refers to a series of display devices, namely, the mM 3275, 3276, 3277, 3278, and 3279 Display Stations. A specific device type is used only when a distinction is required between device types. • "3330" refers to the IBM 3330 Disk Storage, Models 1,2, and 11; the mM 3333 Disk Storage and Control, Models 1 and 11; and the 3350 Direct Access Storage operating in 3330/3333 Model 1 or 3330/3333 Model 2 compatibility mode. • "3340" refers to the IBM 3340 Disk Storage; Models A2, B1 and B2; and, the 3344 Direct Access Storage, Model B2. • "3350" refers to the IBM 3350 Direct Access Storage, Models A2 and B2, in native mode.