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)