SET CP Privilege Class: G
Use the SET command to control various functions within your virtual system.
If you are a CMS user, you can use the CMS SET command to control various
functions related to your CMS virtual machine. For help on the CMS SET
command, type HELP CMSSET.
The format of the SET command is:
+----------+------------------------------------------------------------------+
| SET | ACNT|ECmode|IMSG|ISAM|LINEDit|MSG|NOTRans|PAGEX|RUN|WNG ON|OFF |
| | EMSG ON|OFF|CODE|TEXT |
| | TIMER ON|OFF|REAL |
| | ASsist OFF|[ON][SVC|NOSVC] |
| | PFnn DELayed|IMMed [pfdata1#pfdata2...] |
| | PFnn RECALL|RETRIEVE |
| | PFnn [TAB n1 n2...] |
| | PFnn COPY [cuu|resid] |
+----------+------------------------------------------------------------------+
where:
ACNT ON | OFF
controls whether accounting information is displayed at the terminal
or not (ON and OFF, respectively) when the operator issues the CP ACNT
command. When you log on VM/370, ACNT is set on.
ECmode ON | OFF
controls whether the virtual machine operating system may use
System/370 extended control mode and control registers 1 through 15.
Control register 0 may be used with ECMODE either ON or OFF. When you
log on VM/370, ECMODE is set according to the user's directory option;
ON if ECMODE was specified and OFF if not.
Note: Execution of the SET ECMODE <ON OFF> command always causes a
virtual system reset. Setting ECMODE does not change the PSW EC mode
bit.
IMSG ON | OFF
controls whether certain informational responses issued by the CP
CHANGE, DEFINE, DETACH, ORDER, PURGE, and TRANSFER commands are
displayed at the terminal or not. The descriptions of these CP
commands tell which responses are affected. If ON is specified the
informational responses are displayed. If OFF is specified, they are
not. The SET IMSG ON or OFF command line has no effect on the
handling of error messages set by the SET EMSG command. When you log
on to VM/370, IMSG is set ON.
ISAM ON | OFF
controls whether additional checking is performed on virtual I/O
requests to DASD in order to support the OS Indexed Sequential Access
Method (ISAM). When you log on VM/370, ISAM is set according to the
user's directory options; ON if ISAM was specified and OFF if not.
LINEDit ON | OFF
controls the line editing functions. ON specifies that the line
editing functions and the symbols of the VM/370 system are to be used
to edit virtual processor console input requests. This establishes
line editing features in systems that do not normally provide them.
OFF specifies that no character or line editing is to be used for the
virtual machine operating system. When you log on VM/370, LINEDIT is
set on.
MSG ON | OFF
controls whether messages sent by the MSG command from other users are
to be received at the terminal. If ON is specified, the messages are
displayed. If OFF is specified, no messages are received. In
addition to controlling messages generated by the MESSAGE command,
spooling messages generated by users sending punch, printer or reader
files to another virtual machine are also suppressed if OFF is
specified. When you log on VM/370, MSG is set on.
NOTRans ON | OFF
controls CCW translation for CP. NOTRANS can be specified only by a
virtual machine that occupies the virtual=real space. It causes all
virtual I/O from the issuing virtual machine to bypass the CP CCW
translation except under the following conditions:
o SIO tracing active
o First CCW not in the V=R region
o I/O operation is a sense command
o I/O device is a dial-up terminal
o I/O is for a non-dedicated device
o Pending device status
Any of the above conditions forces CCW translation.
To be in effect in the virtual=real environment, SET NOTRANS ON must
be issued after the virtual=real machine is loaded via the IPL
command. (IPL sets the NOTRANS option to an OFF condition.)
PAGEX ON | OFF
controls the pseudo page fault portion of the VM/VS handshaking
feature. PAGEX ON or OFF should only be issued for a virtual machine
that has the VM/VS handshaking feature active. It can only be
specified for a virtual machine that has the extended control mode
(ECMODE) option. PAGEX ON sets on the pseudo page fault portion of
handshaking; PAGEX OFF sets it off. When you log on to VM/370, PAGEX
is set OFF. Also, each time you IPL your virtual machine, PAGEX is
set off. If you want to use the pseudo page fault handling portion of
handshaking, you must issue SET PAGEX ON after you load your operating
system.
RUN ON | OFF
controls whether the virtual machine stops when the attention key is
pressed. ON allows you to activate the attention key (causing a read
of a CP command) without stopping your virtual machine. When the CP
command is entered, it is immediately executed and the virtual machine
resumes execution. OFF places the virtual machine in the normal CP
environment, so that when the attention key is pressed, the virtual
machine stops. When you log on VM/370, RUN is set off.
WNG ON | OFF
controls whether warning messages are displayed at the terminal. If
ON is specified, all warning messages sent via the CP WARNING command
from the system operator are received at the terminal. If OFF is
specified, no warning messages are received. When you log on to
VM/370, WNG is set ON.
EMSG ON | OFF | CODE | TEXT
controls error message handling. ON specifies that both the error
code and text are displayed at the terminal. OFF specifies that no
error message is to be displayed. CODE specifies that only the error
code is be displayed. TEXT specifies that only text is displayed.
When you log on to VM/370, EMSG is set to TEXT.
If the console is being spooled for error messages from CP, the OFF
setting is ignored for the spooled output and the full error message
appears in the spooled output. The other three settings result in
spooled output that matches the console printout.
It is the responsibility of the operating system running under CP to
determine whether or not its own error messages will honor the EMSG
setting in the spooled output.
Note: CMS always recognizes EMSG settings for all error (E),
information (I), and warning (W) messages, but ignores the EMSG
setting and displays the complete message (error code and text) for
all response (R), severe error (S), and terminal (T) messages. Also,
data written by means of type in, such as a list of names following a
message, are not controlled by the EMSG operand.
TIMER ON | OFF | REAL
controls the virtual timer. ON specifies that the virtual timer is to
be updated only when the virtual processor is running. OFF specifies
that the virtual timer is not to be updated. REAL specifies that the
virtual timer is to be updated during virtual CPU run time and also
during virtual wait time. If the REALTIMER option is specified in
your VM/370 directory entry, TIMER is set to REAL when you log on;
otherwise it is set to ON when you log on.
ASsist OFF | [ON] [SVC | NOSVC]
all functions of SET ASSIST operands pertain to VM/370 hardware
assist. VM/370 hardware assist consists of processor hardware that
assists the processor in the execution of certain instructions, series
of instructions, privileged operations, and interrupt processing that
are normally handled by the control program portion of VM/370.
All, some, or none of the function performed by VM/370 hardware assist
may be available on the processor that the virtual machine is logged
on. If the user requests VM/370 hardware assist and it is available
and active, the request is honored; if VM/370 hardware assist is not
active but is available and the user attempts to enable hardware
assist, the virtual machine remembers the enabling attempt and an
appropriate message is sent to the user. When the system operator
enables hardware assist, it is immediately utilized by the virtual
machine. In the event that hardware assist is not available or active
on the system, an appropriate error message is issued.
PFnn [DELayed | IMMED] [pfdata1#pfdata2#...]
defines a program function for a program function key on a 3270
Display station and indicates when that function is to be executed.
If PFnn is specified with no operands, that program function key is
considered "undefined." See the VM/370 Terminal User's Guide for a
description of how to use the 3270 program function keys.
nn is a number from 1 (or 01) to 24 that corresponds to a key on
a 3270 display station. The program function is a
programming capability you create by defining a series of
VM/370 commands or data you want executed. This series of
commands is executed when you press the appropriate program
function key.
IMMED specifies that the program function is executed immediately
after you press the program function key.
DELAYED specifies that execution of the program function is delayed
for a display terminal. When the program function is entered,
it is displayed in the input area and not executed until you
press the Enter key. DELAYED is the default value for display
terminals.
pfdata1#pfdata2#...
defines the VM/370 command or data lines that constitute the
program function. If more than one command line is to be
entered, the pound sign (#) must separate the lines. If you
use the pound sign (#) to separate commands that you want
executed with the designated PF key, you must precede the
command line with #CP, turn line editing off, or precede each
pound sign with the logical escape character ("). If no
command lines are entered following the PFnn designation, then
the program function is marked undefined. Program functions
cannot be embedded within one another.
PFnn RECALL | RETRIEVE
specifies that the program function key numbered nn carries out the
RETRIEVE function on a 3270 display terminal. The number of the PF
key, nn, can be a value from 1 (or 01) to 24.
Once you have defined a RETRIEVE program function key, CP begins
saving your input lines. When you press the designated PF key, VM/370
displays either the most recently saved input line so that you can
modify and reenter the data. When you first press the RETRIEVE
program function key, VM/370 displays the most current input line. If
you press the key again, VM/370 displays the previous input line.
Each time you press the key, VM/370 scrolls through the input lines,
retrieving older input lines, and displaying them one at a time.
After VM/370 reaches the oldest line stored, it returns to the most
current line once again.
PFnn [TAB n1 n2 ...]
specifies a program function key number to be associated with tab
settings on a terminal. The number of the PF key, nn, can be a value
from 1 (or 01) to 24. TAB is a keyword identifying the tab function.
The tab settings (n1 n2 ...) may be entered in any sequence:
SET PF09 TAB 20 30 40
defines tab settings on columns 20, 30, and 40 of your command line.
PFnn [COPY [cuu | resid]]
specifies that the program function key numbered nn performs a COPY
function for a remote 3270 Information Display terminal. The number,
nn, must be a value from 1 (or 01) to 24. The COPY function produces
a printed output of the entire screen display at the time the PF key
is pressed. The output is printed on an IBM printer connected to the
same control unit as your display terminal; if no printer is
connected, the copy function is not available.
cuu represents the real hardware address of the display printer,
and may specify a printer that is on a different control unit
than the one to which your 3270 is attached. If you do not
specify cuu, the printer with the lowest cuu that is available
on the same control unit as your 3270 is selected.
resid may be specified if more than one printer is connected to the
same control unit as your display terminal. It is a two-
character hexadecimal resource identification number assigned
to a specific printer. If resid is entered, the printed copy
is directed to a specific printer; if not, the copy is printed
on the printer with the lowest resid number. The resid
numbers of the printers available to your display terminal can
be obtained from your system operator. If only one printer is
available, as with the 3275 Display Station, resid need not be
specified.
Responses:
QUERY FILES [CLASS c]
FILES: nnn¦NO RDR, nnn¦no PRT, nnn¦NO PUN
The total number of spool files in your system is displayed. If you specify
the CLASS option, only the totals for the class you specify are displayed.
QUERY LINKS vaddr
userid vaddr R/W ¦ R/O, ...
A list of users who are currently linked to the device at virtual address
vaddr is displayed, where
userid is the identification of the user who originated the link.
vaddr is the virtual address by which the user (userid) refers to the
device.
R/O¦R/W is the type of access the user (userid) has to the device.
QUERY LOGMSG
* logmsg text line
All lines (both those with an asterisk and without) in the log message file
are displayed.
QUERY NAMES
userid - DSC ¦ raddr ¦ resid, ...
A list of all logged-on users is displayed. If the user is currently
connected, the real address (raddr) or the resource id of a 3704/3705 line
(resid) to which he is connected is displayed. If he is not connected, DSC
is displayed.
QUERY PFnn
PFnn IMMED ¦ DELAY pfdata...
The program function defined for a program function key is displayed. If
there is no function defined for the key, this message is displayed:
PFnn UNDEFINED
QUERY READER, QUERY PRINTER, QUERY PUNCH
OWNERID FILE CLASS RECDS CPY HOLD [ DATE TIME NAME TYPE DIST ]
userid spid c typ norecs nn stat [mm/dd hh:mm:ss fn ft distcode]
where:
userid is the user who originally created the file.
spid is a unique, system-assigned number which is used by VM/370 to
identify the file.
c is the spool file class.
typ is the originating device type (PRT, PUN, CON, or RDR).
norecs is the number of logical records contained in the file.
nn is the number of copies assigned to the file (it has no effect for
virtual reader files).
stat is the file hold status: NONE (no hold), USER (user hold), SYS
(system hold), or USYS (system and user hold).
mm/dd is the date the file was created in month/day.
hh:mm:ss is the time the file was opened for creation in hours:minutes:
seconds.
fn is the filename assigned to the file, if any. If the file has a
24-character data set name (dsname), only 20 characters are
displayed.
ft is the filetype assigned to the file, if any.
distcode is the distribution code assigned to the file.
When you issue QUERY READR, QUERY PRINTER, or QUERY PUNCH, CP responds by
listing (as describe above) all the files associated with your virtual
reader, printer, or punch. The optional information is displayed only when
you specify the ALL or spoolid operands.
QUERY SET
MSG ON¦OFF , WNG ON¦OFF , EMSG ON¦OFF¦CODE¦TEXT, ACNT ON¦OFF , RUN ON¦OFF
LINEDIT ON¦OFF , TIMER ON¦OFF¦REAL, ISAM ON¦OFF, ECMODE ON¦OFF
ASSIST ON SVC¦ON NOSVC¦OFF, PAGEX ON¦OFF, AUTOPOLL ON¦OFF
IMSG ON¦OFF
The settings of all functions controlled by the SET command and the VM/370
ISAM and ECMODE options are displayed. See the CP SET command for
information on each of these settings.
QUERY TERMINAL
LINEND #¦OFF , LINEDEL n¦OFF, CHARDEL n¦OFF, ESCAPE n¦OFF, TABCHAR ON¦OFF
LINESIZE nnn, ATTN ON¦OFF , APL ON¦OFF, TEXT ON¦OFF, MODE CP¦VM, HILIGHT ON¦OFF
AUTOCR ON¦OFF, MORE nnn nnn, HOLD ON¦OFF , TIMESTAMP ON¦OFF
The settings of all functions that are controlled by the TERMINAL command
are displayed. See the CP TERMINAL command for information on each of these
settings.
QUERY TIME
TIME IS hh:mm:ss zone weekday mm/dd/yy
The current real clock time in hours:minutes:seconds, the time zone (for
example, EST), the day of the week and the calendar date (month/day/year)
are displayed.
CONNECT= hh:mm:ss VIRTCPU= mmm:ss.hs TOTCPU= mm:ss.hs
The time spent in the current terminal session is displayed, where:
CONNECT= hh:mm:ss is the actual clock time spent in the current terminal
session in hours:minutes:seconds.
VIRTCPU= mmm:ss.hs is the virtual CPU time used in the current terminal
session in minutes:seconds.hundredths of seconds.
TOTCPU= mmm:ss.hs is the total CPU time (virtual and overhead) used in the
current terminal session in minutes:seconds.hundredths
of seconds.
QUERY USERS
nnn USERS, mm DIALED
The number of users logged on and dialed to VM/370 is displayed, where:
nnn is the total number of logged-on users.
mmm is the total number of users attached via DIAL to virtual machines.
QUERY userid ¦ QUERY USERS userid
userid - raddr ¦ resid
The real address (raddr) or the resource id of a 3704/3705 line (resid) to
which he is connected is displayed.
QUERY VIRTUAL ALL
This has the same effect as if all the following commands were issued:
QUERY VIRTUAL STORAGE
QUERY VIRTUAL LINES
QUERY VIRTUAL TAPE
QUERY VIRTUAL UR
QUERY VIRTUAL DASD
QUERY VIRTUAL GRAF
QUERY VIRTUAL CONSOLE
QUERY VIRTUAL CHANNELS
QUERY VIRTUAL CHANNELS
CHANNELS= BMX¦SEL
The operating mode of the virtual machine channels is displayed. This
response applies to all of the virtual machine channels except channel 0,
which is always a byte multiplexer channel, and any channels with virtual or
real channel-to-channel adapters, which are always selector channels.
QUERY VIRTUAL CONSOLE
CONS vaddr ON GRAF ¦ LINE raddr TERM ¦ NOTERM START ¦ STOP
vaddr CL c CONT ¦ NOCONT HOLD ¦ NOHOLD COPY nn READY ¦ NOTREADY
vaddr TO ¦ FOR userid DIST distcode
For virtual machine consoles, a three-line response is displayed. The first
line shows the console status and options and the next two lines show the
virtual console spooling status, where:
vaddr is the virtual address of the virtual machine console.
raddr is the real address of the terminal associated with the virtual
console.
c is the spooling class of the console.
nn is the number of copies specified.
userid is the user identification.
distcode is the distribution code.
The other fields indicate the setting of the respective options in the SPOOL
command. The default settings for a virtual console are:
CONS vaddr ON dev raddr TERM STOP
vaddr CL T NOCONT NOHOLD COPY 01 READY
vaddr FOR userid DIST distcode
QUERY VIRTUAL DASD
DASD vaddr type volser R/W ¦ R/O nnn CYL
The status of each virtual disk defined for your system is displayed, where:
vaddr is the virtual address to which the DASD device is attached.
type is one of the following device types:
231T (2311 at top of 2314) 2314
231B (2311 at bottom of 2314) 3330
2311 3340
2305 3350
volser is the volume serial number of the system disk on which this
virtual disk resides.
R/W ¦ R/O indicates the read/write status of the disk.
nnn is the number of cylinders on the virtual disk.
QUERY VIRTUAL GRAF
GRAF vaddr ON DEV raddr ¦ NOT READY
The status of all locally attached virtual display devices defined to your
virtual machine is displayed, where:
vaddr is the virtual address to which the device is attached.
raddr is the real address of the device.
NOT READY shows the status of a virtual display device that has not been
attached via the DIAL command.
QUERY VIRTUAL LINES
LINE vaddr ON DEV raddr
The status of all communication lines defined in your virtual machine is
displayed, where:
vaddr is the virtual address to which the line is attached.
raddr is the real address of the line.
QUERY VIRTUAL STORAGE
STORAGE = nnnnnK
The size of the virtual machine in multiples of 1024 bytes is displayed.
QUERY VIRTUAL TAPES
TAPE vaddr ON DEV raddr
The status of each tape drive defined for your system is displayed, where:
vaddr is the virtual address to which the tape is attached.
raddr is the real address of the tape.
QUERY VIRTUAL UR
RDR vaddr CL c CONT ¦ NOCONT HOLD ¦ NOHOLD EOF ¦ NOEOF READY ¦ NOTREADY
The status of all the virtual readers attached to your virtual machine is
displayed, where:
vaddr is the virtual device address of the virtual reader.
c is the spool class which the device services. A class of *
indicates the device services all classes of spool files for input.
The other fields indicate the settings of the respective options in the
SPOOL command. The default settings for a reader are:
RDR vaddr CL * NOCONT NOHOLD READY EOF
PRT ¦ PUN vaddr CL c CONT ¦ NOCONT HOLD ¦ NOHOLD COPY nn READY ¦ NOTREADY
vaddr TO ¦ FOR userid DIST distcode
The status of all the virtual printers and punches attached to your virtual
machine is displayed, where:
vaddr is the virtual device address of the virtual printer or punch.
c is the output class assigned to spool files produced from the
device.
nn is the number of copies of each output file to be produced.
TO userid
indicates that the output from the device, when closed, becomes a
reader input spool file for the indicated userid.
FOR userid
indicates the user identification (spool file owner) assigned to
spool files produced from the device.
distcode is the distribution code assigned to each spool file produced from
the device. Note: the distcode in this case indicates the FOR
userid; however, the distcode produced on the output file when the
file is close is the distcode assigned to the FOR userid as
specified in the VM/370 directory.
The other fields indicate the settings of the respective options in the
SPOOL command. The default settings are:
PRT ¦ PUN vaddr CL A NOCONT NOHOLD COPY 01 READY
vaddr FOR userid DIST distcode FLASHC 00
vaddr FLASH CHAR MDFY FCB
QUERY VIRTUAL vaddr
The response is in the same format as QUERY VIRTUAL DASD, TAPES, LINES or UR,
depending on the virtual device type.