NAME
dinsert - insert keyed record
SYNOPSIS
#include <cbase/dirio.h>
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.