[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 Empty orders from an order bag into the order list

     DBSETINDEX(<cOrderBagName>) --> NIL


     <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.


     DBSETINDEX() always returns NIL.


     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.


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

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson