% @(#)synchrtime.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:44:00 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      synchrmidas.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SYNCHRONIZE/TIME
%.PURPOSE    On-line help file for the command: SYNCHRONIZE/TIME
%.VERSION    1.0  20-OCT-1993 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./TIME
\es\co
SYNCHRONIZE/TIME					 27-AUG-1996  KB
\oc\su
SYNCHRONIZE/TIME option
	do time synchronization functions
\us\pu
Purpose:
          Do time synchronization functions.
\up\sy
Syntax:  
          SYNCHRONIZE/TIME [option]
\ys\pa
          option = CHECK, check if timeout reached at this very moment in a
              Midas procedure (i.e. this command is a NoOp in interactive mode)
\ap\sa
See also:
          SET/MIDAS maxtime=...
\as\no
Note:   
          This command has to be used inside Midas procedures which do not
          execute an application (host command) or another Midas procedure
          to enable a timeout.
\\
          The timeout value `n' (in seconds) is set via the command "SET/MIDAS
          maxtime=n" previously.
\\
          If the maximum time is exceeded the procedure is aborted.
\\
          The following (trivial) example ensures that the procedure stops
          once the maximum time is reached:
\\
          DEFINE/LOCAL loopi/i/1/1 0
\\
          DO loopi = 1 {p1}
\\
             WRITE/OUT value = {loopi}
\\
             SYNCHRO/TIME check
\\
          ENDDO
\\
          Because the host commands are executed in a child process where the
          time is checked automatically, the following DO loop does NOT need
          the SYNCHRONIZE/TIME command:
\\
          DEFINE/LOCAL loopi/i/1/1 0
\\
          DO loopi = 1 {p1}
\\
             $echo value = {loopi}
\\
          ENDDO
\on\exs
Examples:
\ex
          see above
\xe\sxe