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

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

GIVE (Virtual Device)<br />

Responses<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 unloaded <strong>and</strong> rewound when it is detached from<br />

the user. This is the default <strong>and</strong> is accepted even if RETURN is not specified.<br />

Usage Notes:<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.<br />

2. The LEAVE option is valid only when the RETurn option is specified.<br />

The following are the comm<strong>and</strong> responses issued to the giver <strong>and</strong> receiver as a<br />

result of successful completion of the GIVE comm<strong>and</strong>.<br />

Response 1:<br />

giver<br />

tape vdev1 given to userid vdev2 [R/O]<br />

This response is issued to the invoking virtual machine to inform the user that the<br />

tape drive was successfully transferred. If read-only access was specified, then R/O<br />

is appended to the response.<br />

Response 2:<br />

operator<br />

456 z/<strong>VM</strong>: <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> <strong>and</strong> <strong>Utilities</strong> <strong>Reference</strong><br />

tape rdev given to userid1 vdev by userid2 [R/O]<br />

This response is issued to the primary system operator to inform the operator that<br />

ownership of the tape drive was transferred from userid2 to userid1 <strong>and</strong> is attached<br />

to userid1 at virtual device number vdev. If read-only access was specified, R/O is<br />

appended to the response.

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

Saved successfully!

Ooh no, something went wrong!