← Back to branch summary

~ubuntu-branches/ubuntu/wily/eso-midas/wily-proposed

« back to all changes in this revision

Viewing changes to prim/help/set_back.hlq

  • Committer: Package Import Robot
  • Author(s): Ole Streicher
  • Date: 2014-04-22 14:44:58 UTC
  • Revision ID: package-import@ubuntu.com-20140422144458-okiwi1assxkkiz39
Tags: upstream-13.09pl1.2+dfsg
Import upstream version 13.09pl1.2+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
prim/help/set_back.hlq
 
1
% @(#)set_back.hlq      13.1.1.1 (ESO-IPG) 06/02/98 18:14:55 
 
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
3
%.COPYRIGHT  (c)  1990 European Southern Observatory
 
4
%.IDENT      set_back.hlq
 
5
%.AUTHOR     KB, IPG/ESO
 
6
%.KEYWORDS   MIDAS, help files, SET/BACKGROUND
 
7
%.PURPOSE    On-line help file for the command: SET/BACKGROUND
 
8
%.VERSION    1.0  12-MAR-1990 : Creation, KB
 
9
%.VERSION    1.1  22-FEB-1993 : Update, KB
 
10
%----------------------------------------------------------------
 
11
\se
 
12
SECTION./BACKGROUND
 
13
\es\co
 
14
SET/BACKGROUND                                  19-JAN-1999  KB
 
15
\oc\su
 
16
SET/BACKGROUND [method] [echo] [sleep_time]
 
17
        put Midas session into "background" mode
 
18
\us\pu
 
19
Purpose:
 
20
        Put Midas session into "background" mode
 
21
\up\sy
 
22
Syntax:
 
23
         SET/BACKGROUND [method] [echo] [sleep_time]
 
24
\ys\pa
 
25
         method = SOCKETS or FILES, if we want to communicate via Unix
 
26
              sockets or via ASCII files.
 
27
\\
 
28
              For the SOCKETS method the communicating Midas sessions may
 
29
              run on the same host or different hosts in the network.
 
30
\\
 
31
              If the Midas session from which we will receive commands is not
 
32
              running on the same host , the "SOCKETS,remote" has to be used.
 
33
\\
 
34
              For the FILES method the communicating Midas sessions have
 
35
              to run on the same host.
 
36
\ap\pa
 
37
         echo = ON or OFF, to echo the no. of bytes received and the unit
 
38
              of the sending Midas or not;
 
39
\\
 
40
              defaulted to ON
 
41
\ap\pa
 
42
         sleep_time = no. of seconds to wait before looking for input;
 
43
\\
 
44
              only applicable for `method'=FILES, defaulted to 1
 
45
\ap\sa
 
46
See also:
 
47
         CLEAR/BACKGROUND, CONNECT/BACK_MIDAS
 
48
\as\no
 
49
Note:  
 
50
         This command currently works only in Unix, not in VMS!
 
51
\\
 
52
         In background mode Midas does not accept input typed at the keyboard.
 
53
         Instead Midas waits for commands sent by other Midas sessions
 
54
\\
 
55
         If communicating Midas sessions run on the same host, they must be
 
56
         started in parallel mode.
 
57
\\
 
58
         If the communication is based on files, the background Midas receives
 
59
         a signal from the sending Midas when a command has been sent.
 
60
\\
 
61
         The par. `sleep_time' is only needed for those cases where the
 
62
         sender is not another Midas session but a stand-alone program 
 
63
         on a different host executing in a different environment, e.g.
 
64
         OS/9 or "Rocky Mountain Basic" from HP.
 
65
\\
 
66
         If the communication is based on sockets, i.e. the Unix OSX interfaces
 
67
         are used, the SET/BACKGROUND command has to be given before any other
 
68
         Midas connects to this session via the CONNECT/BACK_MIDAS command 
 
69
\\
 
70
         The echo can be updated later on by another call to SET/BACK,
 
71
         however, the method remains fixed.
 
72
\on\exs
 
73
Examples:
 
74
\ex
 
75
         SET/BACKGR 
 
76
          Put current Midas into background mode, use ASCII files for 
 
77
          communication and echo the sender Midas unit for incoming commands.
 
78
\xe \ex
 
79
         SET/BACKGR sockets off
 
80
          Put current Midas into background mode, use the osx interfaces 
 
81
          communication and do not echo the sender Midas unit for incoming
 
82
          commands.
 
83
\\
 
84
          Only input from Midas sessions running on the same host is received.
 
85
\xe \ex
 
86
         SET/BACKGR sockets,remote off
 
87
          As above, but input from Midas sessions running on other hosts in
 
88
          the network is received.
 
89
\xe \sxe