SETTIME()
 Sets the system clock
------------------------------------------------------------------------------
 Syntax

     SETTIME(<cTime>, [<lMode>]) --> lSet

 Arguments

     <cTime>  Designates a character string that contains the time that
     is to become the system time.

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

 Returns

     The function returns .T. when the time is set successfully.

 Description

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

 Note

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

 Examples

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

        cNewTime  :=  "10:20:00"
        IF ISAT()
           SETTIME(cNewTime, .T.)
        ELSE
           SETTIME(cNewTime)
        ENDIF

     .  Or, more compactly:

        SETTIME(cNewTime, ISAT())