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