dbWriteRecord(3dba)

dbWriteRecord -- write a record to the log database

Synopsis

cc [flag ...] file ... -kthread -leels [library] ...

#include <eelsdba.h>

int dbWriteRecord(
	DBConn *conn,
	DBRecordHeader_t *header,
	char *tablename,
	char *data,
	int size);

Description

dbWriteRecord writes a record to the log database. The header specified in the call is a DBRecordHeader_t structure which contains all of the header information that is to be logged with the record.

The data parameter specifies the data to be logged with the message. If there is a large amount of event specific information to be logged with a record, dbWriteRecord makes repeated internal calls to the database to add multiple rows with increasing sequence numbers.

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

conn: (Input) A database connection that was returned by a previous call to dbConnect(3dba).
header: (Input) A pointer to a log record header structure as defined in Intro(3dba).
tablename: (Input) The name of the table that will contain the record information.
data: (Input) The data that is to be logged with the record.
size: (Input) The size of data in bytes.

Return values

If successful, dbWriteRecord returns 0. Otherwise, it returns -1.

Diagnostics

An application can call dbGetError(3dba) to obtain the error message returned from the database.

References

dbConnect(3dba), dbGetError(3dba), dbGetNextRow(3dba), Intro(3dba)