NAME
dseti - set secondary index for RMSfile searching
SYNOPSIS
#include <cbase/dirio.h>
int dseti (index, fcb)
int index;
DFILE *fcb;
DESCRIPTION
An RMSfile may have several secondary indexes associated with it. These are used to retrieve records by other than the primary key value. The dseti function selects the secondary index to use during calls to dfindm(C-3), dfindnm(C-3), dfindlm(C-3), dfindpm(C-3), dfindfi(C-3), dfindi(C-3), dfindni(C-3), dfindli(C-3), dfindpi(C-3), and dnumidx(C-3).
RMS keeps track of the current position in the secondary index, so that records can be read in secondary key order.
Index is an integer naming the secondary index to be used. The secondary indexes are numbered starting at 1.
Fcb is the file block pointer returned by dlopen(C-3) or dopen(C-3).
SEE ALSO
dlopen(C-3), dopen(C-3), dfindfi(C-3), dfindi(C-3), dfindni(C-3), dfindli(C-3), dfindpi(C-3), dfindm(C-3), dfindnm(C-3), dfindlm(C-3), dfindpm(C-3), dnumidx(C-3)
Chapter 4,
RMS Programming Guide
DIAGNOSTICS
Dseti returns a value of -1 if an invalid secondary index number is selected.
NOTES
Calling dfindk(C-3), dfindnk(C-3), dfindlk(C-3), or dfindpk(C-3) deselects the secondary index selected by dseti.