|
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.
Device sampling should specify the value of
rdev+2 to obtain information about a virtual
switch's DATA device.
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 132 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 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 End of header
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 and available for IBM
use.
28 1C Unsigned 2 IODVSW_LANIPTO IPTimeout value in number of 30
second tics. Range 2-240
30 1E Unsigned 2 * Reserved and available for IBM
use.
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 Character 0 IODVSW_END
MRIODVSW Cross Reference
Hex Hex
Name Offset Length Value
IODVSW 0 132
IODVSW_ACTIVATE 64 4
IODVSW_END 84 0
IODVSW_LANFSV 1A 1
IODVSW_LANIPTO 1C 2
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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003