PCIx entry for program-controlled or suspend interrupt

Entry:
PCID, PCIR, PCIT, or PCIX
VIT option:
PCID and PCIR: CIA
PCIT and PCIX: CIO
Event:
Program-controlled or suspend interrupt
VIT processing module:
ISTITCOD
Control is returned to:
ISTTSCIE, ISTLLCIE, ISTSRRIE

This trace record is written when a program-controlled interrupt occurs.

This interrupt occurs for a CLAW channel-to-channel attached host, for HPDT read and write devices, or for the OSA-Express QDIO, Shared Memory Communications over Remote Direct Memory Access (SMC-R), or the HiperSockets™ adapter read queue.

The PCID entry is recorded when the OSA-Express QDIO or HiperSockets adapter has completed a read operation. The PCID entry may or may not be preceded by a SIGA (read) operation for the same device.

The PCIT and PCIX entries are correlated to the SIOx, RIOx, and INTx entries for the same device using the CUA field. The combination of the information provided by these entries describe the channel program management and I/O operations for the device.

The PCIR entry is recorded when the IBM® 10Gbe RoCE Express® feature completes a read operation or encounters an error condition. The PCIR entry is followed by the RPLE, RPLP, and RPLA (optional) entries. These entries include information that describes the type and destination of the data received or the type of the error encountered.

See for a description of the NCB fields.

The PCIT and PCIX entries are also captured within the NCB (pointed to by NCBCIOMV). The NCB trace table is mapped by NCBCIOAR.