DFINDNI C-3

NAME

dfindni - find next record using secondary index

Dfindni reads a record from an RMSfile in secondary key order. Before calling dfindni, call dseti(C-3) to select the desired secondary index. Dfindi(C-3), dfindfi(C-3), or dsetpos(C-3) can be called to set the starting point in the secondary index. Each subsequent call to dfindni returns the next record in secondary key order. The beginning contents of buffer are ignored by dfindni.

Dfindni maintains the current position in the secondary index, so additional records may be fetched in secondary key order by using the dfindni function repeatedly.

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).

dlopen(C-3), dopen(C-3), dseti(C-3), dfindfi(C-3), dfindi(C-3)

Chapter 4,

Dfindni returns a value of BAD (-1) if an I/O error occurred, or if there is no record that contains field values greater than or equal to the last values returned. If no record is found, then the contents of buffer are undefined.