IVLBK Back to Index page
 
Prolog 
Control Block Contents 
   IVLBK DSECT
   IVLMBK DSECT
   IVLS_EVENT 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.


  IVLBK Prolog Top of page
 
 NAME       : HCPIVLBK
 DESCRIPTION: IVL Domain Member Table
 DSECT      : IVLBK
 FUNCTION   : This block is created to maintain a record of
              all active IVL Domain members known by this
              z/VM image.
 CREATED BY : HCPIVLCR the first time an IVL VSWITCH is
              instantiated.
  ISABLED BY - HCPIVLDM when the IVL VSWITCH is DETACHed.
 DELETED BY : Never destroyed once created.
 ANCHORED   - HCPLANIV = CONTAINS ADDRESS FOR THE L: VLBK
 SERIALIZED :
              The IVLHLOCK is used to serialize fields within the
              L:IVLBK and to reference IVLMLOCK entries.
              The IVLMLOCK is used to serialize fields in the IVL
              Member Table(IVLMBKs).
 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
 
 
  IVLBK Control Block Content Top of page
 

 IVLBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure IVLBK IVL Domain Member Table 0000 0 Dbl-Word 8 IVLHLOCK (3) IVLBK Header Lock-word 0018 24 Dbl-Word 8 IVLCLBST (0) Start displacement for block clear 0018 24 Character 8 * Reserved for future IBM Use 0020 32 Bitstring 6 IVLHMAC (0) Domain Multicast MAC Address 0020 32 Bitstring 5 IVLHMACH Start of MAC Address 0025 37 Bitstring 1 IVLHMACX Last byte of Domain MAC Address *----- End of MAC Address 0026 38 Character 1 IVLHDOM Domain Membership letter (A-H) 0027 39 Bitstring 1 IVLHLAST Index to last IVL Member Entry 0028 40 Dbl-Word 8 IVLHDCAP Domain level IVL Capability bits Represents the least common denominator of capabilities of all current domain members. .... .... IVLCAPDH X'80000000' High half: Base Capability Level .... .... IVLCAPCH X'40000000' High half: Collaborative Load balancing supported 00004000 IVLCAPCO X'4000' High half half: Collab. LB support .... .... IVLCAPPH X'C0000000' High half: Base plus collaborative load balancing .... .... IVLCAPDL X'00000000' Low half: Base Capability Level Represents the highest possibile capability for the local z/VM image. 0030 48 Bitstring 4 IVLHSRV Maintenance Level ID 0034 52 Signed 2 IVLHHBTO IVL Heartbeat Timeout 0036 54 Signed 2 IVLHVLAN IVL VLAN, or 0 if no IVL VLAN 0038 56 Address 4 IVLHLAN Pointer to LANBK for IVL Virtual Switch 003C 60 Signed 4 IVLHTOK Counter used to generate tokens for SEND_REQUESTs Active SEND_REQUEST Queue The Active SEND_REQUEST Queue is a cyclic list of SRQBKs. The anchor points to the newest SRQBK on the list. Whereas the anchored SRQBK's next pointer is the next most recent SRQBK on the list and its previous pointer links to the longest outstanding SRQBK on the list. SRQBK B +--->+----------+<---+ | | SRQ_NEXT | | | | C | | SRQBK A | +----------+ | +---------+ +----------+<---+ | SRQ_PREV | | | IVLHSRQ |---->| SRQ_NEXT | | A | | | A | | B | +----------+ | +---------+ +----------+ | | | | SRQ_PREV | | | C | | +----------+<---+ | | | | | | +----------+ | Newest | | | | | SRQBK C | +----------+ +--->+----------+<---+ | SRQ_NEXT | | A | +----------+ | SRQ_PREV | | B | +----------+ | | Oldest | | +----------+ Serialization: IVLHSRQ, IVLHALL, IVLHFLAG and IVLHREAS are serialized by the IVL COM Lock and NOT the IVL Header Lock. 0040 64 Address 4 IVLHSRQ Active SEND_REQUEST Queue 0044 68 Signed 2 IVLHALL Mask of ALL currently active IVL Domain Members 0046 70 Bitstring 1 IVLHFLGA IVL Communication Flags 00000080 IVLHFENC X'80' IVLHFENC Local IVL Member FENCED from Domain 00000040 IVLHIDIS X'40' IVLHIDIS IVL Discovery Initiated after IPL 0047 71 Bitstring 1 * Reserved for future IBM use 0048 72 Signed 4 IVLHREAS FENCED Reason Message Number 004C 76 Address 4 IVLHNPBK IVL NIC Port Block L:Address 0050 80 Dbl-Word 8 IVLHDTX Count of messages sent when the target address is the IVL Domain MAC address. 0058 88 Dbl-Word 8 IVLHMRX Count of messages received when the target address is the local system's IVL Handler MAC address. 0060 96 Dbl-Word 8 IVLHDRX Count of messages received when the target address is the IVL Domain MAC address. 0068 104 Dbl-Word 8 IVLHRXDSC Count of replies received and discarded because no matching SRQBK was found and the source MAC did not match a current IVL Domain member. 0070 112 Bitstring 1 IVLHDMCT Count of of duplicate MAC warning messages. 0071 113 Bitstring 7 * Reserved for future IBM use 0078 120 Dbl-Word 8 * (39) Reserved for Future IBM Use Important NOTES : IVLBK Size Restriction The size of the IVLBK fixed header and the size of the 16 table entries can't exceed 4016 bytes. Therefore, you can't increase the size of either the header or a table entry. All new fields must be allocated from reserved space only. 01B0 432 Dbl-Word 8 * (0) 01B0 432 Bitstring 3584 IVLHMEMB Reserve space for maximum sized member table. 000001F6 IVLHSIZ (*-IVLBK+7)/8 Size in double words 00000FB0 IVLHBSIZ IVLHSIZ*8 Size in bytes 000001F3 IVLCSIZ (*-IVLCLBST+7)/8 Clear size in double words 00000F98 IVLCLSIZ IVLCSIZ*8 Clear Size in bytes IVL Domain Member Table Entry The first IVL Member Table Entry is ALWAYS for the local host.
 IVLMBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure IVLMBK IVL Domain Member Table Define the common area of the IVL Member Table Entry 0000 0 Dbl-Word 8 IVLMLOCK (3) Member entry lock 0018 24 Character 8 IVLMNAME Member EBCDIC System Name 0020 32 Bitstring 6 IVLMMAC (0) Unicast MAC address local Manager 0020 32 Bitstring 3 IVLMMACP MAC Address Prefix 0023 35 Bitstring 3 IVLMMACS MAC Address Suffix *----- End of MAC Address 0026 38 Bitstring 1 IVLMSTAT Member Host IVL Handler State machine representing the local system's view of the remote host 00000000 IVLMSTAT_INACTIVE X'00' IVLMSTAT_INACTIVE - Member is inactive 00000020 IVLMSTAT_LEAVING X'20' IVLMSTAT_LEAVING - Member is leaving (tran state) IVLMSTAT > x'4F' indicates different active host states 00000050 IVLMSTAT_ERROR X'50' IVLMSTAT_ERROR - Member is in an error sta 00000060 IVLMSTAT_PENDING X'60' IVLMSTAT_PENDING - Member is in pending jo (transitional state) 000000F0 IVLMSTAT_ACTIVE X'F0' IVLMSTAT_ACTIVE - Active IVL Member 0027 39 Bitstring 1 IVLMEUSE Member Entry validity 00000000 IVLMEUSE_UNUSED X'00' IVLMEUSE_UNUSED - Member entry is not in u 00000001 IVLMEUSE_INUSE X'01' IVLMEUSE_INUSE - Member entry is in use 0028 40 Character 4 IVLMSRV Maintenance Level ID 002C 44 Signed 4 IVLMHBCT IVL Heartbeat Counter 0030 48 Dbl-Word 8 IVLMCAP Member IVL Capability bits Represents the highest possibile capability for the member. 0038 56 Dbl-Word 8 IVLMTX Count of messages sent using the MAC address of the member host's IVL Handler. 0040 64 Dbl-Word 8 IVLMRX Count of messages received using MAC address of the member host's IVL Handler. 0048 72 Dbl-Word 8 IVLMRXDSC Count of replies received and discarded because no matching SRQBK was found. 0050 80 Signed 2 IVLMMASK Member mask 0052 82 Bitstring 1 IVLMFLGA IVL Manager Processing Flags 1... .... IVLMRECV X'80' IVLMRECV HeartBeat Recovery Task Active 0053 83 Bitstring 1 * Reserved for future IBM use 0054 84 Signed 4 * Reserved for future IBM use 0058 88 Dbl-Word 8 * (17) Reserved for Future IBM Use Important NOTES : IVLBK Size Restriction The size of the IVLBK fixed header and the size of the 16 table entries can't exceeded 4016 bytes. Therefore, you can't increase the size of either the header or a table entry. All new fields must be allocated from reserved space only. 0000001C IVLMSIZE (*-IVLMBK+7)/8 Size in double words 000000E0 IVLMBSIZ IVLMSIZE*8 Size in bytes Define the IVLS_EVENT Structure This is used to map the data to be recorded for *VMEVENT events VMEIVLJN and VMEIVLLF.
 IVLS_EVENT DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure IVLS_EVENT IVL Domain Member Table 0000 0 Character 8 IVLS_SYSID Local System ID 0008 8 Bitstring 1 IVLS_DOMAIN IVL Domain 0009 9 Bitstring 1 IVLS_FLAG Flags 1... .... IVLS_JOIN X'80' IVLS_JOIN Local System JOINed IVL Domain .1.. .... IVLS_LEFT X'40' IVLS_LEFT Local System LEFT IVL Domain 000A 10 Bitstring 6 * Reserved for future IBM Use 00000002 IVLS_EVSZ (*-IVLS_EVENT+7)/8 Size of IVLS_EVENT in DWs 00000010 IVLS_EVSZB IVLS_EVSZ*8 Size of IVLS_EVENT in bytes
 
 
  IVLBK Storage Layout Top of page
 
          
