Retro1.org codex

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.