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.