DBSETINDEX()
 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 file name with or
     without the path name 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.

     Note: DBSETINDEX() does not close all currently open index files.

     DBSETINDEX() is a compatibility command and therefore is 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