|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRVNDSES
PrologControl 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