or As Updated April 1, 1981 by TNL GN25-0837
Directory You must define one or more virtual machines for the operator and
should define virtual machines for the system analyst or system
programmer.
The operator's virtual machines should be able to control: • The VM/370 sessions • Allocation of machine resources • Spooling activity • Online disk areas You should also define virtual machines for system analysts that are
equipped to: • perform system analysis • Modify certain VM/370 functions
and additional virtual machines to update or operate: • The CP system I 11 C 1-1.3 ::> y L e In • The RSCS system, if you generate one • The hardware • other operating systems that run in the virtual machine environment • The Installation Verification Procedure SYSTEM SUPPORT VIRTUAL MACHINES At system generation time, two' additional virtual machines should be
created beyond those needed by normal users (one each for hardware and
software support). The IBM FE programming support representative should
be consulted when the configurations for these virtual machines are
being determined.
The hardware support is for: • The processor, which must be supported in a dedicated environment
because there is no method currently available that allows concurrent
support of the processor, real storage, or channels when executing
problem programs. • The input/output equipment, which can be supported using online test (OLT) under OLTSEP. The OLTSEP program can be executed in its own
virtual machine.
Any of the offline testing capabilities of the system devices can be
used on inactive units while the system is operating.
To perform online hardware support, a virtual machine must be defined
in the VM/370 directory for the IBM service representative. The virtual
machine should have enough virtual storage defined to execute OLTSEP. Normally, the service representative requires that the device being
tested be dedicated to his virtual machine. (The system operator can
dedicate devices to a virtual machine by issuing the ATTACH command.)
Also the virtual machine for hardware support should have the minimum
configuration required to run online tests, and provide access to CKS with a read/write minidisk. Privilege class F should be assigned to
allow the hardware diagnostics to be run, and error recording and
retrieval facilities to be utilized.
184 IBM VM/370 Planning and System Generation Guide

Directory
The hardware service representative's virtual machine should also
have access to CMS and to the error recording area of the system
residence volume. An EREP program (CPEREP) runs under CMS thus allowing
editing and printing of all VM/370-recorded machine check and channel
check errors.
This directory entry is included in the VM/370 directory provided
with the starter system.
The virtual machine for software support should have the minimum
configuration necessary to recreate (virtually) problems that occur on
the machine. The ECMODE option must be specified in the directory OPTION control statement for this machine. You should assign privilege
class G to the user of this machine. Also, you should assign privilege
class E if he is to examine real storage addresses, and privilege class
B if he is to allocate devices. Sample Directory Entries
The following sample VM/370 directory entries provide an installation
with some of the entries necessary for operation and updating. The
indentations are for readability and are not required by the directory
program. LINK control statements are used whenever possible to minimize
the number of changes to the VM/370 directory whenever a minidisk extent
is moved. A brief explanation of some of the virtual machine user ids
follows.
THE SYSTEM OPERATOR'S VIRTUAL MACHINE (OPERATOR) The userid for this directory entry must be the same as the userid on
the SYSOPER operand of the SYSOPR system generation macro. The USER control statement gives the operator all command privilege classes
except class F. Actually, if other virtual machines are defined with
command privilege classes appropriate for updating VM/370, the
operator's virtual machine only needs class A command privileges. The MDISK control statement defines the 191 minidisk which contains CMS files, EXEC procedures, and service programs to update VM/370. USER OPERATOR PASSWORD 256K 1M ABCDEG ACCOUNT ACCTNO BIN1 CONSOLE 009 3215 SPOOL OOC 2540 R SPOOL OOD 2540 P SPOOL OOE 1403 LINK VMSYS 190 190 RR MDISK 191 3330 1 10 UDISKA WR RPASS WPASS Part 2. Defining Your VM/370 System 185