UNCOUPLE

Read syntax diagramSkip visual syntax diagram UNCOUPLE vdev

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