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.

DETACH (Virtual Device)<br />

DETACH (Virtual Device)<br />

►►<br />

DETach<br />

Authorization<br />

Purpose<br />

Oper<strong>and</strong>s<br />

Virtual<br />

Usage Notes<br />

▼<br />

vdev<br />

vdev1-vdev2<br />

Privilege Class: G<br />

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

Use DETACH (virtual device) to remove devices from your virtual machine<br />

configuration.<br />

vdev<br />

vdev1-vdev2<br />

is a virtual device number, a list of virtual device numbers, or a range of virtual<br />

device numbers to be detached from your virtual machine. On a single<br />

comm<strong>and</strong> line, you may combine device numbers, lists of device numbers, <strong>and</strong><br />

ranges of device numbers. If you are detaching a list of virtual devices, insert at<br />

least one blank between the device numbers you specify. If you are detaching a<br />

range of devices, insert a hyphen (-) between the device numbers you specify.<br />

The maximum number of devices allowed within a range is 256.<br />

1. You can detach a virtual device even if it is currently in use.<br />

2. When you detach a dedicated device, it becomes inaccessible to your virtual<br />

machine; it is released <strong>and</strong> becomes available to any virtual machine, another<br />

user, or the <strong>CP</strong> system. The system operator receives a response indicating<br />

that the device is free.<br />

3. If the virtual device is part of a Concurrent Copy (CONCOPY) session for your<br />

virtual machine, the CONCOPY session is terminated in the storage control<br />

associated with the device.<br />

4. Tape devices are automatically rewound <strong>and</strong> unloaded when you enter the<br />

DETACH comm<strong>and</strong>, unless the tape device was attached with the NOASSIGN<br />

or MULTIUSER option.<br />

5. If you detach a dedicated device, <strong>and</strong> it was not obtained using a GIVE<br />

comm<strong>and</strong> with return specified, the system operator receives a message<br />

indicating that the device is free.<br />

6. Comm<strong>and</strong> processing does not end if an error (other than a syntax error) is<br />

encountered when processing a range of device numbers or multiple device<br />

numbers. Instead, an error message is issued for each device that cannot be<br />

detached. Informational messages are issued to identify those devices that<br />

were successfully detached. These informational messages may appear<br />

several times in one comm<strong>and</strong> execution when you have specified on the<br />

comm<strong>and</strong> line a range of device numbers or multiple device numbers.<br />

►◄

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

Saved successfully!

Ooh no, something went wrong!