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

Usage Notes
Examples
TYPE QDIO
defines a VM LAN for use by simulated QDIO adapters. A QDIO LAN can only
accept connections from a simulated QDIO adapter.
IP|ETHernet
indicates whether the transport for the LAN is ETHERNET or IP. An ETHERNET
LAN operates at the Layer 2 level of the OSI model.
1. The Class G form of the DEFINE LAN command only allows the invoker to
create a VM LAN that belongs to the invoker. That is, ownerid must be the user
ID of the invoker, or an asterisk (*).
2. The Class B form of the DEFINE LAN command allows the invoker to create a
VM LAN that belongs to another user (or to SYSTEM).
3. A PERSISTENT LAN can only be destroyed by the DETACH LAN command.
When a VM LAN is created for ownerid SYSTEM, it is automatically classified
as a PERSISTENT LAN.
4. A TRANSIENT LAN can be destroyed by the DETACH LAN command, or by
elimination of all references. When a VM LAN is created for a user (any userid
other than SYSTEM) it is automatically classified as a TRANSIENT LAN. During
LOGOFF processing, any TRANSIENT LAN with no active connections will be
destroyed. If active connections exist, the “orphaned” LAN will continue to be
functional until the last adapter is uncoupled. However, if the owner completes
LOGON before the last adapter is uncoupled, the LAN is no longer “orphaned”
and it will survive the removal of the last adapter.
5. The VMLAN statement in SYSTEM CONFIG (or the SET VMLAN command)
may restrict the number of VM LAN segments on the system. Use the QUERY
VMLAN command to determine what limit is in effect.
6. DEFINE LAN statements may be added to the SYSTEM CONFIG file to
automatically create VM LAN segments during CP system initialization. Every
VM LAN defined in the SYSTEM CONFIG file is classified as a PERSISTENT
LAN.
7. A Class B user can use the SET LAN and DETACH LAN commands to operate
on a LAN segment that belongs to another user (e.g. a SYSTEM-owned LAN).
8. When a RESTRICTED LAN is defined, the owner (as determined by the
DEFINE command) is automatically added to the access list. The owner can
use the SET LAN command to grant and revoke access to the LAN.
9. SET LAN cannot be used to change the type of transport. The LAN will need to
be redefined.
1. DEFINE LAN - Class G:
To create a user LAN named QNET that will allow up to 16 connections, enter:
cp define lan qnet type qdio maxconn 16
LAN VMUSERX QNET is created
2. DEFINE LAN - Class B:
To create a SYSTEM LAN named INEWS that will allow up to 100 connections
and will not have accounting records created, enter:
cp define lan inews ownerid system maxconn 100 accounting off
LAN SYSTEM INEWS is created
DEFINE LAN
Note that this must be done by a user with Class B privileges since the LAN is
not owned by the invoker and the ACCOUNTing option is specified.
Chapter 2. CP Commands 171