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  284  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               record length in bytes
  2   2  Unsigned     2  MRHDRZER               field of zeros
  4   4  Unsigned     1  MRHDRDM                domain identifier
  5   5  Unsigned     1  *
  6   6  Unsigned     2  MRHDRRC                record identifier
  8   8  Character    8  MRHDRTOD               Time at which this record was
                                                built. In time-of-day (TOD)
                                                clock format. See IBM System
                                                370 XA Principle of Operation
                                                for explanation of format.
 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
 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  Character    3  *                      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   64  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    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    284
VNDSES_END               11C      0
VNDSES_LANDEFER           48      8
VNDSES_LANID              2C     16
VNDSES_MRHDR               0      0
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     64
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_VDEVDEV            20      2
VNDSES_VDEVSUB            14      2
VNDSES_VRTPFRME            4      4
VNDSES_VSWITCH            3C      1

This information is based on z/VM V5R3.0.
Last updated on 11 Jun 2007 at 16:03:23.
Copyright IBM Corporation, 2007