==Phrack Inc.== Volume Three, Issue 27, File 2 of 12 Operating the IBM VM/SP CP (IBM Virtual Machine System Product Control Program) An information article researched by Taran King May 18, 1989 This article is for the purpose of understanding the Control Program (CP) portion of IBM's VM/SP. This is basically a separate section of VM/CMS known as CP (with full screen editors, the CP level is indicated in the lower right hand corner of the screen and for line-by-line editors, before the command line and after hitting carriage returns, it should say "CP") and it's purpose is to manage real resources. Any command that involves something outside of your virtual machine must communicate with CP. If CMS does not recognize a command you give it, it will give it to CP. The user generally enters the CP stage after a program flops or if you get disconnected. You can also enter the CP stage by hitting PA1 which is a function key of sorts. PA1 toggles between CP and CMS while on-line and if you re-login after being disconnected, PA1 can be used besides the BEGIN command which will be spoken about later in this article. Generally, VM/CMS systems are well equipped with help files so if anything I print becomes unclear to you, from CMS mode, type HELP CP XXX where XXX is the CP command you want information on. To start this article off, I'm printing off the IBM-Defined Class and the Function Types as listed in the IBM VM/SP CP manual. This essentially tells you what privileges you have with your assigned class. ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ IBM-Defined Function User & Class Type Functions ~~~~~~~~~~~ ~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A O Operations: The primary sysop 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 sysop is responsible for the availability of the VM/SP system 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 the VM/SP. The sysop controls operation of the real machine using the system control panel and console device. NOTE: The class A sysop who is automatically logged on during CP initialization is designated as the primary sysop. B R Resource: The system resource operator can issue all class B commands. The class B user controls allocation and deallocation of all the real resources of the VM/SP system, except those controlled by the primary sysop and spooling operator. C P Programmer: The system programmer can issue all class C commands. The class C user updates certain functions of the VM/SP system. The system programmer can modify real storage in the real machine. D S Spooling: The spooling operator can issue all class D commands. The class D user controls spool data files and specific functions of the system's unit record equipment. E A Analyst: The system analyst can issue all class E commands. The class E user displays the contents of real storage, performs the functions required to generate saved systems and discontiguous saved segments, and controls the collecting and recording of performance measurement data. This class of user can display specified real storage areas on the virtual operator's console or on a spooled virtual printer, but cannot modify real storage. F C Customer Engineer: The service representative can issue all class F commands. The class F user obtains, and examines, in detail, certain data about input and output devices connected to the VM/SP system. The service representative can establish extensive recording mode for one I/O device at a time and can cause the recording of repressible machine check errors to be initiated or resumed. G G General: The general user can issue all class G commands. The class G user controls functions associated with the execution of his virtual machine. A general user cannot display or modify real storage. ANY ANY The ANY classification is given to certain CP commands that are available to any user. These are primarily for the purpose of gaining and relinquishing access to the VM/SP system. ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ The following is the list of commands available along with a brief description as to what they do and/or formatting and then ending with the IBM-Defined Class and Function Type. * : From CP, one may use the * command to annotate the terminal console sheet ~ or the terminal display screen with a comment. In other words, type * and then any string of characters you would, for some reason, to be present on the screen thereafter. Privilege Class: ANY Function Type: N/A #CP : This command is used to execute a CP Command while in a virtual machine ~~~ command environment without first signaling attention to get to the CP command environment which means that when typing P to perform a CP operation, CP directly receives the command whereas CP merely queues the command from CP. Privilege Class: ANY Function Type: ANY ACNT : The ACNT command is used to create accounting records for logged on ~~~~ users and to reset accounting data. It also closes a spool file that is accumulating accounting records. Privilege Class: A Function Type: O ADSTOP : The ADSTOP command is used to halt the execution of a virtual machine ~~~~~~ at a virtual instruction point. The hexloc variable may be placed after the word ADSTOP which is a 6 character hexadecimal representation of the virtual instruction address where the execution is to be halted. The OFF option of the ADSTOP command cancels any previous ADSTOP setting. Privilege Class: G Function Type: G ATTN : Use the ATTN command to make an attention interruption pending at your ~~~~ virtual console. Privilege Class: G Function Type: G AUTOLOG : This command allows the user to log on any virtual machine defined ~~~~~~~ in the directory. Privilege Level: A, B Function Type: O BACKSPAC : The BACKSPAC command is used to restart or reposition the current ~~~~~~~~ output on a real punch or printer. Privilege Class: D Function Type: S BEGIN or B : The BEGIN command by itself from CP mode will return the user to ~~~~~~~~~~ CMS mode in the place where he/she left off before he/she was disconnected or thrown into CP. The BEGIN command can also be followed by a hex location as to where to start in the case of the user wanting to be doing something other than what was previously occurring. Privilege Class: G Function Type: G CHANGE or CH : In use of the CHANGE command, there are subcommands with ~~~~~~~~~~~~ variables. Generally, the "name" variable is 1 to 4 characters in length. The following are the subcommands with functions and formatting: o READER or RDR : changes reader spool files. o PRINTER or PRT : changes printer spool files. o PUNCH or PCH : changes punch spool files. o CLASS c1 : designates an existing class where c1 is a 1-character alphanumerical field from A to Z or 0 to 9. o spoolid : spoolid number of file that is to be changed. o FORM form1 : 1 to 8 character alphanumeric form name used to select files to be changed (form1). o ALL : changes all of your spool files. o HOLD : prevents a file from being printed, punched, or read until released. o NOHOLD : releases the specified file from the user's HOLD status. o DIST dist : changes the distribution code to variable "dist". o COPY(*)nnn : specifies number of copies of the file you want spooled, which is valid only for printer or punch files. "nnn" is a number from 1 to 255 and the "*" is present in the case of a 3800 printer being used so that copies will be made in the printer internally. o FLASH name nnn : signifies that a form's overlay contained in the 3800 printer is to be superimposed onto certain pages of output. "nnn" is a number from 0 to 255 representing the number of copies to be superimposed. o MODIFY name (n) : allows text alteration by preventing information printing or by adding labels to output. "n" selects a keyword in CHARS to be used for copy modification text. o CHARS name1 (name2(name3(name4))) CHARS name1(CH names2(CH names3(CH names4))) : specifies character arrangement table when printing a file. There can be up to 4 names. o FCB name : controls vertical spacing of output on a page. o FORM form2 : changes spool form name of file to form2. o NAME fn (ft) : assigns identification to spool file in CMS format filename and filetype. o NAME dsname : assigns identification to spool file in non-CMS format where "dsname" is from 1 to 24 characters, suitable for specifying OS or DOS files. Privilege Class: S, G Function Type: D, G CLOSE or C : The CLOSE command terminates spooling activity on any virtual ~~~~~~~~~~ spooled unit record or console device. It Contains the following subcommands to be followed by the letter C or the word CLOSE: o READER or RDR o PRINTER or PRT o PUNCH or PCH o FORM form1 o HOLD o NOHOLD o DIST dist o NAME fn (ft) o NAME dsname o vaddr : virtual address (cuu) of device to be closed. o CONSOLE : closes virtual machine's console spool file which makes it a printer spool file. o PURGE : closes and immediately purges from the virtual machine the output spool files. No output file is produced. o CHAIN : only valid for VM/SP HPO Release 4.2 and Profs Spool File Enhancement PRPQ. Indicates that the punchfile is to be chained. Privilege Class: G Function Type: G COMMANDS or COMM : Use COMMAND to list the commands and diagnose codes you are ~~~~~~~~~~~~~~~~ authorized to use. Privilege Class: ANY Function Type: ANY COUPLE : Using the COUPLE command connects your virtual non-dedicated ~~~~~~ channel-to-channel device to another user's virtual device of the same type or to another one of your own virtual devices of the same type. The format of this command is in the form of COUPLE vaddr1 TO userid vaddr2. The variable vaddr1 is your virtual address and the variables userid vaddr2 identify the userid and virtual address of that userid to be connected to. Privilege Class: G Function Type: G CP : The CP command may precede the command to be processed, but it is not ~~ necessary. Generally, the CP command is used from CMS mode to queue CP functions by typing CP . Privilege Class: ANY Function Type: ANY CPTRAP : The CPTRAP command creates a reader file of a selected trace table, ~~~~~~ CP interface, and virtual machine interface entries for problem determination. Privilege Class: C Function Type: P DCP : This command displays the contents of real storage locations at the ~~~ terminal. Privilege Class: C, E Function Type: P DEFINE or DEF : The DEFINE command in CP is used to alter your virtual machine ~~~~~~~~~~~~~ configuration or channel operating mode. There are a LOT of subcommands that are used with the DEFINE command such as RDR or PRT or PCH and the list goes on and on. If you want details, there is a help file (type HELP CP DEF) that is almost 600 lines that goes into detail on each subcommand. Privilege Class: B, G Function Type: R, G DETACH or DET : The DETACH command is used to remove a virtual device from the ~~~~~~~~~~~~~ virtual machine. The subcommands are as follows: o vaddr (vaddr...) : used for multiple addresses to be detached where vaddr is the virtual address (cuu) of the device to be detached. o vaddr-vaddr : used to detach a range of addresses. o CHANNEL c : detaches the real address of the channel. Privilege Class: B, G Function Type: R, G DIAL : Using the DIAL command logically connects a switched line, leased line, ~~~~ locally attached, or remote Binary Synchronous (BSC) terminal to a previously logged-on multiple-access virtual machine. It is in the format of DIAL userid (vaddr) where the userid is that to be connected to and the vaddr is the optional virtual address. Privilege Class: ANY Function Type: ANY DISABLE : The DISABLE command prevents low speed communications lines from ~~~~~~~ accessing the system. Privilege Class: A, B Function Type: R DISCONN or DISC : The DISCONNECT command is used to disconnect your terminal ~~~~~~~~~~~~~~~ from the system while the virtual machine continues operation. Using the DISC HOLD or DISC HO option, you specify that the communications line is not to be disabled which allows you to avoid re-dialing the system. Privilege Class: ANY Function Type: ANY DISPLAY or D : The DISPLAY command allows you to display virtual machine ~~~~~~~~~~~~ components at your terminal. Depending on what variable follows the D or DISPLAY command from CP, you can display virtual storage locations, storage keys, general registers, floating-point registers, control registers, vector registers, VAC (Vector Activity Counter), VSR (Vector Status Register), VMR (Vector Mask Register), PSW (Program Status Word), CAW (Channel Address Word), and CSW (Channel Status Word). Privilege Class: G Function Type: G DMCP : This command prints the contents of real storage locations on a user's ~~~~ virtual spooled printer. Privilege Class: C, E Function Type: P DRAIN : The DRAIN command stops spooling operations on a specified real unit's ~~~~~ read devices after the file currently being processed has been completed. Privilege Class: D Function Type: S DUMP or DU : Use the DUMP command to print the contents of various components ~~~~~~~~~~ of the virtual machine on the virtual spooled printer. Depending on what variable is placed after the DUMP or DU command, the items printed include virtual PSW (Program Status Word), general registers, floating-point registers, control registers, storage keys, and virtual storage locations. Privilege Class: G Function Type: G ECHO or EC : Defaulted at 1, the ECHO command places the terminal in the echo ~~~~~~~~~~ environment in which any line entered is transmitted unchanged back to the terminal a specified number of times, depending on the variable entered immediately after the word ECHO or EC. Privilege Type: G Function Type: G ENABLE : Use the ENABLE command to enable the previously disabled or nonabled ~~~~~~ devices so users may access the system. Privilege Class: A, B Function Type: R EXTERNAL or EXT : The EXTERNAL command allows the user to simulate an external ~~~~~~~~~~~~~~~ interrupt to the virtual machine and to return control to that machine. The hexadecimal code following the word EXTERNAL or EXT is associated with the external interrupt, the default being the number 40 which is associated with the external interrupt button on a system console. Privilege Class: G Function Type: G FLUSH : The FLUSH command halts and immediately purges on hold the current ~~~~~ output on a specified unit record device. Privilege Class: D Function Type: S FORCE : This command forces a logoff of any user of the system. ~~~~~ Privilege Class: A Function Type: O FREE : Use the FREE command to remove a set of spool files belonging to a ~~~~ specified user from a system hold status. Privilege Class: D Function Type: S HALT : The HALT command terminates any active channel program on a specified ~~~~ real device. Privilege Class: A Function Type: O HOLD : The HOLD command places user spool files in a system hold status. ~~~~ Privilege Class: D Function Type: S INDICATE or IND : At your terminal, you can display the use of and contention ~~~~~~~~~~~~~~~ for major system resources with the INDICATE command. The following variables that follow the word INDICATE or IND show the following data: o LOAD : shows number of users in queue 1 and queue 2, the usage of real storage, and the ratio of active users to users being serviced. This is done by returning values that indicate operating load on the system. o USER : displays the amounts of system resources used by your virtual machine in the current terminal session. Privilege Class: A, E, G Function Type: O, A, G IPL or I : Generally used to return to CMS via the IPL CMS or I CMS command, ~~~~~~~~ the IPL command simulates an initial program load function for a virtual machine. Subcommands are as follows: o vaddr : virtual address (cuu) of the device that contains the nucleus to be loaded. o cylno : cylinder containing the IPL data which defaults to 0. o nnnnn : block address containing the IPL data which defaults to 0. o CLEAR : sets virtual storage space to binary zeros before the operating system is loaded. o NOCLEAR : allows contents of your virtual storage space to remain unchanged prior to program load. o STOP : halts the virtual machine during the IPL procedure just before the initial PSW is loaded. o ATTN : generates an attention interrupt to the virtual machine during the IPL procedure. o PARM p1 (p2...) : processes up to 64 bytes of data to your virtual machine's general registers starting with the high order byte of general register 0. o systemname : simulates IPL function when loading a named system that was previously saved. Privilege Class: G Function Type: G LINK : The LINK command is used to make a device that is associated with ~~~~ another virtual machine available at your virtual machine configuration based upon info in that user's directory entry. This command is in the format of LINK TO userid vaddr1 AS vaddr2 (mode) ((PASS=) password(1)). Privilege Class: G Function Type: G LOADBUF : On a 1403 printer, the LOADBUF command loads the Universal Character ~~~~~~~ Set (UCS) with a specified print train or chain image. On a 3203, 3211, 3212, 4245, or 4248 printer, it loads the UCS or the Forms Control Buffer (FCB) with a specified image. On a 3289 Model 4 printer, it loads the Font Offset Buffer (FOB) with the image print belt and the FCB. Privilege Class: D Function Type: S LOADVFCB : This command specifies the forms control buffer image for different ~~~~~~~~ virtual spooled printers. The variables that follow it include: o vaddr o FCB : required reserved keyword meaning Forms Control Buffer. o name : a name that is system defined. o INDEX (nn) : place initial printing position in number nn for the 3211 printer. Privilege Class: G Function Type: G LOCATE : Use the LOCATE command to find the addresses of CP control blocks ~~~~~~ associated with a particular user, a user's device, or a real system device. Privilege Class: C, E Function Type: P LOCK : This command permanently locks in selected pages of real storage. ~~~~ Privilege Class: A Function Type: O LOGOFF or LOGOUT or LOG : Used to terminate a virtual machine session and ~~~~~~~~~~~~~~~~~~~~~~~ disconnect your virtual machine from the system, this command can be used with the HOLD option (i.e. LOG HOLD) for retaining the connection allowing for a switched communications line to enable one to log on without re-dialing the system. Privilege Class: ANY Function Type: ANY LOGON or LOGIN or L : Obvious enough, the LOGIN or LOGON command is used to ~~~~~~~~~~~~~~~~~~~ identify yourself to the system and to access that system. Following the words LOGIN or LOGON or L, type your userid which is the identifier assigned to you in the system. If the system you are logging onto does NOT have password suppression, your password can follow directly after your userid. NOTE: If the system you are on does have password suppression (i.e. it does not echo to your screen what you type when you type your password), you will get a system error message if you try to put it on the same line as your userid. The NOIPL option, which would follow your password and userid, specifies that the IPL device or name in the directory should not be used for an automatic IPL. Privilege Class: ANY Function Type: ANY MESSAGE or MSG or M : Use the MESSAGE command to transmit message text to a ~~~~~~~~~~~~~~~~~~~ specified userid or to the primary system operator userid. MSG userid msgtext sends msgtext to the userid specified after userid. If userid is replaced with *, the text is sent to yourself. Also, if the userid is replaced with OPERATOR, the message text is sent to the primary system operator regardless of his userid. Privilege Class: A, B, ANY Function Type: O, ANY MIGRATE : The MIGRATE command activates the normal page/swap table migration ~~~~~~~ routines or forces a particular user's pages to a secondary device even if that user is currently active. Privilege Class: A Function Type: O MONITOR : To initiate or override the system-generated function or to ~~~~~~~ terminate the recording of events occurring in the real machine, use the MONITOR command. Privilege Class: A, E Function Type: O MSGNOH : The MSGNOH command allows a service virtual machine to send messages ~~~~~~ to specified users without the standard header associated with the MESSAGE command. Privilege Class: B Function Type: R NETWORK : The NETWORK command allows you to load, dump and control operation ~~~~~~~ of a 3704 or 3705 and to control operation of a 3725 control program operating in 270x emulation mode (EP). Also, it allows control of remote 3270 devices via binary synchronous lines. Privilege Class: A Function Type: O NOTREADY or NOTR : Using the NOTREADY command causes the virtual device, which ~~~~~~~~~~~~~~~~ is specified after the NOTREADY statement via cuu address, to appear as if it had changed from ready to not ready status. Privilege Class: G Function Type: G ORDER or ORD : ORDER is used to place your closed spool files in a specific ~~~~~~~~~~~~ order by device type. These spool files include READER, PRINTER, and PUNCH files and can be sorted by CLASS, FORM, and spoolid. Privilege Class: D, G Function Type: S, G PER : PER allows one to monitor certain events as they occur during program ~~~ execution in the user's virtual machine. This command can monitor the fetching and execution of an instruction, the execution of a successful branch instruction, the instruction of an instruction that alters a specific general purpose register, and the execution of an instruction in the virtual machine that alters storage. Privilege Class: A, B, C, D, E, F, G Function Type: G PURGE or PUR : Use the PURGE command to remove your own closed spool files ~~~~~~~~~~~~ from the system before they are printed or punched by the spooling devices, or before they are read by a user. The spool file specifications include READER, PRINTER, and PUNCH files as well as the ALL option which purges all of the above mentioned files. Privilege Class: D, G Function Type: S, G QUERY or Q : Also available in CMS mode, the QUERY command is used to ~~~~~~~~~~ determine your system status and machine configuration. Although there are far too many subcommands of the QUERY command, the following is a list of items that may be queried. I recommend, for full detail, using the HELP CP QUERY command as it is quite thorough (over 1000 lines) in explaining the QUERY command. o The time you have used during a terminal session. o The number of closed input and output spool files associated with your virtual machine. o The current settings of the color and/or extended highlight values in effect for your virtual machine console. o The current settings of the SET command functions. o The current settings of the TERMINAL command functions. o The status of all the devices on your virtual machine. o The channel operating mode of your virtual machine, whether block-multiplexer or selector. o A listing of all users who are linked to a given virtual address, together with their device addresses and access modes. o Display of the secondary user (secuser) that is specified in the CONSOLE directory statement. o Identification and attributes associated with your virtual PRINTER, PUNCH, and READER spool files. o The identification of your virtual processor. o The mode of processor operation of your VM/SP HPO installation: uniprocessor mode (UP), attached processor mode (AP), or multiprocessor mode (MP). o The userid and system identifier. o A listing of the PER traceset elements. o The log messages of the day. o The names of the users that are logged on. o The number of users that are logged on or dialed to the system. NOTE: There are other operands you can use with the QUERY command if you have the privilege class required to use them. Privilege Class: A, B, C, D, E, F, G Function Type: O, R, P, S, A, C, G QVM : Use this command to request the transition from the VM/SP environment to ~~~ native mode for a particular virtual machine. Privilege Class: A Function Type: O READY : In the format of READY vaddr, this command is used to set a device-end ~~~~~ interruption pending for the specified virtual device. Privilege Class: G Function Type: G REPEAT : Use the REPEAT command to increase the number of copies of an output ~~~~~~ file or to place the current output file in a hold status increasing or not increasing the number of copies to be created. Privilege Class: D Function Type: S REQUEST or REQ : Simply use the REQUEST command to make an attention interrupt ~~~~~~~~~~~~~~ at your virtual console. Privilege Class: G Function Type: G RESET : Also in the format of RESET vaddr, this command is used to clear all ~~~~~ pending interrupts from the specified virtual device. Privilege Class: G Function Type: G REWIND or REW : The REWIND command is used to rewind a real tape unit attached ~~~~~~~~~~~~~ to your virtual machine at a specified virtual device address in the format REWIND vaddr. Privilege Class: G Function Type: G SAVESYS : This command allows you to save a virtual machine storage space with ~~~~~~~ registers and the PSW as they currently exist. It is used in the process of creating named systems. Privilege Class: E Function Type: A SCREEN or SCRE : Use the SCREEN command to alter or change any extended color ~~~~~~~~~~~~~~ and/or extended highlight definitions for your virtual machine console. You may issue the command from any IBM supported terminal or from a PROFILE EXEC because the SCREEN command is not device dependent. However, the SCREEN command is only valid when the Extended Color Feature has been applied to the terminal controller. You can assign extended color and extended highlighting values to six distinct display screen areas: the input area, the system status area, and the output area that encompasses three other areas: CP output, virtual machine output, virtual machine output, and an input redisplay area. The physical attributes of 3270 Information Display station screens vary according to model. Because this command mainly applies to people who are not on dial-up, I have elected not to detail all of the variables available with the SCREEN command. Once again, I recommend you using HELP CP SCREEN for details. Privilege Class: G Function Type: G SEND : Using the Single Console Image Facility, the SEND command is used to ~~~~ pass commands and message replies for the secondary user's console to disconnect virtual machines for execution. This command is executed in the format: SEND (CP) userid (text). Privilege Class: G Function Type: G SET : Use the SET command to control various functions within your virtual ~~~ system. This command has a large number of variables that can be SET and details for each of the variables can be obtained from the HELP CP SET file. Privilege Class: A, B, E, F, G Function Type: O, R, A, C, G SHUTDOWN : This command, of course, systematically ends all virtual machine ~~~~~~~~ functions and checkpoints the system for an eventual warn start. Privilege Class: A Function Type: O SLEEP or SL : To place the virtual machine in a dormant state but allow ~~~~~~~~~~~ messages to be displayed, use the SLEEP command in the format of SLEEP nn (time-specification) where time-specification is SEC for seconds, MIN for minutes, or HR for hours and nn is the number of the amount of time for the machine to be in dormant state. Privilege Class: G Function Type: G SMSG or SM : The SMSG command is used to send a special message to a virtual ~~~~~~~~~~ machine programmed to accept and process the message. The format of this command is SMSG userid msgtext where userid is the userid to receive the message and msgtext is the message to be sent to the userid. Privilege Class: G Function Type: G SPACE : Use the SPACE command to force the output on a specified printer to be ~~~~~ single spaced for the current active spool file regardless of the carriage control commands in the actual file. Privilege Class: D Function Type: S SPMODE : SPMODE allows the system operator to establish or reset the single ~~~~~~ processor mode environment. Privilege Class: A Function Type: O SPOOL or SP : Use the SPOOL command to modify the spooling control options in ~~~~~~~~~~~ effect for a given virtual spooling device or for a group of devices. The SPOOL command can also start or stop the spooling of virtual console input and output. You can direct a file to a remote location by using the SPOOL command in conjunction with the TAG command. Privilege Class: G Function Type: G SPTAPE : Use this command to dump spool files to tape or to load spool files ~~~~~~ from tape. Privilege Class: D Function Type: S START : The START command restarts a spooling device after it has been drained ~~~~~ or changes the output class that it may service. Privilege Class: D Function Type: S STCP : To alter the contents of real storage but not real PSW or real ~~~~ registers, use the STCP command. Privilege Class: C Function Type: P STORE or ST : The STORE command is used to alter the contents of specified ~~~~~~~~~~~ registers and locations of the virtual machine. As well as saving virtual machine data in low storage, the contents of the following can be altered: o Virtual storage locations o General registers o Floating-point registers o Control registers o Program Status Word (PSW) Privilege Class: G Function Type: G SYSTEM or SYS : SYSTEM is used to simulate the action of the RESET and RESTART ~~~~~~~~~~~~~ buttons on the real computer console, and to clear storage. The variables are as follows: o CLEAR : clears virtual storage and virtual storage keys to binary zeros. o RESET : clears all pending interrupts and conditions in the virtual machine. o RESTART : simulates the hardware system RESTART function by storing the current PSW at virtual location eight and loading, as the new PSW, the doubleword from virtual location zero. Privilege Class: G Function Type: G TAG or TA : The TAG has many different variables that can be tagged, which are ~~~~~~~~~ too many to list here because of different settings for each one, but it is used to associate file descriptive information with a spool file. Privilege Class: G Function Type: G TERMINAL or TERM : The TERMINAL command is used to control the following ~~~~~~~~~~~~~~~~ functions associated with your virtual console: o Logical line-editing symbols o Masking of password o The APL character set o The Text character set o Signaling of an attention interrupt o Attention handling mode for your virtual console o Line length for output on your virtual console o Specifying terminal device type as 3101 or TTY o Location of cursor preceding terminal read o Scrolling rate for 3101 terminal Privilege Class: G Function Type: G TRACE or TR : Use the TRACE command to trace specified virtual machine ~~~~~~~~~~~ activity and to record the results at the terminal, on a virtual spooled printer, or on both terminal and printer. If you issue more than one TRACE command, the operands are cumulative; that is, operands specified for the first time are activated, whereas those specified with new modifiers are updated. The RUN and NORUN operands, however, can be specified in different tracing functions and do not cause a conflict. You cannot issue the TRACE command while preferred machine assist is operating, whether or not you have enabled the preferred machine assist feature's control switch assist. Privilege Class: G Function Type: G TRANSFER or TRAN : This command is used to transfer your closed spool files to ~~~~~~~~~~~~~~~~ a specified user or queue, or to reclaim closed spool files that you created. Privilege Class: D, G Function Type: S, G UNLOCK : Use the UNLOCK command to unlock page frames previously locked by a ~~~~~~ LOCK command. Privilege Class: A Function Type: O VARY : The VARY command marks a device available or unavailable for use by a ~~~~ user or the control program. Privilege Class: B Function Type: R VMDUMP or VMD : The VMDUMP command dumps virtual storage that VM/SP HPO ~~~~~~~~~~~~~ creates for the virtual machine user. VMDUMP dumps the following: o Virtual Program Status Word (PSW) o General registers o Floating-point registers o Control registers o Storage protection keys o Virtual machine type identification o Timer values Privilege Class: G Function Type: G WARNING : Use the WARNING command to transmit high-priority messages to a ~~~~~~~ specified user or to all users. Privilege Class: A, B Function Type: O ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ This article is far from totally complete as far as in-depthness goes. As I have stated in numerous portions of this file, the VM/CMS system has a very good HELP file system, and from CMS, the command HELP CP will, in most cases, allow you to read a relatively clear text file containing the details and usage specifications of these commands. I hope that, should you be moving around a VM/CMS system, this file will assist you in the CP mode. For those that wish to contact me for commentary on this file topic or other topic conversation, you can send e-mail to my network addresses: Internet: C488869@UMCVMB.MISSOURI.EDU Bitnet: C488869@UMCVMB.BITNET ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~