*** IVLBK - IVL Domain Member Table
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       IVLHLOCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  18 |///////////////////////////////////////////////////////|
*     +----------------------------------+------+------+------+
*  20 |            IVLHMACH              |:HMACX|:HDOM |:HLAST|
*     +----------------------------------+------+------+------+
*  28 |                       IVLHDCAP                        |
*     +---------------------------+-------------+-------------+
*  30 |         IVLHSRV           |  IVLHHBTO   |  IVLHVLAN   |
*     +---------------------------+-------------+-------------+
*  38 |         IVLHLAN           |         IVLHTOK           |
*     +---------------------------+-------------+------+------+
*  40 |         IVLHSRQ           |  IVLHALL    |:HFLGA|//////|
*     +---------------------------+-------------+------+------+
*  48 |         IVLHREAS          |         IVLHNPBK          |
*     +---------------------------+---------------------------+
*  50 |                       IVLHDTX                         |
*     +-------------------------------------------------------+
*  58 |                       IVLHMRX                         |
*     +-------------------------------------------------------+
*  60 |                       IVLHDRX                         |
*     +-------------------------------------------------------+
*  68 |                      IVLHRXDSC                        |
*     +------+------------------------------------------------+
*  70 |:HDMCT|////////////////////////////////////////////////|
*     +------+------------------------------------------------+
*  78 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 1B0 |                                                       |
*     =                       IVLHMEMB                        =
*     |                                                       |
*     +-------------------------------------------------------+
* FB0
*
*** IVLBK - IVL Domain Member Table
          
