DINSERT C-3


NAME



dinsert - insert keyed record

SYNOPSIS



#include

rno_t dinsert (buffer, fcb)
char *buffer;
DFILE *fcb;

DESCRIPTION



Dinsert adds a keyed record to an opened RMSfile. The key and
data of the record to be added must be stored in buffer prior to
calling dinsert.

If the RMSfile contains secondary keys, the index key values are
added at the time of the call to dinsert.

Fcb is the file block pointer returned by dlopen(C-3) or
dopen(C-3).

The returned record number may be saved and used on a subsequent
call to dread(C-3). The contents of buffer remain unchanged.

SEE ALSO



dlopen(C-3), dopen(C-3), dread(C-3)
Chapter 4, RMS Programming Guide

DIAGNOSTICS



Dinsert returns a value of BAD (-1) if the RMSfile is full or if
an I/O error occurred.