Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRIODVSW

Prolog
Control 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