| 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) |
|
| 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 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 |
Copyright IBM Corporation, 1990, 2022