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

DETACH (Real Device)
Usage Notes
246 z/VM: CP Commands and Utilities Reference
ldev
ldev1-ldev2
is a logical device number, a list of logical device numbers, or a range of logical
device numbers to be detached from the indicated user. On a single command
line, you may combine device numbers, lists of device numbers, and ranges of
device numbers. Specify a logical device number as an L followed by one to
four hexadecimal digits.
VOLid
indicates that a volume serial number, which must follow this keyword, is used
to identify the real device. If the volume serial number is valid as an operand of
the command (e.g., is a valid device number or XSTore), specify VOLid to
indicate that the operand is a volume serial.
volid
specifies the one- to six-character volume serial number of a real DASD.
userid
* identifies the virtual machine to which the device is currently attached. The
specified user must be logged on, not in the process of logging on. If you are
detaching a device from your own virtual machine, you may specify userid as
an asterisk (*).
ALL
detaches a real device from all virtual machines without having to specify the
user IDs. This operand can be used to detach devices attached with the
MULTIUSER option. The ALL operand is not valid for devices attached to
SYSTEM.
SYSTEM
detaches a DASD currently being used by CP for allocation and control.
UNload
detaches the tape device and automatically rewinds and unloads it. UNLOAD is
the default if the tape was attached with the ASSIGN option.
LEave
detaches the tape device without rewinding and unloading it. The tape remains
positioned as it was before issuing DETACH. LEAVE is the default if the tape
was attached with the NOASSIGN or MULTIUSER option.
1. SET IMSG OFF will not suppress informational messages for this command.
2. A previously attached device can be detached from a user, even if the device
is still in use.
3. When a device is detached from a user, all Concurrent Copy (CONCOPY)
sessions associated with that device for that user are terminated in the storage
control.
4. When a device is detached, all data blocks associated with the device are
removed from the minidisk cache.
5. If you specify multiple device numbers or a range of device numbers on the
DETACH (real device) command line, you receive an affirmative response for
each device that is successfully detached and an error message for each
device that cannot be detached.
6. If you attempt to detach an active shared device from SYSTEM, you receive
an error message indicating that the device is being shared by multiple users.
In order to detach the device, each of the affected users must detach the
device from their virtual systems.