27.12.2012 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Options<br />

Usage Notes<br />

GIVE (Real Device)<br />

v You specify userid2 as “TO” or “FR”or “FRO” or “FROM”.<br />

vdev<br />

AS vdev<br />

is the virtual number to be assigned to the tape drive when it is attached to the<br />

target virtual machine. If this is omitted, the real device number is assigned as<br />

the virtual device number. If vdev is specified, it should be the last oper<strong>and</strong><br />

before the options.<br />

Use the keyword AS when device number to be specified can also be a valid<br />

user ID.<br />

Options may be specified in any order. Conflicting options (for example,<br />

RETurn/NORETurn) cause an error message to be issued <strong>and</strong> the comm<strong>and</strong> to be<br />

terminated. The only valid options are:<br />

RETurn<br />

specifies that the invoker wishes to regain control of the transferred tape drive<br />

when detached by the receiver. If this is the case, RETurn must be explicitly<br />

specified.<br />

NORETurn<br />

specifies that the invoker does not wish to regain control of the transferred tape<br />

drive when detached by the receiver. NORETurn is the default <strong>and</strong> need not be<br />

explicitly specified.<br />

R/O<br />

causes the tape drive to be attached to the target virtual machine in read only<br />

mode. Attempting to write to a tape drive given with R/O specified results in an<br />

error.<br />

R/W<br />

causes the tape drive to be attached to the target virtual machine in read/write<br />

mode. R/W is the default <strong>and</strong> need not be explicitly specified.<br />

LEAVE<br />

specifies that the tape is to be left in its position when it is detached <strong>and</strong><br />

returned to the original owner. LEAVE is the default when RETurn is specified.<br />

UNLOAD<br />

specifies that the tape is to be rewound <strong>and</strong> unloaded when it is detached from<br />

the receiver.<br />

1. If a class B user issues the DETACH comm<strong>and</strong> to detach a GIVEN tape drive,<br />

any UNLOAD or LEAVE options specified on the DETACH comm<strong>and</strong> override<br />

the option that was specified on the GIVE comm<strong>and</strong>. If no option was<br />

specifically requested on the DETACH comm<strong>and</strong>, the option specified on GIVE<br />

is in effect. If LEAVE or UNLOAD are not specified on either the GIVE or<br />

DETACH comm<strong>and</strong>, the tape is rewound <strong>and</strong> unloaded.<br />

2. “FRom userid1” <strong>and</strong> “TO userid2” need not be specified in the order shown if<br />

“FRom” <strong>and</strong> “TO” are used.<br />

3. If “FROM” “TO” <strong>and</strong> “AS” are omitted, the first valid oper<strong>and</strong> for a user ID is<br />

taken as the GIVER <strong>and</strong> the second valid oper<strong>and</strong> for a user ID is taken as the<br />

RECEIVER.<br />

4. “FROM userid” <strong>and</strong> “TO userid” can be interchanged in the comm<strong>and</strong> syntax<br />

order.<br />

Chapter 2. <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> 453

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!