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