|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODVSW
PrologControl Block Contents
Cross Reference
MRIODVSW Prolog
DSECT NAME - IODVSW
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRIODVSW
DESCRIPTIVE NAME - Monitor Sample Record
Domain 6 - I/O Domain
Record 21 - Virtual Switch Activity
DESCRIPTION - Describes I/O activities for a virtual switch's
connection to a real hardware LAN segment through
an OSA.
NOTES - This record is collected for the DATA device
associated with an OSA in use by a virtual
switch. When a virtual switch is
created, the VSWITCH RDEV operand specifies
the first of three sequential device addresses.
One of those devices is designated as the
DATA device. Use the "VSWITCH Connection:"
section of QUERY VSWITCH DETAILS output to
find the value of the DATA device.
Device sampling should specify the value of
the DATA device to obtain information about
virtual switch data transfer.
For example VSWITCH RDEV FB00 indicates
devices FB00, FB01, and FB02 are associated
with the virtual switch. This record is
generated when monitor is enabled for FB02.
MRIODVSW Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 140 IODVSW Start of monitor record
0 0 Character 0 IODVSW_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 4 IODVSW_RDEVSID Host subchannel id
24 18 Unsigned 2 IODVSW_RDEVDEV Device number
26 1A Unsigned 1 IODVSW_LANFSV Queuestorage value (1-8)
27 1B Unsigned 1 * Reserved
28 1C Unsigned 2 IODVSW_LANIPTO IPTimeout value in number of
30 second tics. Range 2-240
30 1E Unsigned 1 IODVSW_LANRDD_OSAPORTN OSA-Express port number
configured
31 1F Unsigned 1 * Reserved
32 20 Character 8 IODVSW_VMDUSER Name of the TCP/IP virtual
machine acting as the vswitch
controller.
40 28 Character 8 IODVSW_NICTXBYT Total Bytes Sent out across
the real device connected to a
virtual switch.
40 28 Character 4 IODVSW_NICTXBYTHI
44 2C Character 4 IODVSW_NICTXBYTLO
48 30 Character 8 IODVSW_NICRXBYT Total Bytes Received from the
real device connected to a
virtual switch.
48 30 Character 4 IODVSW_NICRXBYTHI
52 34 Character 4 IODVSW_NICRXBYTLO
56 38 Unsigned 4 IODVSW_NICTXPKT Number of packets sent across
the real device connected to a
virtual switch.
60 3C Unsigned 4 IODVSW_NICTXDSC Number of valid outbound
packets discarded. May be
discarded due to buffer
overflow, for example.
64 40 Unsigned 4 IODVSW_NICTXERR Number of invalid outbound
packets discarded.
68 44 Unsigned 4 IODVSW_NICRXPKT Number of packets received on
the real device connected to a
virtual switch.
72 48 Unsigned 4 IODVSW_NICRXDSC Number of valid received
packets discarded. May be
discarded due to buffer
overflow, for example.
76 4C Unsigned 4 IODVSW_NICRXERR Number of received packets
discarded due to invalid
format.
80 50 Character 8 IODVSW_VQSCTTOD TOD clock when this VSWITCH
was activated.
88 58 Unsigned 4 IODVSW_SIGWRITE Number of write signals
issued for device.
92 5C Unsigned 4 IODVSW_SIGREAD Number of read signals issued
for device.
96 60 Unsigned 4 IODVSW_SIGSYNC Number of sync signals issued
for device.
100 64 Unsigned 4 IODVSW_ACTIVATE Number of times this device
was activated for data
transfer.
104 68 Unsigned 4 IODVSW_PCIRCVD Total number of PCI
interrupts received from the
adapter.
108 6C Unsigned 4 IODVSW_PCIPROC Number of PCI interrupts that
resulted in input queue
processing.
112 70 Unsigned 4 IODVSW_VQSIQBFC Number of INPUT buffers
processed.
116 74 Unsigned 4 IODVSW_VQSIQOVR Number of INPUT queue
overflows.
120 78 Unsigned 4 IODVSW_VQSOQBFC Number of OUTPUT buffers
processed.
124 7C Unsigned 4 IODVSW_VQSOQOVR Number of OUTPUT queue
overflows.
128 80 Unsigned 4 IODVSW_VQSIQADV Number of extra INPUT buffers
maintained.
132 84 Unsigned 4 IODVSW_LANTRID Count of active trace ids
136 88 Unsigned 4 IODVSW_LANSUSR Count of users in Linux
Sniffer mode
140 8C Character 0 IODVSW_END
MRIODVSW Cross Reference
Hex Hex
Name Offset Length Value
IODVSW 0 140
IODVSW_ACTIVATE 64 4
IODVSW_END 8C 0
IODVSW_LANFSV 1A 1
IODVSW_LANIPTO 1C 2
IODVSW_LANRDD_OSAPORTN 1E 1
IODVSW_LANSUSR 88 4
IODVSW_LANTRID 84 4
IODVSW_MRHDR 0 0
IODVSW_NICRXBYT 30 8
IODVSW_NICRXBYTHI 30 4
IODVSW_NICRXBYTLO 34 4
IODVSW_NICRXDSC 48 4
IODVSW_NICRXERR 4C 4
IODVSW_NICRXPKT 44 4
IODVSW_NICTXBYT 28 8
IODVSW_NICTXBYTHI 28 4
IODVSW_NICTXBYTLO 2C 4
IODVSW_NICTXDSC 3C 4
IODVSW_NICTXERR 40 4
IODVSW_NICTXPKT 38 4
IODVSW_PCIPROC 6C 4
IODVSW_PCIRCVD 68 4
IODVSW_RDEVDEV 18 2
IODVSW_RDEVSID 14 4
IODVSW_SIGREAD 5C 4
IODVSW_SIGSYNC 60 4
IODVSW_SIGWRITE 58 4
IODVSW_VMDUSER 20 8
IODVSW_VQSCTTOD 50 8
IODVSW_VQSIQADV 80 4
IODVSW_VQSIQBFC 70 4
IODVSW_VQSIQOVR 74 4
IODVSW_VQSOQBFC 78 4
IODVSW_VQSOQOVR 7C 4
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
This information is
based on z/VM V5R2.0.
Last updated on 11 Jul 2008 at 08:45:29.
Copyright IBM Corporation, 1990, 2008