Understanding the Diagnostic Subsystem for AIX

pdiag_read_slot_reset

Purpose

Queries the state of the physical reset signal to the I/O Adapter and the Enhanced Error Handling (EEH) slot's capabilities.

Syntax

#include <sys/pdiagex_dds.h>
#include <sys/pdiag_def.h>

int32 pdiag_read_slot_reset( char *device_instance, int32 operation_type )

Description

The pdiag_read_slot_reset subroutine issues a Run-Time Abstraction service (RTAS) call to query the state of the physical reset signal to the I/O Adapter and the EEH slot's capability.

Parameters

Parameter	Description
device_instance	Name of the device under test.
operation_type	Integer indicating the function to be performed. 0: Query Reset State This option returns the slot reset state, indicating if the slot reset is activated or deactivated, and if the I/O adapter is in stopped state or not. 1: Query Slot Capabilities This option returns the EEH I/O Adapter capabilities, indicating if EEH is supported or not.

Return Value

The pdiag_read_slot_reset subroutine returns one of the following values for the Query Reset State operation:

Return Code	Description
-2	Software error
-1	Hardware error
0	Reset deactivated and I/O Adapter is not in the EEH stopped state.
1	Reset activated and I/O Adapter is not in the EEH stopped state.
2	I/O Adapter is in the EEH stopped state with the reset signal deactivated and the Load/Store Path is disabled.
3	I/O Adapter is in the EEH stopped state with the reset signal deactivated and the Load/Store Path is enabled.
4	I/O Adapter is permanently unavailable.

The pdiag_read_slot_reset subroutine returns one of the following values for the Query Slot Capabilities operation:

Return Code	Description
-2	Software error.
-1	Hardware error.
0	EEH not supported.
1	EEH supported.

Related Information

The pdiag_set_slot_reset and pdiag_set_eeh_option subroutines.