DETACH Use the DETACH command to remove a real device from the CP system. Volumes in the SISOWN list, or devices containing minidisks that are in
use, cannot be detached. Tape devices are automatically rewound and
unloaded when detached. A previously attached device can be detached from a user even if the device is still in use. For devices that were
attached by an ATTACH co •• and and then detached by the user, a message is sent to the operator informing him that the device is free. The
for. at of the DETACH co •• and is:
r---------------------------------------------------------.----------------,
DETach raddr .} [Froll] {USerid} raddr... SISTE! raddr-raddr * I , I { }
raddr-raddr
specifies the real address (cuu), multiple addresses or range
of addresses of the device or devices to be detached. FRO! { us:rid} SISTE! specifies the user identification of the virtual machine to
which the real device [raddr] is currently attached. If the
optional keyword FRO! is omitted, the userid cannot be FRO!, FRO, FH or F. If the DETACH command is invoked to detach a
device from the class B operator's own virtual machine, an
asterisk [*] may be used. SISTE! indicates that the device is
a DASD device in use by CP for allocation and control. When specifying a use rid that could also be a valid
hexadecillal device address (for examFle, virtual machine id CE), the FRO! operand !Y§1 be specified to distinguish it as a
userid. Usage !.Qtes: 1. A 370x cannot be used by V8/370 as a 370x unless it has has been
loaded by Y8/370, DOS/YS, or OS/VS with 270x EP program and V!/370 was generated with it specified as a 2701, 2702, or 2703. The DETACH command resets the "loaded" status.
2. If the device being attached is a 2305, then both the real device
address and the virtual device address must be specified as the
first exposure on the 2305 (that is, device address 0 or 8). When attaching or detaching a dedicated 2305 to a user, all eight
exposures are processed.
3. When multiple addresses or a range of addresses are specified on
the DETACH co •• and line, then the affirmative response are issued
for devices that were successfully detached. Error messages are
issued for devices that cannot be detached. 64 V!/370 Operator's Guide

page of GC20-1806-9 As Updated April 1, 1981 by TNL GN25-0834 4. Attempts to detach an active shared device from the system will
result in an error message indicating the device is being shared by Multiple users. In order to detach the device, the system operator
aust inform the affected users to detach the device from their
virtual systems. The QUERY LINKS commands used by the system
operator will infor. him of the progress of the virtual machine
detachment operation.
5. DOS or as virtual machine systems should vary the device offline
before invoking the DETACH command. Similarly, CMS users should
issue the FELEASE command before invoking DETACH.
6. The use of DETACH while a virtual machine is tracing I/O will cause
abnormal termination, (DSP004). !essages are sent to the user, the operator who issued the command,
and the primary system operator (if different from the operator who issued the coamand), notifying them that the DETACH was successful. {
Vaddr... }
vaddr-vaddr
type vaddr DETACHED BY operator
the appropriate response sent to the user if an operator detaches
one or more of the user's devices.
{
raddr... }
raddr-raddr
type raddr DETACHED
r , luseridl L .J
the appropriate response is issued
previously attached device(s) or if
device(s) from a user or the system.
{
raddr.. • }
raddr-raddr r,
type raddr DETACHED luseridl BY operator I SYSTE! I L .J
if the user detaches a
the operator detaches the
the appropriate response is issued to the primary system operator if a class B operator other than the primary system operator issued
the DETACH command and the device or devices had been previously
attached. lote: In the above responses (other than multiple real address response
or a range of real address responses), the term "type" is one of the
following: DASD TAPE LINE RDR
PRT PUN GRIP CONS CTCA
CTLR DEV !SC Meaning Direct access storage device/3330V (MSS 3330 virtual volume) !agnetic tape
co.munication line
Card reader
Line printer
Card punch
Graphics device
Console
Channel-to-channel adapter 3704 or 3705 communications controller
Any other device
3151 port address
Section 3. CP Commands 65