|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRPCI
PrologControl Block Contents
Cross Reference
MRMTRPCI Prolog
DSECT NAME - MTRPCI
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRMTRPCI
DESCRIPTIVE NAME - Monitor Sample Configuration Record
Domain 1 - Monitor Domain
Record 27 - PCI function Configuration Data
DESCRIPTION - Describes the configuration of a real PCI function.
A separate record is generated for each real PCI
function defined to the system.
NOTES:
Values for MTRPCI_RPCIPFT:
'00'X - Unclassified type
'02'X - RoCE Express type
'03'X - zEDC type
'05'X - ISM type
'07'X - Sync IO type
'08'X - RCE type
'0A'X - CX4 type
'0B'X - NVMe type
MRMTRPCI Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 144+ MTRPCI 0 0 Character 0 MTRPCI_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 MTRPCI_RPCIPFID PCI Function ID 24 18 Unsigned 4 MTRPCI_VPCIPFID Virtual PCI function ID (zero if not attached) 28 1C Character 8 MTRPCI_VMDUSER UserID to whom function attached (zero if not attached) 36 24 Unsigned 4 MTRPCI_RPCIHNDG PCI General Handle 40 28 Unsigned 2 MTRPCI_RPCIDVID PCI Device ID 42 2A Unsigned 2 MTRPCI_RPCIVDID PCI Vendor ID 44 2C Bitstring 1 MTRPCI_RPCICFLG PCI State Flag 1... .... MTRPCI_RPCICONF PCI function is configured .1.. .... MTRPCI_RPCIPERM PCI function is in permanent error state ..1. .... MTRPCI_RPCIERR PCI function is in error state ...1 .... MTRPCI_RPCIBLOK PCI function blocked .... 1... * .... .1.. MTRPCI_RPCIUNEN PCI function is unexpectedly in the enabled state .... ..1. MTRPCI_RPCIINIT PCI function initialized .... ...1 MTRPCI_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 45 2D Bitstring 1 MTRPCI_VPCIFC Function Controls 1... .... MTRPCI_VPCIEAS DMA registered .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 46 2E Character 1 MTRPCI_FIBKYDTH Host table type. (Valid when DMA registered) 47 2F Character 1 MTRPCI_FIBKYDTG Guest table type. (Valid when DMA registered) 48 30 Character 8 MTRPCI_FIBPBA DMA base address (valid when DMA registered) 56 38 Character 8 MTRPCI_FIBPAL DMA address limit(valid when DMA registered) 64 40 Character 2 MTRPCI_PCHID Physical Channel Identifier 66 42 Character 2 MTRPCI_PVFN Virtual Function Number 68 44 Character 2 MTRPCI_MUI Measurement block update interval (this is how often the fields IODPAC_FMBxxxx fields are updated) 70 46 Character 2 MTRPCI_PFGID Function Group ID 72 48 Bitstring 1 MTRPCI_CALFLAG PCI function state 1... .... MTRPCI_CALENABL PCI function is enabled .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 73 49 Bitstring 1 MTRPCI_FLAG Flag 1... .... MTRPCI_UVALID Utility String valid .1.. .... MTRPCI_CVALID Capacity valid ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 74 4A Character 1 MTRPCI_RPCIPORT PCI Function Port 75 4B Character 1 MTRPCI_RPCIPFT PCI Function Type 76 4C Character 16 MTRPCI_NETID1 Utility String Network ID 1. Valid when MTRPCI_UVALID is set 92 5C Character 16 MTRPCI_NETID2 Utility String Network ID 2. Valid when MTRPCI_UVALID is set 108 6C Character 16 MTRPCI_NETID3 Utility String Network ID 3. Valid when MTRPCI_UVALID is set 124 7C Character 16 MTRPCI_NETID4 Utility String Network ID 4. Valid when MTRPCI_UVALID is set 140 8C Unsigned 2 MTRPCI_VAROFSET Offset within this record where the PCI function variable configuration data begins. 142 8E Unsigned 2 MTRPCI_VARLEN Length of the PCI function variable configuration data 144 90 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 144 90 Character * MTRPCI_VAR_DATA Start of the PCI variable function data. To find the start of this data use MTRPCI_VAROFSET. To find the length of this data use MTRPCI_VARLEN.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 96 MTRPCI_VAR_NVME Describes the fields in the NVMe variable configuration data. This record extension will exist only if MTRPCI_RPCIPFT = MTRPCI_NVME and MTRPCI_VMDUSER = 'SYSTEM '. 0 0 Character 40 MTRPCI_IDCMN Device model number 40 28 Character 20 MTRPCI_IDCSN Device serial number 60 3C Character 8 MTRPCI_IDCFR Firmware revision 68 44 Character 4 MTRPCI_IDCVID Device vendor ID 72 48 Character 4 MTRPCI_IDCSSID Device subsystem ID 76 4C Character 6 MTRPCI_IDCIEEE Device IEEE OUI identifier 82 52 Unsigned 1 MTRPCI_IDCMDTS Unsigned 8-bit integer Maximum data transfer size in 4K pages 83 53 Unsigned 1 MTRPCI_LSHASTHR Unsigned 8-bit integer Available space threshold 84 54 Unsigned 2 MTRPCI_IDCWCTMP Unsigned 16-bit integer Warning composite temperature threshold in degrees Kelvin 86 56 Unsigned 2 MTRPCI_IDCCCTMP Unsigned 16-bit integer Critical composite temperature threshold in degress Kelvin 88 58 Character 8 MTRPCI_IDCTNCAP Unsigned 128-bit integer Device capacity in 512-byte blocks
MRMTRPCI Cross Reference
Hex Hex
Name Offset Length Value
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
MTRPCI 0 144+
MTRPCI_CALENABL 48 80
MTRPCI_CALFLAG 48 1
MTRPCI_FIBKYDTG 2F 1
MTRPCI_FIBKYDTH 2E 1
MTRPCI_FIBPAL 38 8
MTRPCI_FIBPBA 30 8
MTRPCI_FLAG 49 1
MTRPCI_IDCCCTMP 56 2
MTRPCI_IDCFR 3C 8
MTRPCI_IDCIEEE 4C 6
MTRPCI_IDCMDTS 52 1
MTRPCI_IDCMN 0 40
MTRPCI_IDCSN 28 20
MTRPCI_IDCSSID 48 4
MTRPCI_IDCTNCAP 58 8
MTRPCI_IDCWCTMP 54 2
MTRPCI_IDCVID 44 4
MTRPCI_LSHASTHR 53 1
MTRPCI_MRHDR 0 0
MTRPCI_MUI 44 2
MTRPCI_NETID1 4C 16
MTRPCI_NETID2 5C 16
MTRPCI_NETID3 6C 16
MTRPCI_NETID4 7C 16
MTRPCI_PCHID 40 2
MTRPCI_PFGID 46 2
MTRPCI_PVFN 42 2
MTRPCI_RPCIBLOK 2C 10
MTRPCI_RPCICFLG 2C 1
MTRPCI_RPCICONF 2C 80
MTRPCI_RPCIDEAD 2C 01
MTRPCI_RPCIDVID 28 2
MTRPCI_RPCIERR 2C 20
MTRPCI_RPCIHNDG 24 4
MTRPCI_RPCIINIT 2C 02
MTRPCI_RPCIPERM 2C 40
MTRPCI_RPCIPFID 14 4
MTRPCI_RPCIPFT 4B 1
MTRPCI_RPCIPORT 4A 1
MTRPCI_RPCIUNEN 2C 04
MTRPCI_RPCIVDID 2A 2
MTRPCI_UVALID 49 80
MTRPCI_VARLEN 8E 2
MTRPCI_VAROFSET 8C 2
MTRPCI_VAR_DATA 90 0
MTRPCI_VAR_NVME 0 96
MTRPCI_VMDUSER 1C 8
MTRPCI_VPCIEAS 2D 80
MTRPCI_VPCIFC 2D 1
MTRPCI_VPCIPFID 18 4
This information is based on z/VM V7R3.0.
Last updated on 13 September 2022 at 12:36:05.
Copyright IBM Corporation, 1990, 2022