|
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
22 16 Bitstring 1 VNDSES_NICCFLG Adapter configuration flags
1... .... VNDSES_NICINPRG - Init in progss
.1.. .... VNDSES_NICDLPRG - Delete in prgress
..1. .... VNDSES_NICCNLAN - Connected toSYSTEM LAN
...1 .... VNDSES_NICPVLAN - Connected toPRIVATE LAN
.... 1... VNDSES_NICREADY - LAN READY
.... .1.. VNDSES_NICROUTR - NETROUTER isset
.... ..1. VNDSES_NICPAUT - Promiscuous Mod Author.
.... ...1 VNDSES_NICLGLAN - Connected as a HiperSockets
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
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 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 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 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_FLAG 17 1
VNDSES_INCOMPLETE 17 80
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_NICCFLG 16 1
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_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 V6R2.0.
Last updated on 06 Dec 2012 at 11:34:39.
Copyright IBM Corporation, 1990, 2012