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

GIVE (Real Device)
GIVE (Real Device)
►►
►
GIVE
Authorization
Purpose
rdev
NORETurn
NORETurn
RETurn
Operands
FRom
UNLOAD
LEAVE
UNLOAD
*
userid1
R/W
R/O
Privilege Class: B
452 z/VM: CP Commands and Utilities Reference
TO
*
userid2
Use GIVE (Real Device) to transfer control of a real tape drive dedicated to one
user, from that user’s virtual machine to another user’s virtual machine.
rdev
is a real device number of the tape drive to be transferred from the indicated
user.
userid1
FRom userid1
* identifies the virtual machine to which the device is currently attached. The
specified user must be logged on and not in the process of logging off. If you
are issuing the GIVE (Real Device) command to give a device from your own
virtual machine, you can specify userid1 as an asterisk (*).
Use the keyword FROM 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 userid1 as “to” or “fr”or “fro” or “from”.
userid2
TO userid2
* identifies the virtual machine that receives the tape drive. If you are issuing the
GIVE (Real Device) command to transfer the ownership from another user to
your virtual machine, you can specify userid as an asterisk (*). The receiver
must be logged on to the system. The specified user ID must not be that of the
giver (the virtual machine to which the device is currently attached). If the user
ID of the specified receiver is also a valid hexadecimal number of not more than
4 digits and the immediate operand following this operand is not “[AS] vdev”,
the command is rejected with error message HCP1123E.
AS
vdev
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)
►
►◄