Understanding the Diagnostic Subsystem for AIX

dlog_formatElogResults

Purpose

Returns a formatted string of the diagnostic event log information.

Syntax

#include                <diag/diag_log.h>

char *dlog_formatElogResults(dlEntry *entry) 

Description

The dlog_formatElogResults subroutine formats a diagnostic log entry for display in the error log with the errpt command. When a SRN is caused by an entry in the error log, the error log is updated with the diagnostic log entry's sequence number. When the error log is displayed the formatted string returned from this subroutine shows the diagnostic log information. It is up to the calling application to free the memory allocated for the return string.

The return string will look like the following:

        Diagnostic Log sequence number: sequence number 
        Resource tested:      resource name 
        Resource Description: resource description
        Location:             resource location 
        SRN:   SRN
        Description:  Error Description
        Possible FRUs: List of possible FRUs

Parameters

Return Value

Upon successful completion a NON-ZERO pointer is returned. Otherwise, a pointer to NULL is returned.