Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODPDS
PrologControl Block Contents
Cross Reference
MRIODPDS Prolog
DSECT NAME - IODPDS FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRIODPDS DESCRIPTIVE NAME - Monitor Event Record Domain 6 - I/O Domain Record 40 - Guest Disables a PCI Function DESCRIPTION - This record indicates when a guest disables a PCI function. NOTES: Anytime that a guest succesfully disables a PCI function, this record will be built to indicate that event occurring.
MRIODPDS Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 116+ IODPDS 0 0 Character 0 IODPDS_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 IODPDS_RPCIPFID Real PCI Function ID 24 18 Unsigned 4 IODPDS_VPCIPFID Virt PCI Function ID 28 1C Character 8 IODPDS_VMDUSER User Name of Function Owner 36 24 Unsigned 4 IODPDS_VPCIHNDG PCI General Handle 40 28 Bitstring 1 IODPDS_FLAGS General Flags 1... .... IODPDS_DSNOSUCC DISABLE not issued or it failed .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 41 29 Character 1 IODPDS_FMBFMT Determines the format of the variable PCI function data. When: 0 = IODPDS_FORM_0 1 = IODPDS_FORM_1 2 = IODPDS_FORM_2 2 = IODPDS_FORM_3 42 2A Character 2 * Reserved and available for IBM Use 44 2C Character 8 IODPDS_RPCIHPIN Unsigned 64-bit integer Cumulative count of host pages currently pinned. 52 34 Character 8 IODPDS_RPCIPCNT Count of shadow tables in use since last DMA register. Valid when DMA registered. (MTRPCI_VPCIEAS bit on). Reset to zero when operation unreg is successful(MRIODPMD is cut with IODPMD_DMAUNREG) 60 3C Character 8 IODPDS_VPCIRPCN Count of guest RDMA mapping requests 68 44 Unsigned 4 IODPDS_FMBSMPCT Cumulative sample count of the number of times the PCI-Function measurement block has been updated. This value may be wrapped. 72 48 Character 8 IODPDS_FMBTOD Time of last update where the resolution is identical to that of bits 0-62 of the TOD clock and is not necessarily synchronized with the TOD clock. Reset to zero when record MRIODPEN is cut (measurements ar enabled) and are no longer valid /useful when record MRIODPDS is cut (measurements are disabled). Can be used to calculate time elapsed (delta) since last measurements gatherd. 80 50 Character 8 IODPDS_FMBLGCNT Unsigned 64-bit integer Count of successful reads from the PCI function memory or configuration space during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and are no longer valid/useful when record MRIODPDS is cut (measurements are disabled). 88 58 Character 8 IODPDS_FMBSGCNT Unsigned 64-bit integer Count of successful writes to the PCI function memory or configuration space during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and are no longer valid/useful when record MRIODPDS is cut ( measurements are disabled). 96 60 Character 8 IODPDS_FMBSBCNT Unsigned 64-bit integer Count of successful block writes to the PCI function memory or configuration space during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and are no longer valid/useful when record MRIODPDS is cut ( measurements are disabled). 104 68 Character 8 IODPDS_FMBRPCNT Unsigned 64-bit integer Count of successful address-translation refreshes during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and are no longer valid/useful when record MRIODPDS is cut (measurements are disabled). 112 70 Unsigned 2 IODPDS_VAROFSET Offset within this record where the PCI function variable measurement data begins. 114 72 Unsigned 2 IODPDS_VARLEN Length of the PCI function variable measurement data. 116 74 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 0 0 Character 0 IODPDS_VAR_DATA Start of the PCI variable function data. To find the start of this data use IODPDS_VAROFSET. To find the length of this data use IODPDS_VARLEN.
Mapping of PCI function variable measurement data
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 16 IODPDS_FORM_0 Describes the fields in the Format 0 PCI function variable measurement data. 0 0 Character 8 IODPDS_FMBDRCNT Unsigned 64-bit integer Number of bytes transferred to the PCI function from main memory during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut ( measurements are enabled) and are no longer valid/useful when record MRIODPDS is cut ( measurements are disabled). 8 8 Character 8 IODPDS_FMBDWCNT Unsigned 64-bit integer Number of bytes transferred from the PCI function to main memory during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut ( measurements are enabled) and are no longer valid/useful when record MRIODPDS is cut ( measurements are disabled).
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 32 IODPDS_FORM_1 Describes the fields in the Format 1 PCI function variable measurement data. 0 0 Character 8 IODPDS_FMBRBCNT Unsigned 64-bit integer Number of bytes received on the external ethernet interface during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled). 8 8 Character 8 IODPDS_FMBRPKNT Unsigned 64-bit integer Number of packets received on the external ethernet interface during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled). 16 10 Character 8 IODPDS_FMBTBCNT Unsigned 64-bit integer Number of bytes transmitted on the external ethernet interface during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled). 24 18 Character 8 IODPDS_FMBTPCNT Unsigned 64-bit integer Number of packets transmitted on the external ethernet interface during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled).
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 16 IODPDS_FORM_2 Describes the fields in the Format 2 PCI function variable measurement data. 0 0 Character 8 IODPDS_FMBCWUCT Unsigned 64-bit integer Number of work units processed by the PCI function during the update interval. This value may be wrapped. Reset to zero when record MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled). 8 8 Character 8 IODPDS_FMBMWUCT Unsigned 64-bit integer The maximum number of work units that the PCI function is capable of processing per second. This value is static. Reset to zero when record MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled).
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 8 IODPDS_FORM_3 Describes the fields in the Format 3 PCI function variable measurement data. 0 0 Character 8 IODPDS_FMBTRCNT Unsigned 64-bit integer Number of bytes transmitted on the ISM function during the update interval. This value may be wrapped. Rest to zero when record MRIODPEN is cut (measurments are enabled) and is no longer valid/useful when record MRIODPDS is cut. (measurments are disabled) * * Character 0 IODPDS_END
MRIODPDS Cross Reference
Hex Hex Name Offset Length Value IODPDS 0 116+ IODPDS_DSNOSUCC 28 80 IODPDS_END * 0 IODPDS_FLAGS 28 1 IODPDS_FMBCWUCT 0 8 IODPDS_FMBDRCNT 0 8 IODPDS_FMBDWCNT 8 8 IODPDS_FMBMWUCT 8 8 IODPDS_FMBFMT 29 1 IODPDS_FMBLGCNT 50 8 IODPDS_FMBRBCNT 0 8 IODPDS_FMBRPCNT 68 8 IODPDS_FMBRPKNT 8 8 IODPDS_FMBSBCNT 60 8 IODPDS_FMBSGCNT 58 8 IODPDS_FMBSMPCT 44 4 IODPDS_FMBTBCNT 10 8 IODPDS_FMBTOD 48 8 IODPDS_FMBTPCNT 18 8 IODPDS_FMBTRCNT 0 8 IODPDS_FORM_0 * 16 IODPDS_FORM_1 * 32 IODPDS_FORM_2 * 16 IODPDS_FORM_3 * 8 IODPDS_MRHDR 0 0 IODPDS_RPCIHPIN 2C 8 IODPDS_RPCIPCNT 34 8 IODPDS_RPCIPFID 14 4 IODPDS_VARLEN 72 2 IODPDS_VAROFSET 70 2 IODPDS_VAR_DATA * * IODPDS_VMDUSER 1C 8 IODPDS_VPCIHNDG 24 4 IODPDS_VPCIPFID 18 4 IODPDS_VPCIRPCN 3C 8 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 V7R3.0.
Last updated on 09 September 2022 at 15:05:05.
Copyright IBM Corporation, 1990, 2022