SETDATE()
 Sets the system date
------------------------------------------------------------------------------
 Syntax

     SETDATE(<dDate>, [<lMode>]) --> lSet

 Arguments

     <dDate>  Designates which date to use to set the system date.

     <lMode>  Designates whether the date should also be set in the CMOS-
     RAM of an AT.  The default is do not write (.F.).

 Returns

     SETDATE() returns .T. when the date is successfully set.

 Description

     When you use this function to set the system date from within your
     CA-Clipper application, all files acquire this date with each write
     procedure.

 Note

     .  Please note that you can only implement the optional <lMode>
        parameter for AT-compatible machines.  The correct operation of
        SETDATE() cannot be guaranteed on machines that use a hardware clock.
        The default value for <lMode> is .F..

 Examples

     .  Set the system date in each case; but the hardware clock only
        on an AT:

        dNewDate  :=  CTOD("07/30/91")
        IF ISAT()
           SETDATE(dNewDate, .T.)
        ELSE
           SETDATE(dNewDate)
        ENDIF

     .  Or, more compactly:

        SETDATE(dNewDate, ISAT())