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.
                   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  340  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  Bitstring    1  IODVSW_LANISOL         LAN Isolation flag
              1... ....      IODVSW_LANDROP         Isolation ON (drop)
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     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        31-bit counter only. please
                                                    refer to IODVSW_NICTXPKT64
     60  3C  Unsigned     4  IODVSW_NICTXDSC        31-bit counter only. please
                                                    refer to IODVSW_NICTXDSC64
     64  40  Unsigned     4  IODVSW_NICTXERR        31-bit counter only. please
                                                    refer to IODVSW_NICTXERR64
     68  44  Unsigned     4  IODVSW_NICRXPKT        31-bit counter only. please
                                                    refer to IODVSW_NICRXPKT64
     72  48  Unsigned     4  IODVSW_NICRXDSC        31-bit counter only. please
                                                    refer to IODVSW_NICRXDSC64
     76  4C  Unsigned     4  IODVSW_NICRXERR        31-bit counter only. please
                                                    refer to IODVSW_NICRXERR64
     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  Unsigned     4  IODVSW_LANMGIPA        LAN Management IP address
    144  90  Character    8  IODVSW_MGSWIEUSER      LAN Management User ID
    152  98  Character    6  IODVSW_MGNICMAC        VSWITCH MAC address
    158  9E  Character    2  *                      Reserved
    160  A0  Character    6  IODVSW_OSAMAC          OSA device MAC addr
    166  A6  Character    1  IODVSW_NICTRANP        Session Layer(2 or 3)
    167  A7  Character    1  *
    168  A8  Character   16  IODVSW_LANID           LAN ID (owner||name)
    184  B8  Character    8  IODVSW_LOCKREQS        Lock requests for network
                                                    lock (LANLKWRD)
    184  B8  Character    4  IODVSW_LOCKREQHI
    188  BC  Character    4  IODVSW_LOCKREQLO
    192  C0  Character    8  IODVSW_LANDEFER        Number of times we had to
                                                    wait for the network lock
                                                    (LANLKWRD)
    192  C0  Character    4  IODVSW_LANDEFERHI
    196  C4  Character    4  IODVSW_LANDEFERLO
    200  C8  Character    8  IODVSW_TXDEFERS        Number of times we had to
                                                    wait for a lock when sending
                                                    data from this port
    200  C8  Character    4  IODVSW_TXDEFERSHI
    204  CC  Character    4  IODVSW_TXDEFERSLO
    208  D0  Character    8  IODVSW_RXDEFERS        Number of times we had to
                                                    wait for a lock when receiving
                                                    data on this port
    208  D0  Character    4  IODVSW_RXDEFERSHI
    212  D4  Character    4  IODVSW_RXDEFERSLO
    216  D8  Character    8  IODVSW_NICTXPKT64      Number of packets sent across
                                                    the real device connected to a
                                                    virtual switch.
    216  D8  Character    4  IODVSW_NICTXPKTHI
    220  DC  Character    4  IODVSW_NICTXPKTLO
    224  E0  Character    8  IODVSW_NICTXDSC64      Number of valid outbound
                                                    packets discarded. May be
                                                    discarded due to buffer
                                                    overflow, for example.
    224  E0  Character    4  IODVSW_NICTXDSCHI
    228  E4  Character    4  IODVSW_NICTXDSCLO
    232  E8  Character    8  IODVSW_NICTXERR64      Number of invalid outbound
                                                    packets discarded.
    232  E8  Character    4  IODVSW_NICTXERRHI
    236  EC  Character    4  IODVSW_NICTXERRLO
    240  F0  Character    8  IODVSW_NICRXPKT64      Number of packets received on
                                                    the real device connected to a
                                                    virtual switch.
    240  F0  Character    4  IODVSW_NICRXPKTHI
    244  F4  Character    4  IODVSW_NICRXPKTLO
    248  F8  Character    8  IODVSW_NICRXDSC64      Number of valid received
                                                    packets discarded. May be
                                                    discarded due to buffr overflow
                                                    for example.
    248  F8  Character    4  IODVSW_NICRXDSCHI
    252  FC  Character    4  IODVSW_NICRXDSCLO
    256 100  Character    8  IODVSW_NICRXERR64      Number of received packets
                                                    discarded due to invalid format
    256 100  Character    4  IODVSW_NICRXERRHI
    260 104  Character    4  IODVSW_NICRXERRLO
    264 108  Character    8  IODVSW_SWPGROUP        Name of the Link Agg port
                                                    group in use for virtual switch
    272 110  Character    4  IODVSW_VQSOMLVL        OSA device microcode level
    276 114  Unsigned     2  IODVSW_SWPINTSC        Number of seconds be- tween
                                                    load balancing operations
    278 116  Character    6  IODVSW_VQSDVMAC        OSA device virtual MAC
                                                    address
    284 11C  Unsigned     4  IODVSW_VQSMRKCT        Number of Marker PDUs sent to
                                                    this port
    288 120  Unsigned     4  IODVSW_VQSMRPCT        Number of Marker responses
                                                    received
    292 124  Unsigned     4  IODVSW_VQSMRRCT        Number of Marker responses
                                                    PDUs sent to this port in
                                                    response to receiving a marker
                                                    PDU from the partner port
    296 128  Unsigned     4  IODVSW_VQSMTOCT        Number of times timed out
                                                    waiting for Marker response PDU
                                                    for a Marker request sent by CP
                                                    to partner port
    300 12C  Unsigned     4  IODVSW_VQSLCSCT        Number of LACP PDUs sent on
                                                    this port
    304 130  Unsigned     4  IODVSW_VQSLCRCT        Number of LACP PDUs received
                                                    on this port
    308 134  Character    8  IODVSW_TXREQS          Lock requests made when
                                                    sending data from this port
    308 134  Character    4  IODVSW_TXREQSHI
    312 138  Character    4  IODVSW_TXREQSLO
    316 13C  Character    8  IODVSW_RXREQS          Lock requests made while
                                                    receiving data on this port
    316 13C  Character    4  IODVSW_RXREQSHI
    320 140  Character    4  IODVSW_RXREQSLO
    324 144  Character    8  IODVSW_STKREQS         Requests made to stack or
                                                    unstack work on this port
    324 144  Character    4  IODVSW_STKREQHI
    328 148  Character    4  IODVSW_STKREQLO
    332 14C  Character    8  IODVSW_STKDEFERS       Number of times it took
                                                    multiple attempts to stack work
                                                    on this port
    332 14C  Character    4  IODVSW_STKDEFERSHI
    336 150  Character    4  IODVSW_STKDEFERSLO
    340 154  Character    0  IODVSW_END

    MRIODVSW Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODVSW                     0    340
    IODVSW_ACTIVATE           64      4
    IODVSW_END               154      0
    IODVSW_LANDEFER           C0      8
    IODVSW_LANDEFERHI         C0      4
    IODVSW_LANDEFERLO         C4      4
    IODVSW_LANDROP            1B           80
    IODVSW_LANFSV             1A      1
    IODVSW_LANID              A8     16
    IODVSW_LANIPTO            1C      2
    IODVSW_LANISOL            1B      1
    IODVSW_LANMGIPA           8C      4
    IODVSW_LANRDD_OSAPORTN    1E      1
    IODVSW_LANSUSR            88      4
    IODVSW_LANTRID            84      4
    IODVSW_LOCKREQHI          B8      4
    IODVSW_LOCKREQLO          BC      4
    IODVSW_LOCKREQS           B8      8
    IODVSW_MGNICMAC           98      6
    IODVSW_MGSWIEUSER         90      8
    IODVSW_MRHDR               0      0
    IODVSW_NICRXBYT           30      8
    IODVSW_NICRXBYTHI         30      4
    IODVSW_NICRXBYTLO         34      4
    IODVSW_NICRXDSC           48      4
    IODVSW_NICRXDSCHI         F8      4
    IODVSW_NICRXDSCLO         FC      4
    IODVSW_NICRXDSC64         F8      8
    IODVSW_NICRXERR           4C      4
    IODVSW_NICRXERRHI        100      4
    IODVSW_NICRXERRLO        104      4
    IODVSW_NICRXERR64        100      8
    IODVSW_NICRXPKT           44      4
    IODVSW_NICRXPKTHI         F0      4
    IODVSW_NICRXPKTLO         F4      4
    IODVSW_NICRXPKT64         F0      8
    IODVSW_NICTRANP           A6      1
    IODVSW_NICTXBYT           28      8
    IODVSW_NICTXBYTHI         28      4
    IODVSW_NICTXBYTLO         2C      4
    IODVSW_NICTXDSC           3C      4
    IODVSW_NICTXDSCHI         E0      4
    IODVSW_NICTXDSCLO         E4      4
    IODVSW_NICTXDSC64         E0      8
    IODVSW_NICTXERR           40      4
    IODVSW_NICTXERRHI         E8      4
    IODVSW_NICTXERRLO         EC      4
    IODVSW_NICTXERR64         E8      8
    IODVSW_NICTXPKT           38      4
    IODVSW_NICTXPKTHI         D8      4
    IODVSW_NICTXPKTLO         DC      4
    IODVSW_NICTXPKT64         D8      8
    IODVSW_OSAMAC             A0      6
    IODVSW_PCIPROC            6C      4
    IODVSW_PCIRCVD            68      4
    IODVSW_RDEVDEV            18      2
    IODVSW_RDEVSID            14      4
    IODVSW_RXDEFERS           D0      8
    IODVSW_RXDEFERSHI         D0      4
    IODVSW_RXDEFERSLO         D4      4
    IODVSW_RXREQS            13C      8
    IODVSW_RXREQSHI          13C      4
    IODVSW_RXREQSLO          140      4
    IODVSW_SIGREAD            5C      4
    IODVSW_SIGSYNC            60      4
    IODVSW_SIGWRITE           58      4
    IODVSW_STKDEFERS         14C      8
    IODVSW_STKDEFERSHI       14C      4
    IODVSW_STKDEFERSLO       150      4
    IODVSW_STKREQHI          144      4
    IODVSW_STKREQLO          148      4
    IODVSW_STKREQS           144      8
    IODVSW_SWPGROUP          108      8
    IODVSW_SWPINTSC          114      2
    IODVSW_TXDEFERS           C8      8
    IODVSW_TXDEFERSHI         C8      4
    IODVSW_TXDEFERSLO         CC      4
    IODVSW_TXREQS            134      8
    IODVSW_TXREQSHI          134      4
    IODVSW_TXREQSLO          138      4
    IODVSW_VMDUSER            20      8
    IODVSW_VQSCTTOD           50      8
    IODVSW_VQSDVMAC          116      6
    IODVSW_VQSIQADV           80      4
    IODVSW_VQSIQBFC           70      4
    IODVSW_VQSIQOVR           74      4
    IODVSW_VQSLCRCT          130      4
    IODVSW_VQSLCSCT          12C      4
    IODVSW_VQSMRKCT          11C      4
    IODVSW_VQSMRPCT          120      4
    IODVSW_VQSMRRCT          124      4
    IODVSW_VQSMTOCT          128      4
    IODVSW_VQSOMLVL          110      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 V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009