Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODVSW
PrologControl 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