% @(#)clear_back.hlq	19.1 (ESO-IPG) 02/25/03 14:03:00
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      clear_back.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CLEAR/BACKGROUND
%.PURPOSE    On-line help file for the command: CLEAR/BACKGROUND
%.VERSION    1.0  12-MAR-1990 : Creation, KB
%.VERSION    1.1  22-FEB-1993 : Update, KB
%----------------------------------------------------------------
\se
SECTION./BACKGROUND
\es\co
CLEAR/BACKGROUND					04-NOV-1996  KB
\oc\su
CLEAR/BACKGROUND [no_secs]
	put Midas session into "foreground" mode
\us\pu
Purpose:
         Put Midas session back into "foreground" mode, i.e. close the
         communication from server side.
\up\sy
Syntax:
         CLEAR/BACKGROUND [no_secs]
\ys\pa
         no_secs = no. of seconds to wait before actually changing to the
                   foreground mode (i.e. closing the communication); 
\\
                   defaulted to 0
\ap\sa
See also:
         SET/BACKGROUND, CONNECT/BACK_MIDAS
\as\no
Note:  
         In foreground mode Midas accepts input typed at the keyboard. In
         background mode the input is sent from another Midas session (or any
         other process using the communication interfaces of Midas) which is
         a client of this background Midas session.
\\
         This command is typically sent from another Midas session, since the
         current Midas session being in background mode does not accept any
         command typed in by the user.
\\
         Since the server must close the communication only after all clients
         have closed their communication, the parameter `no_secs' may be
         used by a client to close its communication (via command
         DISCONNECT/BACK_MIDAS) before the background Midas actually executes
         the CLEAR/BACKGR which was sent to it.
\on\exs
Examples:
\ex
         CLEAR/BACKGR 
           Put this (current) Midas from background into foreground 
           (interactive) mode.
\xe\ex
         b,CLEAR/BACKGR 5
           Send to a connected, background Midas (for details see HELP of 
           CONNECT/BACK_MIDAS) the command CLEAR/BACKGR which will be executed
           by the background Midas (server) after 5 seconds.
           In the meantime this Midas can execute DISCONNECT/BACK_MIDAS.
\\
           Naturally, the connection should have been established with the
           NO_WAIT option!
\xe \sxe
