IBM Virtual Machine Facility/370: Operator's Guide 2
Page54(54 of 260)
Apr il 1 , 1 9 81 36.2 VM/370 Operator's Guide
Section 3. CP Commands The CP commands represent a set of interactive console functions that the operator uses to control the VM/370 system, and that permit user control of virtual machines. CP indicates the results of command processing with a conversational response, if appropriate (for example, COMMAND COMPLETE, MISSING ARGUMENT, or INVALID OPTION). The commands that a VM/370 user (including the operator) can issue depend upon the user's assigned privilege class(es), as described in the paragraphs. PRIVILEGE CLASSES FOR CP COMMANDS The CP co •• ands are divided into eight groups, each represented by a privilege class that indicates the type of user from which the commands are accepted. Each user is assigned, as part of his entry in the VM/370 directory, one or more privilege classes (Figure 4 shows the function of each class). The exceptions are users with a Iassword of NOLOG. The BaLOG ,users have no privilege class and can only send .essages via the command or receive spooled output as punched cards or printed forms. The BOLOG password allows them to be identified as the recipients of spooled output when a virtual machine user spools output for them. Section 3. CP Commands 37
Section 3. CP Commands The CP commands represent a set of interactive console functions that the operator uses to control the VM/370 system, and that permit user control of virtual machines. CP indicates the results of command processing with a conversational response, if appropriate (for example, COMMAND COMPLETE, MISSING ARGUMENT, or INVALID OPTION). The commands that a VM/370 user (including the operator) can issue depend upon the user's assigned privilege class(es), as described in the paragraphs. PRIVILEGE CLASSES FOR CP COMMANDS The CP co •• ands are divided into eight groups, each represented by a privilege class that indicates the type of user from which the commands are accepted. Each user is assigned, as part of his entry in the VM/370 directory, one or more privilege classes (Figure 4 shows the function of each class). The exceptions are users with a Iassword of NOLOG. The BaLOG ,users have no privilege class and can only send .essages via the command or receive spooled output as punched cards or printed forms. The BOLOG password allows them to be identified as the recipients of spooled output when a virtual machine user spools output for them. Section 3. CP Commands 37
IBM Virtual Machine Facility/370: Operator's Guide 2
Page56(56 of 260)
I IClass User and Function 1------- ------------------------------------------------------------------- I Al The class A user controls the I I I I Cl FI G2 H V8/370 system. Class A is assigned to the user at the V8/370 system console during IPL. The primary system operator is responsible for the availability of the V6/370 systs. and its communication lines and resources. In addition, the class A user controls system accounting, broadcast messages, virtual machine performance options and other command operands that affect the overall performance of V8/370. The class A system operator who is automatically logged on during CP initialization is designated as the primary system operator. The class B user controls all the real resources of the V8/370 system, except those controlled by the primary system operator and spooling operator. The class C user updates certain functions of the VM/370 system. The class D user controls spool data files and specific functions of the system's unit record equipment. The class E user examines and saves certain data in the Y8/370 storage area. The class F user obtains, and examines, in detail, certain data about input and output devices connected to the VM/370 system. General User: The class G user controls functions associated iIth-the-execution of his virtual machine. The Any classification is given to certain CP commands that are available to any user. These are Frimarily for the purpose of gaining and relinquishing access to the V8/370 system. Reserved for IB8 use. IDescribed in this publication. 2Described in the £f !2! Figure q. CP Privilege Class Descriptions In most cases, a user is assigned to the class G commands. Any attempt by a user to issue a command that is not within his command classes causes an error response from CPa Figure 5 shows the commands that are accepted from each user command class. Some commands fall into more than one class. In those cases, the major operands of those commands are shown in the classes in which they are valid. 38 V8/370 Operator's Guide
Page of GC20-1806-9 As Updated April 1, 1981 by TNL GN25-0834 .- Class Co.mands I Operands Class Commands I Operands Any * B DISABLE tcp (cont.) ENABLE CP ftESSlGE ALL DIlL KSGNOH DISCONN NETWORK DISABLE LOGOFF DISPLAY LOGON DUKP KESS AGE ENABLE SLEEP LOAD POLLDLAY A ACNT QUERY AUTOLOG VARY DISABLE QUERY ALL ENABLE DASD FORCE DUKP HALT GRAF LOCK LINES KESSAGE ALL LOGftSG KONITOR NAKES NETWORK DISABLE PROCESSOR DISPLAY raddr DUMP STORAGE ENABLE SYSTE! HALT TAPES LOAD TDSK POLLDLAY UR QUERY userid VARY USERS QUERY AFFINITY SET DUKP CPASSIST LOGKSG JOURNAL VARY LOGKSG WARNING NAKES PAGING C DCP PRIORITY DKCP PROCESSOR LOCATE SASSIST QUERY LOGftSG userid NAKES USERS PROCESSOR SET AFFINITY userid CPASSIST USERS JOURNAL STCP FAVORED PRIORITY 0 BACKSPAC RESERVE CHANGE SASSIST DRAIN SHUTDOWN FLUSH UNLOCK FREE WARNING HOLD LOADBUF B ATTACH ORDER ATTACH CHANNEL PURGE AUTOLOG QUERY FILES DEFINE SYSVIRT HOLD VIRTUAL LOGKSG DETACH NAKES DETACH CHANNEL PRINTER PUNCH Figure 5. Commands Accepted from Each User Class (Part 1 of 2) Section 3. CP Commands 39
IBM Virtual Machine Facility/370: Operator's Guide 2
Page52(52 of 260)
Page of GC20-1806-9 As Updated April 1, 1981 by TNL GN25-0834 SYSTEM ABEND Conditions can occur the CP program that may force an abnormal ending condition (ABEND) and cause the dumping of system registers and storaqe. The device that receives these records can be a tape, printer, or disk device. A system restart dump is taken when the system operator presses the SYSTEM RESTART button on the processor console or initiates system restart in some other manner as dictated by the processor device type. In an AP configuration, the attached processor should not be stopped before the system restart is initiated. Dumping operations are caused by any program interruptions or system restart condition. These interruptions cause routines to gather data from registers and storage and place this data on a previously defined device. The system CP command SET DUMP defines the quantity of data to be dumped. For example: SET DUMP AUTO SET DUMP raddr SET DUMP raddr ALL SET DUMP AUTO ALL SET DUMP AUTO places the VM/370 system dump on a preselected file device. (The disk dump area is antOlllatically selected at system initialization time if sufficient contiguous space is available.) You can verify the device type and address by entering the QUERY DUMP command. Use SET DUMP raddr when the dump device is to be a high speed printer or tape device. The real hexadecimal one to three digit device address is substituted for the raddr operand. The ALL operand used with SET DUMP AUTO or SET DUMP raddr dumps all of storage onto to the DUMP device. If the ALL operand is not specified, the system defaults to dumping only those areas that pertain to CP, and not those areas that pertain to virtual machine operations. If you dump to a disk file, an additional operation is necessary to transform these records into readable output for programmers or system analysts. You can do this with the CMS VMFDUMP program. Note that expanded function is available to the VMFDUMP command as generated for the IPCS virtual machine. For more information on this, refer to the VM/370 Interactive Problem Control System If the records are dumped onto a tape drive, other CMS command options must be invoked for printout. Only abend dumps that are a result of using the SET DUMP AUTO command are spooled as a special virtual card reader file. This card reader file is assigned during system generation to a specific virtual machine user via the SYSOPR macro. The CMS VMFDUMP command formats and prints these CP abend dumps. 36 VM/370 Operator's Guide
Page of GC20-1806-9 As Updated April 1, 1981 by TNL GN25-0834 The VMFDUKP command creates a CMS file from the CP disk dump data and prints the dump from the CMS file. The VM/Interactive problem Control System Extension (VM/IPCS Extension) provides installations with expanded facilities for reporting and diagnosing software failure. The VMDUMP command allows the user to dump a virtual machine's entire storage area. The VK/IPCS Extension program product or a user written program must process the VMDUMP command. If you have installed this program, see the VK/Interactive System Extension User's Quide and Order No. SC34-2020. Section 2. Initiating VM/370 Operation 36.1