GVSBK | Back to Index page

| Prolog Control Block Contents GVSBK DSECT GVSENBK DSECT GVSMBK 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.

GVSBK Prolog | Top of page

     NAME       : HCPGVSBK
     DESCRIPTION: Global VSwitch Manager Block
     DSECT      : GVSBK
     FUNCTION   :
                  This block maintains a list of Global VSwitches defined
                  on a local z/VM image.  Each Global VSwitch within the
                  list contains information for each active IVL Member
                  which has an instance of the VSwitch defined on its
                  system.
      NCHORED BY -
                  HCPLANGV = Contains Address for the L:GVSBK
     CREATED BY :
                  HCPIVSCR when an IVL VSwitch is first defined for
                  the z/VM system.
     DELETED BY :
                  The GVSBK is never deleted once created.  Although its
                  lock will be destroyed if the IVL VSwitch is DETACHED.
                  See "Notes" for additional information.
     SERIALIZED :
                  The GVSHLOCK is used to serialize fields within the
                  L:GVSBK (header) and to add, remove and modify Global
                  VSwitch entities (GVSENBK).
                  The LANLKWRD is used to serialize fields in the local
                  system's VSwitch Member entry (GVSMBK).
     RELOCATION CONSIDERATIONS : None
     COMPATIBILITY AND MIGRATION CONCERNS : N/A.
     NOTES      :
                  Individual Global VSwitch entities (GVSENBKs) are added
                  by DEFINE VSWITCH (GLOBAL) and deleted by DETACH
                  VSWITCH (GLOBAL). The L:GVSENBK for a given VSwitch is
                  anchored in the LANBK (LANGVSENBK).

GVSBK Control Block Content | Top of page

     GVSBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GVSBK          Global VSwitch Manager Block
          EQUATES
              00000010       GVSMMAX        16 Maximum Global VSwitch Members
                                            per Global VSwitch
          The Global VSwitch Manager Block
    0000    0 Dbl-Word     8 GVSHLKST (0)   Start displacement for block
                                            clear
    0000    0 Dbl-Word     8 GVSHLOCK (3)   GVSBK Header Lock-word
    0018   24 Address      4 GVSHLPTR       Ptr to Global VSwitch Array
                                            header
    001C   28 Signed       4 *              Reserved for future IBM use
    0020   32 Dbl-Word     8 *              Reserved for future IBM Use
              00000005       GVSHSIZ        (*-GVSBK+7)/8 Size in double
                                            words
              00000028       GVSHBSIZ       GVSHSIZ*8 Size in bytes
          Global VSwitch Linked List
           The Global VSwitch Linked List Structure
            - Global VSwitch entities (GVSENBK)
            - Up to 16 VSwitch Member Array (GVSMBK) entries per
              parent Global VSwitch entity.
             - Each VSwitch Array entry represents a single VSwitch
               instance that is a member of the parent Global
               VSwitch.
              GVSBK
           +----------+
           | GVSHLOCK |         GVSENBK              GVSENBK
           | GVSHLPTR |---->+---------------+    +---------------+
           +----------+  +->|  GVSEHFP      |--->|  GVSEHFP = 0  |
             HCPLANBK    |  |  GVSEHBP = 0  |<---|  GVSEHBP      |
           +-----------+ |  |  GVSENAME     |    |  GVSENAME     |
           | LANGVSENBK|-+  |---------------|    |---------------|
           +-----------+    |(1)GVSMBK      |    |(1)GVSMBK      |
                            | !  -----      |    | !  -----      |
                            | !  GVSMSN     |    | !  GVSMSN     |
                            | !  GVSMSTAT   |    | !  GVSMSTAT   |
                            | !    .        |    | !    .        |
                            | !    .        |    | !    .        |
                            | V             |    | V             |
                            |(16)GVSMBK     |    |(16)GVSMBK     |
                            |    ------     |    |    ------     |
                            |    GVSMSN     |    |    GVSMSN     |
                            |    GVSMSTAT   |    |    GVSMSTAT   |
                            +---------------+    +---------------+
           Serialized :
              LAN Lock (LANLKWRD) -
                The LAN Lock (LANLKWRD) serializes the DEFINE, SET
                STATE and membership of a GLOBAL VSwitch which is
                represented as a Global VSwitch Array entry.
              GVSBK Header Lock (GVSHLOCK) -
                The GVSBK Header Lock (GVSHKWRD) serializes the
                addition and deletion of Global VSwitch Array
                entries.
          Global VSwitch Array Entity
           The Global VSwitch Array Entity: A single Global VSwitch
           entity and its imbedded VSwitch Member Array.  This
           Global VSwitch entity is linked to all known Global
           VSwitch entities discovered by the local Global VSwitch
           Manager.

     GVSENBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GVSENBK        Global VSwitch Manager Block
    0000    0 Address      4 GVSEHFP        L:next Global VSwitch Entity
                                            block
    0004    4 Address      4 GVSEHBP        L:prev Global VSwitch Entity
                                            block
    0008    8 Character    8 GVSENAME       Name of Global VSwitch
    0010   16 Bitstring    1 GVSELAST       Index to last VSwitch Member
                                            Entry
    0011   17 Character    1 * (7)          Reserved for future IBM Use
          Local VSwitch Member Area - Currently supports 16 VSwitch
          members per Global VSwitch (Global VSwitch Array Entry).
          The memory allocated needs to contain a potential maximum
          of 16 VSwitch Member entries.
    0018   24 Bitstring  256 GVSVMEMB       Memory for the maximum number of
                                            VSwitch Member Arrays.
              00000023       GVSESIZE       (*-GVSENBK+7)/8 Size in double
                                            words
              00000118       GVSEBSZE       GVSESIZE*8 Size in bytes
          VSwitch Member Entry
           The VSwitch member entry represents a particular VSwitch
           that is a member of a the Global VSwitch represented by
           the Global VSwitch Entry. The current limit of 16 LPARs
           supported for the IVL LAN segment insures that the total
           number of VSwitch Member entries will not exceed 16.
           NOTES      : If the VSwitch member entry is expanded beyond
                 16 bytes, then the GVSVMEMB area must also be
                 increased to accommodate the growth for 16 entries.

     GVSMBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GVSMBK         Global VSwitch Manager Block
    0000    0 Character    8 GVSMSN         System name for member VSwitch
    0008    8 Signed       4 GVSMREAS       ERROR State Reason Message Number
    000C   12 Bitstring    1 GVSMSTAT       Global VSwitch Handler State
                                            machine representing the synch
                                            state of the VSwitch member
              00000000       GVSMSTAT_OUTOFSYNC
                                            X'00' GVSMSTAT_OUTOFSYNC - Member
                                            is not in sync Global VSwitch
                                            attributes
              00000050       GVSMSTAT_ERROR X'50' GVSMSTAT_ERROR - Member is
                                            in an error sta
              00000060       GVSMSTAT_PENDING
                                            X'60' GVSMSTAT_PENDING - Member
                                            is in pending sy state
                                            (transitional state)
              000000F0       GVSMSTAT_INSYNC
                                            X'F0' GVSMSTAT_INSYNC - Member
                                            attributes in syn with Global
                                            VSwitch attributes
    000D   13 Bitstring    3 *              Reserved for future IBM Use
              00000002       GVSMSIZE       (*-GVSMBK+7)/8 Size in double
                                            words
              00000010       GVSMBSZE       GVSMSIZE*8 Size in bytes

