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.

Responses<br />

7. You cannot detach volumes in the SYS<strong>CP</strong>VOL list that are in use by the<br />

system, shared by another system in a CSE complex, or devices containing<br />

minidisks to which users are linked.<br />

8. If a tape device being detached was transferred to a user with the GIVE (Real<br />

Device) comm<strong>and</strong>, the LEAVE or UNLOAD option specified on the DETACH<br />

comm<strong>and</strong> overrides any option that was set when the GIVE comm<strong>and</strong> was<br />

issued. If LEAVE or UNLOAD is not specifically requested on the DETACH<br />

comm<strong>and</strong>, the option specified when GIVE was issued is processed. If no<br />

option was specified on either GIVE or DETACH, the tape is rewound <strong>and</strong><br />

unloaded.<br />

9. If a device was attached using the <strong>CP</strong> ATTACH comm<strong>and</strong> <strong>and</strong> later detached,<br />

the system operator receives a response saying that the device was detached.<br />

10. For more information, see “Usage Notes” on page 232.<br />

11. When the primary or the secondary volume of a duplex pair is detached from a<br />

virtual machine, the response generated will indicate that the volume was<br />

either the primary duplex volume or the secondary duplex volume of the duplex<br />

pair. When the primary of a duplex pair is detached from the system, the<br />

response generated will indicate that the volume was the primary duplex<br />

volume of the duplex pair.<br />

12. A tape device attached with the SINGLEUSER option (the default) will<br />

automatically be unassigned by <strong>CP</strong> when the device is detached, unless the<br />

LEAVE option is specified on DETACH or the tape was attached with the<br />

NOASSIGN option.<br />

A tape device attached with both the SINGLEUSER <strong>and</strong> NOASSIGN options<br />

will not be unassigned by <strong>CP</strong> when the device is detached, regardless of<br />

whether the tape is currently assigned by a guest. In other words, <strong>CP</strong> will not<br />

change the ASSIGNED or UNASSIGNED status of the drive. It is the<br />

responsibility of the guest to issue the ASSIGN CCW when it needs the tape<br />

drive <strong>and</strong> to issue the UNASSIGN CCW when it is finished using the drive.<br />

13. A tape device attached with the MULTIUSER option will be unassigned by <strong>CP</strong><br />

when the device is detached, even though MULTIUSER implies NOASSIGN.<br />

This prevents one user from unexpectedly locking out many other users from<br />

the drive.<br />

The user who currently owns the device (if different from the primary system<br />

operator), the user who issues the DETACH (real device) comm<strong>and</strong> (if different from<br />

the owner of the device), <strong>and</strong> the primary system operator (if different from the user<br />

who issued the comm<strong>and</strong>) each receive messages indicating that the DETACH (real<br />

device) is successful.<br />

Note: The type variable in the following responses is omitted when a range of<br />

device numbers or multiple device numbers are being reflected in the<br />

response.<br />

In the responses below, the term type is one of the following:<br />

Type Meaning<br />

CTCA Channel-to-channel adapter<br />

CTLR 37xx Communications Controller<br />

DASD Direct access storage device<br />

F<strong>CP</strong> SCSI device adapter<br />

GRAF Display device<br />

MSC Mass Storage Controller<br />

DETACH (Real Device)<br />

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

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

Saved successfully!

Ooh no, something went wrong!