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

Responses
7. A tape device attached with the SINGLEUSER option (the default) will
automatically be unassigned by CP when the device is detached, unless the
device was attached with the NOASSIGN option.
A tape device attached with both the SINGLEUSER and NOASSIGN options
will not be unassigned by CP when the device is detached, regardless of
whether the tape is currently assigned by a guest. In other words, CP will not
change the ASSIGNED or UNASSIGNED status of the drive. It is the
responsibility of the guest to issue the ASSIGN CCW when it needs the tape
drive and to issue the UNASSIGN CCW when it is finished using the drive.
8. A tape device attached with the MULTIUSER option will be unassigned by CP
when the device is detached, even though MULTIUSER implies NOASSIGN.
This prevents one user from unexpectedly locking out many other users from
the drive.
9. Devices that are part of a virtual network adapter cannot be detached
individually. Virtual network adapters are detached with the DETACH NIC
command.
10. If you use DETACH to detach a virtual disk in storage, and you are the last
user, the virtual disk in storage is destroyed.
11. SET IMSG OFF suppresses informational messages for this command.
12. For more information, see “Usage Notes” on page 232.
In Response 1, type is one of the following:
Type Meaning
CONS Console
CTCA Channel-to-channel adapter
CTLR 3705 Communications Controller
DASD Direct access storage device
DEV Any other device
FCP SCSI device adapter
GRAF Display device
MSC Mass Storage Controller
OSA Open Systems Adapter
PRT Printer
PUN Card punch
RDR Card reader
SWCH Dynamic Switching Device
TAPE Magnetic tape
The type variable in the remaining responses is omitted when a range of device
numbers or multiple device numbers are being reflected in the response.
Response 1:
{type vdev} DETACHED
{vdev ... }
{vdev-vdev}
is the response you receive for the device or devices that were successfully
detached (if you are not the primary system operator).
Response 2:
CTCA vdev DROPPED FROM userid vdev
DETACH (Virtual Device)
Chapter 2. CP Commands 253