dinsert - insert keyed record
rno_t dinsert (buffer, fcb)
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.
dlopen(C-3), dopen(C-3), dread(C-3)
RMS Programming Guide
Dinsert returns a value of BAD (-1) if the RMSfile is full or if an I/O error occurred.