dseti - set secondary index for RMSfile searching
#include
int dseti (index, fcb)
int index;
DFILE *fcb;
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).
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.
Calling dfindk(C-3), dfindnk(C-3),
dfindlk(C-3), or dfindpk(C-3)
deselects the secondary index selected by dseti.