$FUNCNAME$
  DBSETINDEX()
$CATEGORY$
  DATABASE
$SUMMARY$
   Empty orders from an order bag into the order list
$LANG_RU$
      .
$SYNTAX$
     DBSETINDEX(<cOrderBagName>) --> NIL
$LANG_RU$
     DBSETINDEX( <  > ) --> 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>, xClipper uses the default extension of the
     current RDD.
$LANG_RU$
     <  > -  ,   
       .
$RETURNS$
     DBSETINDEX() always returns NIL.
$LANG_RU$
     DBSETINDEX()   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.
$LANG_RU$
     DBSETINDEX()       .
       ,      ,
       .      
      ,    ,   
      ,   ,    
     .

            
            .

     DBSETINDEX()    ,     SET
     INDEX   INDEX  USE.   
        SET INDEX.
$SEEALSO$
  ORDLISTADD(),DBCLEARINDEX(),DBCREATEINDEX(),DBREINDEX(),DBSETORDER()
$END$
