% @(#)disconback.hlq	19.1 (ESO-IPG) 02/25/03 14:03:16 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      disconback.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, DISCONNECT/BACK_MIDAS
%.PURPOSE    On-line help file for the command: DISCONNECT/BACK_MIDAS
%.VERSION    1.0  04-AUG-1994 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./BACK_MIDAS
\es\co
DISCONNECT/BACK_MIDAS					04-AUG-1994  KB
\oc\su
DISCONNECT/BACK_MIDAS unit [server_flag]
	disconnect from a background MIDAS 
\us\pu
Purpose:
          Disconnect from a previously connected background MIDAS.
\up\sy
Syntax:
          DISCONNECT/BACK_MIDAS unit [server_flag]
\ys\pa
          unit = unit of background Midas;
\\
               if omitted or = `*', all connected background Midas
               sessions will be disconnected
\ap\pa
          server_flag = flag indicating additional actions on the server
               side (in background Midas);
               X - background Midas (server) also closes the connection, i.e.
                   switches to foreground mode (interactive input);
\\
               Z - background Midas (server) closes the connection and also
                   terminates;
\\
               N - leave background Midas as it is; that's the default
\ap\sa
See also:
         CONNECT/BACK_MIDAS, SET/BACKGROUND, CLEAR/BACKGROUND
\\
         [BackgroundMidas]
\as\no
Note:  
         This command cuts the connection from the current Midas to another
         Midas session, i.e. you cannot send commands to it anymore.
\\
         Using the server_flag ensures that the background Midas (server)
         closes it's connection AFTER the foreground Midas (client) has closed
         its connection, as is required for socket based communication.
\\
         In order to achieve this, the connection must have been set up
         with the NO_WAIT option!
\on\exs
Examples:
\ex
         DISCONNECT/BACK 77 
           Cut the connection to Midas session with unit 77.
           It is assumed that a command: CONNECT/BACK_MIDAS 77 has been
           executed before. The Midas session 77 remains in background mode.
\xe\ex
         DISCONNECT/BACK * Z
           Cut the connection to all Midas sessions we are connected to
           and terminate those Midas sessions as well.
\xe\ex
         DISCONNECT/BACK 
           Cut the connection to all Midas sessions we are connected to
           and leave those Midas sessions in background mode, so we can later
           reconnect to them.
\xe \sxe
