CP Command Reference for General Users (Rel 6 PLC 17 Apr81) Page 68 (80 of 213)

DETACH
In the above responses, 'type' is one of the following: IYQ§ DA5D TAPE
LINE
RDR T?RT PUN GRAF CONS CTCA DEY MSC Direct access storage device/3330Y(virtual) volumes
Maqnetic tape
Communication line
Card reader
Line printer
Card punch
Graphics device
Console
Channel-to-channel adapter other device Storaqe Control unit IBM VM/370 CP Command Peference for General Users

DETACH CHANNEL Use the DETACH CHANNEL command to detach a iedicated channel from your
virtual michine when that channel path is no longer required for virtual
machine I/8 operations. The format of the DETACH CHANNEL command is:
r I I CHANnel c
L
CHANNEL c -, I I is the real address of the channel that is to be detached.
If DETACH is invoked prior to the normal completion of 1/0 activities on the dedicated channel, those activities are aborted. CHANNEL c DETACHED userid
is sent to the user who issued the and to the primary
system operator.
section 5. Format of CP Commands 69

Previous Page Next Page

Extracted Text (may have errors)

DETACH
In the above responses, 'type' is one of the following: IYQ§ DA5D TAPE
LINE
RDR T?RT PUN GRAF CONS CTCA DEY MSC Direct access storage device/3330Y(virtual) volumes
Maqnetic tape
Communication line
Card reader
Line printer
Card punch
Graphics device
Console
Channel-to-channel adapter other device Storaqe Control unit IBM VM/370 CP Command Peference for General Users

DETACH CHANNEL Use the DETACH CHANNEL command to detach a iedicated channel from your
virtual michine when that channel path is no longer required for virtual
machine I/8 operations. The format of the DETACH CHANNEL command is:
r I I CHANnel c
L
CHANNEL c -, I I is the real address of the channel that is to be detached.
If DETACH is invoked prior to the normal completion of 1/0 activities on the dedicated channel, those activities are aborted. CHANNEL c DETACHED userid
is sent to the user who issued the and to the primary
system operator.
section 5. Format of CP Commands 69

Help

DETACH Use the command to remove a virtual device from the virtual
machine. The format of the DETACH command is:
r
DETach
L {
[Vaddr fvaddr ••• ll}
rvaddr-vaddr ]
------, I I J
vaddr [vaidr ••• ]
vaddr-vaddr
the term vaddr is the virtual address (CUU) of the device to
be detached from your virtual machine. To detach multiple
devices on one command line, a blank must be inserted between
the addresses specified. To detach a range of devices, a
hyphen (-) must be inserted between the addresses specified. Multiole addresses and a range of addresses cannot be
intermixed on the same command line.
1. =an detach a previously attached device even if the device is currently in use. You can also detach devices that were attached
becaJse of VM/310 directory entries or during :P system
initialization.
2. When you detach a virtual device, it becomes inaccessible to your
virtual machine. If the device was previously attached to your
virtual machine bV an ATTACH command, it is released and becomes
available for attachment to your virtual machine, another user, or
the CP system. Tape devices are automatically rewound and unloaded
when detached.
3. If detach a device that was previously attached to your virtual
machine bv the operator, a message is sent to the operator informing him that the device is free. 4. If the device being detached is a dedicated 2305, the virtual
address vou specify must be a base address (xxO or xx8). s. If a detach operation is taking place for a 2305 device and a range
is being used, processinq for all 2305 exposures is performed when
the base address is encountered. It is possible that the range operand may not include all the 2305 exposures. This is not an
error all exposures are detached. When multiple real devi=e addresses are specified on the command line, only the base
address for the 2305 should be used. Anv device address other than
the base exposure is considered an error condition. 66 CP Command Reference for General Users

