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
       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

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:05:48 EDT.
Copyright IBM Corporation, 1990, 2008