|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SLMBK
Control Block Contents
SLMBK DSECT
Cross Reference (Contains links to field and bit definitions)
SLMBK Prolog
NAME : HCPSLMBK
DESCRIPTION: System LAN Management block
DSECT : SLMBK
FUNCTION :
The SLMBK holds the status of System LAN Management.
LOCATED BY -
HCPLANSL = Pointer to SLMBK
HCPLANSD = Area reserved for the SLMBK
CREATED BY :
Storage for the SLMBK is reserved in module HCPLAN
when it is compiled.
DELETED BY :
None
REFERENCES :
HCPLANBK COPY - LANBK represents a single Virtual LAN
HCPMLTBK COPY - MLTBK represents a multi-level table
SLMBK Control Block Content
SLMBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SLMBK System LAN Management block
LAN Management Lock -
Notes : LKWRDSIZ == 3 doublewords.
0000 0 Dbl-Word 8 SLMLKWRD (3) Adapter Lockword
System LAN Management -
These fields are used to control and access the
independent Virtual LAN structures in the system.
The LAN Management Lock (SLMLKWRD) must be held
EXCLUSIVE to modify these fields.
The LAN Management LOCK (SLMLKWRD) must be held
SHARED to reference these fields.
Lock Hierarchy -
The following list is arranged to represent the sequence
in which these locks must be OBTAINED (when multiple
locks are required):
NICLKWRD - NIC (adapter) Lock
SLMLKWRD - System LAN Management Lock
LANLKWRD - LAN Lock
SLMSWLCK - Switch Eligible Table Lock
(1) RDEVLOCK - RDEV Lock Address for VSWITCH OSA-E devices
VDEVLOCK - VDEV Lock Address for VSWITCH OSA-E devices
(1) LANCTLCK - LAN Controller Lock
ILMLKWRD - IP LAN Management lock
(1) Currently there are no conditions imposed on the
sequence in which these locks are obtained, as long
as the higher level and lower level locks are obtained
in the proper order.
0018 24 Address 4 SLMLANHD Pointer to the First LANBK
001C 28 Bitstring 4 * Reserved
0020 32 Signed 4 SLMPXCTR Count of PERSISTENT VM LAN
0024 36 Signed 4 SLMTXCTR Count of TRANSIENT VM LAN
0028 40 Signed 4 SLMPXMAX Limit for PERSISTENT VM LAN
002C 44 Signed 4 SLMTXMAX Limit for TRANSIENT VM LAN
0030 48 Bitstring 1 SLMCFLAG Control Flag:
1... .... SLMPXLIM X'80' - LIMIT PERSISTENT
(SLMPXMAX)
.1.. .... SLMTXLIM X'40' - LIMIT TRANSIENT
(SLMTXMAX)
..1. .... SLMMACRS X'20' - MACIDRANGE SYSTEM set
...1 .... SLMMACRU X'10' - MACIDRANGE USER set
0031 49 Bitstring 1 SLMACNT Accounting Flags:
1... .... SLMSYSAC X'80' - SYSTEM ACNT default = ON
.1.. .... SLMUSRAC X'40' - USER ACNT default = ON
0032 50 Bitstring 2 * Reserved
0034 52 Bitstring 3 SLMMACPF VMLAN MACADDR Prefix
0037 55 Bitstring 1 * Reserved
MAC Address Table (serialized by SLMMACLK).
Notes : LKWRDSIZ == 3 doublewords.
0038 56 Dbl-Word 8 SLMMACLK (3) MACADDR Table Lockword
0050 80 Dbl-Word 8 SLMMACTB (4) Reserve a MLTBK here
Periodic Maintenance for VM LAN.
0070 112 Signed 4 SLMPMCTR Periodic Maintenance counter
0074 116 Signed 4 SLMPMFRQ Frequency of Maintenance (Number
of SRMTIMIN intervals to count
between calls)
0078 120 Bitstring 1 SLMFRMLK Spin Lock for SLMFRMQH
0079 121 Bitstring 1 SLMPM_ACTIVE Set (TS) during maintenance
007A 122 Bitstring 2 * Reserved
007C 124 Signed 4 SLMFRMMX Maximum recycled frame count
0080 128 Signed 4 SLMFRMCT Recycled Frame counter
0084 132 Address 4 SLMFRMQP Pointer to NDMBK recycle stack
0088 136 Address 4 SLMSWIPT Switch Eligible Table Pointer
008C 140 Signed 4 SLMSWICT Switch Eligible Table Counter
0090 144 Dbl-Word 8 * (0) Align lockword on doubleword
0090 144 Bitstring 24 SLMSWLCK Switch Eligible Table Lock
00A8 168 Address 4 SLMDIPHD First Delete in Progress Pointer
00AC 172 Signed 4 SLMDIPCT Delete in Progress Counter
00B0 176 Character 8 SLMPM_LANOWNER LANOWNER of most recent LANBK
00B8 184 Character 8 SLMPM_LANNAME LANNAME of most recent LANBK
00C0 192 Signed 8 SLMPM_OLDTOD Prior TOD clock
00C8 200 Signed 8 SLMPM_NEWTOD Current TOD clock
Timeout / Failover values for Guest Lan / VSWITCH
00D0 208 Dbl-Word 8 * (0) Align on doubleword
00D0 208 Signed 4 SLMTODMAX Timeout (secs) Guest LAN queues
00D4 212 Signed 4 * Reserved
00D8 216 Dbl-Word 8 SLMCONTR Controller hang time out value
00E0 224 Dbl-Word 8 SLMSETIP SETIP Throttle time out value
00E8 232 Bitstring 12 SLMMACRG (0) VMLAN MACIDRANGE values
00E8 232 Bitstring 3 SLMMACSB SYSTEM begin
00EB 235 Bitstring 3 SLMMACSE SYSTEM end
00EE 238 Bitstring 3 SLMMACUB USER begin
00F1 241 Bitstring 3 SLMMACUE USER end
00F4 244 Bitstring 4 * Reserved
End of the SLMBK.
00F8 248 Dbl-Word 8 SLM$END (0) End of the SLMBK structure
000000F8 SLMBKLN *-SLMBK Length of SLMBK in bytes
0000001F SLMBKSZ (*-SLMBK+7)/8 Size of SLMBK in
doublewords
PREFIX_LEN = 3
Start of Assembler Control Block
SLMBK Storage Layout
*** SLMBK - System LAN Management block
*
* +-------------------------------------------------------+
* 0 | |
* = SLMLKWRD =
* | |
* +---------------------------+---------------------------+
* 18 | SLMLANHD |///////////////////////////|
* +---------------------------+---------------------------+
* 20 | SLMPXCTR | SLMTXCTR |
* +---------------------------+---------------------------+
* 28 | SLMPXMAX | SLMTXMAX |
* +------+------+-------------+--------------------+------+
* 30 |:CFLAG|:ACNT |/////////////| SLMMACPF |//////|
* +------+------+-------------+--------------------+------+
* 38 | |
* = SLMMACLK =
* | |
* +-------------------------------------------------------+
* 50 | |
* = SLMMACTB =
* | |
* +---------------------------+---------------------------+
* 70 | SLMPMCTR | SLMPMFRQ |
* +------+------+-------------+---------------------------+
* 78 |:FRMLK|(079) |/////////////| SLMFRMMX |
* +------+------+-------------+---------------------------+
* 80 | SLMFRMCT | SLMFRMQP |
* +---------------------------+---------------------------+
* 88 | SLMSWIPT | SLMSWICT |
* +---------------------------+---------------------------+
* 90 | |
* = SLMSWLCK =
* | |
* +---------------------------+---------------------------+
* A8 | SLMDIPHD | SLMDIPCT |
* +---------------------------+---------------------------+
* B0 | SLMPM_LANOWNER |
* +-------------------------------------------------------+
* B8 | SLMPM_LANNAME |
* +-------------------------------------------------------+
* C0 | SLMPM_OLDTOD |
* +-------------------------------------------------------+
* C8 | SLMPM_NEWTOD |
* +---------------------------+---------------------------+
* D0 | SLMTODMAX |///////////////////////////|
* +---------------------------+---------------------------+
* D8 | SLMCONTR |
* +-------------------------------------------------------+
* E0 | SLMSETIP |
* +--------------------+--------------------+-------------+
* E8 | SLMMACSB | SLMMACSE | SLMMACUB- |
* +------+-------------+------+-------------+-------------+
* F0 |-(0EE)| SLMMACUE |///////////////////////////|
* +------+--------------------+---------------------------+
*
*** SLMBK - System LAN Management block
SLMBK Cross Reference
Symbol Dspl Value -------------- ---- ----- SLM$END 00F8 SLMACNT 0031 SLMBKLN 00F8 000000F8 SLMBKSZ 00F8 0000001F SLMCFLAG 0030 SLMCONTR 00D8 SLMDIPCT 00AC SLMDIPHD 00A8 SLMFRMCT 0080 SLMFRMLK 0078 SLMFRMMX 007C SLMFRMQP 0084 SLMLANHD 0018 SLMLKWRD 0000 SLMMACLK 0038 SLMMACPF 0034 SLMMACRG 00E8 SLMMACRS 0030 20 SLMMACRU 0030 10 SLMMACSB 00E8 SLMMACSE 00EB SLMMACTB 0050 SLMMACUB 00EE SLMMACUE 00F1 SLMPM_ACTIVE 0079 SLMPM_LANNAME 00B8 SLMPM_LANOWNER 00B0 SLMPM_NEWTOD 00C8 SLMPM_OLDTOD 00C0 SLMPMCTR 0070 SLMPMFRQ 0074 SLMPXCTR 0020 SLMPXLIM 0030 80 SLMPXMAX 0028 SLMSETIP 00E0 SLMSWICT 008C SLMSWIPT 0088 SLMSWLCK 0090 SLMSYSAC 0031 80 SLMTODMAX 00D0 SLMTXCTR 0024 SLMTXLIM 0030 40 SLMTXMAX 002C SLMUSRAC 0031 40
Copyright IBM Corporation, 1990, 2004