ORDDESTROY() function
 Remove a specified Order from an Order Bag
------------------------------------------------------------------------------
 Syntax

     ORDDESTROY(<cOrderName> [, <cOrderBagName> ]) --> NIL

 Arguments

     <cOrderName> is the name of the Order to be removed from the current
     or specified work area.

     <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 appropriate extension.  If you do not include the
     extension as part of <cOrderBagName> CA-Clipper uses the default
     extension of the current RDD.

 Returns

     ORDDESTROY() always returns NIL.

 Description

     ORDDESTROY() is an Order management function that removes a specified
     Order from multiple-Order Bags.

     The active RDD determines the Order capacity of an Order Bag.  The
     default DBFNTX and the DBFNDX drivers only support single-Order Bags,
     while other RDDs may support multiple-Order Bags (e.g., the DBFCDX and
     DBPX drivers).

     Note:  RDD suppliers may define specific behaviors for this command.

     Warning!  ORDDESTROY() is not supported for DBFNDX and DBFNTX.

 Examples

     .  This example demonstrates ORDDESTROY() with the FoxPro driver,
        DBFCDX:

        USE Customer VIA "DBFCDX" NEW
        SET INDEX TO Customer, CustTemp
        ORDDESTROY( "CuAcct", "Customer" )

 Status:  New

 See also:  DELETE TAG, ORDCREATE()