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.