CP Command Reference for General Users (Rel 6 PLC 17 Apr81)
Page7(19 of 213)
Section 2. The CP Command Language The CP represent a set of interactive console functions that are used (1) bV the operator to control the VM/370 system and (2) by a user to control a virtual machine. In this publication, only those commanas that are used to control a virtual machine are fully Other commands are referenced only to the extent necessary to show relationships and provide general knowledge. Privilege Classes fOi CP Commands Each user of VM/370 is assigned one or more privilege classes as part of the entry of the virtual machine. Each user class is indicative of a specific function of a virtual machine and entitles the user a specific subset of the CP command language. Fiqure 3 lists each CP privilege class along with the associated type of user ala function performed. Figure 3 also identifies the specific in which each class subset of :P commands is described in detail. Figure 4 is a list of CP commands by privilege classes. users are functionally divided into seven classes (A through G) with a correspondinq privilege class of CP commands, there is another small of commands available to all users. The eighth group consists)f commands that do not belong to a privilege class because they are used to perform certain basic functions that are required by all virtlal machines, such as logging on, logging off, and sending messages. These CP commands are in the Any class. This Plblication addresses itself as a reference manual for only the class G and class Any subsets of the CP command language. section 2. The CP Command Language 7
r ------, IClass I 1-------1 User and Function Al The class A user controls the pi Any2 , VM/370 system. Class A is assigned to the user at the VM/370 system console during IPL. The primary system operator is responsible for the availability of the VM/370 system and its Gommunication lines and resources. In addition, the class A crser controls system accountinq, broadcast messages, virtual machine performance options, and other command operands that affect the overall performance of VM/370. The system operator controls operation of the real machine using the system control panel and console device. The class A system operator who is automatically logged on during CP initialization is designated as the primary system operator. QEerator: The class B user controls allocation and deallocation of all the real resources of the VM/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 system programmer can modify real storage in the real machine. QEgtgtQI: The class D user controls spool data files and specific functions of the system's unit record equipment. !ngly§t: The class E user displays the contents of real storage, performs the functions required to generate systems and discontiguous saved segments, and controls the collection and recording of performance measurement data. This class of user can display the contents of specified real storale areas on the virtual operator's console or on a spooled virtual printer, but cannot modify real storage. The class F user obtains, and examines, in detail, certain data about input and output devices connected to the VM/370 system. The service representative can establish intensive recording mode for one device at a time and can cause the recording of repressable machine check errors to be initiated or resumed. Q§gr: The class G user controls functions associated with the execution of his virtual machine. A general user cannot display or modify real storage. The Any classification is qiven to certain CP commands that available to any user. These are primarily for the puroose of gaining and relinquishing access to the VM/370 system. , H Reserved for IBM use. 1 ,1Described in the 12Described in this publication. L Fiqure 3. CP Class Descriptions 8 VM/370 CO Command Feference for Users J
Section 2. The CP Command Language The CP represent a set of interactive console functions that are used (1) bV the operator to control the VM/370 system and (2) by a user to control a virtual machine. In this publication, only those commanas that are used to control a virtual machine are fully Other commands are referenced only to the extent necessary to show relationships and provide general knowledge. Privilege Classes fOi CP Commands Each user of VM/370 is assigned one or more privilege classes as part of the entry of the virtual machine. Each user class is indicative of a specific function of a virtual machine and entitles the user a specific subset of the CP command language. Fiqure 3 lists each CP privilege class along with the associated type of user ala function performed. Figure 3 also identifies the specific in which each class subset of :P commands is described in detail. Figure 4 is a list of CP commands by privilege classes. users are functionally divided into seven classes (A through G) with a correspondinq privilege class of CP commands, there is another small of commands available to all users. The eighth group consists)f commands that do not belong to a privilege class because they are used to perform certain basic functions that are required by all virtlal machines, such as logging on, logging off, and sending messages. These CP commands are in the Any class. This Plblication addresses itself as a reference manual for only the class G and class Any subsets of the CP command language. section 2. The CP Command Language 7
CP Command Reference for General Users (Rel 6 PLC 17 Apr81)
Page5(17 of 213)
r , I Character set Names Symbols I , , Separat::>r Blank , , Nation3.1 Dollar Siqn if; 'Dound c.; ,...,... # ....; ..... At Siqn W Al ph'l bet i:: Uppercase A - Z Lowercase a -z Numecic Numeric 0 - 9 Alph3.meri:: National $, i, CD 7\1 ph a bet ic A -Z a -z Numeric n. - 1"\ V Snecial All other characters L -.I Fiq 1 1re 2. Character Sets and Their contents section 1. The VM/370 Command Languages 5
CP Command Reference for General Users (Rel 6 PLC 17 Apr81)
Page9(21 of 213)
CP Commands Accepted from Each User Class The information should help the user interpret Figure 4. The table every CP command but it does nQ!' contain every operand. Fiqure 4 2n!y lists those operands that fall into these categories: • The operand for a command is unique to one particular privilege class; the operand cannot be specified by the same command when the commanj belongs to another privilege class. An example is the TRACE operanj which is only valid for the class F NETRORK command, but invalij for the command in class A or B. The operand is available for a command in several privilege classes, but one or more privilege classes exist that do not support the operanj. example is the SET command which has an AFFINITY operand available for class A and G commands, but not in the B or F class. commanjs listed without operands indicate that any valid operand associatej with the command can be specified in any class the command belongs t.:::>. The operands listed in the table in lowercase indicate either an or numeric specification is required. These lowercase operands include user identification (userid), virtual ajdress (vaddr), real address (raddr), and device type (device). For example: userid vaddr raddr pd58gh1c OOe, OOc, 1ac, 005 008, OOa, fff t3330, 3211, 2314, 1403 r---------------------------------, r I Class I Commands , Operands I Class Commands f------- , Any * I A iCP i (cont.) CP I DIAL I DISCONN I LOGOFF I LaGON I QUERY MESSAGE , SLEEP I I A ACNT I AUTOLOG , DISABLE I ENABLE I FORCE I I LaCK 1 MESSAGE ALL I SET MONITOR I NETWORK DISABLE I ., DISPLAY , I DUMP I I ENABLE , L ________ --' Fiqure 4. Commands Accepted from Each User Class (Part 1 of Section 2. The CP Command Operands HALT LOAD POLLDLAY QUERY SHUTDOWN VARY AFFINITY CPASSIST JOURNAL LOGMSG NAMES PAGING PRIORITY PROCESSOR SASSIST userid USERS AFFINITY CPASSIST FAVORED JOURNAL PRIORITY RESERVE 3) Language 9
r , r , I Class Commands Operands , Class Commands Operands , I i A I SASSIST I D HOLD I (cont.) , SHUTDOWN I (cont.) LOADBUF I I UNLOCK ORDER , I WARNING PURGE I I QUERY FILES I B I ATTACH HOLD I I AT'J'ACF CHANNEL LOGMSG I I AUTOLOG NAMES I I DEFINE SYSVIRT PRINTER I , VIRTUAL PUNCH I I DET!.CH READER I I DETACH CHANNEL userid I I Dr SABLE USERS I I ENABLE REPEAT , I MESSAGE ALL SPACE , , MSGNOH START I , NETWORK DISABLE TRANSFER , I DISPLAY I I DUMP E DCP I I ENABLE DMCP I I LOAD INDICATE 1/0 I I POLLDLAY LOAD , , QUERY PAGING , I VAFY QUEUES I I QUERY ALL USER I I LOCATE I I DUMP MONITOR , I GRAF QUERY AFFINITY , I LINES CPASSIST I I LOGMSG JOURNAL , , NAMES LOGKSG I , PROCESSOR NAMES I I raddr PAGING I , STOFAGE PRIORITY I I SYSTEM PROCESSOR I , TAPES SASSIST , I TDSK userid , I UR USERS , I userid SAVESYS , I USERS I I SET DUMP F NETWORK TRACE I LOGMSG QUERY LOGMSG I VARY NAKES I WARNI!'lG userid I USERS C I DCP SET RECORD I DMCP MODE I LOCATE G ADSTO? I QUERY LOGMSG ATTN I NAMES BEGIN I PROCESSOR CHANGE I userid CLOSE I USERS COUPLE I STCt.> DEFINE READER I PRINTER D I BACKSPAC PUNCH I CHANGE CONSOLE I DRAIN CTCA I FLUSH TIMER I FREE CHANNELS L ___ -.J L--- Fiqure 4. Commands Accepted from Each User Class (Part 2 of 3t 1 C) CP Command Peference for General Users