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

#### MRIODBPS

Prolog
Control Block Contents
Cross Reference

#### MRIODBPS Prolog

     DSECT NAME - IODBPS
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODBPS
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 6 - I/O Domain
                        Record 35 - Virtual Switch Bridge Port Activity
     DESCRIPTION - Describes I/O activities for a virtual switch's
                   bridge port connection.
     NOTES -       This record is collected for the DATA device
                   associated with a HiperSockets device in use
                   by a virtual switch as a bridge port. When a
                   HiperSockets bridge is defined for a virtual
                   switch with the VSWITCH BRIDGEPORT RDEV
                   operand, it specifies the first of three
                   sequential device addresses. One of those
                   devices is designated as the DATA device.
                   Use the "Bridge Port:" section of the QUERY
                   VSWITCH DETAILS display to find the value of
                   the DATA device.
                   Device sampling should specify the value of
                   the DATA device to obtain information about
                   virtual switch bridge port data transfer.

#### MRIODBPS Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   336  IODBPS                 Start of monitor record
       0   0  Character     0  IODBPS_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  IODBPS_RDEVSID         Host subchannel id
      24  18  Unsigned      2  IODBPS_RDEVDEV         Device number
      26  1A  Unsigned      1  IODBPS_LANFSV          Queuestorage value (1-8)
      27  1B  Bitstring     1  IODBPS_LANFORW         LAN Forwarding flags
              1... ....        IODBPS_LANISOL          Isolation ON (drop)
              .1.. ....        IODBPS_LANVEPA          VEPA ON
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      28  1C  Unsigned      2  IODBPS_LANIPTO         IPTimeout value in number
                                                      of 30 second tics. Range
                                                      2-240
      30  1E  Character     1  IODBPS_BPBROLE         Configured Bridge Port Role
                                                      Primary   = 4
                                                      Secondary = 8
      31  1F  Bitstring     1  IODBPS_LANCFLG3        Access List Type Flag
              1... ....        *
              .1.. ....        *
              ..1. ....        LANPORTB                PORT BASED Vswitch
              ...1 ....        LANUSERB                USER BASED Vswitch
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      32  20  Character     8  IODBPS_VMDUSER         Name of the TCP/IP virtual
                                                      machine acting as the vswitch
                                                      controller.
      40  28  Character     8  IODBPS_NICTXBYT        Total Bytes Sent out across
                                                      the real device connected to
                                                      a virtual switch.
      40  28  Character     4  IODBPS_NICTXBYTHI
      44  2C  Character     4  IODBPS_NICTXBYTLO
      48  30  Character     8  IODBPS_NICRXBYT        Total Bytes Received from
                                                      the real device connected to
                                                      a virtual switch.
      48  30  Character     4  IODBPS_NICRXBYTHI
      52  34  Character     4  IODBPS_NICRXBYTLO
      56  38  Character     8  IODBPS_VQSCTTOD        TOD clock when this VSWITCH
                                                      was activated.
      64  40  Unsigned      4  IODBPS_RDEVVSSW        Number of write signals
                                                      issued for device.
      68  44  Unsigned      4  IODBPS_RDEVVSSR        Number of read signals
                                                      issued for device.
      72  48  Unsigned      4  IODBPS_RDEVVSSS        Number of sync signals
                                                      issued for device.
      76  4C  Unsigned      4  IODBPS_RDEVVSAQ        Number of times this device
                                                      was activated for data
                                                      transfer.
      80  50  Unsigned      4  IODBPS_RDEVVSIN        Total number of PCI
                                                      interrupts received from the
                                                      adapter.
      84  54  Unsigned      4  IODBPS_RDEVVSIR        Number of PCI interrupts
                                                      that resulted in input queue
                                                      processing.
      88  58  Unsigned      4  IODBPS_VQSIQBFC        Number of INPUT buffers
                                                      processed.
      92  5C  Unsigned      4  IODBPS_VQSIQOVR        Number of INPUT queue
                                                      overflows.
      96  60  Unsigned      4  IODBPS_VQQOQBFC        Total number of OUTPUT
                                                      buffers processed.
     100  64  Unsigned      4  IODBPS_VQQOQOVR        Total number of OUTPUT
                                                      queue overflows.
     104  68  Unsigned      4  IODBPS_VQSIQADV        Number of extra INPUT
                                                      buffers maintained.
     108  6C  Unsigned      4  IODBPS_LANTRID         Count of active trace ids
     112  70  Unsigned      4  IODBPS_LANSUSR         Count of users in Linux
                                                      Sniffer mode
     116  74  Unsigned      4  IODBPS_LANMGIPA        LAN Management IP address
     120  78  Character     8  IODBPS_MGSWIEUSER      LAN Management User ID
     128  80  Character     6  IODBPS_MGNICMAC        VSWITCH MAC address
     134  86  Character     2  *                      Reserved for IBM use
     136  88  Character     6  *                      Reserved
     142  8E  Character     1  IODBPS_NICTRANP        Session Layer(2 or 3)
     143  8F  Bitstring     1  IODBPS_BPBLFAGS        Bridge Port Flags
              1... ....        IODBPS_BPBHLGPC         NIC Distribution ON
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     144  90  Character    16  IODBPS_LANID           LAN ID (owner||name)
     160  A0  Character     8  IODBPS_LOCKREQS        Lock requests for network
                                                      lock (LANLKWRD)
     160  A0  Character     4  IODBPS_LOCKREQHI
     164  A4  Character     4  IODBPS_LOCKREQLO
     168  A8  Character     8  IODBPS_LANDEFER        Number of times we had to
                                                      wait for the network lock
                                                      (LANLKWRD)
     168  A8  Character     4  IODBPS_LANDEFERHI
     172  AC  Character     4  IODBPS_LANDEFERLO
     176  B0  Character     8  IODBPS_TXDEFERS        Number of times we had to
                                                      wait for a lock when sending
                                                      data from this port
     176  B0  Character     4  IODBPS_TXDEFERSHI
     180  B4  Character     4  IODBPS_TXDEFERSLO
     184  B8  Character     8  IODBPS_RXDEFERS        Number of times we had to
                                                      wait for a lock when
                                                      receiving data on this port
     184  B8  Character     4  IODBPS_RXDEFERSHI
     188  BC  Character     4  IODBPS_RXDEFERSLO
     192  C0  Character     8  IODBPS_NICTXPKT64      Number of packets sent
                                                      across the real device
                                                      connected to a virtual
                                                      switch.
     192  C0  Character     4  IODBPS_NICTXPKTHI
     196  C4  Character     4  IODBPS_NICTXPKTLO
     200  C8  Character     8  IODBPS_NICTXDSC64      Number of valid outbound
                                                      packets discarded. May be
                                                      discarded due to buffer
                                                      overflow, for example.
     200  C8  Character     4  IODBPS_NICTXDSCHI
     204  CC  Character     4  IODBPS_NICTXDSCLO
     208  D0  Character     8  IODBPS_NICTXERR64      Number of invalid outbound
                                                      packets discarded.
     208  D0  Character     4  IODBPS_NICTXERRHI
     212  D4  Character     4  IODBPS_NICTXERRLO
     216  D8  Character     8  IODBPS_NICRXPKT64      Number of packets received
                                                      on the real device connected
                                                      to a virtual switch.
     216  D8  Character     4  IODBPS_NICRXPKTHI
     220  DC  Character     4  IODBPS_NICRXPKTLO
     224  E0  Character     8  IODBPS_NICRXDSC64      Number of valid received
                                                      packets discarded. May be
                                                      discarded due to buffr
                                                      overflow for example.
     224  E0  Character     4  IODBPS_NICRXDSCHI
     228  E4  Character     4  IODBPS_NICRXDSCLO
     232  E8  Character     8  IODBPS_NICRXERR64      Number of received packets
                                                      discarded due to invalid
                                                      format
     232  E8  Character     4  IODBPS_NICRXERRHI
     236  EC  Character     4  IODBPS_NICRXERRLO
     240  F0  Character     8  *                      Reserved.
     248  F8  Character     4  IODBPS_VQSOMLVL        RDEV maintenance level
     252  FC  Unsigned      2  *                      Reserved.
     254  FE  Character     6  IODBPS_VQSDVMAC        Device virtual MAC address
     260 104  Unsigned      4  IODBPS_VQSMRKCT        Number of Marker PDUs sent
                                                      to this port
     264 108  Unsigned      4  IODBPS_VQSMRPCT        Number of Marker responses
                                                      received
     268 10C  Unsigned      4  IODBPS_VQSMRRCT        Number of Marker responses
                                                      PDUs sent to this port in
                                                      response to receiving a
                                                      marker PDU from the partner
                                                      port
     272 110  Unsigned      4  IODBPS_VQSMTOCT        Number of times timed out
                                                      waiting for Marker response
                                                      PDU for a Marker request sent
                                                      by CP to partner port
     276 114  Unsigned      4  IODBPS_VQSLCSCT        Number of LACP PDUs sent on
                                                      this port
     280 118  Unsigned      4  IODBPS_VQSLCRCT        Number of LACP PDUs
                                                      received on this port
     284 11C  Character     8  IODBPS_TXREQS          Lock requests made when
                                                      sending data from this port
     284 11C  Character     4  IODBPS_TXREQSHI
     288 120  Character     4  IODBPS_TXREQSLO
     292 124  Character     8  IODBPS_RXREQS          Lock requests made while
                                                      receiving data on this port
     292 124  Character     4  IODBPS_RXREQSHI
     296 128  Character     4  IODBPS_RXREQSLO
     300 12C  Character     8  IODBPS_STKREQS         Requests made to stack or
                                                      unstack work on this port
     300 12C  Character     4  IODBPS_STKREQHI
     304 130  Character     4  IODBPS_STKREQLO
     308 134  Character     8  IODBPS_STKDEFERS       Number of times it took
                                                      multiple attempts to stack
                                                      work on this port
     308 134  Character     4  IODBPS_STKDEFERSHI
     312 138  Character     4  IODBPS_STKDEFERSLO
     316 13C  Character     1  IODBPS_BPBSTATE        Current Bridge Port State 0
                                                      = BPBPUNDF, undefined 4 =
                                                      BPBPINAC, inactive 8 =
                                                      BPBPSTBY, standby 12 =
                                                      BPBPACTV, active
     317 13D  Character     1  IODBPS_BPBMFS          CHPID Configured MFS Size
                                                        0 = BPBMFS16, 16K
                                                        4 = BPBMFS24, 24K
                                                        8 = BPBMFS40, 40K
                                                       12 = BPBMFS64, 64K
                                                      252 = BPBMFSUN, Unknown
     318 13E  Character     1  IODBPS_BPBCTSTA        The state of the bridge
                                                      port connection. 1 = Vswitch
                                                      defined 2 = Controller not
                                                      available 3 = Operator
                                                      intervention required 4 =
                                                      Disconnected 5 = VDEVs
                                                      attached to controller 6 =
                                                      Initialization in progress 7
                                                      = Device not ready 8 = Device
                                                      ready 9 = Devices being
                                                      detached 10 = VSWITCH delete
                                                      pending 11 = VSWITCH failover
                                                      recovering 12 = Autorestart
                                                      in progress
     319 13F  Character     1  *                      Reserved.
     320 140  Unsigned      4  IODBPS_BPBACNT         Cardinal count of the
                                                      number of configured buffers
                                                      currently in use.
                                                      (unsigned-32)
     324 144  Character     8  IODBPS_BPBAOWNER       When BPBSTATE is Active or
                                                      Standby, the LPAR name acting
                                                      as the active Bridge Port
                                                      connection. Blanks otherwise.
     332 14C  Unsigned      4  IODBPS_BPBABUFS        Count of the maximum number
                                                      of asynchronous buffers
                                                      allowed.
     336 150  Character     0  IODBPS_END

