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

MRIODVSE

Prolog
Control Block Contents
Cross Reference

MRIODVSE Prolog

 DSECT NAME - IODVSE
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRIODVSE
 DESCRIPTIVE NAME - Monitor Sample Record
                    Domain 6  - I/O Domain
                    Record 54 - Virtual Switch EQDIO Queues
 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 VSWITCH EQDIO queues.
           The IODVSE_QueueData section will contain an entry
           for each defined queue pertaining to this VSwitch.
           Each entry is identified by the IODVSE_QID.
 

MRIODVSE Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   172+ IODVSE                 Start of monitor record
   0   0  Character     0  IODVSE_MRHDR           Record header. See MRRECHDR
                                                  for details.
   0   0  Character    20  MRHDR
   0   0  Unsigned      2  MRHDRLEN
   2   2  Unsigned      2  MRHDRZER
   4   4  Unsigned      1  MRHDRDM
   5   5  Unsigned      1  *
   6   6  Unsigned      2  MRHDRRC
   8   8  Character     8  MRHDRTOD
  16  10  Character     4  *
  20  14  Character     0  MRHDR_END
  20  14  Unsigned      4  IODVSE_NumQueues_Record nbr of queues
                                                  in record.
  24  18  Unsigned      2  IODVSE_CALENTSZ        The size (in bytes) of
                                                  each IODVSE_QueueData entry.
  26  1A  Unsigned      2  IODVSE_CALENTDSP       The displacement (in
                                                  bytes) from the beginning of this
                                                  record to the first IODVSE_QueueData
                                                  entry. The entries are consecutive
                                                  storage starting with the first at
                                                  at this displacement.
  28  1C  Unsigned      4  IODVSE_RDEVSID
  32  20  Unsigned      2  IODVSE_RDEVDEV
  34  22  Unsigned      1  IODVSE_DQRXCOUNT       Number of input data
                                                  queues.
  35  23  Unsigned      1  IODVSE_DQTXCOUNT       Number of output data
                                                  queues.
  36  24  Unsigned      8  IODVSE_CALCTRLTXPKT    TX Packets
  48  30  Unsigned      8  IODVSE_CALCTRLTXBYT    TX Bytes
  52  34  Unsigned      8  IODVSE_CALCTRLTXDSC    Discarded Packets
  60  3C  Unsigned      8  IODVSE_CALCTRLTXERR    Error Packets
 
  68  44  Unsigned      8  IODVSE_CALCTRLRXPKT    TX Packets
  76  4C  Unsigned      8  IODVSE_CALCTRLRXBYT    TX Bytes
  84  54  Unsigned      8  IODVSE_CALCTRLRXDSC    Discarded Packets
  92  5C  Unsigned      8  IODVSE_CALCTRLRXERR    Error Packets
 
 100  64  Unsigned      8  IODVSE_CALDATATXPKT    TX Packets
 108  6C  Unsigned      8  IODVSE_CALDATATXBYT    TX Bytes
 116  74  Unsigned      8  IODVSE_CALDATATXDSC    Discarded Packets
 124  7C  Unsigned      8  IODVSE_CALDATATXERR    Error Packets
 
 132  84  Unsigned      8  IODVSE_CALDATARXPKT    TX Packets
 140  8C  Unsigned      8  IODVSE_CALDATARXBYT    TX Bytes
 148  94  Unsigned      8  IODVSE_CALDATARXDSC    Discarded Packets
 156  9C  Unsigned      8  IODVSE_CALDATARXERR    Error Packets
 164  A4  Unsigned      4  *                      Reserved for IBM use
 168  A8  Unsigned      2  *                      Reserved for IBM use
 170  AA  Unsigned      1  *                      Reserved for IBM use
 171  AB  Bitstring     1  *                      Reserved for IBM use
          1... ....        IODVSE_C               Record continuation identifier
                                                  identifier. Set when there are
                                                  more records, off in the last
                                                  record.
          .1.. ....        *
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 172  AC  Character     0  IODVSE_CALENTS         Start of the array
                                                  for Queues.

