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