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

 AX_ExprEngine()
 Turns the Advantage Expression Engine ON or OFF
------------------------------------------------------------------------------

 Syntax

     AX_ExprEngine( [<.T.|.F.>] ) -> logical

     [.T. | .F.] Optional logical value.  A value of .T. enables the
     Advantage Expression Engine. A value of .F. disables the Advantage
     Expression Engine.

 Returns

     Returns the previous setting. If no parameter is passed, the current
     state is returned.

 Description

     Advantage can perform certain CA-Clipper operations, such as index
     creation and SET FILTERs, completely on the server using Advantage's
     Expression Engine.  The Advantage Expression Engine is used to parse
     and evaluate expressions in the CA-Clipper commands. These commands
     may cause the server utilization to increase. If you would prefer to
     not have these commands executed on the server (at the penalty of a
     severe performance decline), you can shut the Advantage Expression
     Engine OFF by calling AX_ExprEngine(.F.).

     If a command that would ordinarily be performed on the server was
     performed instead on the client because the Advantage Expression
     Engine was turned off, an error code will be generated and can be read
     by the function, AX_ExprError(). The error is returned to notify you
     that the command was being executed on the client and not the server.

 Example

     USE test VIA "DBFNTXAX"
     AX_ExprEngine( .F. )          // Turn Expression Engine OFF

     INDEX ON lastname TO slow     // Index built on client

     ? AX_ExprError()              // An error code that is greater than
                                   // zero will be displayed signifying
                                   // that the command was executed on the
                                   // client rather than the server.

     AX_ExprEngine( .T. )          // Turn Expression Engine ON

     INDEX ON firstname TO fast    // Index built on server

     ? AX_ExprError()              // A zero will be displayed
                                   // signifying that no error occurred
                                   // and the index was built on the
                                   // server.