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

    MRVNDSES Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  292  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
     22  16  Unsigned     2  *                      RESERVED FOR FUTURE USE
     24  18  Character    8  VNDSES_OWNER           userid of owner
     32  20  Unsigned     2  VNDSES_VDEVDEV         VDEV device address
     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
                                                    INMN NIC = 4
                                                    IEDN NIC = 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  Unsigned     1  VNDSES_LCLFLAGS        Flags
              1... ....      VNDSES_UPLINK          UPLINK NIC if on
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     62  3E  Character    2  *                      RESERVED FOR FUTURE 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
    104  68  Character    8  VNDSES_SESRXBYT        Total Bytes Received from OSA
    112  70  Character    8  VNDSES_SESTXPKT        Packets sent to OSA
    120  78  Character    8  VNDSES_SESTXDSC        TX packets discarded
    128  80  Character    8  VNDSES_SESTXERR        TX packets in error
    136  88  Character    8  VNDSES_SESRXPKT        Packets received from OSA
    144  90  Character    8  VNDSES_SESRXDSC        RX packets discarded
    152  98  Character    8  VNDSES_SESRXERR        RX packets in error
    160  A0  Character    8  VNDSES_SESRXPCI        Count of PCI (or AIF) events
                                                    reflected for input queues.
    168  A8  Character    8  VNDSES_SESTXPCI        Count of PCI (or AIF) events
                                                    reflected for output queues.
    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    2  *                      Reserved 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    2  *                      Reserved
    292 124  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    292
    VNDSES_END               124      0
    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_NICMAC             24      6
    VNDSES_NICTRANP           2A      1
    VNDSES_NICTYPE            2B      1
    VNDSES_NIDDVNUM            0      2
    VNDSES_OWNER              18      8
    VNDSES_PORTS              BC      8
    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_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_VRTPFRME            4      4
    VNDSES_VSWITCH            3C      1

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

    Last updated on 10 November 2010 at 14:20:41.

    Copyright IBM Corporation, 1990, 2010