IBM Virtual Machine Facility/370: Operator's Guide 2
Page58(58 of 260)
Paqe of GC20-1806-9 As Updated April 1, 1981 by TNL GN2S-0834 .-- Class Commands Operands Class Commands Operands I I D READER G CONSOLE t (cont. ) userid (cont.) DASD USERS FILES REPEAT CPUID SPACE GRAF START LINES TRANSFER LINKS E DCP LOGlISG DflCP NAlIES INDICATE I/O PFnn LOAD PRINTER PAGING PROCESSOR USER PUNCH QUEUES READER LOCATE SET !!ONITOR STORAGE QUERY AFFINITY TAPES CPASSIST TER!!INAL JOURNAL TlflE LOGMSG UR NAMES userid PAGING USERS PRIORITY vaddr PROCESSOR VIRTUAL SASSIST READY userid REQUEST USERS RESET SAVESYS REWIND SET AFFINITY F QUERY LOGMSG ACNT NAMES ASSIST userid AUTOP.QLL USERS CPUID SET RECORD ECMODE MODE EMSG G ADSTOP I!!SG ATTN ISAfI BEGIN LINEDIT CHANGE ftSG CLOSE NOTRANS COUPLE PAGEX DEFINE PFnn DETACH RUN DETACH CHANNEL SMSG DISPLAY TIMER DUMP WNG ECHO SMSG EXTERNAL SPOOL INDICATE LOAD STORE USER SYSTEM IPL TAG DEV LINK FILE LOADVFCB QUERY NOTREADY TERMINAL ORDER TRACE PURGE TRANSFER QUERY ALL VKDUflP CHANNELS Figure 5. Commands Accepted from Each User Class (Part 2 of 2) 40 VM/370 Guide
OPERATOR CO!!ANDS section 3 describes CP commands available to users with the privilege classes of A, B, C, D, E, and F. These privilege classes are assigned to users who manage the V!/370 system and ,spooling and hardware resources. The privilege class G commands control the functions of the general user's virtual .achine. Consult the V!LJ1Q CP Reference for information on all G privilege class commands. The class of commands,described as "Any", which can be used by any user of the system, are also described in the !!/370 CP £QI!gnd NOTATIONAL CONVENTIONS The notation used to define the command syntax for V8/370 is: • Truncations and Abbreviations of Commands Where truncation' of a command name is permitted, the shortest acceptable version of the is represented by uppercase letters. (Remember, ho¥ever, that VM/370 ccmmands can be entered with any combination of uppercase and lowercase letters.) The example below shows the format specification for the INDICATE command. INDicate This representation means that IND, INDI, IBDIC, INDICI, IBDICIT, and INDICATE are all valid specifications for this command name. Operands are specified in the same manner. Where truncation is permitted, the shortest acceptable version of the operand is represented by uppercase letters in the command format box. If no minimum truncation is noted, the entire word (represented by all capital letters) must be entered. Abbreviations are shorter forms of com.and names and operands. Abbreviations for command names are shown below the full name in the format box. Abbreviations for operands are shown in the description of the individual operands that follows the format box. For example, the operand READER has both a minimum truncation and an abbreviation. In the foraat bOX, it is shown as: Reader indicating that the m1n1mum truncation is R. In the discussion of the READER operand that follows the format bleck, it is shown as: READER RDR indicating that the specifications for the REIDER, and RDR. abbreviation is RDR. Thus, the acceptable READER operand are: R, RE, REA, READ, REIDE, Section 3. CP Commands 41
Paqe of GC20-1806-9 As Updated April 1, 1981 by TNL GN2S-0834 .-- Class Commands Operands Class Commands Operands I I D READER G CONSOLE t (cont. ) userid (cont.) DASD USERS FILES REPEAT CPUID SPACE GRAF START LINES TRANSFER LINKS E DCP LOGlISG DflCP NAlIES INDICATE I/O PFnn LOAD PRINTER PAGING PROCESSOR USER PUNCH QUEUES READER LOCATE SET !!ONITOR STORAGE QUERY AFFINITY TAPES CPASSIST TER!!INAL JOURNAL TlflE LOGMSG UR NAMES userid PAGING USERS PRIORITY vaddr PROCESSOR VIRTUAL SASSIST READY userid REQUEST USERS RESET SAVESYS REWIND SET AFFINITY F QUERY LOGMSG ACNT NAMES ASSIST userid AUTOP.QLL USERS CPUID SET RECORD ECMODE MODE EMSG G ADSTOP I!!SG ATTN ISAfI BEGIN LINEDIT CHANGE ftSG CLOSE NOTRANS COUPLE PAGEX DEFINE PFnn DETACH RUN DETACH CHANNEL SMSG DISPLAY TIMER DUMP WNG ECHO SMSG EXTERNAL SPOOL INDICATE LOAD STORE USER SYSTEM IPL TAG DEV LINK FILE LOADVFCB QUERY NOTREADY TERMINAL ORDER TRACE PURGE TRANSFER QUERY ALL VKDUflP CHANNELS Figure 5. Commands Accepted from Each User Class (Part 2 of 2) 40 VM/370 Guide
OPERATOR CO!!ANDS section 3 describes CP commands available to users with the privilege classes of A, B, C, D, E, and F. These privilege classes are assigned to users who manage the V!/370 system and ,spooling and hardware resources. The privilege class G commands control the functions of the general user's virtual .achine. Consult the V!LJ1Q CP Reference for information on all G privilege class commands. The class of commands,described as "Any", which can be used by any user of the system, are also described in the !!/370 CP £QI!gnd NOTATIONAL CONVENTIONS The notation used to define the command syntax for V8/370 is: • Truncations and Abbreviations of Commands Where truncation' of a command name is permitted, the shortest acceptable version of the is represented by uppercase letters. (Remember, ho¥ever, that VM/370 ccmmands can be entered with any combination of uppercase and lowercase letters.) The example below shows the format specification for the INDICATE command. INDicate This representation means that IND, INDI, IBDIC, INDICI, IBDICIT, and INDICATE are all valid specifications for this command name. Operands are specified in the same manner. Where truncation is permitted, the shortest acceptable version of the operand is represented by uppercase letters in the command format box. If no minimum truncation is noted, the entire word (represented by all capital letters) must be entered. Abbreviations are shorter forms of com.and names and operands. Abbreviations for command names are shown below the full name in the format box. Abbreviations for operands are shown in the description of the individual operands that follows the format box. For example, the operand READER has both a minimum truncation and an abbreviation. In the foraat bOX, it is shown as: Reader indicating that the m1n1mum truncation is R. In the discussion of the READER operand that follows the format bleck, it is shown as: READER RDR indicating that the specifications for the REIDER, and RDR. abbreviation is RDR. Thus, the acceptable READER operand are: R, RE, REA, READ, REIDE, Section 3. CP Commands 41
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
Page60(60 of 260)
• The following symbols are used to define the co.mand format and should never be typed when the actual command is entered. underscore braces { } brackets [] ellipsis • Uppercase letters and words, and the following symbols, should be entered as specified in the format box. asterisk * comma hyphen equal sign = parentheses () period colon • Lowercase letters, words, and symbols that appear in the command format box represent variables for which specific information should be substituted. Por example, "hexloc" indicates that a hexadecimal storage location address is to be entered. • Choices are represented in the command format boxes by stacking. A B C • An underscore indicates an assumed default. If an underscored choice is selected, it need not be specified when the command is entered. The representation 1 C indicates that either 1, selected, it need not be assumed. B, or C may be selected. However, if B is specified. Or, if none is entered, B is • The use of braces denotes choices, one of which be selected. The representation { i } indicates that you specify either 1, or B, or C. choices is enclosed by neither brackets or braces, treated as if enclosed by braces. 42 i!/370 Operator's Guide If a list of it is to be
• The use of brackets denotes choices, one of which be selected. • The representation r , I A I I B I I C I L J indicates that you may enter A, B, or C, or you may omit the field. In instances where there are nested lines, the following rule applies; dependent upon the selection of the nesting. [Level 1 [Level 2 [Level 3 ]]] [filename [filetype [filemode]]] braces or brackets on the text Nested operand selectibn is operand of a higher level of Where the highest level of nesting is the operand that is enclosed in only one pair of brackets and the lowest level of nesting is the operand that is enclosed by the maximum number of brackets. Thus in the previous example, the user has the option of selecting a file by filename only, or filename filetype only or by filename filetype filemode. The user cannot select filetype alone because filetype is nested within filename; and, as noted, our rule states: the higher level of nesting .ust be selected in order to select the next level (lower level) operand. The same is true if the user wants to select filemode; filename and filetype must also be selected. • An ellipsis indicates that the preceding ite. or group of items may be repeated more than once in succession. Exa!!£le The representation {spoolid1 spoolid2 ••• } indicates that more than one spoolid may be coded within the braces. Section 3. CP Commands 43