*** IVLMBK - IVL Domain Member Table
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       IVLMLOCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  18 |                       IVLMNAME                        |
*     +--------------------+--------------------+------+------+
*  20 |     IVLMMACP       |     IVLMMACS       |:MSTAT|:MEUSE|
*     +--------------------+------+-------------+------+------+
*  28 |         IVLMSRV           |         IVLMHBCT          |
*     +---------------------------+---------------------------+
*  30 |                       IVLMCAP                         |
*     +-------------------------------------------------------+
*  38 |                        IVLMTX                         |
*     +-------------------------------------------------------+
*  40 |                        IVLMRX                         |
*     +-------------------------------------------------------+
*  48 |                      IVLMRXDSC                        |
*     +-------------+------+------+---------------------------+
*  50 |  IVLMMASK   |:MFLGA|//////|///////////////////////////|
*     +-------------+------+------+---------------------------+
*  58 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  E0
*
*** IVLMBK - IVL Domain Member Table
          
*** IVLS_EVENT - IVL Domain Member Table
*
*     +-------------------------------------------------------+
*   0 |                      IVLS_SYSID                       |
*     +------+------+-----------------------------------------+
*   8 |(008) |(009) |/////////////////////////////////////////|
*     +------+------+-----------------------------------------+
*  10
*
*** IVLS_EVENT - IVL Domain Member Table
 
 
  IVLBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
