DWRITE C-3





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



NAME


dwrite - write record using record number

SYNOPSIS


#include 

rno_t dwrite (buf, record, fcb)
char *buf;
rno_t record;
DFILE *fcb;

DESCRIPTION


Dwrite writes the record in buf at the record number specified by
record where record is between 1 and number of records in the
RMSfile. Record is returned by all calls that access the RMSfile.

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

Dwrite does not  use the primary key values in the record to
determine where the record shall be stored. That is specified
solely by the record parameter. Dwrite is intended to be used
only as a low level RMS access routine when alternate file access
methods are desired.

If the RMSfile contains secondary keys, the key indexes are not
updated by the call to dwrite.

SEE ALSO


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

DIAGNOSTICS

Dwrite returns a value of BAD (-1) if record is not within the
range of valid records for the RMSfile or if fcb is not an opened
RMSfile.