GPGBK | Back to Index page

| Prolog Control Block Contents GPGBK DSECT GPGENT DSECT GPGARY 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.

GPGBK Prolog | Top of page

     NAME       : HCPGPGBK
     DESCRIPTION: Global Port Group Manager Block
     DSECT      : GPGBK
     FUNCTION   : This block maps a global port group, which can
                  be controlled by multiple IVL Members within
                  the same IVL Domain.  The L:GPGBK is used to
                  keep track of the global port groups (SWPBKs)
                  defined on this system and the state of its
                  instances residing in other IVL Members.
                  A port group defined as SHARED via a SET PORT
                  GROUP CP Command causes z/VM to create an
                  instance of the global port group in every
                  active IVL Member.  Each global port group
                  instance can then be used in a Multi-VSwitch
                  LAG configuration by a Global VSWITCH.  The
                  SHARED operand allows a Global VSWITCH
                  spanning multiple IVL Members to share the
                  same physical LAG.
     ANCHORED BY - HCPLANGP CONTAINS ADDRESS FOR THE L: PGBK.
     CREATED BY : HCPIVGCR when an IVL VSwitch is first
                  defined on a z/VM System.
     DELETED BY : Never destroyed or deleted once created.
     SERIALIZED :
                  VSwitch Port Group Lock (SWPLOCK) -
                  VSwitch Port Group Lock for a SHARED Port Group
                  serializes modifications to both its SWPBK and
                  corresponding Global Port Block Entry GPGENT linked
                  off the Global Port Group Manager Block (GPGENTRY).
                  Global Port Group Lock (GPGLOCK) -
                  The Global Port Group Lock serializes modifications
                  to the GPGBK and the adding and deletion of Global
                  Port Group Entries.
     RELOCATION CONSIDERATIONS : None
     COMPATIBILITY AND MIGRATION CONCERNS : N/A.
     NOTES      :
                  - The following tags are used to described the
                  address type for pointers within this control block:
                  A : Host absolute address
                  R : Host real address
                  L : Logical address in the system execution space
                  G : Guest absolute address
                  The Global Port Group Control Block Structure
         GPGBK
      +----------+
      | GPGENTRY |          GPGENT A              GPGENT B
      |          |---->+---------------+    +---------------+
      +----------+  +->| GPGEFWD  (B)  |--->| GPGEFWS  (0)  |
         SWPBK      |  +---------------+    +---------------+
      +-----------+ |  | GPGEBACK (0)  |<---| GPGEBACK (A)  |
      | SWPGPGET  |-+  +---------------*    +---------------*
      +-----------+    |               |    |               |
                       |  Global Port  |    |  Global Port  |
                       |  Group Entry  |    |  Group Entry  |
                       |               |    |               |
                       | 1 per SHARED  |    | 1 per SHARED  |
                       |  Port Group   |    |  Port Group   |
                       |               |    |               |
                       | Contains an   |    | Contains an   |
                       | Array of up   |    | Array of up   |
                       | to 16 IVL     |    | to 16 IVL     |
                       | Member Entries|    | Member Entries|
                       +---------------+    +---------------+

