Reporting defective PCIe devices

6.10 LPAR mode z/VM guest

For Linux® in LPAR mode or Linux on z/VM®, use the zpcictl command to report defective PCIe devices to the Support Element (SE). Such devices might require physical repair actions.

Before you begin

  • You need to know the function address of the defective PCIe device or a device node that represents the device.
  • To send diagnostic data with the error report you need to install the smartmontools package. Whether data is collected and which data is available depends on the PCI device type. For example, S.M.A.R.T. data is gathered for NVMe devices.

Procedure

Issue a command of this form to report a device with function address 0000:00:00.0 to the SE:
# zpcictl --report-error <device>
where <device> is the device's function address or a device node that represents the device.
Example:
# zpcictl --report-error 0000:00:00.0