Understanding the Diagnostic Subsystem for AIX

diag_get_device_flag

Purpose

Obtain device flag from residual data information.

Attention: This diagnostic library function has been removed in AIX 5.2 but the information has been left in for reference.

Syntax

#include    <diag/diag.h>
#include    <sys/residual.h>

int  diag_get_device_flag (
                                 char            *device_name,
                                 long            *Flag)

Description

The diag_get_device_flagsubroutine searches residual data for an object matching the devicespecified by device_name. The value of the Flags field asdefined in the DEVICE_ID structure for the device is returned inthe Flag argument.

Implementation Specifics

POWER-based

Parameters

Parameter	Description
device_name	Pointer to a character string containing the logical name of the device.
Flag	Pointer to a long integer where the value of the Flag field in the DEVICE_ID structure as defined by sys/residual.h header file will be written.

Return Value

Upon successful completion, a 0 isreturned if the device flag information was retrieved successfully. If thediag_get_device_flag fails, a value of -1 is returned.