DBSETINDEX() function*
 Empty Orders from an Order Bag into the Order List
------------------------------------------------------------------------------
 Syntax

     DBSETINDEX(<cOrderBagName>) --> NIL

 Arguments

     <cOrderBagName> is the name of a disk file containing one or more
     Orders.  You may specify <cOrderBagName> as the filename with or without
     the pathname or extension.  If you do not include the extension as part
     of <cOrderBagName>, CA-Clipper uses the default extension of the current
     RDD.

 Returns

     DBSETINDEX() always returns NIL.

 Description

     DBSETINDEX() is a database function that adds the contents of an Order
     Bag into the Order List of the current work area.  Any Orders already
     associated with the work area continue to be active.  If the newly
     opened Order Bag is the only Order associated with the work area, it
     becomes the controlling Order; otherwise, the controlling Order remains
     unchanged.  If the Order Bag contains more than one Order, and there are
     no other Orders associated with the work area, the first Order in the
     new Order Bag becomes the controlling Order.

     DBSETINDEX() is a compatibility command and therefore not recommended.
     It is superseded by the ORDLISTADD() function.

 Examples

     USE Customer NEW
     DBSETINDEX( "Cust01" )        // Open the index Cust01
                                   // in the current work area
     DBSETINDEX( "Cust02" )        // Open the index Cust02
                                   // leaving Cust01 open

 Status:  Enhanced

 See also:  ORDLISTADD()