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

#### MRVNDSES

Prolog
Control Block Contents
Cross Reference

#### MRVNDSES Prolog

     DSECT NAME - VNDSES
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRVNDSES
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 8 - Virtual Network Domain
                        Record 1  - Virtual NIC Session Activity
     DESCRIPTION - Describes network activity for a virtual NIC
                   connection to a virtual network (Guest LAN or
                   VSWITCH).
     NOTES - (1)   This record is collected for the base device
                   of a virtual NIC (the first in the series of
                   devices created when the NIC is defined) when
                   it is coupled to a virtual network and network
                   sampling is enabled.

                   VNDSES_VDEVDEV will contain the device address
                   of the first device on this virtual NIC.  For
                   the typical guest, the virtual NIC represents
                   a single network interface.  However, it is
                   possible to define a virtual NIC with capacity
                   for more than one data device.  In that case,
                   these counters represent the total activity
                   of all data devices contained in this NIC.

             (2)   A null record may be created if a complete
                   sample cannot be obtained due to lock
                   contention. A null record is created with
                   VNDSES_INCOMPLETE set ON and all other fields
                   set to 0.

#### MRVNDSES Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  304  VNDSES                 Start of monitor record
      0   0  Character    0  VNDSES_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  Unsigned     2  VNDSES_VDEVSUB         VDEV subchannel id
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON.
     22  16  Bitstring    1  VNDSES_NICCFLG         Adapter configuration flags
              1... ....      VNDSES_NICINPRG        - Init in progress
              .1.. ....      VNDSES_NICDLPRG        - Delete in progress
              ..1. ....      VNDSES_NICCNLAN        - Connected to SYSTEM LAN
              ...1 ....      VNDSES_NICPVLAN        - Connected to PRIVATE LAN
              .... 1...      VNDSES_NICREADY        - LAN READY
              .... .1..      VNDSES_NICROUTR        - NETROUTER is set
              .... ..1.      VNDSES_NICPAUT         - Promiscuous Mode Author
              .... ...1      VNDSES_NICLGLAN        - Connected as a HiperSockets
                                                      Logical Guest Port
     23  17  Bitstring    1  VNDSES_FLAG            Sample control flag
              1... ....      VNDSES_INCOMPLETE      - Sample is incomplete.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     24  18  Character    8  VNDSES_OWNER           userid of owner
     32  20  Unsigned     2  VNDSES_VDEVDEV         VDEV device address
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON.
     34  22  Unsigned     2  VNDSES_NICBASE         NIC base device address
     36  24  Character    6  VNDSES_NICMAC          MAC ADDRESS OF NIC
     42  2A  Character    1  VNDSES_NICTRANP        Session Layer (2 or 3) Codes
                                                    defined : Layer 3 IP = 1 Layer
                                                    2 Ethernet = 2 Unknown (not
                                                    coupled) = 3
     43  2B  Character    1  VNDSES_NICTYPE         HiperSockets/OSA Codes
                                                    defined : Hipersockets = 1 QDIO
                                                    = 2 IBM RESERVED = 4 IBM
                                                    RESERVED = 5
     44  2C  Character   16  VNDSES_LANID           LAN ID (owner||name)
     60  3C  Character    1  VNDSES_VSWITCH         Indicate this is a VSWITCH
                                                    VSWITCH = 1 Guest LAN = 0
     61  3D  Bitstring    1  VNDSES_LCLFLAGS        General flags
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON.
              1... ....      VNDSES_UPLINK          UPLINK NIC if on
              .1.. ....      VNDSES_RELO1           Indicates this is first record
                                                    since a live guest relocation
                                                    occurred.
              ..1. ....      VNDSES_HLGPC           Indicate NIC Distribution is ON.
                                                    Only valid if
                                                    VNDSES_NICLGLAN is ON
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     62  3E  Character    2  *                      Reserved for future IBM use
     64  40  Character    8  VNDSES_NIC_LOCKREQS    Lock requests for network
                                                    lock (LANLKWRD)
     72  48  Character    8  VNDSES_LANDEFER        Number of times we had to
                                                    wait for the network lock
                                                    (LANLKWRD)
     80  50  Character    8  VNDSES_TXDEFERS        Number of times we had to
                                                    wait for a lock when sending
                                                    data from this port
     88  58  Character    8  VNDSES_RXDEFERS        Number of times we had to
                                                    wait for a lock when receiving
                                                    data on this port
     96  60  Character    8  VNDSES_SESTXBYT        Total bytes sent to OSA
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    104  68  Character    8  VNDSES_SESRXBYT        Total Bytes Received from OSA
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    112  70  Character    8  VNDSES_SESTXPKT        Packets sent to OSA
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    120  78  Character    8  VNDSES_SESTXDSC        TX packets discarded
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    128  80  Character    8  VNDSES_SESTXERR        TX packets in error
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    136  88  Character    8  VNDSES_SESRXPKT        Packets received from OSA
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    144  90  Character    8  VNDSES_SESRXDSC        RX packets discarded
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    152  98  Character    8  VNDSES_SESRXERR        RX packets in error
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON & VNDSES_HLGPC is OFF
    160  A0  Character    8  VNDSES_SESRXPCI        Count of PCI (or AIF) events
                                                    reflected for input queues.
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON.
    168  A8  Character    8  VNDSES_SESTXPCI        Count of PCI (or AIF) events
                                                    reflected for output queues.
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON.
    176  B0  Character    8  VNDSES_SWPGROUP        Name of the Link Agg port
                                                    group in use for virtual switch
    184  B8  Unsigned     2  VNDSES_SWPINTSC        Number of seconds be- tween
                                                    load balancing operations
    186  BA  Character    1  VNDSES_SWPLBAL         Load Balance Type
                                                    Independent = 0
                                                    Forced Independent= 8
                                                    Collaborative = 16
    187  BB  Character    1  VNDSES_PQUPLTX         Uplink TX Priority
                                                    z/VM (CP use) = 0
                                                    High (Guest use) = 1
                                                    Normal (Guest use) =2
                                                    Low (Guest use) = 3
                                                    Enforce Doubleword
                                                    boundary for VNDSES_PORTS
                                                    array.
    188  BC  Character    1  VNDSES_PORTS(8)        Array of Port Info
      0   0  Unsigned     2  VNDSES_NIDDVNUM        OSA Device number
      2   2  Character    2  *                      Reserved
      4   4  Unsigned     4  VNDSES_VRTPFRME        Last interval number of
                                                    packets
    252  FC  Character    8  VNDSES_TXREQS          Lock requests made when
                                                    sending data from this port
    252  FC  Character    4  VNDSES_TXREQSHI
    256 100  Character    4  VNDSES_TXREQSLO
    260 104  Character    8  VNDSES_RXREQS          Lock requests made while
                                                    receiving data on this port
    260 104  Character    4  VNDSES_RXREQSHI
    264 108  Character    4  VNDSES_RXREQSLO
    268 10C  Character    8  VNDSES_STKREQS         Requests made to stack or
                                                    unstack work on this port
    268 10C  Character    4  VNDSES_STKREQHI
    272 110  Character    4  VNDSES_STKREQLO
    276 114  Character    8  VNDSES_STKDEFERS       Number of times it took
                                                    multiple attempts to stack work
                                                    on this port
    276 114  Character    4  VNDSES_STKDEFERSHI
    280 118  Character    4  VNDSES_STKDEFERSLO
    284 11C  Character    6  VNDSES_MSVCMAC         VDEV MAC address
    290 122  Character    1  VNDSES_IVLNICP         Indicate this is an IVLPORT
                                                    IVL NIC Port = 1
    291 123  Character    1  *                      Reserved
    292 124  Character    8  VNDSES_VMDRLLST        Time stamp of last relocation
                                                    of this user. Valid only if
                                                    VNDSES_RELO1=ON.
                                                    Zero when VNDSES_NICLGLAN
                                                    is ON.
    300 12C  Unsigned     4  VNDSES_NICMGPOR        Port value for the guest
                                                    connection.
    304 130  Character    0  VNDSES_END

