Understanding the Diagnostic Subsystem for AIX

Enables and disables the Enhanced Error Handling (EEH) option for an I/O Adapter, for systems supporting the EEH option.

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

int32 pdiag_set_eeh_option( char *device_instance, int32 operation_type )

The pdiag_set_eeh_option subroutine issues Run-Time Abstraction Services (RTAS) calls to enable and disable the EEH option for an I/O Adapter.

Parameter	Description
device_instance	Name of the device under test.
operation_type	Integer indicating the function to be performed. Supported operations: 0: Disable EEH option: This operation disables the EEH option for the selected I/O Adapter (freeze function is disabled). An error is reported if the EEH function is not supported. 1: Enable EEH option: This operation enables the EEH option for the selected I/O Adapter (freeze function enabled). An error is reported if the EEH function is not supported.

Parameter

Description

device_instance

Name of the device under test.

operation_type

Integer indicating the function to be performed.
Supported operations:

0:: Disable EEH option:
This operation disables the EEH option for the selected I/O Adapter (freeze function is disabled). An error is reported if the EEH function is not supported.
1:: Enable EEH option:
This operation enables the EEH option for the selected I/O Adapter (freeze function enabled). An error is reported if the EEH function is not supported.

The pdiag_set_eeh_option subroutine returns one of the following values:

Return Code	Description
-2	A software error occurred.
-1	A hardware error occurred.
0	The operation was successful.