`
`
`
`Symantec 2022
`
`Veeam v. Symantec
`
`|PR2013-00150
`
`
`
`Virtual Machine/
`System Product
`
`CP Command Reference
`for General Users
`
`Release 4
`
`SC19~6211—3
`
`
`
`
`
`Notice: The term Virtual Machine/ System Product (abbreviated
`VM/SP), as used in this publication, refers to VM/SP when used in
`conjunction with VM/3 70 Release 6.
`
`Fourth Edition (December 1984)
`
`This edition, (SC19-6211~3) is a major revision of SC19—6211-2. This edition applies to
`the Virtual Machine/System Product Release 4. program number 5664-167, unlefi
`otherwise indicated in new editions or Technical Newsletters. Changes are periodically
`made to the information contained herein; before using this publication in connection with
`the operation of IBM systems. consult the latest IBM Swim/3 70 and 4300 Processors
`Bibliogrqphy, GCZO-OOOI. for the editions that are applicable and current.
`
`SummaryofChmcs
`
`For a detailed list of changes. see page iii.
`
`Changes or additions to text and illustrations are indicated by a vertical bar to the left of
`the change.
`
`References in this publication to IBM products. programs. or sci-vices do not imply that
`[BM 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.
`
`OldemtgPublications
`
`Requests for IBM publications should be made to your IBM representative or to the 13M
`branch office serving your locality. Publications are not stocked at the address given
`below.
`
`A form for reader‘s comments-is provided at the back of this publication. If the form has
`been removed, comments may be addressed to IBM Programming Publications. Dept.
`G60, PO. Box 6. Endicott. NY. USA. 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, 1984
`
`
`
`Summary of Changes
`
`To obtain editions of this publication that pertain to earlier releases of VM/SP, you
`must order using the pseudo-number assigned to the respective edition. For:
`
`Release 3, order ST00—1359
`Release 2, order 8019-6211
`Release 1, order ST19-6211
`
`Summary of Changes
`for SC19-6211-3
`
`for VM/SP Release 4
`
`VMD UMP Enhancements
`
`Diagnose function X‘ 94’ is available to allow a virtual machine to request
`dumping of its virtual storage. Also, the three address range restriction has
`been removed from the VMDUMP command.
`
`SHARED/NONSHARED Restriction
`
`With the addition of this support, any attempt to construct a virtual device
`configuration that would mix SHARED and NONSHARED device types on
`the same virtual control unit is rejected.
`
`TERMINAL Enhancements
`
`VM SNA Console Services (VSCS) graphics device users can access logged-on
`guest virtual machines with the DIAL command.
`
`The GRAF and CONSOLE options of the QUERY command contain
`additional function.
`
`The $10 instruction can be used with attached remote printers and dedicated
`graphics terminal devices.
`
`Summary of Changes
`for SC19—6211-2
`
`for VM/SP Release 3
`
`PER COMMAND
`
`The PER command is added to allow monitoring of certain events in the user’s
`virtual machine as they occur during program execution.
`
`Summary of Changes
`
`iii
`
`
`
`CMS PERFORMANCE ENHANCEMENT
`
`The discontiguous saved segment, CMSSEG, has been removed by merging
`modules from the CMSSEG segment into the CMS shared nucleus.
`
`DIAGNOSE ‘14’
`
`_
`DIAGNOSE X‘14’ has been modified so that subcodes X‘OFFE’ and
`X‘OFFF’ respect the SFBINUSE flag when the file is not in use by the reader.
`These subcodes wait for a file being used by a system function. If, however,
`the file is not available within the 25-milliseccnd time limit a condition code of
`
`3 and a return code of 24 is returned. This condition shows system problems
`because of performance or errors in the spoofing area.
`
`4245 LINE PRIMER SUPPORT
`
`The 4245 Line Printer is a channel-attached, high-speed line printer (2000
`LPM) using print band technology. It combines 3203 and 3262 technologies
`with newly developed hardware. The programming support for this printer is
`similar to the 3262 programming support. The 4245 is supported as a virtual,
`dedicated, and system printer. In addition, FCB lengths for the 4245 will be
`allowed the maximum length that hardware supports (256 byte length). It is
`not limited to a ISO-byte maximum length as are previous printers.
`
`3088 MULTISYSTEM CHANNEL COMMUNICA TI0N3 UNIT
`
`The IBM 3088 Multisystem Channel Conununications Unit interconnects
`multiple systems using block multiplexer channels. The 3088 uses an unshared
`subchannel for each unique address and is fully compatible with existing
`channel-to—channel adapter protocol.
`
`VM/SP 3800 MODEL 3 COMPATIBILITY
`
`VM users have access to the 3800 Model 1 and Model 3 Printing Subsystem.
`Existing programs designed to produce 3800 Model 1 printer output may
`produce output for the 3800 Model 3 printer with little or no program change.
`
`Use of this support provides improved print quality (240 X 240 pel resolution
`compared with the 180 X 144 pel resolution of the 3800 Model 1) and the
`addition of a 10 lines-per-inch (LPI) vertical space option.
`
`MISCELLANEOUS
`
`Minor technical and editorial changes have been made throughout this
`publication.
`
`iv VM/SP or Command Reference for General Users
`
`
`
`Summary of Changes
`for SCl9-621l-l
`for VM/SP Release 2
`
`PR OGRAMMA BLE OPERA TOR FA CILITY
`
`This facility provides the capability to: log messages, suppress messages,
`redirect messages, execute messages, or preprogram message'responses. The
`capabilities are under control of an editable message routine table in a CMS
`file.
`
`Inter-User Communication Vehicle (IUCV) enhancements for message
`handling are also included.
`
`DIAL COMMAND SUPPORTFOR REMOTE BSC 32 70 USERS
`
`This facility provides the ability for remote BSC 3270 users to issue the DIAL
`command. The remote 3270 appears to be a locally attached terminal to the
`dialed virtual machine.
`
`ENHANCED 3800 SUPPORT
`
`This facility allows the RSCS Networking Release 3 program product to pass to
`CF the 3800 attributes defined in a NJI header created by a system using the
`Network Job Interface (NII) protocol. This will also allow files created in
`these systems to print properly on a 3800 controlled by VM/ SP Release 2.
`Copy group and burst attributes remain unsupported.
`
`COMMAND RETRIEVE CAPABILITY
`
`A RETRIEVE option is added to the CP SET program function command.
`When specified, the system will save input lines. When the specified program
`function key is pressed, the saved input lines are redisplayed in the reverse
`sequence of entry.
`
`QUER Y COMMAND ENHANCEMENT
`
`The QUERY command is enhanced to allow the user to specify the operands
`“USERID” or “CPLEVEL.” The QUERY USERID command responds with
`the userid and with the system identifier of the system that the user is logged
`on to. The QUERY CPLEVEL command provides information relative to the
`software product’s name (e.g. VM/SP). release number, service level number,
`nucleus creation date and time, along with the .[PL date and time. Time zone
`information is also included.
`
`ENHANCED ASCII SUPPORT
`
`This support provides the 3101 terminal user with the following capability:
`
`.
`
`.
`
`Screen Management - controlled scrolling of output
`
`Improved Communication Line Utilization - compression of contiguous
`blanks
`
`Summary of Amendments V
`
`
`
`.
`
`Program Function Key Support (1-8)
`
`In addition, support for other ASCII terminal users includes the following:
`
`.
`
`Prompting - Line feed prompting can be selected to allow data to be
`entered starting in column 1
`
`'
`
`. Read operations can be command-chained to the write operations
`
`.
`
`Line size control option has been added
`
`MISCELLANEOUS
`
`Minor technical and editorial changes have been made throughout this
`publication.
`
`Vi VM/SP CP Command Reference for General Users
`
`
`
`Preface
`
`This publication is a reference manual that discusses the IBM-Defined Class G
`VM / SP CP commands available to the general user.
`
`The user should be knowledgeable of the concepts of VM/SP as outlined in the
`Virtual Machine/System Product Introduction, Order No. 6019-6200. In addition,
`the user should be aware of the logon process, terminal-initiated interrupts,
`terminal modes, and the method of switching from GP to virtual machine mode and
`vice versa. This information is detailed in the Virtual Machine /’System Product
`Terminus! Reference. Order No. (3019-6206.
`
`With the commands described in this publication, the general user can reconfigure
`his virtual machine, control devices attached to his virtual machine, perform input
`and output spoofing functions, and simulate many other functions of a real
`computer console.
`
`Other VM/ SP CP commands, available only to system operators, system
`programmers and analysts, and service representatives, are described in the
`publication Virtual Machine/Swen: Product Operator’s Guide, Order No.
`SCl9-6202.
`
`This publication is organized in two parts: “Part 1. Guidance Information" and
`“Part 2. Reference Information.” There is also an appendix.
`
`Part 1 has three sections:
`
`“Section 1. The CP Command Syntax” describes the VM/SP command
`environments and the general structure of the CP command language.
`
`“Section 2. The CP Command Language” provides additional information on the
`CP command set, including the optional user-defined classes.
`
`“Section 3. CP Command Usage” describes the use of CP commands to control
`terminal sessions, control [/0 devices, test and debug programs, and control virtual
`machine functions.
`
`Part 2 has two sections:
`
`“Section 4. Notational Conventions" describes the syntax that is used in this
`publication to display command formats and command truncation and
`abbreviation.
`
`“Section 5. Format of CP Commands” contains reference data for all the class G
`and class Any commands in alphabetical sequence by command name. The
`
`Preface Vii
`
`
`
`command line format includes all operands along with a description of each. Any
`limitations or restrictions applicable to the values of variable operands are also
`defined.
`
`“Appendix A. VM/SP Command Summary" contains all of the VM/SP
`commands, with a brief description of each command’s function. This is intended
`to give the general user a perspective of the position that the CP class G and class
`Any commands occupy in the overall VM/SP command structure.
`
`In this publication, the following terminology is used:
`
`-
`
`.
`
`.
`
`.
`
`The term ‘cylinder’ is used to describe DASD space on Direct Access Storage
`Devices (count—key—data devices) supported by the VM/ SP System Control
`Program. The term ‘block’ is used to describe DASD space on FB—512
`devices. Specifically, FB-S 12 devices are the IBM 3310 and 3370 Direct
`Access Devices employing'fixed block mode. The term ‘DASD space’ may
`appear in text when there is no need to differentiate between count-key-data
`devices and FB—S l 2 devices.
`
`“23 05” refers to the IBM 2305 Fixed Head Storage, Models 1 and 2.
`
`The term “3088" refers to the IBM 3088 Multisystem Communications Unit
`Models 1 and 2.
`
`The term, “3270,” is used in this publication to refer to a series of display
`devices, namely, the IBM 3275, 3276, 3277, 3278, and 3279 Display Stations,
`and the 3290 Information Panel. A specific device type is used onlyr when a
`distinction is required between device types. Information about display
`terminal usage also applies to the IBM 3138, 3148, 3158, 3033, and 3036
`Display Consoles when used in display mode, unless otherwise noted.
`
`9 Any-information pertaining to the IBM 3284 or 3286 printer also pertains to
`the IBM 3262, 3287, 3288 and 3289 printers unless otherwise noted.
`
`.
`
`.
`
`.
`
`.
`
`o
`
`.
`
`“3330” refers to the IBM 3330 Disk Storage Models 1, 2, 11; the IBM 3333
`Disk Storage and Control Models 1 and ll 1; and the 3350 Direct Access
`Storage operating in 3330/3333 Model 1 or 3330/ 3333 Model 2 compatibility
`mode.
`
`“3340” refers to the [BM 3340 Disk Storage, Models A2, BI, 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.
`:
`
`“3370” refers to the IBM 3370 Direct Access Storage, Models A1, A2, 231,
`and 32.
`
`“3375” refers to the IBM 3375 Direct Access Storage.
`
`“33 80” refers to IBM 3380 Direct Access Storage.
`
`viii.
`
`VM/SP CP Command Reference for General Users
`
`
`
`.
`
`“VM/STO hardware assist” refers to both the virtual machine assist function
`and VIM/370 Extended Control-Program Support. Some form of the VM/370
`hardware assist is available on all VM/ 3 70 supported System/370 systems
`except the 155 11, 165-111, and 4331. Refer to Virtual Machine/System Product
`Manning Guide and Reference. Order No. SC 19-620 1, for further device
`information on the VM/ 370 hardware assist and ECPS features.
`
`. Any information pertaining to the IBM 2741 terminal also applies to the IBM
`376? terminal, Model 1, Operating as a 2741, unless otherwise specified.
`
`.
`
`.
`
`.
`
`.
`
`The term “processor” used in this publication means the main processor which
`is the processor with 1/0 handling capabilities. The term “attached processor”
`means a processor that has no I/O capabilities; an attached processor is always
`linked to a main processor for utilization. VM/SP also supports real
`multiprocessor (MP) configurations on the 158MP, 168MP, and 303.3MP
`processors. In a MP system, the term “IPL processor” refers to the processor
`that is initialized first during system generation. The term “nonIPL. processor”
`refers to the processor that is initialized after the IPL processor. Both the [PL
`and nonIPL processors in a real MP configuration have [/0 capabilities.
`
`“3800” refers to the IBM 3800 Printing Subsystem, Models 1 and 3. A
`specific device type is used only when a distinction is required between device
`types.
`
`“3850” refers to the IBM 3850 Mass Storage System.
`
`“4243" refers to the IBM 4248 Printer.
`
`- Unless otherwise noted, the term VSE refers to the combination of the
`DOS/VSE system control program and the VSE/Advanced Functions program
`product.
`
`In certain cases, the term DOS is still used as a generic term. For example, the
`disk packs initialized for use with VSE or any predecessor DOS or DOS/VS
`system may be referred to as DOS disks.
`
`For a glossary of VM/ SP terms. see the Virtue! Machine/System Product library
`Guide and Master Index, Order No. GC19-6207.
`
`Prerequisite Publications
`
`The concepts of VM / SP are described in the Virtual Machine/System Product
`Introduction, Order No. GC19-6200.
`
`The physical operation of the virtual machine console is covered in the Virtual
`Machine/System Product Tenninai Reference, Order No. GOD-6206.
`
`If the IBM 376’? Communications Terminal is to be used as a virtual console, the
`publication IBM 3 767 Operator’s Guide, Order No. GAB-2000, is a prerequisite.
`
`Preface
`
`ix
`
`
`
`The VM/SP Library
`
`
`
`Evaluation
`
`QENERAL
`iNFOHMAHON
`
`
`
`Planning
`
`PLAWNB
`GLIDE ”D
`HWEHCE
`
`ECHO-£201
`
`Administration
`
`..
`
`..... :1
`
`
`
`
`
`
`
`LEW
`GUIDE.
`GLOBE-IRY.
`AW .
`MASTER INEEI
`act—m?
`
`8624—5137
`
`installation"Z"
`
`
`
`"STALLA'HON
`GUII
`
`
`
`
`
`
`Applications
`K
`
`"
`
`SCWJZC
`
`Scab-52"
`
`To Omar a] the Harem-um Sm'lnlrlaa. use ardlr um BBOF 8221
`
` —-——w—.—-n..-.———
`
`commas
`(GENERAL
`UGEFO
`
`“20-44-01
`
`SP
`COW 3P EDITOR
`INTEPHEI'E!
`[Other than
`comp
`“WWCE
`mural Used
`fiEFEiEiICE
`W SUM
`Emir-5122
`find-512$
`
`5):me
`
`PCS
`REFERENCE
`SUMMARY
`
`$X24-51BB
`
`3024-51247
`
`X VNUSP CP Command Reference for General Users
`
`
`
`
`
`Diagnosis
`
`
`
`
`
`
`OL‘TGEP
`NIB ERHCH
`RECORDING
`GLIDE
`
`WOW
`
`mu mAID CONTROL
`BLOCKS
`VOL. 2 (ONE)
`
`
`
`DNA-6:231
`
`
`89-33-011?
`
`Device a
`ETQ-mm
`
`on Funnies
`
`"I
`gum-mm“
`[Hg
`
`
`
`Auxiliary C ornrnunication Support
`
`HSCS NBMI
`“anion 2 W
`5064-485
`
`Wm
`ufimmmmm
`
`For wm
`_ WNW!)
`
`Preface Xi
`
`
`
`Associated Publications
`
`CP error messages and return codes that may be issued to a user during a terminal
`session are documented in Virtual Machine/System Product System Messages and
`Codes, Order No. SC 19-6204.
`
`General users intending to use CMS should refer to the following publications for
`information on the CMS command language and its implementation:
`
`Virtual Machine/Swi‘em Product
`
`CMS Command and Macro Reference, Order No. SC 19-6209 ..
`
`CMS User’s Guide, Order No. SCl9-6210
`
`The RSCS component of VM/ 3 70 remains unmodified by the VM/ SP program
`product If the general user intends to use the unmodified VM/ 370 component, he
`should refer to the following publication for information on the RSCS command
`language:
`
`Virmaf Machine Focilfna/3 70:
`
`Remote Spoofing Communications Subsystem (RSCS) User ’3 Guide, Order No.
`GCZO— 181 6
`
`In addition, VM/SP users can have enhanced networking facilities provided in the
`RSCS Networking program product (S748-XP1). The following publication
`contains information about the command languages of the RSCS Networking
`program product.
`
`VM/3 70 RSCS Networking Program Reference and Operations Guide, Order No.
`SH24-5005
`
`VM/SP has an enhanced interactive problem control system (VM/SP IPCS)
`component. This component replaces the unmodified VM/370 interactive problem
`control system. Details of this major component are found in the I’M/SP
`Interoctim Problem Control System Guide, SC24-5260.
`
`Note: VM/ SP IPCS provides extended function over the IPCS ExtenSion Program
`Product (5748-SA1).
`
`References in text to titles of prerequisite and corequisite VM/SP publications are
`given in abbreviated form.
`
`xii
`
`VM/ SP CP Command Reference for General Users
`
`
`
`Contents
`
`Part1. Guidancelnformation
`
`1
`
`The CP Command Syntax . ......................................... 3
`VM/ SP Command Environments ..............................' ...... 3
`VM/ SP CP Command Structure
`.................................... 4
`The Command Name ........................................... 4
`
`The Command Operands ........................................ 4
`Comments in the 0? Command Language ........................... 4
`Character Set Usage ............................................ S
`
`The CP Command Language ........................................ 7
`Privilege Classes for CP Commands .................................. 7
`The Class G Commands ......................................... 9
`
`The Class Any Commands ...................................... 10
`
`ll
`. ............. .
`CP Command Usage ........................... . . .
`Controlling Input and Output Functions .............................. 13
`Virtual Disks ................................................. 15
`Permanent Virtual Disks ........................................ 15
`
`....................................... 15
`Temporary Virtual Disks
`Sharing Virtual Disks .......................................... 16
`Virtual Unit Record Devices ..................................... 16
`
`Virtual Unit Record Spooling .................................... l6
`Spool File Characteristics ....................................... 17
`Virtual Console Spoofing ....................................... 19
`Reordering and Purging Spool Files ............................... 20
`Dedicated Devices
`............................................ 20
`Dedicated Channels ........................................... 21
`
`Controlling the Virtual Machine .................................... 22
`Loading an Operating System .................................... 22
`Simulating Interrupts
`.................................. '........ 24
`Entering CP Commands ........................................ 24
`Entering CP Commands when the Virtual Machine Is Running .......... 25
`Entering CP Commands from the Virtual Console Read Environment
`.
`.
`.
`. 26
`Entering CP Commands from CP Console Function Mode ............. 26
`Reconfiguring the Virtual Machine ................................ 27
`Testing and Debugging of Programs ................................. 27
`Stopping Execution of Your Virtual Machine ........................ 28
`
`Displaying Virtual Storage ...................................... 28
`Terminal Output .............................................. 29
`Byte Alignment on Terminal Output
`.
`.
`.' ........................... 29
`
`Contents
`
`xiii
`
`
`
`.......................... ' ..................... 30
`Printer Output
`Altering Virtual Storage ........................................ 31
`TracingVittualMachineActivity
`................ 33
`Using the PER Command ....................................... 35
`Selectivity 36
`Terminating PER ............................................. 37
`SuspendingPER
`.................................. 37
`Additional Program Debugging Using PER ......................... 38
`The Branch Trace-back Table .................................... 38
`The PER COUNT Sub-Command ................................ 39
`
`The PER Command Option ..................................... 41
`Storage Alteration
`............................................ 42
`GUESTR and GUESTV ....................................... .. 43
`
`Part2. Referencelnformatio“ CC.0......CCICOIOCCO'COCICO 4s
`
`Notational Conventions ........................................... 4‘7
`
`Format of CP Commands .......................................... 51
`* ............................................................ 52
`#CP .......................................................... 53
`ADSTOP
`..................................................... 55
`ATTN ........................................................ 5?
`BEGIN ....................................................... 58
`CHANGE ..................................................... 59
`CLOSE ....................................................... 64
`COMMANDS .................................................. 63
`COUPLE .
`.- .......................................' ............ 6 9
`CP ........................................................... 71
`
`DEFINE ......... , ............................................ 7 3
`DETACH ..................................................... 83
`.DETACH CHANNEL ........................................... 86
`DIAL ........................................................ 87
`DISCONN .................................................... 90
`DISPLAY ..................................................... 92
`DUMP ....................................................... 98
`ECHO ...................................................... 102
`EXTERNAL .................................................. 103
`INDICATE ................................................... 104
`[PL ......................................................... 108
`LINK ....................................................... 1 13
`LOADVFCB ................................................. 1 19
`LOGOFF .................................................... 122
`LOGON ..................................................... 125
`MESSAGE ................................................... 129
`NOTREADY ................................................. 1 3 1
`ORDER ..................................................... 132
`PER ........................................................ 134
`Merging Trace Elements ....................................... 146
`Changing Options on Trace Elements ............................ 146
`Changing Specific Trace Elements ............................... 147
`PURGE ..................................................... 1 57
`QUERY ..................................................... 159
`
`xiv VM/SP CP Command Reference for General Users
`
`
`
`QUERY Command for Class G Users ............................ 161
`
`QUERY Command for All Classes of Users (Except Class Any) .......... 183
`READY ..................................................... 1 8?
`REQUEST ................................................... 1 88
`RESET ...................................................... 1 89
`REWIND .................................................... 190
`SCREEN .................................................... 1 9 1
`SEND ....................................................... 1 94
`SET ......................................................... 196
`SLEEP ...................................................... 213
`SMSG ....................................................... 215
`SPOOL ...................................................... 217
`STORE ...................................................... 228
`SYSTEM ..................................................... 232
`TAG ........................................................ 234
`TERMINAL .................................................. 238
`TRACE ..................................................... 246
`TRANSFER .................................................. 253
`VMDUMP ................................................... 257
`
`Appendix A. CP Command Summary ................................ 263
`
`Index ................................................
`
`271
`
`Contents
`
`XV
`
`
`
`xvi VM/SP CP Command Reference for General Users
`
`
`
`Figures
`
`Character Sets and Their Contents .............................. 5
`
`8
`......
`IBM-Defined and Function Type CP Privilege Class Descriptions
`Controlling the Virtual Machine During a Terminal Session .......... 12
`System Action to #CP Command
`.............................. 54
`Action Taken on CLOSE for a Virtual Input Device.
`............... 66
`Action Taken on CLOSE for a Virtual Output Device
`.............. 67
`Available Form Width Codes .................................. 81
`
`. 116
`.
`Illustration of the Type of Link Established Under Every Condition .
`3270 High. Intensity Features ................................. 245
`
`PWHP‘EAPE‘9PI‘
`
`Figures xvii
`
`
`
`XViii VM/ SP CP Command Reference for General Users
`
`
`
`Part 1. Guidance Information
`
`N
`
`This part of the publication contains general information about the Virtual
`Machine/ System Product (abbreviated VM/ SP) system. It contains three sections.
`
`“The CP Command Syntax” describes the CP command environments and the
`general structure of the command languages.
`
`“The CP Command Language" provides additional information on the CP
`command set.
`
`“CP Command Usage” describes a variety of user requests Via class G CP
`commands.
`
`Part 1. Guidance Information
`
`1
`
`
`
`2 VM/ SP CP Command Reference for General Users
`
`
`
`The CP Command Syntax
`
`The CP component of VM/ SP has its own command language. Much like any
`other language, the CP command language has a set 3 rules and structures. This
`section describes the CP command language environment, syntax and structure,
`giving general descriptions of command names, operands and their position on the
`command line, and character set usage in OF. A further discussion of CP
`commands is included in VM/SP Operating System in a Virma! Machine.
`
`There are two types of CP commands: system commands and user—defined
`commands. Depending on your privilege class, you can issue CP system commands
`to do various system oriented functions. Privilege class is discussed in “Section 2.
`The CP Command Language.” You, as a class G, or general, user can use CP
`commands to simulate the function of the system operator’s console. You can issue
`commands to control the operating system running in your virtual machine much
`like an operator controls the entire VM/ SP operating system using the keys and
`switches on his system console. User—defined CP commands are aIIOWed, too;
`however, your system programmer must create them for you. The procedure for
`creating your own CP commands is detailed in I’M/SP System Programmr’s
`Guide.
`
`VM/SP Command Environments
`
`There are two basic command environments: the control program (CP) command
`environment and the virtual machine command environment.
`
`You are in the control program (CP) command environment when you log on to
`VM/ SP and issue CP commands.
`
`You are in the virtual machine command environment when you load your virtual
`machine with CMS or another operating system.
`
`If you are operating under CMS, you can determine which command environment
`you are in by entering a null line (that is, pressing the enter key, or equivalent, with
`no data). VM/SP responds to a null line by displaying the current command
`environment, CMS or CF.
`
`The CP Command Syntax
`
`3
`
`
`
`The CP Command Syntax
`
`VM/ SP CP Command Structure
`
`A VM/SP command consists of a command name, usually followed by one or more
`positional operands. The general form for the CP command line is:
`
`
`
`You must use one or more blanks to separate each entry in the command line
`unless otherwise indicated.
`
`The Command Name
`
`The command name is an alphameric symbol of not more than eight characters. In
`general, the names are verbs that describe the function you want the system to
`perform. For example, you may want to find out whether or not a certain user is
`logged on the VM/SP system. In this case, you would use the CP QUERY
`command.
`
`The Command Operands
`
`The command operands are keywords and positional operands of no more than
`eight alphameric characters each. The operands specify the information on which
`the system operates when it performs the command function. For the QUERY
`command, for example, you could use the USER or userid operand to find out
`whether the user is on the system.
`
`Some commands require no operands; others require several. You can find each
`class G and class Any command with all of its operand requirements in “Section 5:
`Format of CP Commands” of this publication.
`
`You must write the operands in the order in which they appear in the command
`formats in Section 5, unless otherwise specified.
`
`Comments In the CP Command Language
`
`You can write comments with CP commands of the following types:
`
`. Commands with no operands
`- Commands with a fixed number of operands
`. Commands with a single optional operand
`
`You should not write comments with commands that have a variable number of
`
`operands or with commands that have more than one optional operand. If you do,
`the comment could be interpreted as an operand.
`
`You can enter comments on your console by using the CP * command.
`
`4 VM/SP CP Command Reference for General Users
`
`
`
`The CP Command Syntax
`
`
`Character Set Usage
`
`VM/SP commands are entered using a combination of characters from six different
`character sets. The contents of each of the character sets is described in Figure 1.
`
`Character Set
`
`Separator
`
`National
`
`Alphabetic
`
`Numeric
`
`Alphameric
`
`Dollar Sign
`Pound Sign
`At Sign
`
`Uppercase
`Lowercase
`
`National
`Alphabetic
`
`Numeric
`
`
`
`—_ All chcr characters
`
`Figure 1. Character Sets and Their Contents
`
`The CP Command Syntax
`
`5
`
`
`
`The CP Command Syntax
`
`6 VM/ SP CP Command Reference for General Users
`
`
`
`The CP Command Language
`
`The CP commands represent a set of interactive console functions that are used (1)
`by the operator to control the VM/SP system and (2) by a user to control a virtual
`machine.
`In this publication, only those commands that are used to control a
`virtual machine are fully documented. Other commands are referenced only to the
`extent necessary to show relationships and provide general knowledge.
`
`Privilege Classes for CP Commands
`
`Each user of VM/ SP is assigned one or more privilege classes as part of the
`directory entry of the virtual machine. Each user class is indicative of a specific
`function of a virtual machine and entitles the user to a specific subset of the CP
`command language.
`
`Your installation may add to, or delete from, this set of commands in order to tailor
`the command set to your needs. Your installation administrator should make you
`aware of any changes of this type.
`
`If your installation chooses to change user classes, you may record the changes in
`the blank column in Appendix A, Command Summary, in the back of the book.
`
`This publication is a reference manual for class G and class ANY subsets of the CP
`command language.
`
`Figure 2 on page 8 lists each CP privilege class along with the associated type of
`user and function performed. Figure 2 on page 8 also identifies the specific
`publications in which each class subset of CP commands is described in detail.
`
`For a complete list of CP commands grouped by privilege class, refer to VM/SP
`Operators Guide.
`
`Although users are functionally divided into seven classes (A through G) with a
`corresponding privilege class of CP commands, there is another small group of
`commands available to all users. The eighth group consists of commands that do
`not belong to a privilege class because they are used to perform certain basic
`functions that are required by all virtual machines, such as logging on, logging off,
`and sending messages. These CP commands are in class Any.
`
`The CP Command Language
`
`7
`
`
`
`The CP Command Language
`
`FUNCTION USER
`DEFINED TYPE
`AND
`FUNCTION
`
`Operation.-
`
`The primary system operator can issue all Class A commands. The class A user
`controls the VM/ SP system. Class A is assigned to the user at the VM/ SP
`system console during IPL. The primary system operator is responsible for the
`availability of the VM/ SP