#### MRVNDSES 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
    VNDSES                     0    304
    VNDSES_END               130      0
    VNDSES_HLGPC              3D           20
    VNDSES_INCOMPLETE         17           80
    VNDSES_IVLNICP           122      1
    VNDSES_LANDEFER           48      8
    VNDSES_LANID              2C     16
    VNDSES_LCLFLAGS           3D      1
    VNDSES_MRHDR               0      0
    VNDSES_MSVCMAC           11C      6
    VNDSES_NIC_LOCKREQS       40      8
    VNDSES_NICBASE            22      2
    VNDSES_NICCNLAN           16           20
    VNDSES_NICDLPRG           16           40
    VNDSES_NICINPRG           16           80
    VNDSES_NICLGLAN           16           01
    VNDSES_NICMAC             24      6
    VNDSES_NICMGPOR          12C      4
    VNDSES_NICPAUT            16           02
    VNDSES_NICPVLAN           16           10
    VNDSES_NICREADY           16           08
    VNDSES_NICROUTR           16           04
    VNDSES_NICTRANP           2A      1
    VNDSES_NICTYPE            2B      1
    VNDSES_NIDDVNUM            0      2
    VNDSES_OWNER              18      8
    VNDSES_PORTS              BC      8
    VNDSES_PQUPLTX            BB      1
    VNDSES_RELO1              3D           40
    VNDSES_RXDEFERS           58      8
    VNDSES_RXREQS            104      8
    VNDSES_RXREQSHI          104      4
    VNDSES_RXREQSLO          108      4
    VNDSES_SESRXBYT           68      8
    VNDSES_SESRXDSC           90      8
    VNDSES_SESRXERR           98      8
    VNDSES_SESRXPCI           A0      8
    VNDSES_SESRXPKT           88      8
    VNDSES_SESTXBYT           60      8
    VNDSES_SESTXDSC           78      8
    VNDSES_SESTXERR           80      8
    VNDSES_SESTXPCI           A8      8
    VNDSES_SESTXPKT           70      8
    VNDSES_STKDEFERS         114      8
    VNDSES_STKDEFERSHI       114      4
    VNDSES_STKDEFERSLO       118      4
    VNDSES_STKREQHI          10C      4
    VNDSES_STKREQLO          110      4
    VNDSES_STKREQS           10C      8
    VNDSES_SWPGROUP           B0      8
    VNDSES_SWPINTSC           B8      2
    VNDSES_SWPLBAL            BA      1
    VNDSES_TXDEFERS           50      8
    VNDSES_TXREQS             FC      8
    VNDSES_TXREQSHI           FC      4
    VNDSES_TXREQSLO          100      4
    VNDSES_UPLINK             3D           80
    VNDSES_VDEVDEV            20      2
    VNDSES_VDEVSUB            14      2
    VNDSES_VMDRLLST          124      8
    VNDSES_VRTPFRME            4      4
    VNDSES_VSWITCH            3C      1

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

    Last updated on 13 December 2021 at 10:37:55.

    Copyright IBM Corporation, 1990, 2021