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

ATTACH
28 z/VM: CP Commands and Utilities Reference
If you are specifying a virtual device number or volume label for the device, you
can specify only one logical device number when you enter the ATTACH
command.
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
* is the virtual machine that is to receive the device, devices, or Expanded
Storage. That virtual machine must currently be logged on to the system. If you
are attaching either a device or Expanded Storage to your own virtual machine,
you can specify your user ID as an asterisk (*).
Use the keyword TO when:
v You specify a user ID with three numbers or fewer in a range of addresses or
multiple device addresses
v You specify a user ID that could also be a valid hexadecimal device address
(for example, CE)
v You specify a user ID as “to” or “t”.
vdev
is the virtual device number you want assigned to the device. The device
number is assigned to an available virtual subchannel number, and may be as
long as four digits.
SYSTEM
makes the DASD available to CP for access to users’ virtual disks, or for
paging, spooling, and temporary disk functions.
volid
is the volume label of the volume on the device being attached. The system
verifies the volume label on the device, so the label must be unique when
compared with all other volumes attached to the system.
XSTore
XSTorage
indicates that Expanded Storage is to be attached to the specified user.
XSTORE TO userid
is the user ID of the virtual machine that is to receive the real Expanded
Storage. The virtual machine must be currently logged on to the system. A user
ID of SYSTEM is not valid.
XSTORE TO *
specifies that the virtual machine issuing the ATTACH XSTORE command
receives the real Expanded Storage.
ALL
specifies that all of Expanded Storage that has not been reserved for CP use
with the RETAIN XSTORE command is attached to the user’s virtual machine
for exclusive use. ALL is the default.
nnnnnnnnM
is the size of real Expanded Storage to be assigned to the virtual machine. If
the amount specified exceeds the maximum available for guest virtual machine
use, the maximum contiguous Expanded Storage available is assigned.