dbGetNextRecord(3dba)
dbGetNextRecord --
read a record from the log database
Synopsis
cc [flag ...] file ...
-kthread -leels [library] ...
#include <eelsdba.h>
int dbGetNextRecord(
DBResult *result,
DBRecordHeader_t *header,
char *bufp,
int size);
Description
dbGetNextRecord
writes a record to the log database.
The header specified in the call is a
DBRecordHeader_t structure which will contain all
of the header information from the record retrieved via
dbGetNextRow.
The bufp parameter specifies a buffer that will contain
the data for all fields of type EELSBuffer_t
in the
DBRecordHeader_t. It is reccommended that bufp
be large enough to hold the maximum amount of data possible given
the size of the fields in the database schema.
When
dbGetNextRow(3dba)
is used to retrieve a row that contains event specific information
in excess of the maximum record size supported by the database,
additional entries with increasing sequence numbers are extracted
from the database. In order to assemble the entire log entry,
all the rows with matching UniqEventIDs should be gathered
in SequenceNumber order.
Arguments
result-
(Input) A database result that was returned by a previous call to
dbQuery(3dba).
header-
(Output) A pointer to a log record header structure
as defined in
Intro(3dba).
bufp-
(Output) The buffer used to hold EELSBuffer_t
fields of the record.
size-
(Input) The size (in bytes) of the bufp buffer.
Return values
If successful, dbGetNextRecord returns 0.
Otherwise, it returns -1.
Diagnostics
An application can call
dbGetError(3dba)
to obtain the error message returned from the database.
References
dbQuery(3dba),
dbGetError(3dba),
dbGetNextRow(3dba),
Intro(3dba)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004