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 MSVLKWRD - MAC Services Lock (1) QIOLOCK - QIOBK Lock (1) SLMMACLK - MACADDR Table Lock (1) SLMSWLCK - Switch Eligible Table Lock (2) RDEVLOCK - RDEV Lock Address for VSWITCH OSA-E devs VDEVLOCK - VDEV Lock Address for VSWITCH OSA-E devs (2) LANCTLCK - LAN Controller Lock ILMLKWRD - IP LAN Management lock (1) SPBLOCK - VSWITCH Physical Ports Block (1,2) 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. These tiers show the order for obtaining virtual networking locks. Jump in at an level, but from that point on, you may obtain additional locks ONLY from a lower tier. ---------------------------------------------------------- Tier 1: NICLKWRD ---------------------------------------------------------- Tier 2: SLMLKWRD ---------------------------------------------------------- Tier 3: LANLKWRD ---------------------------------------------------------- Tier 4: MSVLKWRD ---------------------------------------------------------- Tier 5: QIOLOCK SLMMACLK SLMSWLCK SPBLOCK ---------------------------------------------------------- Tier 6: RDEVLOCK LANCTLCK ---------------------------------------------------------- Tier 7: VDEVLOCK ILMLKWRD ---------------------------------------------------------- 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' SLMPXLIM - LIMIT PERSISTENT (SLMPXMAX) .1.. .... SLMTXLIM X'40' SLMTXLIM - LIMIT TRANSIENT (SLMTXMAX) ..1. .... SLMMACRS X'20' SLMMACRS - MACIDRANGE SYSTEM set ...1 .... SLMMACRU X'10' SLMMACRU - MACIDRANGE USER set 0031 49 Bitstring 1 SLMACNT Accounting Flags: 1... .... SLMSYSAC X'80' SLMSYSAC - SYSTEM ACNT default = ON .1.. .... SLMUSRAC X'40' SLMUSRAC - USER ACNT default = ON 0032 50 Bitstring 2 * Reserved 0034 52 Bitstring 3 SLMMACPF VMLAN MACADDR Prefix Flag used to enable display of controller messages. Set to X'37' = X'FF'-(SLMMSGON+SLMMSGHX+SLMMSGIN) This is used as the "expected" value by tools such as ZAPCP. 0037 55 Bitstring 1 SLMMSGFL VSWITCH controller message disply 1... .... SLMMSGON X'80' SLMMSGON - Display controller message info .1.. .... SLMMSGHX X'40' SLMMSGHX - Display details as hex data .... 1... SLMMSGIN X'08' SLMMSGIN - Message is FROM controller MAC Address Table (serialized by SLMMACLK). Notes : LKWRDSIZ == 3 doublewords. 0038 56 Dbl-Word 8 SLMMACLK (3) MACADDR Table Lockword Also protects the SLMMSVBK chain. BLOCKMAP DEFINE SLMMACTB (4)D 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 1 SLMDCINT Deferred Controller Assignment Interval Time (# of 30 second intervals to wait) 00000002 SLMDCA 2 Default Deferred Controller INTV (30 to 60 seconds wait time) 007B 123 Bitstring 1 * Reserved for Future IBM Use 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 Notes : SLMSWIPT/SLMSWICT access controlled by SLMSWLCK 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 SLMOSATO VSWITCH OSA timeout (seconds) 00D4 212 Signed 4 SLMUSRTO User interface timeout (seconds) 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 Signed 4 SLM26CVR (0) Diag x26C Buffer Version 00F4 244 Signed 2 SLM26CSV - Service level version 00F6 246 Signed 2 SLM26CRV - Release level version 00F8 248 Address 4 SLMSWPHD Ptr to first SWPBK 00FC 252 Signed 2 SLMSWCTR SWPBK counter 00FE 254 Bitstring 1 SLMFLAG Reserved for IBM Internal Use 1... .... SLMALLOW X'80' SLMALLOW - Allow flag 00FF 255 Bitstring 1 * Reserved 0100 256 Dbl-Word 8 SLMRRTIM Trunk retry time out value 0108 264 Signed 4 SLMWTMGRS Managers waiting for VSWITCH creation 010C 268 Signed 4 SLMVDEVN High water mark for VSWITCH pseudo-virtual device number 0110 272 Address 4 SLMMSVBK HCPMSVBK VSWITCH chain anchor, holding virtual MAC assignment info. This chain, and the fields in its MSVBKs is protected by the SLMMACLK. 0114 276 Signed 4 * Reserved for future IBM use End of the SLMBK. 0118 280 Dbl-Word 8 SLM$END (0) End of the SLMBK structure 00000118 SLMBKLN *-SLMBK Length of SLMBK in bytes 00000023 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 |:MSGFL| * +------+------+-------------+--------------------+------+ * 38 | | * = SLMMACLK = * | | * +-------------------------------------------------------+ * 50 | | * = SLMMACTB = * | | * +---------------------------+---------------------------+ * 70 | SLMPMCTR | SLMPMFRQ | * +------+------+------+------+---------------------------+ * 78 |:FRMLK|(079) |:DCINT|//////| 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 | SLMOSATO | SLMUSRTO | * +---------------------------+---------------------------+ * D8 | SLMCONTR | * +-------------------------------------------------------+ * E0 | SLMSETIP | * +--------------------+--------------------+-------------+ * E8 | SLMMACSB | SLMMACSE | SLMMACUB- | * +------+-------------+------+-------------+-------------+ * F0 |-(0EE)| SLMMACUE | SLM26CSV | SLM26CRV | * +------+--------------------+-------------+------+------+ * F8 | SLMSWPHD | SLMSWCTR |:FLAG |//////| * +---------------------------+-------------+------+------+ * 100 | SLMRRTIM | * +---------------------------+---------------------------+ * 108 | SLMWTMGRS | SLMVDEVN | * +---------------------------+---------------------------+ * 110 | SLMMSVBK |///////////////////////////| * +---------------------------+---------------------------+ * *** SLMBK - System LAN Management block
SLMBK Cross Reference
Symbol Dspl Value -------------- ---- ----- SLM$END 0118 SLMACNT 0031 SLMALLOW 00FE 80 SLMBKLN 0118 00000118 SLMBKSZ 0118 00000023 SLMCFLAG 0030 SLMCONTR 00D8 SLMDCA 007A 00000002 SLMDCINT 007A SLMDIPCT 00AC SLMDIPHD 00A8 SLMFLAG 00FE 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 SLMMSGFL 0037 SLMMSGHX 0037 40 SLMMSGIN 0037 08 SLMMSGON 0037 80 SLMMSVBK 0110 SLMOSATO 00D0 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 SLMRRTIM 0100 SLMSETIP 00E0 SLMSWCTR 00FC SLMSWICT 008C SLMSWIPT 0088 SLMSWLCK 0090 SLMSWPHD 00F8 SLMSYSAC 0031 80 SLMTXCTR 0024 SLMTXLIM 0030 40 SLMTXMAX 002C SLMUSRAC 0031 40 SLMUSRTO 00D4 SLMVDEVN 010C SLMWTMGRS 0108 SLM26CRV 00F6 SLM26CSV 00F4 SLM26CVR 00F4
Copyright IBM Corporation, 1990, 2009