DINSERT C-3





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



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.