Understanding the Diagnostic Subsystem for AIX

query_output Structure

The query_output structure contains information about individual diagnostic event log entries matching the criteria specified by the query_log structure. These structures are contained within the query_results structure returned by dlog_query. Some entries may not contain information for some of the fields within query_output. The query_output structure is defined in diag_log.h.

The query_output structure is defined as:

typedef struct _log_query_output {
   char type;
   char identifier[5];
   unsigned int el_identifier;
   char *timestamp;
   unsigned int seqNum;
   unsigned int el_seqNum;
   unsigned int session;
   unsigned int testMode;
   char *name;
   char *location;
   dl_srn *srn;
   dl_menugoal *mgoal;
   dl_partition *partition;
   char reserved[100];
}query_output;

type	Type of log template used to create the entry. I, S, N, E, and X are the valid values for type.
identifier	Identifier of the diagnostic event log entry.
timestamp	Formatted string of the time at which the diagnostic event log entry was logged.
seqNum	Sequence number for the diagnostic event log entry.
el_seqNum	AIX error log sequence number. The diagnostic event log entry may not be tied to an AIX error log entry.
session	Process id of the diagnostic session that created the entry.
testMode	Diagnostics test mode. This is stored as a hex value. The following macros are defined in diag_log.h to decode testMode: IS_CONSOLE_MODE(testMode) Returns 1 when the diagnostic event was in console mode (No-console mode otherwise) IS_ADVANCE_MODE(testMode) Returns 1 when the diagnostic event was caused while running advanced diagnostics (Customer diagnostics otherwise) IS_NORMAL_BOOT(testMode) Returns 1 when the diagnostics booted normally (Service Boot otherwise) IS_NETWORK_BOOT(testMode) Returns 1 when the diagnostics booted from the network IS_ELA_MODE(testMode) Returns 1 when the diagnostic event performed error log analysis only IS_PD_MODE(testMode) Returns 1 when the diagnostic event performed Problem Determination (System Verification otherwise) IS_SYSTEM_CHECK(testMode) Returns 1 when the diagnostic event performed System Checkout (Option Checkout otherwise) IS_LOOP_MODE(testMode) Returns 1 when the diagnostic event was in loop mode IS_PRETEST_MODE(testMode) Returns 1 when the diagnostic event performed a pretest IS_MISSING_MODE(testMode) Returns 1 when the diagnostic event was caused by Missing Options Resolution IS_NEW_MODE(testMode) Returns 1 when the diagnostic event was caused while testing new devices
name	Name of the resource the entry was logged against.
location	Location code for the resource the entry was logged against.
srn	Pointer to SRN information. The pointer will be NULL when there is not an SRN.
mgoal	Pointer to menugoal information. The pointer will be NULL when there is not a menugoal.
partition	Pointer to partition information. The pointer will be NULL when there is no partition information.
reserved	Reserved for future use.