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.3.0 Last updated on 22 Jun 2022 at 15:50:57 EDT.
Copyright IBM Corporation, 1990, 2022