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 Bitstring 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 80 = IODPAC_FORM_80 1... .... IODPAC_FMBFMT_EXT Extended format .111 1111 IODPAC_FMT Format number 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)
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 160 IODPAC_FORM_80 Describes the fields in the extended format 0 PCI function variable measurement data. 0 0 Character 16 IODPAC_LSHDURD Cumulative number of 512- byte data units read from the device, in thousands rounded up 16 10 Character 16 IODPAC_LSHDUWR Cumulative number of 512- byte data units written to the device, in thousands rounded up 32 20 Character 16 IODPAC_LSHHRDCM Cumulative number of read commands completed. 48 30 Character 16 IODPAC_LSHHWRCM Cumulative number of write commands completed. 64 40 Character 16 IODPAC_LSHBUSTM Cumulative time the device has been busy with I/O commands, in minutes. 80 50 Character 16 IODPAC_LSHPWRCY Unsigned 128-bit integer Cumulative number of power cycles 96 60 Character 16 IODPAC_LSHPWRON Unsigned 128-bit integer Cumulative number of hours powered on 112 70 Character 16 IODPAC_LSHNDIER Unsigned 128-bit integer Cumulative number of unrecoverable media and data integrity errors 128 80 Character 16 IODPAC_LSHERRCT Unsigned 128-bit integer Cumulative number of error information log entries 144 90 Character 4 IODPAC_LSHWCTTM Unsigned 32-bit integer Cumulative time the Composite Temperature has been greater than or equal to the Warning Composite Temperature Threshold and less than or equal to the Critical Composite Temperature Threshold, in minutes 148 94 Character 4 IODPAC_LSHCCTTM Unsigned 32-bit integer Cumulative time the Composite Temperature has been greater than or equal to the Critical Composite Temperature Threshold, in minutes 152 98 Bitstring 1 IODPAC_LSHCRITW Critical warnings 1... .... IODPAC_LSHCRTAS Available spare capacity below threshold .1.. .... IODPAC_LSHCRTTM Temperature above high threshold or below low threshold ..1. .... IODPAC_LSHCRTME Significant media-related errors or internal errors encountered ...1 .... IODPAC_LSHCRTRO Media placed in read-only status .... 1... IODPAC_LSHCRTBU Volatile memory backup device failed .... .1.. * .... ..1. * .... ...1 * 153 99 Character 1 IODPAC_LSHASPAR Unsigned 8-bit integer Percentage of remaining spare capacity available, between 0 and 100 154 9A Character 1 IODPAC_LSHPCTUS Unsigned 8-bit integer Vendor-specific estimate of percentage of subsystem life used; may exceed 100 155 9B Character 1 * 156 9C Character 2 IODPAC_LSHCTEMP Unsigned 16-bit integer Composite temperature in degrees Kelvin 158 9E Character 2 *
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_FORM_80 * 160 IODPAC_LSHASPAR 99 1 IODPAC_LSHBUSTM 40 16 IODPAC_LSHCCTTM 94 4 IODPAC_LSHCRITW 98 1 IODPAC_LSHCRTAS 98 80 IODPAC_LSHCRTBU 98 08 IODPAC_LSHCRTME 98 20 IODPAC_LSHCRTRD 98 10 IODPAC_LSHCRTTM 98 40 IODPAC_LSHCTEMP 9C 2 IODPAC_LSHDURD 0 16 IODPAC_LSHDUWR 10 16 IODPAC_LSHERRCT 80 16 IODPAC_LSHHRDCM 20 16 IODPAC_LSHHWRCM 30 16 IODPAC_LSHMDIER 70 16 IODPAC_LSHPCTUS 9A 1 IODPAC_LSHPWRCY 50 16 IODPAC_LSHPWRON 60 16 IODPAC_LSHWCTTM 90 4 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 V7R3.0.
Last updated on 13 September 2022 at 13:29:05.
Copyright IBM Corporation, 1990, 2022