Name

---

      DBINDEX

Purpose

---

      Procedure to create index file for data base

Calling Sequence

---

      dbindex, [ items ]

Optional Input

---

      items - names or numbers of items to be index -- if not supplied,
              then all indexed fields will be processed.

Output

---

      Index file <name>.dbx is created on disk location ZDBASE:

Operational Notes

---

      (1) Data base must have been previously opened for update
      by DBOPEN
      (2) Only 18 items can be indexed at one time. If the database has
      more than 18 items, then two separate calls to DBINDEX are needed.

Procedures Called

---

      DBINDEX_BLK, DB_INFO(), DB_ITEM, DB_ITEM_INFO(), IEEE_TO_HOST,
      IS_IEEE_BIG()

History

---

      version 2 D. Lindler Nov 1987 (new db format)
      W. Landsman added optional items parameter Feb 1989
      William Thompson, GSFC/CDS (ARC), 30 May 1994
              Added support for external (IEEE) data format
      Test if machine is bigendian W. Landsman May, 1996
      Change variable name of BYTESWAP to BSWAP W. Thompson Mar, 1997
      Increased number of fields to 15 W. Landsman June, 1997
      Increase number of items to 18 W. Landsman November 1999
      Allow multiple valued (nonstring) index items W. Landsman November 2000
      Use 64 bit integers for V5.2 or later W. Landsman February 2001
      Do not use EXECUTE() for V6.1 or later, improve efficiency
                W. Landsman December 2006
      Automatically enlarge .dbx file if needed, fix major bug in last
            update W. Landsman Dec 2006
      Assume since V6.1 W. Landsman June 2009
      Allow sorted string items W. Landsman October 2009