Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRVNDGLB

Prolog
Control Block Contents
Cross Reference

#### MRVNDGLB Prolog

     DSECT NAME - VNDGLB
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRVNDGLB
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 8 - Virtual Network Domain
                        Record 4  - Global Networking Activity
     DESCRIPTION - Describes Inter-VSwitch Link network activity for a
                   global networking  object.
     NOTES - (1)   When the IVL virtual switch exists, this record is
                   collected for each global networking object that
                   exists to report information about its IVL network
                   traffic.
                   At this time, this record is supported only for
                   virtual switches defined with the GLOBAL attribute,
                   so VNDGLB_TYPE is always equal to VNDGLB_VSWITCH.
             (2)   A null record may be created if a complete
                   sample cannot be obtained due to lock
                   contention. In that case, a null record is created
                   with VNDGLB_INCOMPLETE set ON and all other fields
                   set to 0 or blanks.
             (3)   Value for VNDGLB_TYPE - Networking Object type
                     1 = (VNDGLB_VSWITCH) Global VSWITCH

#### MRVNDGLB Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    88  VNDGLB                 Start of monitor record
       0   0  Character     0  VNDGLB_MRHDR           Record header. See MRRECHDR
                                                      for details.
       0   0  Character    20  MRHDR
       0   0  Unsigned      2  MRHDRLEN
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      20  14  Character     8  VNDGLB_SYSID           System name.
      28  1C  Character     8  VNDGLB_LANNAME         Global object name - When
                                                      VNDGLB_TYPE is
                                                      VNDGLB_VSWITCH, contains the
                                                      name of a virtual switch
                                                      defined with the GLOBAL
                                                      attribute.
      36  24  Unsigned      1  VNDGLB_TYPE            Networking Object type.
      37  25  Unsigned      1  VNDGLB_FLAG            Sample control flag
              1... ....        VNDGLB_INCOMPLETE       - Sample is incomplete.
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      38  26  Unsigned      2  VNDGLB_SWPINST         Shared port group instance
                                                      (0-3) if a shared port group
                                                      is in use on the global
                                                      vswitch. Otherwise contains
                                                      0.
      40  28  Character     8  VNDGLB_SWPGROUP        - When VNDGLB_TYPE is
                                                      VNDGLB_VSWITCH, contains the
                                                      name of a shared port group
                                                      if one is in use on the
                                                      global virtual switch.
                                                      Otherwise contains blanks.
      48  30  Unsigned      2  VNDGLB_OFFCTR          Offset within this record
                                                      to the start of
                                                      VNDGLB_COUNTER.
      50  32  Unsigned      2  VNDGLB_CTRLN           Length of the
                                                      VNDGLB_COUNTER field.
      52  34  Character     4  VNDGLB_UNQID           Unique ID for vswitch
      56  38  Character    32  VNDGLB_COUNTER
      56  38  Character     8  VNDGLB_LANIVLDPTXBYT   Cumulative number of bytes
                                                      of customer data sent over
                                                      the IVL Network (Data Plane
                                                      traffic) on behalf of this
                                                      global object.
      64  40  Character     8  VNDGLB_LANIVLDPRXBYT   Cumulative number of bytes
                                                      of customer data received
                                                      over the IVL Network (Data
                                                      Plane traffic) on behalf of
                                                      this global object.
      72  48  Character     8  VNDGLB_LANIVLDPTXPKT   Cumulative count of the
                                                      packets of customer data sent
                                                      over the IVL Network (Data
                                                      Plane traffic) on behalf of
                                                      this global object.
      80  50  Character     8  VNDGLB_LANIVLDPRXPKT   Cumulative count of the
                                                      packets of customer data
                                                      received over the IVL Network
                                                      (Data Plane traffic) on
                                                      behalf of this global object.
      88  58  Character     0  VNDGLB_END

#### MRVNDGLB Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    MRHDR                      0     20
    MRHDR_END                 14      0
    MRHDRDM                    4      1
    MRHDRLEN                   0      2
    MRHDRRC                    6      2
    MRHDRTOD                   8      8
    MRHDRZER                   2      2
    VNDGLB                     0     88
    VNDGLB_COUNTER            38     32
    VNDGLB_CTRLN              32      2
    VNDGLB_END                58      0
    VNDGLB_FLAG               25      1
    VNDGLB_INCOMPLETE         25           80
    VNDGLB_LANIVLDPRXBYT      40      8
    VNDGLB_LANIVLDPRXPKT      50      8
    VNDGLB_LANIVLDPTXBYT      38      8
    VNDGLB_LANIVLDPTXPKT      48      8
    VNDGLB_LANNAME            1C      8
    VNDGLB_MRHDR               0      0
    VNDGLB_OFFCTR             30      2
    VNDGLB_SWPGROUP           28      8
    VNDGLB_SWPINST            26      2
    VNDGLB_SYSID              14      8
    VNDGLB_TYPE               24      1
    VNDGLB_UNQID              34      4

    This information is
    based on z/VM V7R2.0.

    Last updated on 05 August 2020 at 20:54:40.

    Copyright IBM Corporation, 1990, 2020