Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
LANBK
Control Block Contents
LANBK DSECT
LANRDD DSECT
Cross Reference (Contains links to field and bit definitions)
LANBK Prolog
NAME : HCPLANBK DESCRIPTION: Virtual LAN block DSECT : LANBK FUNCTION : Define a structure to represent a Virtual LAN (Local Area Network) in CP. LOCATED BY - SLMLANTB - The System LAN Table CREATED BY : CP DEFINE LAN command DELETED BY : CP DETACH LAN processing REFERENCES : HCPEQUAT COPY - General CP equates
LANBK Control Block Content
LANBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure LANBK Virtual LAN block Static Area - The fields in this area are relatively static. They are set when the LANBK is constructed. 0000 0 Character 16 LANID (0) LAN Fully-Qualified Identifier 0000 0 Character 8 LANOWNER LAN Owner (user who defined it) 0008 8 Character 8 LANNAME LAN Name 0010 16 Character 8 LANDESC LAN Description 0018 24 Character 8 LANDEFBY LAN Defined By <userid> 0020 32 Signed 4 LANDFTOD CPU TOD (high-order word) when this LAN was defined 0024 36 Bitstring 1 LANTYPE LAN Type 00000001 LANHIPR 1 - HiperSockets LAN 00000002 LANQDIO 2 - QDIO LAN 0025 37 Bitstring 1 LANPROTO LAN Protocol 00000001 LANENET X'01' - Ethernet / Fast Ethernet 00000002 LANTRNET X'02' - High Speed Token Ring 00000003 LANGBE X'03' - Gigabit Ethernet 00000010 LAN10GE X'10' - 10 Gig Ethernet 00000080 LANQDIOP X'80' - QDIO Protocol 00000081 LANATME X'81' - ATM Emulated Enet Port 00000082 LANATMTR X'82' - ATM Emulated Token Ring Port 00000083 LANATMGE X'83' - ATM Emulated GbEnet + MTU size 00000088 LANATMP X'88' - ATM Emulated Port + autoconfig 00000090 LANATM X'90' - Native ATM 0026 38 Bitstring 1 LANLEVEL LAN Level 00000001 LANGLAN 1 - Level 1 - Guest Lan 00000002 LANVSW 2 - Level 2 - Vswitch 0027 39 Bitstring 1 * Reserved LAN Lock - Note that certain fields are additionally serialized by LANCTLCK. See below for more information. Notes : LKWRDSIZ == 3 doublewords. 0028 40 Dbl-Word 8 LANLKWRD (3) LAN Lockword LAN Management Area - 0040 64 Bitstring 1 LANCFLG LAN Configuration Flags 1... .... LANINPRG X'80' - Initialization in Progress .1.. .... LANDLPRG X'40' - Delete in Progress ..1. .... LANLIMCN X'20' - Limit connections by LANMAXCN ...1 .... LANLIMID X'10' - Limit connections by userid .... 1... LANSYSLN X'08' - Registered System LAN .... .1.. LANUSRLN X'04' - Private LAN .... ..1. LANTRANS X'02' - Transient LAN .... ...1 LANACNT X'01' - Accounting Enabled 0041 65 Bitstring 1 LANCFLG2 More LAN Configuration Flags 1... .... LANRDV X'80' - RDEV was specified for VSWITCH .1.. .... LANDLDIP X'40' - LANBK on Delete In Progress Chain ..1. .... LANPRTRQ X'20' - PRIROUTER was specified for VSWITCH 0042 66 Signed 2 LANIPTO IP Timeout value (in 30 sec tics) 0044 68 Signed 4 LANRFCTR LAN Reference Counter 0048 72 Address 4 LANFPNT Pointer to next LANBK 004C 76 Address 4 LANBPNT Pointer to previous LANBK 0050 80 Address 4 LANACLHD Pointer to first ACLBK 0054 84 Address 4 LANACLTL Pointer to last ACLBK 0058 88 Signed 4 LANMFS Maximum Frame Size in bytes 005C 92 Signed 4 LANMAXCN Maximum number of connections 0060 96 Address 4 LANCNLST Pointer to Connected NICBK List 0064 100 Signed 4 LANCNCTR LAN Connection Counter 0068 104 Character 8 LANUPDBY LAN Updated By <userid> 0070 112 Character 8 LANPORT Portname 0078 120 Character 8 LANCONT Controller 0080 128 Address 4 LANVQSBK Pointer to VQSBK for VSWITCH 0084 132 Signed 2 LANRDEV Rdev 0086 134 Bitstring 1 LANFSV Queuestorage value (1-8) 0087 135 Bitstring 1 * Reserved LANIPTBL - LAN IP Table LANIPTBL is a pointer to a HASH Table that uses the IP Address as the key. Each IPNBK in the hash table represents an IP Address pointing to a network device (NIDBK). 0088 136 Address 4 LANIPTBL Pointer to LAN IP Table 008C 140 Signed 2 LANIPCTR Number of entries in LANIPTBL 008E 142 Bitstring 2 * Reserved LANBCLST - LAN Broadcast List Each IPNBK in the Broadcast List represents a device (NIDBK) which is enabled for inbound broadcast. 0090 144 Address 4 LANBCLST Pointer to Broadcast IPNBK list 0094 148 Signed 2 LANBCCTR Number of Broadcast entries 0096 150 Bitstring 2 * Reserved LANMRLST - Multicast Router List Each IPNBK in the Multicast Router List represents a device (NIDBK) which is set as a Multicast Router. 0098 152 Address 4 LANMRLST Pointer to MC Router IPNBK list 009C 156 Signed 2 LANMRCTR Number of MC Router entries 009E 158 Bitstring 2 * Reserved LANRXLST - Unicast Router List Each IPNBK in the Unicast Router List represents a device (NIDBK) which is the active unicast router for an adapter coupled to this LAN. 00A0 160 Address 4 LANRXLST Pointer to UC Router IPNBK list 00A4 164 Signed 2 LANRXCTR Number of UC Router entries 00A6 166 Bitstring 2 * Reserved LANDXLST - LAN Device Connection List Each IPNBK in the LAN Device Connection List represents a device (NIDBK) which is active on this LAN (that is, a STRTLAN primitive has been issued by the driver for this device). 00A8 168 Address 4 LANDXLST Pointer to LAN Device IPNBK list 00AC 172 Signed 2 LANDXCTR Number of LANDXLST entries 00AE 174 Bitstring 2 * Reserved LANPXLST - LAN Observer (Promiscuous) List Each IPNBK in the Observer List represents a device (NIDBK) which is operating in promiscuous mode. 00B0 176 Address 4 LANPXLST Pointer to Observer IPNBK list 00B4 180 Signed 2 LANPXCTR Observer count 00B6 182 Bitstring 2 * Reserved LANDFNIC/LANDFNIC - Default Router to External Network. These fields are only used for a VSWITCH LAN. When the External Link is active, they point to the device that represents the data connection. 00B8 184 Address 4 LANDFNIC Pointer to Default Router NICBK 00BC 188 Address 4 LANDFNID Pointer to Default Router NIDBK Queue of Pending IP Functions (VSWITCH ONLY). 00C0 192 Address 4 LANPIFHD Head of Pending IP Functions 00C4 196 Address 4 LANPIFTL Tail of Pending IP Functions Chain of pending IP address entries (VSWITCH ONLY). This is the anchor for pending IP Address entries. Each entry is an IPNBK representing an IP Address that was referenced as the target of a datagram. Entries are added via CS logic while LANLKWRD is held SHARED, and removed while LANLKWRD is held in EXCLUSIVE mode. 00C8 200 Address 4 LANIPPND Pointer to pending IP entries 00CC 204 Signed 4 LANIPPID ICMP Identifier for IPPND ******** Start of Virtual Switch Controller Section The Virtual Switch Controller section of this structure is serialized by a combination of LANLKWRD and LANCTLCK. To reference these fields, the LANLKWRD must be held at least SHARED. To modify these fields, either: 1) Obtain the LANLKWRD EXCLUSIVE, or 2) Obtain the LANLKWRD SHARED and the LANCTLCK EXCLUSIVE. The second choice allows access to the controller- related fields without interference with data transfer among the guest hosts coupled to the virtual switch. 00D0 208 Dbl-Word 8 LANCTLCK (3) LAN CONTROLLER lock word 00E8 232 Address 4 LANCTPTR Pointer to controller entry 00EC 236 Signed 2 LANVDEV Vdev assigned by controller 00EE 238 Signed 2 LANMXMTU MaxMTU reported by H/W 00F0 240 Bitstring 1 LANCTSTA VSwitch Controller State .... ...1 LANCTDEF X'01' - Virtual switch defined .... ..1. LANCTNOC X'02' - Controller not available .... ..11 LANCTOPR X'03' - Operator intervention required .... .1.. LANCTDIS X'04' - Disconnected .... .1.1 LANCTATT X'05' - VDEVs attached to controller .... .11. LANCTINI X'06' - OSA initialization in progress .... .111 LANCTNOT X'07' - OSA device not ready .... 1... LANCTRDY X'08' - OSA device ready .... 1..1 LANCTDET X'09' - OSA devices being detached .... 1.1. LANCTDEL X'0A' - VSWITCH delete pending 00F1 241 Bitstring 1 LANCTFLG VSwitch Controller Flag 1... .... LANXIPV6 X'80' - VSWITCH RDEV supports IPv6 .1.. .... LANPRTAC X'40' - PRIROUTER is active on VSWITCH 00F2 242 Bitstring 6 LANDVMAC VSwitch RDEV MAC address 00F8 248 Address 4 * 00FC 252 Signed 4 * (0) 00FC 252 Bitstring 36 LANRRDEV Array of LANRDD elements ******** End of Virtual Switch Controller Section End of the LANBK. 00000120 LAN$END * End of the LANBK 00000120 LANBKLN *-LANBK Length of LANBK in bytes 00000024 LANBKSZ (*-LANBK+7)/8 Size of LANBK in doublewords Define the LANRDD structure. This structure maps each element of the LANRRDEV array. LANRDD_LAST=1 for the last valid element in this array.
LANRDD DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure LANRDD Virtual LAN block 0000 0 Signed 2 LANRDD_RDEV Real device address 0002 2 Bitstring 1 LANRDD_FLAG Device status flags: 1... .... LANRDD_LAST X'80' - Last active descriptor .1.. .... LANRDD_INOP X'40' - Inoperative device ..1. .... LANRDD_VDEV X'20' - VDEV not available at chosen controller ...1 .... LANRDD_PRT X'10' - Port name specified 0003 3 Bitstring 1 * Reserved 0004 4 Character 8 LANRDD_PORT Port name for this device 0000000C LANRDDLN *-LANRDD Length of each LANRDD in bytes
LANBK Storage Layout
*** LANBK - Virtual LAN block * * +-------------------------------------------------------+ * 0 | LANOWNER | * +-------------------------------------------------------+ * 8 | LANNAME | * +-------------------------------------------------------+ * 10 | LANDESC | * +-------------------------------------------------------+ * 18 | LANDEFBY | * +---------------------------+------+------+------+------+ * 20 | LANDFTOD |:TYPE |:PROTO|:LEVEL|//////| * +---------------------------+------+------+------+------+ * 28 | | * = LANLKWRD = * | | * +------+------+-------------+---------------------------+ * 40 |:CFLG |:CFLG2| LANIPTO | LANRFCTR | * +------+------+-------------+---------------------------+ * 48 | LANFPNT | LANBPNT | * +---------------------------+---------------------------+ * 50 | LANACLHD | LANACLTL | * +---------------------------+---------------------------+ * 58 | LANMFS | LANMAXCN | * +---------------------------+---------------------------+ * 60 | LANCNLST | LANCNCTR | * +---------------------------+---------------------------+ * 68 | LANUPDBY | * +-------------------------------------------------------+ * 70 | LANPORT | * +-------------------------------------------------------+ * 78 | LANCONT | * +---------------------------+-------------+------+------+ * 80 | LANVQSBK | LANRDEV |LANFSV|//////| * +---------------------------+-------------+------+------+ * 88 | LANIPTBL | LANIPCTR |/////////////| * +---------------------------+-------------+-------------+ * 90 | LANBCLST | LANBCCTR |/////////////| * +---------------------------+-------------+-------------+ * 98 | LANMRLST | LANMRCTR |/////////////| * +---------------------------+-------------+-------------+ * A0 | LANRXLST | LANRXCTR |/////////////| * +---------------------------+-------------+-------------+ * A8 | LANDXLST | LANDXCTR |/////////////| * +---------------------------+-------------+-------------+ * B0 | LANPXLST | LANPXCTR |/////////////| * +---------------------------+-------------+-------------+ * B8 | LANDFNIC | LANDFNID | * +---------------------------+---------------------------+ * C0 | LANPIFHD | LANPIFTL | * +---------------------------+---------------------------+ * C8 | LANIPPND | LANIPPID | * +---------------------------+---------------------------+ * D0 | | * = LANCTLCK = * | | * +---------------------------+-------------+-------------+ * E8 | LANCTPTR | LANVDEV | LANMXMTU | * +------+------+-------------+-------------+-------------+ * F0 |:CTSTA|:CTFLG| LANDVMAC | * +------+------+-------------+---------------------------+ * F8 |///////////////////////////| | * +---------------------------+ | * 100 | | * = LANRRDEV = * | | * +-------------------------------------------------------+ * 120 * *** LANBK - Virtual LAN block *** LANRDD - Virtual LAN block * * +-------------+------+------+---------------------------+ * 0 |LANRDD_RDEV |(002) |//////| LANRDD_PORT- | * +-------------+------+------+---------------------------+ * 8 | -(004) | C * +---------------------------+ * *** LANRDD - Virtual LAN block
LANBK Cross Reference
Symbol Dspl Value -------------- ---- ----- LAN$END 00FC 00000120 LANACLHD 0050 LANACLTL 0054 LANACNT 0040 01 LANATM 0025 00000090 LANATME 0025 00000081 LANATMGE 0025 00000083 LANATMP 0025 00000088 LANATMTR 0025 00000082 LANBCCTR 0094 LANBCLST 0090 LANBKLN 00FC 00000120 LANBKSZ 00FC 00000024 LANBPNT 004C LANCFLG 0040 LANCFLG2 0041 LANCNCTR 0064 LANCNLST 0060 LANCONT 0078 LANCTATT 00F0 05 LANCTDEF 00F0 01 LANCTDEL 00F0 0A LANCTDET 00F0 09 LANCTDIS 00F0 04 LANCTFLG 00F1 LANCTINI 00F0 06 LANCTLCK 00D0 LANCTNOC 00F0 02 LANCTNOT 00F0 07 LANCTOPR 00F0 03 LANCTPTR 00E8 LANCTRDY 00F0 08 LANCTSTA 00F0 LANDEFBY 0018 LANDESC 0010 LANDFNIC 00B8 LANDFNID 00BC LANDFTOD 0020 LANDLDIP 0041 40 LANDLPRG 0040 40 LANDVMAC 00F2 LANDXCTR 00AC LANDXLST 00A8 LANENET 0025 00000001 LANFPNT 0048 LANFSV 0086 LANGBE 0025 00000003 LANGLAN 0026 00000001 LANHIPR 0024 00000001 LANID 0000 LANINPRG 0040 80 LANIPCTR 008C LANIPPID 00CC LANIPPND 00C8 LANIPTBL 0088 LANIPTO 0042 LANLEVEL 0026 LANLIMCN 0040 20 LANLIMID 0040 10 LANLKWRD 0028 LANMAXCN 005C LANMFS 0058 LANMRCTR 009C LANMRLST 0098 LANMXMTU 00EE LANNAME 0008 LANOWNER 0000 LANPIFHD 00C0 LANPIFTL 00C4 LANPORT 0070 LANPROTO 0025 LANPRTAC 00F1 40 LANPRTRQ 0041 20 LANPXCTR 00B4 LANPXLST 00B0 LANQDIO 0024 00000002 LANQDIOP 0025 00000080 LANRDD_FLAG 0002 LANRDD_INOP 0002 40 LANRDD_LAST 0002 80 LANRDD_PORT 0004 LANRDD_PRT 0002 10 LANRDD_RDEV 0000 LANRDD_VDEV 0002 20 LANRDDLN 0004 0000000C LANRDEV 0084 LANRDV 0041 80 LANRFCTR 0044 LANRRDEV 00FC LANRXCTR 00A4 LANRXLST 00A0 LANSYSLN 0040 08 LANTRANS 0040 02 LANTRNET 0025 00000002 LANTYPE 0024 LANUPDBY 0068 LANUSRLN 0040 04 LANVDEV 00EC LANVQSBK 0080 LANVSW 0026 00000002 LANXIPV6 00F1 80 LAN10GE 0025 00000010
This information is based on z/VM V4R4.0. Last updated on 11 Mar 2004 at 11:29:43 EDT.
Copyright IBM Corporation, 1990, 2003