Start of the Queue's information. QID describes which queue's data is being recorded.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 144 IODVSE_QueueData 0 0 Unsigned 1 IODVSE_QID Q Identifier 0-31 1 1 Bitstring 1 IODVSE_QI1TYPE 1... .... IODVSE_QI1OUTQ Output Queue=1 Input Queue=0 .1.. .... IODVSE_QI1CPIN Control Plane Input Queue identifier. Set when there are more records, off in the last record. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 IODVSE_QI1DPIN Data Plane Input Queue 2 2 Unsigned 2 * Reserved for IBM use 4 4 Unsigned 4 * Reserved for IBM use 8 8 Unsigned 8 IODVSE_VQQCPTKT TX/RX Packets 16 10 Unsigned 8 IODVSE_VQQCPBYT TX/RX Bytes 24 18 Unsigned 8 IODVSE_VQQCPDSC Discarded Packets 32 20 Unsigned 8 IODVSE_VQQCPERR Error Packets 40 28 Unsigned 8 IODVSE_VQQCTPK0 Short (in<=128) pkts 48 30 Unsigned 8 IODVSE_VQQCTPK1 Medum (in<=900) pkts 56 38 Unsigned 8 IODVSE_VQQCTPK2 Large (in<=2500) pkts 64 40 Unsigned 8 IODVSE_VQQCTPK3 Jumbo (in>1500) pkts 72 48 Unsigned 8 IODVSE_VQQCTUNI Unicast packets 80 50 Unsigned 8 IODVSE_VQQCTMCP Multicast packets 88 58 Unsigned 8 IODVSE_VQQCTBCP Broadcast packets 96 60 Unsigned 4 IODVSE_VQQSBMIN Min pages to prepare 100 64 Unsigned 4 IODVSE_VQQSBMAX Max pages to prepare 104 68 Unsigned 4 IODVSE_VQQSBCUR Current pages ready 108 6C Unsigned 4 IODVSE_VQQSBPRF Preferred pages 112 70 Unsigned 8 IODVSE_VQQSBTOD VQQSBPRF update TOD 120 78 Unsigned 4 IODVSE_VQQSBPIX Next SBPE to reclaim 124 7C Unsigned 4 IODVSE_VQQPEPIX Next SBPE to extract 128 80 Unsigned 8 IODVSE_vqqStallDetected Number of stalls detected. 136 88 Unsigned 8 IODVSE_vqqFISSet Number of times "Force Initiative state" set 144 92 Character 0 * End

MRIODVSE Cross Reference

                      Hex           Hex
Name                  Offset Length Value
 
IODVSE                     0    172+
IODVSE_C                  AB          80
IODVSE_CALCTRLRXBYT       4C      8
IODVSE_CALCTRLRXDSC       54      8
IODVSE_CALCTRLRXERR       5C      8
IODVSE_CALCTRLRXPKT       44      8
IODVSE_CALCTRLTXBYT       2C      8
IODVSE_CALCTRLTXDSC       34      8
IODVSE_CALCTRLTXERR       3C      8
IODVSE_CALCTRLTXPKT       24      8
IODVSE_CALDATARXBYT       8C      8
IODVSE_CALDATARXDSC       94      8
IODVSE_CALDATARXERR       9C      8
IODVSE_CALDATARXPKT       84      8
IODVSE_CALDATATXBYT       6C      8
IODVSE_CALDATATXDSC       74      8
IODVSE_CALDATATXERR       7C      8
IODVSE_CALDATATXPKT       64      8
IODVSE_CALENTDSP          1A      2
IODVSE_CALENTS            AC      0
IODVSE_CALENTSZ           18      2
IODVSE_DQRXCOUNT          22      1
IODVSE_DQTXCOUNT          23      1
IODVSE_MRHDR               0      0
IODVSE_NumQueues          14      4
IODVSE_QID                 0      1
IODVSE_QueueData           0    144
IODVSE_QI1CPIN             1         40
IODVSE_QI1DPIN             1         01
IODVSE_QI1OUTQ             1         80
IODVSE_QI1QTYPE            1      1
IODVSE_RDEVDEV            20      2
IODVSE_RDEVSID            1C      4
MRHDR                      0     20
MRHDR_END                 14      0
MRHDRDM                    4      1
MRHDRLEN                   0      2
MRHDRRC                    6      2
MRHDRTOD                   8      8
MRHDRZER                   2      2
IODVSE_VQQCTBCP           58      8
IODVSE_VQQCTBYT           10      8
IODVSE_VQQCTDSC           18      8
IODVSE_VQQCTERR           20      8
IODVSE_VQQCTMCP           50      8
IODVSE_VQQCTPKT            8      8
IODVSE_VQQCTPK0           28      8
IODVSE_VQQCTPK1           30      8
IODVSE_VQQCTPK2           38      8
IODVSE_VQQCTPK3           40      8
IODVSE_VQQCTUNI           48      8
IODVSE_VQQFISSET          88      8
IODVSE_VQQPEPIX           7C      4
IODVSE_VQQSBCUR           68      4
IODVSE_VQQSBMAX           64      4
IODVSE_VQQSBMIN           60      4
IODVSE_VQQSBPIX           78      4
IODVSE_VQQSBPRF           6C      4
IODVSE_VQQSBTOD           70      8
IODVSE_VQQSTALLDETECTED   80      80      8

This information is
based on z/VM V7R4.0.

Last updated on 12 May 2025 at 12:27:05.
Copyright IBM Corporation, 1990, 2025