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

DEFINE VSWITCH
Examples
Responses
Messages
The PORTNAME operand is optional. However, some levels of the OSA
Express adapters require that the PORTNAME operand is specified. When
such an adapter is in use and the PORTNAME operand is omitted, an error
message is displayed during switch initialization.
If the device is already started, you must stop it by issuing the SET VSWITCH
switchname DISCONNECT command before changing the port name.
10. PRIROUTER is required only when IP forwarding (routing) nodes will be
coupled to the switch. Router nodes provide connectivity for their LAN
segments (remote nodes) through their switch connection. When Router nodes
are deployed, their switch connection must be configured as PRIROUTER. In
addition to this, the switch itself must also be configured as PRIROUTER to
the OSA-E adapter. This will insure delivery of datagrams destined for LAN
segments that are connected through routers coupled to a switch. Only one
connection on each OSA-Express card can be designated as PRIROUTER. If
the switch is successful in establishing PRIROUTER on the OSA-Express
card, no other node (or switch) sharing the same OSA-Express card will be
able to act as PRIROUTER. If another connection has already been
established as PRIROUTER, the switch will be left with NONROUTER status
(which is reflected in the QUERY VSWITCH response).
11. NONROUTER is the default mode for the switch. Every node is directly
coupled to the switch and the associated IP destinations are registered with the
OSA Express connection. This is the most efficient way to use the virtual
switch. In this mode, packets with an unrecognized IP destination are
automatically sent out through the switch connection.
12. For a VLAN aware Virtual Switch, you should specify the same default VLAN
ID (defvid) as specified in your configuration of any physical switches in your
network. Most hardware manufacturers use a default of 1.
13. SET VSWITCH cannot be used to change the VLAN awareness attribute. To
change the attribute, detach the Virtual Switch and define it again with the
correct attribute.
14. If the Virtual Switch is defined as VLAN UNAWARE, any attempts to define a
VLAN membership will fail. When the CP address list is used, SET or MODIFY
VSWITCH GRANT with VLAN membership list fails. When an ESM is used,
the COUPLE command fails if a VLAN list is returned by the ESM.
1. To define a switch named BIGANG that connects to a real LAN through device
fd00, specify the following:
define vswitch bigang rdev fd00
Response 1:
VSWITCH SYSTEM switchname is created
This is the normal response for this command.
HCP2846E The PORTTYPE option is not allowed
for a VLAN UNAWARE virtual switch
204 z/VM: CP Commands and Utilities Reference