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. ....      *
          ...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.
104  68  Character    8  VNDSES_SESRXBYT        Total Bytes Received from OSA
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
112  70  Character    8  VNDSES_SESTXPKT        Packets sent to OSA
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
120  78  Character    8  VNDSES_SESTXDSC        TX packets discarded
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
128  80  Character    8  VNDSES_SESTXERR        TX packets in error
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
136  88  Character    8  VNDSES_SESRXPKT        Packets received from OSA
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
144  90  Character    8  VNDSES_SESRXDSC        RX packets discarded
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
152  98  Character    8  VNDSES_SESRXERR        RX packets in error
                                                Zero when VNDSES_NICLGLAN
                                                is ON.
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
186  BB  Character    1  *                      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    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_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_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 V6R4.0.

Last updated on 10 Dec 2016 at 20:45:55.
Copyright IBM Corporation, 1990, 2017