Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

SLMBK

Prolog  

Control Block Contents  
   SLMBK DSECT

Storage Layout  

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
   (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,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.
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
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
      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       Diag x26C Buffer Version
00F8  248 Address      4 SLMSWPHD       Ptr to first SWPBK
00FC  252 Signed       2 SLMSWCTR       SWPBK counter
00FE  254 Bitstring    2 *              Reserved
0100  256 Dbl-Word     8 SLMRRTIM       Trunk retry time out value
0108  264 Signed       4 SLMWTMGRS      Managers waiting for VSWITCH
                                        creation
      End of the SLMBK.
0110  272 Dbl-Word     8 SLM$END (0)    End of the SLMBK structure
          00000110       SLMBKLN        *-SLMBK Length of SLMBK in bytes
          00000022       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) |: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       |         SLM26CVR          |
*     +------+--------------------+-------------+-------------+
*  F8 |         SLMSWPHD          |  SLMSWCTR   |/////////////|
*     +---------------------------+-------------+-------------+
* 100 |                       SLMRRTIM                        |
*     +---------------------------+---------------------------+
* 108 |        SLMWTMGRS          |///////////////////////////|
*     +---------------------------+---------------------------+
*
*** SLMBK - System LAN Management block

 

SLMBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SLM$END        0110
SLMACNT        0031
SLMBKLN        0110 00000110
SLMBKSZ        0110 00000022
SLMCFLAG       0030
SLMCONTR       00D8
SLMDCA         007A 00000002
SLMDCINT       007A
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
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
SLMWTMGRS      0108
SLM26CVR       00F4

This information is based on z/VM V5R3.0. Last updated on 25 Jun 2007 at 17:28:59 EDT.
Copyright IBM Corporation, 1990, 2007