home *** CD-ROM | disk | FTP | other *** search
-
- ==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 <command> to perform a CP
- operation, CP directly receives the command whereas CP <command> 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 <command>.
- 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 <command> 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
-
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-