#### MRIODBPS Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODBPS                     0    336
    IODBPS_BPBABUFS          14C      4
    IODBPS_BPBACNT           140      4
    IODBPS_BPBAOWNER         144      8
    IODBPS_BPBCTSTA          13E      1
    IODBPS_BPBFLAGS           8F      1
    IODBPS_BPBHLGPC           8F           80
    IODBPS_BPBMFS            13D      1
    IODBPS_BPBROLE            1E      1
    IODBPS_BPBSTATE          13C      1
    IODBPS_END               150      0
    IODBPS_LANCFLG3           1F      1
    IODBPS_LANDEFER           A8      8
    IODBPS_LANDEFERHI         A8      4
    IODBPS_LANDEFERLO         AC      4
    IODBPS_LANFORW            1B      1
    IODBPS_LANFSV             1A      1
    IODBPS_LANID              90     16
    IODBPS_LANIPTO            1C      2
    IODBPS_LANISOL            1B           80
    IODBPS_LANMGIPA           74      4
    IODBPS_LANSUSR            70      4
    IODBPS_LANTRID            6C      4
    IODBPS_LANVEPA            1B           40
    IODBPS_LOCKREQHI          A0      4
    IODBPS_LOCKREQLO          A4      4
    IODBPS_LOCKREQS           A0      8
    IODBPS_MGNICMAC           80      6
    IODBPS_MGSWIEUSER         78      8
    IODBPS_MRHDR               0      0
    IODBPS_NICRXBYT           30      8
    IODBPS_NICRXBYTHI         30      4
    IODBPS_NICRXBYTLO         34      4
    IODBPS_NICRXDSCHI         E0      4
    IODBPS_NICRXDSCLO         E4      4
    IODBPS_NICRXDSC64         E0      8
    IODBPS_NICRXERRHI         E8      4
    IODBPS_NICRXERRLO         EC      4
    IODBPS_NICRXERR64         E8      8
    IODBPS_NICRXPKTHI         D8      4
    IODBPS_NICRXPKTLO         DC      4
    IODBPS_NICRXPKT64         D8      8
    IODBPS_NICTRANP           8E      1
    IODBPS_NICTXBYT           28      8
    IODBPS_NICTXBYTHI         28      4
    IODBPS_NICTXBYTLO         2C      4
    IODBPS_NICTXDSCHI         C8      4
    IODBPS_NICTXDSCLO         CC      4
    IODBPS_NICTXDSC64         C8      8
    IODBPS_NICTXERRHI         D0      4
    IODBPS_NICTXERRLO         D4      4
    IODBPS_NICTXERR64         D0      8
    IODBPS_NICTXPKTHI         C0      4
    IODBPS_NICTXPKTLO         C4      4
    IODBPS_NICTXPKT64         C0      8
    IODBPS_RDEVDEV            18      2
    IODBPS_RDEVSID            14      4
    IODBPS_RDEVVSAQ           4C      4
    IODBPS_RDEVVSIN           50      4
    IODBPS_RDEVVSIR           54      4
    IODBPS_RDEVVSSR           44      4
    IODBPS_RDEVVSSS           48      4
    IODBPS_RDEVVSSW           40      4
    IODBPS_RXDEFERS           B8      8
    IODBPS_RXDEFERSHI         B8      4
    IODBPS_RXDEFERSLO         BC      4
    IODBPS_RXREQS            124      8
    IODBPS_RXREQSHI          124      4
    IODBPS_RXREQSLO          128      4
    IODBPS_STKDEFERS         134      8
    IODBPS_STKDEFERSHI       134      4
    IODBPS_STKDEFERSLO       138      4
    IODBPS_STKREQHI          12C      4
    IODBPS_STKREQLO          130      4
    IODBPS_STKREQS           12C      8
    IODBPS_TXDEFERS           B0      8
    IODBPS_TXDEFERSHI         B0      4
    IODBPS_TXDEFERSLO         B4      4
    IODBPS_TXREQS            11C      8
    IODBPS_TXREQSHI          11C      4
    IODBPS_TXREQSLO          120      4
    IODBPS_VMDUSER            20      8
    IODBPS_VQQOQBFC           60      4
    IODBPS_VQQOQOVR           64      4
    IODBPS_VQSCTTOD           38      8
    IODBPS_VQSDVMAC           FE      6
    IODBPS_VQSIQADV           68      4
    IODBPS_VQSIQBFC           58      4
    IODBPS_VQSIQOVR           5C      4
    IODBPS_VQSLCRCT          118      4
    IODBPS_VQSLCSCT          114      4
    IODBPS_VQSMRKCT          104      4
    IODBPS_VQSMRPCT          108      4
    IODBPS_VQSMRRCT          10C      4
    IODBPS_VQSMTOCT          110      4
    IODBPS_VQSOMLVL           F8      4
    LANPORTB                  1F           20
    LANUSERB                  1F           10
    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 V7R2.0.

    Last updated on 13 December 2021 at 09:22:17.

    Copyright IBM Corporation, 1990, 2021