UNCOUPLE
Authorization
Privilege Class: G
Purpose
Use UNCOUPLE to disconnect a virtual CTCA from a coupled CTCA device, or to disconnect a virtual
network adapter from a guest LAN 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.Operands
- 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.
Usage Notes
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.
Responses
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)
NIC vdev is disconnected from LAN ownerid lanname
is
the response from the invoker's console after a virtual network adapter is uncoupled.Response 4: (virtual NIC uncoupled)
NIC vdev is disconnected from switch SYSTEM switchnm
is
the response from the invoker's console after a virtual network adapter is uncoupled from a virtual
switch.Messages
- HCP006E Invalid device type - vdev
- HCP040E Device vdev does not exist