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

#### SWIBK

Prolog

Control Block Contents
SWIBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SWIBK Prolog

     NAME       : HCPSWIBK
     DESCRIPTION: DSECTS and EQUATES for z/VM Virtual Switch
                  functions.
     DSECT      : SWIBK
     FUNCTION   : z/VM Virtual Switch Eligible Controller Table
     LOCATED BY : SWUECTPT (data area in HCPSWU)
     CREATED BY : HCPSWIAC when a z/VM TCP/IP stack connects to
                  the *VSWITCH CP System Service.
     DELETED BY : An entry may be cleared by HCPSWRSV. The table
                  itself is usually not deleted. However, when
                  a table becomes full, the AddEntry subroutine
                  in HCPSWI can allocate a new, larger table,
                  copy over the existing one, and then delete it.
     REFERENCES : None.
     SERIALIZED : Switch Eligible Controller Table Lock,
                  (SLMSWLCK).
     NOTES      : None.
     NOTES      : None.

#### SWIBK Control Block Content

#### SWIBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SWIBK          DSECTS and EQUATES for z/VM Virtual Switch
    0000    0 Address      4 SWIEFPTR       Next SWIBK
    0004    4 Signed       4 *              Switch participant user ID
    0008    8 Character    8 SWIEUSER       Switch participant user ID
    0010   16 Signed       4 SWIEVMDBK      VMDBK address for controller
    0014   20 Signed       2 SWIEPATH       IUCV Path ID
    0016   22 Address      1 SWIEAVAIL      Ready flag
    0017   23 Bitstring    1 SWIEFLAG       Controller flags
              1... ....      SWIETASK       X'80' SWIETASK - Timestamp task
                                            active USED FOR FIRST ENTRY ONLY
              .1.. ....      SWIECONTRLR    X'40' SWIECONTRLR - Received
                                            ControllerStatus update
              ..1. ....      SWIEMANAGER    X'20' SWIEMANAGER - Received
                                            ManagementID message X'10' -
                                            Reserved X'08' - Reserved X'04' -
                                            Reserved
              .... ..1.      SWIEFAILOVER   X'02' SWIEFAILOVER - Perform
                                            timeout chk for failover
              .... ...1      SWIESTALLED    X'01' SWIESTALLED - Controller is
                                            unresponsive
    0018   24 Signed       4 SWIECOUNT      Count of active switches
    001C   28 Signed       4 SWIEVDEVS      Start of VDEV range
    0020   32 Signed       4 SWIEVDEVE      End of VDEV range
    0024   36 Signed       4 SWIECAPAB      Controller Capabilities
              .... ....      SWIEStTransportIP
                                            X'80000000' SWIEStTransportIP
                                            (V4R4.0
              .... ....      SWIEStTransportL2
                                            X'40000000' SWIEStTransportL2
                                            (V5R1.0
              .... ....      SWIEStReleaseLevelInfo
                                            X'20000000'
                                            SWIEStReleaseLevelInfo (V
              .... ....      SWIEStSend_Grat_Arp
                                            X'10000000' SWIEStSend_Grat_Arp
                                            (V4R4
              .... ....      SWIEStGVRP     X'08000000' SWIEStGVRP (V5R2.0+
                                            level
              .... ....      SWIEStManagement
                                            X'04000000' SWIEStManagement
                                            (V5R3.0+
              .... ....      SWIEStLinkAggregation
                                            X'04000000' SWIEStLinkAggregation
                                            (V5
              .... ....      SWIEStSetAccessControl
                                            X'02000000'
                                            SWIEStSetAccessControl (V
    0028   40 Dbl-Word     8 SWIESTIME      Send-to-controller timestamp
    0030   48 Dbl-Word     8 SWIERTIME      Receive-from-controller timestamp
    0038   56 Dbl-Word     8 SWIECTIME      Last checked timestamp
    0040   64 Dbl-Word     8 SWIEXTIME      Special send-to-controller
                                            timestamp
    0048   72 Bitstring   20 SWIELEVEL      TCP/IP Stack Level String
    005C   92 Signed       4 *
              0000000C       SWIESIZE       (*-SWIBK+7)/8 size in double
                                            words
              00000060       SWIEBSIZ       SWIESIZE*8 size in bytes
              00000008       SWIEINIT       8 Default number of entries

#### SWIBK Storage Layout

    *** SWIBK - DSECTS and EQUATES for z/VM Virtual Switch
    *
    *     +---------------------------+---------------------------+
    *   0 |         SWIEFPTR          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *   8 |                       SWIEUSER                        |
    *     +---------------------------+-------------+------+------+
    *  10 |        SWIEVMDBK          |  SWIEPATH   |(016) |:EFLAG|
    *     +---------------------------+-------------+------+------+
    *  18 |        SWIECOUNT          |        SWIEVDEVS          |
    *     +---------------------------+---------------------------+
    *  20 |        SWIEVDEVE          |        SWIECAPAB          |
    *     +---------------------------+---------------------------+
    *  28 |                      SWIESTIME                        |
    *     +-------------------------------------------------------+
    *  30 |                      SWIERTIME                        |
    *     +-------------------------------------------------------+
    *  38 |                      SWIECTIME                        |
    *     +-------------------------------------------------------+
    *  40 |                      SWIEXTIME                        |
    *     +-------------------------------------------------------+
    *  48 |                                                       |
    *     =                      SWIELEVEL                        =
    *     |                           +---------------------------+
    *  58 |                           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  60
    *
    *** SWIBK - DSECTS and EQUATES for z/VM Virtual Switch

#### SWIBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SWIEAVAIL      0016
    SWIEBSIZ       005C 00000060
    SWIECAPAB      0024
    SWIECONTRLR    0017 40
    SWIECOUNT      0018
    SWIECTIME      0038
    SWIEFAILOVER   0017 02
    SWIEFLAG       0017
    SWIEFPTR       0000
    SWIEINIT       005C 00000008
    SWIELEVEL      0048
    SWIEMANAGER    0017 20
    SWIEPATH       0014
    SWIERTIME      0030
    SWIEStGVRP     0024 00
    SWIEStLinkAggregation
                   0024 00
    SWIEStManagement
                   0024 00
    SWIEStReleaseLevelInfo
                   0024 00
    SWIEStSend_Grat_Arp
                   0024 00
    SWIEStSetAccessControl
                   0024 00
    SWIEStTransportIP
                   0024 00
    SWIEStTransportL2
                   0024 00
    SWIESIZE       005C 0000000C
    SWIESTALLED    0017 01
    SWIESTIME      0028
    SWIETASK       0017 80
    SWIEUSER       0008
    SWIEVDEVE      0020
    SWIEVDEVS      001C
    SWIEVMDBK      0010
    SWIEXTIME      0040

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