Understanding the Diagnostic Subsystem for AIX

get_diag_att

Purpose

Reads an attribute from the predefined database PDiagAtt.

Syntax

#include    <diag/modid.h>
 
int get_diag_att ( type, attribute, conversion, byte_count, value )
 
char *type;
char *attribute;
char conversion;
int  *byte_count;
void *value;

Description

The get_diag_att subroutine gets attributes from the predefined diagnostic database PDiagAtt.

Parameters

The arguments are defined as follows:

Parameter	Description
type	Device type, which should be Class/SubClass/Type string. This fully qualified string reduces the chance of finding two objects having the same Type value in the PdDv object class.
attribute	Attribute name to get from the Predefined Attribute Object Class.
conversion	The data type to which the attribute is to be converted, including the following: `s' = string rep = s `b' = byte sequence rep = s (for example "0x56FFE67") `l' = long rep = n `i' = int rep = n `h' = short (half) rep = n `f' = float rep = n `c' = char rep = n, or s `a' = address rep = n
byte_count	Number of bytes (for byte sequence only).
value	Pointer to where the converted attribute value is returned.

Return Value

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned.