Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODPAC
PrologControl Block Contents
Cross Reference
MRIODPAC Prolog
DSECT NAME - IODPAC FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRIODPAC DESCRIPTIVE NAME - Monitor Sample Record Domain 6 - I/O Domain Record 39 - PCI Activities DESCRIPTION - Indicates activity on a PCI function NOTES: This record is emitted for PCI functions which have been attached to a guest and enabled by the guest. Measurements can only be gathered for an enabled function.
MRIODPAC Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 112+ IODPAC 0 0 Character 0 IODPAC_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 IODPAC_RPCIPFID Real PCI function ID 24 18 Unsigned 4 IODPAC_VPCIPFID Virtual PCI function ID 28 1C Character 8 IODPAC_VMDUSER UserID to whom function attached 36 24 Bitstring 1 IODPAC_RPCICFLG PCI State Flag 1... .... IODPAC_RPCICONF PCI function is configured .1.. .... IODPAC_RPCIPERM PCI function is in Permanent Error state ..1. .... IODPAC_RPCIERR PCI function is in Error state ...1 .... IODPAC_RPCIBLOK PCI function blocked .... 1... * .... .1.. IODPAC_RPCIUNEN PCI function is unexpectedly in the enabled state .... ..1. IODPAC_RPCIINIT PCI function initialized .... ...1 IODPAC_RPCIDEAD Indicates RPCI has been scheduled for deletion. The RPCI has been removed from the ordered list and all hash tables. This bit should NEVER be ON for any live RPCI 37 25 Bitstring 1 IODPAC_CALFLAG PCI function state 1... .... IODPAC_CALENABL PCI function is enabled .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 38 26 Bitstring 1 IODPAC_VPCIFC Function Controls 1... .... IODPAC_VPCIEAS DMA registered .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 39 27 Character 1 IODPAC_FMBFMT Determines the format of the variable PCI function data When: 0 = IODPAC_FORM_0 1 = IODPAC_FORM_1 2 = IODPAC_FORM_2 3 = IODPAC_FORM_3 40 28 Character 8 IODPAC_RPCIHPIN Unsigned 64-bit integer Cardinal count of host pages currently pinned. 48 30 Character 8 IODPAC_RPCIPCNT Cardinal 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) 56 38 Character 8 IODPAC_VPCIRPCN Count of guest RDMA mapping requests 64 40 Unsigned 4 IODPAC_FMBSMPCT Cumulative sample count of the number of times the PCI-Function measurement block has been updated. This field wraps to zero with no notification when counter overflow occurs. 68 44 Character 8 IODPAC_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. 76 4C Character 8 IODPAC_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). 84 54 Character 8 IODPAC_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). 92 5C Character 8 IODPAC_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). 100 64 Character 8 IODPAC_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). 108 6C Unsigned 2 IODPAC_VAROFSET Offset within this record where the PCI function variable measurement data begins. 110 6E Unsigned 2 IODPAC_VARLEN Length of the PCI function variable measurement data. 112 70 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 0 0 Character 0 IODPAC_VAR_DATA Start of the PCI variable function data. To find the start of this data use IODPAC_VAROFSET. To find the length of this data use IODPAC_VARLEN.
Mapping of PCI function variable measurement data
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 16 IODPAC_FORM_0 Describes the fields in the Format 0 PCI function variable measurement data. 0 0 Character 8 IODPAC_FMBDRCNT Unsigned 64-bit integer Number of bytes read from main memory by the PCI function during the update interval. This value is always zero. 8 8 Character 8 IODPAC_FMBDWCNT Unsigned 64-bit integer Number of bytes written to main memory by the PCI function during the update interval. This value is always zero.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 32 IODPAC_FORM_1 Describes the fields in the Format 1 PCI function variable measurement data. 0 0 Character 8 IODPAC_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 IODPAC_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 IODPAC_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 IODPAC_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 IODPAC_FORM_2 Describes the fields in the Format 2 PCI function variable measurement data. 0 0 Character 8 IODPAC_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 IODPAC_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 IODPAC_FORM_3 Describes the fields in the Format 3 PCI function variable measurement data. 0 0 Character 8 IODPAC_FMBTRCNT Unsigned 64-bit integer Number of bytes transmitted over the ISM function during the update interval. This value may be wrapped. Reset to zero when the MRIODPEN is cut (measurements are enabled) and is no longer valid/useful when record MRIODPDS is cut (measurements are disabled)
MRIODPAC Cross Reference
Hex Hex Name Offset Length Value IODPAC 0 112+ IODPAC_CALENABL 25 80 IODPAC_CALFLAG 25 1 IODPAC_END * 0 IODPAC_FMBCWUCT 0 8 IODPAC_FMBDRCNT 0 8 IODPAC_FMBDWCNT 8 8 IODPAC_FMBFMT 27 1 IODPAC_FMBLGCNT 4C 8 IODPAC_FMBMWUCT 8 8 IODPAC_FMBRBCNT 0 8 IODPAC_FMBRBCNT 0 8 IODPAC_FMBRPCNT 64 8 IODPAC_FMBRPKNT 8 8 IODPAC_FMBSBCNT 5C 8 IODPAC_FMBSGCNT 54 8 IODPAC_FMBSMPCT 40 4 IODPAC_FMBTBCNT 10 8 IODPAC_FMBTOD 44 8 IODPAC_FMBTPCNT 18 8 IODPAC_FMBTRCNT 0 8 IODPAC_FORM_0 * 16 IODPAC_FORM_1 * 32 IODPAC_FORM_2 * 16 IODPAC_FORM_3 * 8 IODPAC_MRHDR 0 0 IODPAC_RPCIBLOK 24 10 IODPAC_RPCICFLG 24 1 IODPAC_RPCICONF 24 80 IODPAC_RPCIDEAD 24 01 IODPAC_RPCIERR 24 20 IODPAC_RPCIHPIN 28 8 IODPAC_RPCIINIT 24 02 IODPAC_RPCIPCNT 30 8 IODPAC_RPCIPERM 24 40 IODPAC_RPCIPFID 14 4 IODPAC_RPCIUNEN 24 04 IODPAC_VARLEN 6E 2 IODPAC_VAROFSET 6C 2 IODPAC_VAR_DATA * * IODPAC_VMDUSER 1C 8 IODPAC_VPCIEAS 26 80 IODPAC_VPCIFC 26 1 IODPAC_VPCIPFID 18 4 IODPAC_VPCIRPCN 38 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 V6R4.0.
Last updated on 10 Dec 2018 at 09:06:34.
Copyright IBM Corporation, 1990, 2018