GVSBK Storage Layout | Top of page

    *** GVSBK - Global VSwitch Manager Block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       GVSHLOCK                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  18 |         GVSHLPTR          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  20 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  28
    *
    *** GVSBK - Global VSwitch Manager Block

    *** GVSENBK - Global VSwitch Manager Block
    *
    *     +---------------------------+---------------------------+
    *   0 |         GVSEHFP           |         GVSEHBP           |
    *     +---------------------------+---------------------------+
    *   8 |                       GVSENAME                        |
    *     +------+------------------------------------------------+
    *  10 |:ELAST|////////////////////////////////////////////////|
    *     +------+------------------------------------------------+
    *  18 |                                                       |
    *     =                       GVSVMEMB                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 118
    *
    *** GVSENBK - Global VSwitch Manager Block

    *** GVSMBK - Global VSwitch Manager Block
    *
    *     +-------------------------------------------------------+
    *   0 |                        GVSMSN                         |
    *     +---------------------------+------+--------------------+
    *   8 |         GVSMREAS          |:MSTAT|////////////////////|
    *     +---------------------------+------+--------------------+
    *  10
    *
    *** GVSMBK - Global VSwitch Manager Block

GVSBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    GVSEBSZE       0018 00000118
    GVSEHBP        0004
    GVSEHFP        0000
    GVSELAST       0010
    GVSENAME       0008
    GVSESIZE       0018 00000023
    GVSHBSIZ       0020 00000028
    GVSHLKST       0000
    GVSHLOCK       0000
    GVSHLPTR       0018
    GVSHSIZ        0020 00000005
    GVSMBSZE       000D 00000010
    GVSMMAX        0000 00000010
    GVSMREAS       0008
    GVSMSIZE       000D 00000002
    GVSMSN         0000
    GVSMSTAT       000C
    GVSMSTAT_ERROR
                   000C 00000050
    GVSMSTAT_INSYNC
                   000C 000000F0
    GVSMSTAT_OUTOFSYNC
                   000C 00000000
    GVSMSTAT_PENDING
                   000C 00000060
    GVSVMEMB       0018

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