|
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. .... VNDSES_HLGPC Indicate NIC Distribution is ON. Only valid if VNDSES_NICLGLAN is ON ...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 & VNDSES_HLGPC is OFF 104 68 Character 8 VNDSES_SESRXBYT Total Bytes Received from OSA Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 112 70 Character 8 VNDSES_SESTXPKT Packets sent to OSA Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 120 78 Character 8 VNDSES_SESTXDSC TX packets discarded Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 128 80 Character 8 VNDSES_SESTXERR TX packets in error Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 136 88 Character 8 VNDSES_SESRXPKT Packets received from OSA Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 144 90 Character 8 VNDSES_SESRXDSC RX packets discarded Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 152 98 Character 8 VNDSES_SESRXERR RX packets in error Zero when VNDSES_NICLGLAN is ON & VNDSES_HLGPC is OFF 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 187 BB Character 1 VNDSES_PQUPLTX Uplink TX Priority z/VM (CP use) = 0 High (Guest use) = 1 Normal (Guest use) =2 Low (Guest use) = 3 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_HLGPC 3D 20
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_PQUPLTX BB 1
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 V7R4.0.
Last updated on 10 September 2024 at 20:24:05.
Copyright IBM Corporation, 1990, 2024