GPGBK Control Block Content | Top of page

     GPGBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GPGBK          Global Port Group Manager Block
    0000    0 Dbl-Word     8 GPGLOCK (3)    Global Port Group Lock-word
    0018   24 Address      4 GPGENTRY       Global Port Group Entry List
    001C   28 Signed       4 *              Reserved for Future IBM Use
    0020   32 Dbl-Word     8 *              Reserved for Future IBM Use
              00000005       GPGSIZE        (*-GPGBK+7)/8 Size in Double
                                            Words
              00000028       GPGBSIZE       GPGSIZE*8 Size in Bytes
                          Global Port Group Entry

     GPGENT DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GPGENT         Global Port Group Manager Block
    0000    0 Dbl-Word     8 GPGEPTRS (0)   Link List Pointers
    0000    0 Address      4 GPGENEXT       L:NEXT Global Port Group Entry
    0004    4 Address      4 GPGEPREV       L:PREV Global Port Group Entry
                                            *******************************--
                                            -
    0008    8 Address      4 GPGESWPK       L:SWPBK Associated with this
                                            Entry
    000C   12 Bitstring    1 GPGELAST       Index to last IVL Member Entry
    000D   13 Bitstring    1 GPGEPSTA       Previous Non-Transitional State
                                            SYNC, SYN-ERR, NonSYNC for None
    000E   14 Bitstring    2 *              Reserved for future IBM Use
    0010   16 Signed       4 *              Reserved for future IBM Use
    0014   20 Signed       4 GPGEPRES       Previous Error Reason Code
    0018   24 Bitstring  640 GPGEARRY       Start of GPG IVL Member Array
              00000053       GPGESIZE       (*-GPGENT+7)/8 Size in Double
                                            Words
              00000298       GPGEBSZE       GPGESIZE*8 Size in Bytes
                    Global Port Group IVL Member Array Entry

     GPGARY DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GPGARY         Global Port Group Manager Block
    0000    0 Character    8 GPGANAME       IVL Member (System) Name
    0008    8 Character    8 GPGAGVN        Global VSwitch Name (base
                                            instance)
    0010   16 Dbl-Word     8 GPGAUTC        UTC Timestamp
    0018   24 Signed       4 GPGAREAS       ERROR State Reason Message Number
    001C   28 Bitstring    1 GPGAPGMD       Port Group Mode
              00000000       GPGAPAS        X'00' GPGAPAS PASSIVE Port Group
                                            Mode
              00000001       GPGACT         X'01' GPGACT ACTIVE Port Group
                                            Mode
    001D   29 Bitstring    1 GPGASTAT       Global Port Group State
              00000000       GPGAOUT        X'00' GPGAOUT Qut of SYNC
              00000050       GPGAPEND       X'50' GPGAPEND Pending
                                            Synchronization
              0000005F       GPGATRAN       X'5F' GPGATRAN *---- Transitional
                                            State Line ----*
              00000060       GPGAERR        X'60' GPGAERR Error
              000000F0       GPGASYNC       X'F0' GPGASYNC Synchronized
              000000FF       GPGAPREV       X'FF' GPGAPREV Revert to previous
                                            non-transitional state.
    001E   30 Bitstring    2 *              Reserved for future IBM Use
    0020   32 Dbl-Word     8 *              Reserved for future IBM Use
              00000005       GPGASIZE       (*-GPGARY+7)/8 Size in Double
                                            Words
              00000028       GPGABSZE       GPGASIZE*8 Size in Bytes

GPGBK Storage Layout | Top of page

    *** GPGBK - Global Port Group Manager Block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       GPGLOCK                         =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  18 |         GPGENTRY          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  20 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  28
    *
    *** GPGBK - Global Port Group Manager Block

    *** GPGENT - Global Port Group Manager Block
    *
    *     +---------------------------+---------------------------+
    *   0 |         GPGENEXT          |         GPGEPREV          |
    *     +---------------------------+------+------+-------------+
    *   8 |         GPGESWPK          |:ELAST|:EPSTA|/////////////|
    *     +---------------------------+------+------+-------------+
    *  10 |///////////////////////////|         GPGEPRES          |
    *     +---------------------------+---------------------------+
    *  18 |                                                       |
    *     =                       GPGEARRY                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 298
    *
    *** GPGENT - Global Port Group Manager Block

    *** GPGARY - Global Port Group Manager Block
    *
    *     +-------------------------------------------------------+
    *   0 |                       GPGANAME                        |
    *     +-------------------------------------------------------+
    *   8 |                       GPGAGVN                         |
    *     +-------------------------------------------------------+
    *  10 |                       GPGAUTC                         |
    *     +---------------------------+------+------+-------------+
    *  18 |         GPGAREAS          |:APGMD|:ASTAT|/////////////|
    *     +---------------------------+------+------+-------------+
    *  20 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  28
    *
    *** GPGARY - Global Port Group Manager Block

GPGBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    GPGABSZE       0020 00000028
    GPGACT         001C 00000001
    GPGAERR        001D 00000060
    GPGAGVN        0008
    GPGANAME       0000
    GPGAOUT        001D 00000000
    GPGAPAS        001C 00000000
    GPGAPEND       001D 00000050
    GPGAPGMD       001C
    GPGAPREV       001D 000000FF
    GPGAREAS       0018
    GPGASIZE       0020 00000005
    GPGASTAT       001D
    GPGASYNC       001D 000000F0
    GPGATRAN       001D 0000005F
    GPGAUTC        0010
    GPGBSIZE       0020 00000028
    GPGEARRY       0018
    GPGEBSZE       0018 00000298
    GPGELAST       000C
    GPGENEXT       0000
    GPGENTRY       0018
    GPGEPRES       0014
    GPGEPREV       0004
    GPGEPSTA       000D
    GPGEPTRS       0000
    GPGESIZE       0018 00000053
    GPGESWPK       0008
    GPGLOCK        0000
    GPGSIZE        0020 00000005

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