IVLCAPCH       0028 00
IVLCAPCO       0028 00004000
IVLCAPDH       0028 00
IVLCAPDL       0028 00
IVLCAPPH       0028 00
IVLCLBST       0018
IVLCLSIZ       01B0 00000F98
IVLCSIZ        01B0 000001F3
IVLHALL        0044
IVLHBSIZ       01B0 00000FB0
IVLHDCAP       0028
IVLHDMCT       0070
IVLHDOM        0026
IVLHDRX        0060
IVLHDTX        0050
IVLHFENC       0046 00000080
IVLHFLGA       0046
IVLHHBTO       0034
IVLHIDIS       0046 00000040
IVLHLAN        0038
IVLHLAST       0027
IVLHLOCK       0000
IVLHMAC        0020
IVLHMACH       0020
IVLHMACX       0025
IVLHMEMB       01B0
IVLHMRX        0058
IVLHNPBK       004C
IVLHREAS       0048
IVLHRXDSC      0068
IVLHSIZ        01B0 000001F6
IVLHSRQ        0040
IVLHSRV        0030
IVLHTOK        003C
IVLHVLAN       0036
IVLMBSIZ       0058 000000E0
IVLMCAP        0030
IVLMEUSE       0027
IVLMEUSE_INUSE
               0027 00000001
IVLMEUSE_UNUSED
               0027 00000000
IVLMFLGA       0052
IVLMHBCT       002C
IVLMLOCK       0000
IVLMMAC        0020
IVLMMACP       0020
IVLMMACS       0023
IVLMMASK       0050
IVLMNAME       0018
IVLMRECV       0052 80
IVLMRX         0040
IVLMRXDSC      0048
IVLMSIZE       0058 0000001C
IVLMSRV        0028
IVLMSTAT       0026
IVLMSTAT_ACTIVE
               0026 000000F0
IVLMSTAT_ERROR
               0026 00000050
IVLMSTAT_INACTIVE
               0026 00000000
IVLMSTAT_LEAVING
               0026 00000020
IVLMSTAT_PENDING
               0026 00000060
IVLMTX         0038
IVLS_DOMAIN    0008
IVLS_EVSZ      000A 00000002
IVLS_EVSZB     000A 00000010
IVLS_FLAG      0009
IVLS_JOIN      0009 80
IVLS_LEFT      0009 40
IVLS_SYSID     0000
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:51:48 EDT.
Copyright IBM Corporation, 1990, 2022