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

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:24:34 EDT.
Copyright IBM Corporation, 1990, 2005