DETACH
6. Command processing does not terminate if an error (other than a error) is encountered when processinq a range of addresses
or mlltiple addresses. Instead, an error message is issued for
each device (address) that cannot be detached. In addition, an
informational message identifies those devices that were saccessfully detached. Informational messaqes may appear several in one command execution when a range of addresses or maltiple addresses are being processed. informational
messages appear only when range is being processed.
7. It is for a class B user to DETACH real devices from
another user or other users.
The DErACH command belongs to both the B and the G privilege class of
user; the response or responses issued are dependent upon who the
DETACH command. Depending upon the situation, responses are issued to: • the general user whose virtual machine has the device to be detached • the system operator informing him that the device is successfully
detached • another B privilege class operator (not the system operator) that may
have initiated the detach operation.
This publication documents only those responses that the general user
would receive in the course of a virtual machine terminal sessiono For
those responses that are received by the system operator as a result of
a qeneral users detach operation, refer to the DETACH command in the gYiQ§· the 'tvpe' variable in the following responses is omitted when a
ranqe of addresses or multiple addresses are being reflected in the
response.
(type vaddr ) DETACHED vad dr. • • ( vaddr-vaidr )
The user receives
completion of a
initiated.
{
type vaddr } DETACHED
vad dr ••• vaddr-vaddr
one or more of
successful detach BY operator
these responses
operation that
upon the
was self
The user receives one or more of these responses upon the of the detach operation if the system operator or
another user with the B privilege class had initiated the detach
operation.
CTCA vadde DROP FROM userid vaddr
This is the response if the device detached was a virtual CTC! connected (via the COUPLE command) to another CTCA on the virtual
machine specified by the userid. This response is always followed bV the response:
CTCA vaddr DETACHED
section 5. Format of CP Commands 67

Previous Page Next Page

Extracted Text (may have errors)

DETACH Use the command to remove a virtual device from the virtual
machine. The format of the DETACH command is:
r
DETach
L {
[Vaddr fvaddr ••• ll}
rvaddr-vaddr ]
------, I I J
vaddr [vaidr ••• ]
vaddr-vaddr
the term vaddr is the virtual address (CUU) of the device to
be detached from your virtual machine. To detach multiple
devices on one command line, a blank must be inserted between
the addresses specified. To detach a range of devices, a
hyphen (-) must be inserted between the addresses specified. Multiole addresses and a range of addresses cannot be
intermixed on the same command line.
1. =an detach a previously attached device even if the device is currently in use. You can also detach devices that were attached
becaJse of VM/310 directory entries or during :P system
initialization.
2. When you detach a virtual device, it becomes inaccessible to your
virtual machine. If the device was previously attached to your
virtual machine bV an ATTACH command, it is released and becomes
available for attachment to your virtual machine, another user, or
the CP system. Tape devices are automatically rewound and unloaded
when detached.
3. If detach a device that was previously attached to your virtual
machine bv the operator, a message is sent to the operator informing him that the device is free. 4. If the device being detached is a dedicated 2305, the virtual
address vou specify must be a base address (xxO or xx8). s. If a detach operation is taking place for a 2305 device and a range
is being used, processinq for all 2305 exposures is performed when
the base address is encountered. It is possible that the range operand may not include all the 2305 exposures. This is not an
error all exposures are detached. When multiple real devi=e addresses are specified on the command line, only the base
address for the 2305 should be used. Anv device address other than
the base exposure is considered an error condition. 66 CP Command Reference for General Users

DETACH
6. Command processing does not terminate if an error (other than a error) is encountered when processinq a range of addresses
or mlltiple addresses. Instead, an error message is issued for
each device (address) that cannot be detached. In addition, an
informational message identifies those devices that were saccessfully detached. Informational messaqes may appear several in one command execution when a range of addresses or maltiple addresses are being processed. informational
messages appear only when range is being processed.
7. It is for a class B user to DETACH real devices from
another user or other users.
The DErACH command belongs to both the B and the G privilege class of
user; the response or responses issued are dependent upon who the
DETACH command. Depending upon the situation, responses are issued to: • the general user whose virtual machine has the device to be detached • the system operator informing him that the device is successfully
detached • another B privilege class operator (not the system operator) that may
have initiated the detach operation.
This publication documents only those responses that the general user
would receive in the course of a virtual machine terminal sessiono For
those responses that are received by the system operator as a result of
a qeneral users detach operation, refer to the DETACH command in the gYiQ§· the 'tvpe' variable in the following responses is omitted when a
ranqe of addresses or multiple addresses are being reflected in the
response.
(type vaddr ) DETACHED vad dr. • • ( vaddr-vaidr )
The user receives
completion of a
initiated.
{
type vaddr } DETACHED
vad dr ••• vaddr-vaddr
one or more of
successful detach BY operator
these responses
operation that
upon the
was self
The user receives one or more of these responses upon the of the detach operation if the system operator or
another user with the B privilege class had initiated the detach
operation.
CTCA vadde DROP FROM userid vaddr
This is the response if the device detached was a virtual CTC! connected (via the COUPLE command) to another CTCA on the virtual
machine specified by the userid. This response is always followed bV the response:
CTCA vaddr DETACHED
section 5. Format of CP Commands 67

