ORDNAME() function
 Return the name of an Order in the Order List
------------------------------------------------------------------------------
 Syntax

     ORDNAME(<nOrder>[,<cOrderBagName>])
        --> cOrderName

 Arguments

     <nOrder> is an integer that identifies the position in the Order
     List of the target Order whose database name is sought.

     <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 <xcOrderBagName> CA-Clipper uses the default
     extension of the current RDD.

 Returns

     ORDNAME() returns the name of the specified Order in the current Order
     List or the specified Order Bag if opened in the Current Order list.

 Description

     ORDNAME() is an Order management function that returns the name of the
     specified Order in the current Order List.

     If <cOrderBagName> is an Order Bag that has been emptied into the
     current Order List, only those Orders in the Order List that correspond
     to <cOrderBagName> Order Bag are searched.

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

 Examples

     .  This example retrieves the name of an Order using its position
        in the order list:

        USE Customer NEW
        SET INDEX TO CuAcct, CuName, CuZip
        ORDNAME( 2 )                        // Returns: CuName

     .  This example retrieves the name of an Order given its position
        within a specific Order Bag in the Order List:

        USE Customer NEW
        SET INDEX TO Temp, Customer
        // Assume Customer contains CuAcct, CuName, CuZip
        ORDNAME( 2, "Customer" )            // Returns: CuName

 Status:  New

 See also:  ORDFOR(), ORDKEY(), ORDNUMBER()