DSETI C-3
Copyright (C) 1994-95 Conetic Software Systems, Inc.
All names, products, and services mentioned are the trademarks of their respective organizations.
NAME
dseti - set secondary index for RMSfile searching
SYNOPSIS
#include
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.