822 lines
37 KiB
Plaintext
822 lines
37 KiB
Plaintext
==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
|
||
|
||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|