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

#### VLABK

Prolog

Control Block Contents
VLABK DSECT
VLANITEM DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### VLABK Prolog

     NAME       : HCPVLABK
     DESCRIPTION: VLAN Authorization List
     DSECT      : VLABK
     FUNCTION   :
                  Each VLABK represents a list of IEEE VLAN ID numbers.
                  The VLABK structure is variable length.
     LOCATED BY -
       NICESMVL - List of VLAN IDs authorized by the ESM.
     CREATED BY :
                  CP COUPLE command processing (see HCPCPL).
     DELETED BY :
                  CP COUPLE command processing (see HCPCPL).

#### VLABK Control Block Content

#### VLABK DSECT

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      VLABK          VLAN Authorization List
          Link to owning structure.
            During COUPLE this is a pointer to RPABK.
            For the adapter authorization list, this points to NICBK.
            For the active VLAN list, this points to NIDBK.
    0000    0 Address      4 VLALINK        Pointer to owning structure
          Counters.
    0004    4 Signed       2 VLAMAX         Maximum for this list
    0006    6 Signed       2 VLACNT         Count of entries (current)
              00000004       VLA_INIT       4 Initial allocation
              00000004       VLA_INCR       4 Incremental allocation
              000007D0       VLA_MAX        2000 Maximum allocation
    0008    8 Bitstring    1 VLAFLAG        Flags
              1... ....      VLA_LSNIF      X'80' Promiscuous mode is
                                            authorized
              .1.. ....      VLA_LSON       X'40' Audit promiscuous mode ON.
              ..1. ....      VLA_LSOFF      X'20' Audit promiscuous mode OFF.
    0009    9 Bitstring    1 *              Reserved
              0000000A       VLAHDRLN       *-VLABK Length of header
          Array of device pointers begins here (see VLAITEM).
              0000000A       VLANLIST       * Start of VLAN ID list
    000A   10 Signed       2 VLAN_ID1       VLAN ID (1)
              00000002       VLAN_LEN       *-VLAN_ID1 Length of one VLAN ID
              00000001       VLAN_SLL       1 Bits to shift (count to bytes)
          OBJECT - VLANITEM
            Map a single element in the VLANLIST array.

    VLANITEM DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      VLANITEM       VLAN Authorization List
    0000    0 Signed       2 VLAN_ID        One VLAN ID
    0002    2 Signed       2 VLAN_NXT       Next VLAN ID

    VLABK Storage Layout

    *** VLABK - VLAN Authorization List
    *
    *     +---------------------------+-------------+-------------+
    *   0 |         VLALINK           |   VLAMAX    |   VLACNT    |
    *     +------+------+-------------+-------------+-------------+
    *   8 |:FLAG |//////|  VLAN_ID1   | C
    *     +------+------+-------------+
    *
    *** VLABK - VLAN Authorization List

    *** VLANITEM - VLAN Authorization List
    *
    *     +-------------+-------------+
    *   0 |  VLAN_ID    |  VLAN_NXT   | 4
    *     +-------------+-------------+
    *
    *** VLANITEM - VLAN Authorization List

    VLABK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    VLA_INCR       0006 00000004
    VLA_INIT       0006 00000004
    VLA_LSNIF      0008 80
    VLA_LSOFF      0008 20
    VLA_LSON       0008 40
    VLA_MAX        0006 000007D0
    VLACNT         0006
    VLAFLAG        0008
    VLAHDRLN       0009 0000000A
    VLALINK        0000
    VLAMAX         0004
    VLAN_ID        0000
    VLAN_ID1       000A
    VLAN_LEN       000A 00000002
    VLAN_NXT       0002
    VLAN_SLL       000A 00000001
    VLANLIST       0009 0000000A

    This information is
    based on z/VM V5R2.0.
    Last updated on 12 Apr 2006 at 17:37:58 EDT.

    Copyright IBM Corporation, 1990, 2005