                                ==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

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
