z/VM: CP Commands and Utilities Reference - z/VM - IBM

DELETE DEVICE / IODEVICE
Usage Notes
Responses
Note: This parameter and other parameters that identify different
channel-subsystem IDs require that the logical channel-subsystem facility
be installed.
1. Before you delete one or more real devices from your I/O configuration, they
must all be offline and their corresponding subchannels must also be offline. To
take a device offline, use the VARY (Real Device) command. (See page 1710.)
To take a subchannel offline, use the VARY SUBCHANNEL command.(See
page 1714.)
2. On a machine with multiple logical channel-subsystem images, the DELETE
DEVICE and DELETE IODEVICE commands delete the device with respect to
the control unit’s connection to channel paths within the single specified logical
channel-subsystem image. To delete devices from more than one logical
channel-subsystem image, you must enter a separate DELETE DEVICE or
DELETE IODEVICE command for each logical channel-subsystem image from
which you want the devices deleted.
3. When you delete one or more real devices from your I/O configuration, CP also
deletes their corresponding real device blocks (RDEVs). If you want to delete
the RDEV but do not want to change the I/O configuration, use the DELETE
RDEVICE command.(See page 228.)
4. After successfully entering this command, you will have changed the software’s
view of the I/O configuration and part of the hardware’s view: the active I/O
configuration in the hardware system area (HSA). You should also change the
other part of the hardware’s view: the active I/O configuration data set (IOCDS)
file on the support element (SE) hard disk.
To change the IOCDS file on the SE hard disk, you must:
a. Update the IOCP source file.
b. Run the IOCP utility (see page 1849) against the updated IOCP file. If the
IOCP utility runs without errors, it downloads the new IOCDS file to the SE
hard disk.
c. Issue the SET IOCDS_ACTIVE command (see page 1258) to make the new
IOCDS file the active file that the processor will use during the next
power-on reset (POR).
5. To define a new device on the system, use the DEFINE DEVICE or IODEVICE
command. (See page 155.)
6. To change the definition of an existing device on the system, use the MODIFY
DEVICE or IODEVICE command.(See page 610.)
7. To display the status of one or more real devices, use the QUERY (Real
Device) command. (See page 955.)
Note: If your processor is in LPAR mode, the QUERY (Real Device) command
displays the status of the device only if you issue the QUERY command
in a logical partition (LP) that has been defined to have access to the
device.
Response 1:
224 z/VM: CP Commands and Utilities Reference
To delete 4 real devices from your I/O configuration, enter the following:
delete device 300-303 unit_address 00 cu_number 300
Device configuration change completed successfully
RDEV 0300 deleted