|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODPER
PrologControl Block Contents
Cross Reference
MRIODPER Prolog
DSECT NAME - IODPER
FUNCTION - The record indicates a PCI function error event.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRIODPER
DESCRIPTIVE NAME - Monitor Event Record
Domain 6 - I/O Domain
Record 41 - PCI function error
DESCRIPTION - This record indicates when a PCI function has entered
an error state.
NOTES: Channel Report Words (CRWs) indicating PCI error events
are received and processed by the system. This record
will be built to record such an event.
PCI Error Event Codes -
X'0001' - A DMA operation was attempted to a DMA address
space for which I/O translations were not
registered.
X'0002' - The PCI address of a DMA operation is not within
the range registered for the PCI function. The
PCI-virtual address is less than the PCI-base
address, or the sum of the PCI-virutal address
plus the length of DMA data transfer is greater
than the PCI address limit.
X'0003' - A DMA operation was attempted to a DMA addrress
space for which the format of the I/O-
Transaltion-Anchor (IOTA) was not valid.
X'0004' - IOTA protection exception. A DMA write
operation was attempted when the storage-
protection bit (P) in the IOTA was one.
X'0005' - Address-translation protection exception.
A DMA write operation was attempted when
the storage protection bit (P) in a
translation-table entry was one.
X'0006' - Storage-access exception due to key mismatch.
A DMA operation was attempted for which the
key in the IOTA did not match the storage key.
X'0007' - Storage exception due to invalid translation-
table entry. The invalid bit (I) is one, in
the region, segment, or page table used in the
translation process.
X'0008' - Storage exception due to invalid table offset
or table length in the translation-table entry.
The content of the table offset is not 00 binary
or the content of the table length is not 11
binary, in the region-table entry used in the
translation process.
X'0009' - Storage exception due to unexpected table type.
The table type (TT) bits in the translation
table entry that was fetched do not match the
expected-table-type (ETT).
X'000A' - Invalid main-storage address: During the
execution of the DMA operation, the z/PCI
facility detected an invalid main storage
address.
X'000B' - Uncorrectable storage error encountered during
processing of a DMA request.
X'0010' - The PCI function was not registered for
adapter interruptions when a message-signaled-
interruption (MSI) request was received from the
PCI function.
X'0011' - The adapter-interruption-bit vector (AIBV) or
the adapter-interruption-summary bit (AISB)
address, is not valid when an MSI request was
received from the PCI-function.
X'0012' - The AIBV number exceeds the number of
registered AIBVs for the PCI function when an
MSI request was received from the PCI function.
X'0013' - Uncorrectable storage error encountered during
processing of an adpater-interruption request.
X'002A' - Function-measurement-block addressing exception.
An access exception was encountered when
attempting to update the function measurement
block.
X'002B' - Uncorrectable storage error encountered when
attempting to update the function measurement
block.
X'002C' - Function-measurement-block protection exception.
Key-controlled protection applies when the
function-measurement-block key is non-zero,
and the non-zero key does not match the storage
key.
X'0030' - The PCI function is in error state due to the
corruption of the configuration space.
X'003A' - PCI-function recovery successful: The PCI
function is in error state. The z/PCI facility
has encountered and error with the PCI function
but has successfully recovered.
X'003B' - PCI-Function recovery unsuccessful: The PCI
function remains configured, but in the
permanent error state. The enabled PCI function
handle stored for this event identifies the PCI
function in error, but is no longer usable.
X'0040' - z/PCI facility processing error: The PCI
function remains configured, but in the
permanent error state. The enabled or general
function handle stored for this event identifies
the PCI function in error, but is no longer
usuable.
MRIODPER Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 44 IODPER 0 0 Character 0 IODPER_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 IODPER_RPCIPFID Real PCI Function ID 24 18 Unsigned 4 IODPER_VPCIPFID Virt PCI Function ID 28 1C Character 8 IODPER_VMDUSER User Name of Function Owner 36 24 Unsigned 4 IODPER_RPCIHNDE PCI Enabled Handle 40 28 Unsigned 2 IODPER_ERRCODE PCI Error Code 42 2A Bitstring 1 IODPER_RPCICFLG PCI State Flag 1... .... IODPER_RPCICONF PCI function is configured .1.. .... IODPER_RPCIPERM PCI function is in Permanent Error state ..1. .... IODPER_RPCIERR PCI function is in Error state ...1 .... IODPER_RPCIBLOK PCI function is Blocked .... 1... * .... .1.. IODPER_RPCIUNEN PCI function is unexpectedly in the enabled state .... ..1. IODPER_RPCIINIT PCI Function initialized .... ...1 IODPER_RPCIDEAD Indicates RPCI has been 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 43 2B Bitstring 1 IODPER_CALFLAG PCI function state 1... .... IODPER_CALENABL PCI function is enabled .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 44 2C Character 0 IODPER_END
MRIODPER Cross Reference
Hex Hex
Name Offset Length Value
IODPER 0 44
IODPER_CALENABL 2B 80
IODPER_CALFLAG 2B 1
IODPER_END 2C 0
IODPER_ERRCODE 28 2
IODPER_MRHDR 0 0
IODPER_RPCIBLOK 2A 10
IODPER_RPCICFLG 2A 1
IODPER_RPCICONF 2A 80
IODPER_RPCIDEAD 2A 01
IODPER_RPCIERR 2A 20
IODPER_RPCIHNDE 24 4
IODPER_RPCIINIT 2A 02
IODPER_RPCIPERM 2A 40
IODPER_RPCIPFID 14 4
IODPER_RPCIUNEN 2A 04
IODPER_VMDUSER 1C 8
IODPER_VPCIPFID 18 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 V6R3.0.
Last updated on 03 Nov 2014 at 14:58:00.
Copyright IBM Corporation, 2014