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