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 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 - 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

 
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