DIAL Use the DIAL command to logically connect a switched line, leased line,
or locally attached terminal to a previously logged-on multiple-access
virtual ma=hine. The format of the DIAL command is: r DIAL userid [vaddr]
L _____ _ userid vaddr
is the identification of a virtual machine that is currently loqgei on.
is the address of the virtual communication line to which the
connection is to be made.
1. A cJmmand is accepted only at logon, and only as a substitute a LOGON command. The type of terminal used must be supported by bJth V,/370 and the multiple-access virtual machine. See the for details on running and gaining
access to multiple-access machines.
2. The command is not supported for the 3066 system console, for
the 3210/3215 system console, or for terminals that are using Nep lines in a 3704/3705 control unit, but is supported for 3138, 3148,
and 3158 display consoles.
3. Once the connection is made, your terminal operates entirely under
the =ontrol of that virtual machine. The DIAL command matches your
terminal to an equivalent type defined in the multiple-access virtual machine. If no matching terminal type exists, the cannot be made and an error message is issued. 4. The DIlL command, though not supported for remote 3270 terminals, is slPPJrted for locally-attached 3270 display devices. If the command is issued from a local 3270 terminal, the virtual system user must issue the CP command RESET to drop the dialed TO userid vaddr is the messaqe sent to the user indicating that a logical cJnnection has been made. 70 CP Command Peference for General Users

DIAL
(GRAF raddr} <LINE raddr DIALED TO userid DIALED = nnn (DEV resid
is the response to the primary system operator. It indicates a
slccessful connection to the virtual machine (userid) and the tJtal numrer of VM/370 lines (nnn) currently connected to other victual machines. DEV resid indicates the resource
identification of a 3704/3705 line. NJte: The terminal remains connected to and under the control of the-virtual machine until that virtual machine terminates the cJmmcrnication. DROP userid vaddr
is the messaae sent to the user when the line is disabled.
{
GRAF raddr}
LINE raddc DROP userid DIALED DEV cesid. nnn
is the message sent to the primary system operator when the line
is disabled.
section 5. Format of CP Commands 71

Previous Page Next Page

Extracted Text (may have errors)

DIAL Use the DIAL command to logically connect a switched line, leased line,
or locally attached terminal to a previously logged-on multiple-access
virtual ma=hine. The format of the DIAL command is: r DIAL userid [vaddr]
L _____ _ userid vaddr
is the identification of a virtual machine that is currently loqgei on.
is the address of the virtual communication line to which the
connection is to be made.
1. A cJmmand is accepted only at logon, and only as a substitute a LOGON command. The type of terminal used must be supported by bJth V,/370 and the multiple-access virtual machine. See the for details on running and gaining
access to multiple-access machines.
2. The command is not supported for the 3066 system console, for
the 3210/3215 system console, or for terminals that are using Nep lines in a 3704/3705 control unit, but is supported for 3138, 3148,
and 3158 display consoles.
3. Once the connection is made, your terminal operates entirely under
the =ontrol of that virtual machine. The DIAL command matches your
terminal to an equivalent type defined in the multiple-access virtual machine. If no matching terminal type exists, the cannot be made and an error message is issued. 4. The DIlL command, though not supported for remote 3270 terminals, is slPPJrted for locally-attached 3270 display devices. If the command is issued from a local 3270 terminal, the virtual system user must issue the CP command RESET to drop the dialed TO userid vaddr is the messaqe sent to the user indicating that a logical cJnnection has been made. 70 CP Command Peference for General Users

DIAL
(GRAF raddr} <LINE raddr DIALED TO userid DIALED = nnn (DEV resid
is the response to the primary system operator. It indicates a
slccessful connection to the virtual machine (userid) and the tJtal numrer of VM/370 lines (nnn) currently connected to other victual machines. DEV resid indicates the resource
identification of a 3704/3705 line. NJte: The terminal remains connected to and under the control of the-virtual machine until that virtual machine terminates the cJmmcrnication. DROP userid vaddr
is the messaae sent to the user when the line is disabled.
{
GRAF raddr}
LINE raddc DROP userid DIALED DEV cesid. nnn
is the message sent to the primary system operator when the line
is disabled.
section 5. Format of CP Commands 71

Page 3Section 1. The VM/370 Command Languages click to expand contents

Page 7Section 2. The CP Command Language click to expand contents

Page 13Section 3. CP Command Usage click to expand contents

Page 35Part 2. Reference Information click to expand contents

Page 41Section 5. Format of CP Commands click to expand contents

Page 173Appendix. VM/370 Command Summary click to expand contents

Extracted Text (may have errors)

Help

loading

Extracted Text (may have errors)

Extracted Text (may have errors)