z/VM: CP Commands and Utilities Reference - z/VM - IBM

UNCOUPLE
UNCOUPLE
►►
UNCOUPLE
Authorization
Purpose
Operands
Usage Notes
Responses
vdev
Privilege Class: G
Use UNCOUPLE to disconnect a virtual CTCA from a coupled CTCA device, or to
disconnect a virtual network adapter from a VM LAN segment or a Virtual Switch.
You can also uncouple a virtual CTCA by using an improper form of the COUPLE
command. For example,
COUPLE vdev TO * vdev
would disconnect vdev from the current partner and leave it disconnected because
it is not possible to connect a CTCA to itself.
vdev
specifies the virtual device number (hex) of the adapter to be disconnected. You
may specify the virtual device number of any device that is defined as part of
the adapter. However, CP responses refer to each virtual adapter by its base
device address; this is the first device in the range.
When vdev is a virtual OSA device type, it represents a virtual network adapter
created by the DEFINE NIC command. You can use any vdev on the command line
that is part of the virtual adapter configuration. However, CP responses use the
base device number to identify the virtual adapter.
Response 1: (virtual CTCA uncoupled by partner)
CTCA vdev DROPPED BY invoker vdev
is the response from a partner’s console after a virtual CTCA device is uncoupled
by the other user.
Response 2: (virtual CTCA uncoupled by user)
CTCA vdev DROPPED FROM userid vdev
CTCA vdev is uncoupled now
is the response from an invoker’s console after a virtual CTCA device is uncoupled
by the user.
Response 3: (virtual NIC uncoupled)
1694 z/VM: CP Commands and Utilities Reference
NIC vdev is disconnected from LAN ownerid lanname
is the response from the invoker’s console after a virtual network adapter is
uncoupled.
►◄