isaddindex(S)                  6 January 1993                  isaddindex(S)


 Name

    isaddindex - add an index to an ISAM file

 Syntax


    cc  . . .  -lisam


    isaddindex (isfd, keydesc)
    int isfd;
    struct keydesc *keydesc;


 Description

    The isaddindex routine builds an index for an open ISAM file.  You can
    use the following arguments with this routine:


    _________________________________________________________________________
    Argument  Description
    _________________________________________________________________________
    isfd      File descriptor of the ISAM data file being indexed.
    keydesc   Structure defining the index.

    The isaddindex routine executes only if the file has been opened in
    exclusive mode.

    The number of parts of the index cannot exceed NPARTS.  The sum of the
    lengths of the parts of a key may not exceed MAXKEYSIZE.  NPARTS and
    MAXKEYSIZE are defined in the isam.h header file.

    An ISAM file can have any number of indexes built on it.

    This call returns an error if the index is defined not to allow dupli-
    cates and the data contains duplicates.

 Example


       isaddindex(bookfd, &key) ;


 See also

    isdelindex(S)

 Standards conformance

    isaddindex is not part of any currently supported standard; it is an
    extension of AT&T System V provided by the Santa Cruz Operation.