Click above to get retro games delivered to your door ever month!

 AX_ChooseOrdBagExt()
 Allows the programmer to choose which extension ordBagExt() will return for
 the DBFCDXAX RDD
------------------------------------------------------------------------------

 Syntax

     AX_ChooseOrdBagExt( [<cBagExt>] ) -> charstring

     <cBagExt>  An optional character string specifying the index
     extension to be returned by the ordBagExt() function for the
     DBFCDXAX RDD. Valid values are ".IDX" and ".CDX". The default
     value is ".IDX".

 Returns

     If no parameter is passed, then it returns the current index
     extension that will be returned by ordBagExt() for the DBFCDXAX
     RDD. If a parameter is passed, then it returns the previous index
     extension that was returned by ordBagExt() for the DBFCDXAX RDD.

 Description

     CA-Clipper's ordBagExt() returns the default index extension for
     the current RDD. CA-Clipper's DBFCDX RDD and Loadstone's COMIX RDD
     return ".CDX" from the ordBagExt() function. By default, Advantage's
     DBFCDXAX RDD returns ".IDX" from the ordBagExt() function.
     AX_ChooseOrdBagExt() allows the programmer to choose which extension
     ordBagExt() should return for the DBFCDXAX RDD. Therefore, the
     Advantage "default" index extension for its CDX RDD can be changed
     to ".CDX" so that ordBagExt() will return the same value as
     CA-Clipper's DBFCDX RDD and Loadstone's COMIX RDD.

     Note: The Advantage DBFCDXAX RDD existed before the CA-Clipper
     DBFCDX RDD and the Loadstone COMIX RDD.  Thus, by existing first,
     Advantage "defined" the standard return value for the "index
     extension" functions to be ".IDX" for CDX/IDX RDDs.  DBFCDX and COMIX
     chose to not follow this standard and returned ".CDX" instead.
     Advantage cannot change it's default of ".IDX" as that would likely
     break existing Advantage applications who rely on the returned value
     to be ".IDX".  Thus, we provided this AX_ChooseOrdBagExt() function
     for those who want the returned value to be ".CDX".

     Note: AX_ChooseOrdBagExt() has no effect on the Advantage NTX RDD,
     DBFNTXAX. OrdBagExt() will always return ".NTX" for the DBFNTXAX
     RDD.

 Example

     USE test VIA "DBFCDXAX"

     ? AX_ChooseOrdBagExt()         // Will return ".IDX"
     ? ordBagExt()                  // Will return ".IDX"

     // Change Advantage's "default" index extension to .CDX
     AX_ChooseOrdBagExt( ".CDX" )
     ? ordBagExt()                  // Will return ".CDX"