Understanding the Diagnostic Subsystem for AIX

dlog_find_sequence

Purpose

Finds the diagnostic log entry that has the specified sequence number.

Syntax

#include                <diag/diag_log.h>

int dlog_find_sequence(dl_info *dlogInfo,uint seq,dlEntry **results) 

Description

The dlog_find_sequence subroutine finds the diagnostic log entry with a specific diagnostic log sequence number. The matching entry will be in results and its index in the log array will be returned. It is the responsibility of the calling application to free the memory allocated for dlEntry. The results variable will be NULL if no match is found.

Parameters

Return Value

Upon successful completion, a value >= 0 is returned. Otherwise, a value of -1 is returned and results will be NULL.