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

DETACH
DETACH
Purpose
Usage Notes
Messages
Use the DETACH commands to detach the following:
v Virtual processors from your virtual machine
v Real devices from the host system
v Logical devices from the host system
v Real devices from your virtual machine
v Logical devices from your virtual machine
v A Virtual Vector Facility from your virtual machine
v Virtual devices from your virtual machine
v Real Expanded Storage from your virtual machine
v Virtual message processor and message devices from your virtual machine
v A VM LAN segment from the host system.
(General for DETACH)
1. SET IMSG OFF will suppress the informational messages for DETACH
CRYPTO, DETACH CPU, DETACH MSGPROC, DETACH VECTOR, and
DETACH VDEV. DETACH RDEV and DETACH XSTORE are not affected by the
IMSG setting.
2. You cannot be certain that the device or Expanded Storage capability has been
detached until you receive the appropriate response from the system. If after a
reasonable amount of time you haven’t received the expected response, enter
the QUERY command to determine the status of the device. Detachment may
be pending or may have been unsuccessful.
3. If you detach a minidisk with this command without releasing it, CMS implicitly
releases the minidisk. QUERY DISK will not display that minidisk.
4. You can designate a virtual CTCA by device address. If a virtual CTCA is
detached while coupled with another virtual CTCA, the remote device is left in
an un-coupled state, similar to its original condition after the DEFINE command.
(General for DETACH)
HCP002E Invalid operand - operand
HCP003E Invalid option - {option|command
contains extra option(s) starting with
option}
HCP006E Invalid device type vdev
HCP007E Invalid userid - userid
HCP009E Invalid range - range
HCP020E Userid missing or invalid
HCP021E A real device number was not supplied
or it is invalid.
232 z/VM: CP Commands and Utilities Reference
HCP022E A virtual device number was not
supplied or it was invalid.
HCP026E Operand missing or invalid
HCP040E Device {rdev|vdev|ldev} does not exist
HCP045E userid not logged on
HCP121E type {rdev|ldev} not attached to
{userid|system}
HCP124E DASD rdev in use by nnnnn users
HCP143E type rdev in use by system