SWIBK | Back to Index page

| Prolog Control Block Contents SWIBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

SWIBK Prolog | Top of page

     NAME       : HCPSWIBK
     DESCRIPTION: DSECTS and EQUATES for z/VM Virtual Switch
                  functions.
     DSECT      : SWIBK
     FUNCTION   : z/VM Virtual Switch Eligible Controller
     LOCATED BY : Single threaded link list anchored from
                  SLMSWIPT in the SLMBK pointed by HCPLANSD.
     CREATED BY : HCPSWIAC when a z/VM TCP/IP stack connects to
                  the *VSWITCH CP System Service.
     DELETED BY : A SWIBK may be cleared for future reuse by
                  HCPSWRSV, but is never deleted once allocated.
     REFERENCES : None.
     SERIALIZED : Switch Eligible Controller Table Lock,
                  (SLMSWLCK).
                  As noted below, some fields are serialized
                  by execution on the SYSTEM VMDBK.
     COMPATIBILITY AND MIGRATION CONCERNS : None.
     RELOCATION CONSIDERATIONS : None
     NOTES      : None.

SWIBK Control Block Content | Top of page

     SWIBK DSECT
    Top of page

    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 *              Reserved for Future IBM Use
    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 EQU X'80' -
                                            Reserved for Future IBM Use
              .1.. ....      SWIECONTRLR    X'40' SWIECONTRLR - Received
                                            ControllerStatus update
              ..1. ....      SWIEMANAGER    X'20' SWIEMANAGER - Received
                                            ManagementID message
              ...1 ....      SWIEHEARTBEAT  X'10' SWIEHEARTBEAT - Sent
                                            Heartbeat message
              .... 1...      SWIEFORCE      X'08' SWIEFORCE - Force a
                                            Controller Stall 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 EQU
                                            X'01000000' Reserved EQU
                                            X'00800000' Reserved
              WIECAPAB       SWIEBridge     X'00400000' SWIEBridge (V6R2.0+
                                            level
              WIECAPAB       SWIEStVEPA     X'00200000' SWIEStVEPA (V6R3.0+
                                            level
              WIECAPAB       SWIEExpVlanData
                                            X'00100000' SWIEExpVlanData
                                            (VM65104+
              WIECAPAB       SWIESharedLinkAgg
                                            X'00080000' SWIESharedLinkAgg
                                            (VMnnnn
              WIECAPAB       SWIEPriorityQueuing
                                            X'00040000' SWIEPriorityQueuing
                                            (VM66
          Controller Activity Timestamps
          Serialized : The following fields are serialized by
                         execution on the SYSTEM VMDBK.
    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 *-- End SYSTEM
                                            Serialization
    0048   72 Bitstring   20 SWIELEVEL      TCP/IP Stack Level String
    005C   92 Signed       4 SWIEVDEVC      Current VDEV range start
              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 | Top of page

    *** 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 |                           |        SWIEVDEVC          |
    *     +---------------------------+---------------------------+
    *  60
    *
    *** SWIBK - DSECTS and EQUATES for z/VM Virtual Switch

SWIBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    SWIEAVAIL      0016
    SWIEBridge     0024 WIECAPAB
    SWIEBSIZ       005C 00000060
    SWIECAPAB      0024
    SWIECONTRLR    0017 40
    SWIECOUNT      0018
    SWIECTIME      0038
    SWIEExpVlanData
                   0024 WIECAPAB
    SWIEFAILOVER   0017 02
    SWIEFLAG       0017
    SWIEFORCE      0017 08
    SWIEFPTR       0000
    SWIEHEARTBEAT  0017 10
    SWIEINIT       005C 00000008
    SWIELEVEL      0048
    SWIEMANAGER    0017 20
    SWIEPriorityQueuing
                   0024 WIECAPAB
    SWIEPATH       0014
    SWIERTIME      0030
    SWIESharedLinkAgg
                   0024 WIECAPAB
    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
    SWIEStVEPA     0024 WIECAPAB
    SWIESIZE       005C 0000000C
    SWIESTALLED    0017 01
    SWIESTIME      0028
    SWIEUSER       0008
    SWIEVDEVC      005C
    SWIEVDEVE      0020
    SWIEVDEVS      001C
    SWIEVMDBK      0010
    SWIEXTIME      0040

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:30:56 EDT.
Copyright IBM Corporation, 1990, 2020