DFINDLM C-3

NAME

dfindlm - find last matching record using secondary index

Dfindlm finds the last record with field values equal to the beginning field values placed in the data buffer.

An RMSfile may have several secondary indexes associated with it. These are used to retrieve records by other than the primary key value. Before calling dfindlm, call dseti(C-3) to select the desired secondary index. The selected secondary index has between one and eight fields associated with it. The search values for these secondary index fields desired must be stored in buffer before calling dfindlm. If dnumidx(C-3) has been called prior to this function, only the first n fields of the current index are compared; otherwise, all fields of the current index are compared.

Dfindlm returns into the buffer the last record that contains secondary field values equal to the field values passed in buffer. Dfindlm also saves the current position in the secondary index, and additional records that match the field values may be fetched with the dfindpm(C-3) function. Additionally, records may be read in reverse secondary key order with the dfindpi(C-3) function.

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

All character positions in the primary key field are used in determining the key value. The function strncpy is recommended for storing string key values in buffer.

dlopen(C-3), dopen(C-3), dseti(C-3), dfindpi(C-3),

dfindpm(C-3), dread(C-3), strncpy(C-3)

Chapter 4,

Dfindlm returns a value of BAD (-1) if an I/O error occurred or if there is no record that contains field values equal to the beginning values passed in buffer. If no record is found, the contents of buffer are undefined.