DEFINE CP Privilege Class: G
Use the DEFINE command to alter your virtual machine configuration or channel
operating mode. The format of the DEFINE command is:
+----------+------------------------------------------------------------------+
| DEFINE | Reader|Printer|PUnch|CONsole|CTCa|TIMer [As] vaddr |
| | 1403|1443|2501|2540P|2540R|3211|3505|3525 [As] vaddr |
| | CHANnels [As] SEL|BMX |
| | LIne [As] vaddr [IBM[1]|TELE[2] |
| | GRAF cuu [3270|3158] |
| | vaddr1 [As] vaddr2 |
| | T2305|T2314|T2319|T3330|T3340|T3350 [As] vaddr [CYL] nnn |
| | STORage [As] nnnnnK|nnM |
+----------+------------------------------------------------------------------+
where:
CONsole [As] vaddr
adds a virtual system console to the virtual machine at the address
specified by vaddr.
CTCa [As] vaddr
adds a virtual channel-to-channel adapter with the address specified
by vaddr to the virtual machine configuration.
Printer [As] vaddr
PRT adds a spooling 1403 printer with the address specified by vaddr to
the virtual machine configuration.
PUnch [As] vaddr
PCH adds a spooling 2540 card punch with the address specified by vaddr to
the virtual machine configuration.
Reader [As] vaddr
RDR adds a spooling 2540 card reader with the address specified by vaddr
to the virtual machine configuration.
TIMer [As] vaddr
adds a pseudo timing device with the address specified by vaddr to the
virtual machine configuration.
1403 [As] vaddr
adds a spooling 1403 printer with the address specified by vaddr to
the virtual machine configuration.
1443 [As] vaddr
adds a spooling 1443 printer with the address specified by vaddr to
the virtual machine configuration.
2501 [As] vaddr
adds a spooling 2501 card reader with the address specified by vaddr
to the virtual machine configuration.
2540P [As] vaddr
adds a spooling 2540 card punch with the address specified by vaddr to
the virtual machine configuration.
2540R [As] vaddr
adds a spooling 2540 card reader with the address specified by vaddr
to the virtual machine configuration.
3211 [As] vaddr
adds a spooling 3211 printer with the address specified by vaddr to
the virtual machine configuration. The virtual 3211 printer supports
LOADVFCB and the Index feature (right-index only).
3505 [As] vaddr
adds a spooling 3505 card reader with the address specified by vaddr
to the virtual machine configuration.
3525 [As] vaddr
adds a spooling 3525 card punch with the address specified by vaddr to
the virtual machine configuration.
CHANnels [As] SEL | BMX
redefines the channel mode of operation for the virtual machine to
either selector or block multiplexer. Use of the SEL (selector
channel) or BMX (block multiplexer channel) operand sets the mode of
operation for all channels except virtual channel 0. Channel 0 always
operates in byte multiplexer mode.
Block multiplexer mode may enhance the virtual machine's operating
system by allowing the overlap of Start I/O operations. This is done
by reflecting a channel condition code of 0 back to the virtual
machine rather than a channel busy signal.
Note: The virtual machine is immediately reset when this set of
operands is executed.
GRAF cuu [3158 | 3270]
defines a temporary 3270 or 3158 (the console used on the IBM
System/370 Model 158) for the virtual machine. The cuu is the
hexadecimal virtual address for the device. After you define the
3158, you must issue the CP DIAL command from the device in order to
use it. The device must be supported by the virtual machine's
operating system.
LIne [As] vaddr [IBM[1] | TELE[2]]
adds a virtual 2701/2702/2703 communication line with the address
specified by vaddr to the virtual machine configuration. IBM1
indicates that an IBM-type terminal (2741, 1050, or equivalent) is on
the 2701/2702/2703 line. TELE2 indicates that a teletypewriter is on
the 2701/2702/2703 line.
T2305 | T2314 | T2319 | T3330 | T3340 | T3350 [As] vaddr [CYL] nnn
adds a temporary virtual disk of the specified type to the virtual
machine configuration. See Usage Note 5. CYL nnnn specifies the
number of cylinders that the disk contains. Specify T3350 if a 3350
is used in native mode; specify T3330 if a 3350 is used in 3330
compatibility mode. Specify T3340 if a 3344 is used.
When you define temporary disk space on a 2305 device, only the vaddr
specified is defined (not all eight addresses associated with the devic
Note: Temporary disk space is assigned from a pool of DASD resources;
therefore, you should always format your temporary disk space before
you use it. If your installation's system programmer specifies the
SYSCLR=Yes option on the SYSRES macro, and you release temporary disk
space or logoff the system, CP clears all data areas and directory
areas in that temporary space. If your installation chooses not to
implement the SYSCLR option, you should clear any temporary disk space
yourself before you release it to free storage or logoff the system.
This eliminates the possibility of an unauthorized person accessing
your data either accidentally or deliberately.
STORage [As] nnnnnK | nnM
redefines the size of the virtual storage for the virtual machine as
nnnnnK (where K represents 1024 bytes) or nnM (where M represents
1,048,576 bytes). The value specified becomes the new virtual storage
size. Sizes must be in 4K increments and are limited by the maximum
value in the VM/370 directory entry. The minimum size you can specify
is 8K. All entries not specified in a 4K increment are rounded up to
the next 4K boundary. Changing the virtual storage size (increasing
or decreasing) causes a virtual system reset and clears all virtual
storage to binary zeros.
vaddr1 [As] vaddr2
redefines the device represented by vaddr1 as vaddr2. The virtual
address, vaddr1, must represent a defined device in the virtual
machine configuration. See Usage Note 5 for more information on
potential conflicts with the virtual control unit that would support
the new device.
If vaddr1 is a dedicated 2305, both vaddr1 and vaddr2 must be
specified as base addresses (xx0 or xx8). Also, when you redefine a
dedicated 2305, all eight exposure addresses are redefined.
Redefining any virtual unit record device will result in any open
output files being closed and available for further processing as
determined by previously issued spooling commands.
Usage notes:
1. When you alter the configuration or channel operating mode of your virtual
machine via the DEFINE command, the changes are temporary and are in effect
for the current terminal session only.
2. If either storage or channel operating mode is altered, the virtual machine
is immediately reset and the IPL procedure must be performed again.
3. If storage is redefined, any pages that have been locked via the LOCK
command become unlocked.
4. If your virtual machine is operating in the basic control mode (ECMODE
OFF), virtual addresses specified in vaddr, vaddr1, and vaddr2 can be no
higher than 5FF (channels 0 through 5). If it is operating in extended
control mode (ECMODE ON), all addresses through FFF are valid.
5. Defining a shared and nonshared device on the same virtual control unit
will result in an error message being issued (DMKDEF331E). Define shared
and nonshared devices on separate subchannels.
6. If the optional keyword "AS" is omitted, the vaddr to be assigned cannot be
"A."
7. To find the status of the virtual devices that have been defined the QUERY
VIRTUAL ALL command can be used.
Responses
Responses are generated to confirm that the desired configuration change has
taken place. These responses do not appear on your terminal if you have issued
the CP SET IMSG OFF command line.
type vaddr DEFINED
where the possible values for type are:
DASD Direct access storage device/3330V (virtual volumes)
TAPE Magnetic tape
LINE Communication line
RDR Card reader
PRT Line printer
PUN Card punch
GRAF Graphics device
CONS Console
CTC Channel-to-channel device
CHANNELS = SEL ¦ BMX
is the channel mode of operation for the virtual machine. This response
applies to all channels except channel 0 (always a byte multiplexer
channel).
STORAGE = nnnnnK ¦ nnM
verifies the new storage size of your virtual machine. The minimum storage
you may specify is 8K.