SLMBK - 32-bit CP - V4R4.0

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
       LANCTLCK - LAN Controller Lock
    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)
    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 (6)   Reserve a MLTBK here
          Periodic Maintenance for VM LAN.
    0080  128 Signed       4 SLMPMCTR       Periodic Maintenance counter
    0084  132 Signed       4 SLMPMFRQ       Frequency of Maintenance (Number
                                            of SRMTIMIN intervals to count
                                            between calls)
    0088  136 Bitstring    1 SLMFRMLK       Spin Lock for SLMFRMQH
    0089  137 Bitstring    1 SLMPM_ACTIVE   Set (TS) during maintenance
    008A  138 Bitstring    2 *              Reserved
    008C  140 Signed       4 SLMFRMMX       Maximum recycled frame count
    0090  144 Signed       4 SLMFRMCT       Recycled Frame counter
    0094  148 Address      4 SLMFRMQP       Pointer to NDMBK recycle stack
    0098  152 Address      4 SLMSWIPT       Switch Eligible Table Pointer
    009C  156 Signed       4 SLMSWICT       Switch Eligible Table Counter
    00A0  160 Dbl-Word     8 * (0)          Align lockword on doubleword
    00A0  160 Bitstring   24 SLMSWLCK       Switch Eligible Table Lock
    00B8  184 Address      4 SLMDIPHD       First Delete in Progress Pointer
    00BC  188 Signed       4 SLMDIPCT       Delete in Progress Counter
    00C0  192 Character    8 SLMPM_LANOWNER LANOWNER of most recent LANBK
    00C8  200 Character    8 SLMPM_LANNAME  LANNAME of most recent LANBK
    00D0  208 Signed       8 SLMPM_OLDTOD   Prior TOD clock
    00D8  216 Signed       8 SLMPM_NEWTOD   Current TOD clock
          End of the SLMBK.
    00E0  224 Dbl-Word     8 SLM$END (0)    End of the SLMBK structure
              000000E0       SLMBKLN        *-SLMBK Length of SLMBK in bytes
              0000001C       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                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  80 |         SLMPMCTR          |         SLMPMFRQ          |
    *     +------+------+-------------+---------------------------+
    *  88 |:FRMLK|(089) |/////////////|         SLMFRMMX          |
    *     +------+------+-------------+---------------------------+
    *  90 |         SLMFRMCT          |         SLMFRMQP          |
    *     +---------------------------+---------------------------+
    *  98 |         SLMSWIPT          |         SLMSWICT          |
    *     +---------------------------+---------------------------+
    *  A0 |                                                       |
    *     =                       SLMSWLCK                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  B8 |         SLMDIPHD          |         SLMDIPCT          |
    *     +---------------------------+---------------------------+
    *  C0 |                    SLMPM_LANOWNER                     |
    *     +-------------------------------------------------------+
    *  C8 |                    SLMPM_LANNAME                      |
    *     +-------------------------------------------------------+
    *  D0 |                     SLMPM_OLDTOD                      |
    *     +-------------------------------------------------------+
    *  D8 |                     SLMPM_NEWTOD                      |
    *     +-------------------------------------------------------+
    *
    *** SLMBK - System LAN Management block

#### SLMBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SLM$END        00E0
    SLMACNT        0031
    SLMBKLN        00E0 000000E0
    SLMBKSZ        00E0 0000001C
    SLMCFLAG       0030
    SLMDIPCT       00BC
    SLMDIPHD       00B8
    SLMFRMCT       0090
    SLMFRMLK       0088
    SLMFRMMX       008C
    SLMFRMQP       0094
    SLMLANHD       0018
    SLMLKWRD       0000
    SLMMACLK       0038
    SLMMACPF       0034
    SLMMACTB       0050
    SLMPM_ACTIVE   0089
    SLMPM_LANNAME  00C8
    SLMPM_LANOWNER
                   00C0
    SLMPM_NEWTOD   00D8
    SLMPM_OLDTOD   00D0
    SLMPMCTR       0080
    SLMPMFRQ       0084
    SLMPXCTR       0020
    SLMPXLIM       0030 80
    SLMPXMAX       0028
    SLMSWICT       009C
    SLMSWIPT       0098
    SLMSWLCK       00A0
    SLMSYSAC       0031 80
    SLMTXCTR       0024
    SLMTXLIM       0030 40
    SLMTXMAX       002C
    SLMUSRAC       0031 40

This information is based on z/VM V4R4.0. Last updated on 6 Aug 2003 at 08:55:58 EDT.
Copyright IBM Corporation, 1990, 2003