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

GIVE (Virtual Device)
►►
►
GIVE
R/W
R/O
Authorization
Purpose
Operands
Options
Virtual
vdev1
TO
Privilege Class: B
userid
AS
vdev2
NORETurn
RETurn
NORETurn
UNLOAD
GIVE (Virtual Device)
LEAVE
UNLOAD
Use GIVE (Virtual Device) to transfer control of a dedicated tape drive from your
virtual machine to another virtual machine.
vdev1
is the virtual address of the tape drive to be transferred. If this is not specified,
the command is rejected.
userid
TO userid
identifies the virtual machine that receives the tape drive. The receiver must be
logged on to the system. The specified user ID must not be that of the invoking
virtual machine (for example, one cannot GIVE a tape drive to oneself). If a
valid user ID is not specified, the command is rejected.
Use the keyword TO when:
v You specify a user ID with four numbers or fewer
v You specify a user ID that could also be a valid hexadecimal device address
(for example, ABC)
v You specify for giver or receiver a user ID that is “TO” or “FR” or “FRO” or
“FROM”.
vdev2
AS vdev2
is the virtual number to be assigned to the tape drive when it is attached to the
target virtual machine. If this is omitted, the real device number is assigned as
the virtual device number.
Use the keyword AS when the device number to be specified can also be a
valid user ID.
Options may be specified in any order. Conflicting options (for example,
RETURN/NORETURN) cause an error message to be issued and the command to
be terminated. The only valid options are:
►
►◄
Chapter 2. CP Commands 455