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.2.0 Last updated on 24 Jun 2020 at 09:28:44 EDT.
Copyright IBM Corporation, 1990, 2020