Debian Codegraph @

system/unix/manl/inmidas.l

raw
1 .\" @(#)inmidas.l 19.1 (ESO-IPG) 02/25/03 14:32:14
2 .\" Copyright (c) 1989 European Southern Observatory.
3 .\" All rights reserved.
4 .\"
5 .TH inmidas 1L "11 November 1994" MIDAS
6 .SH NAME
7 inmidas \- MIDAS start-up procedure for users.
8 .SH SYNOPSIS
9 .B inmidas
10 [
11 .I unit
12 ] [
13 .B \-h
14 .I midashome
15 ] [
16 .B \-r
17 .I midvers
18 ]
19 .br
20 [
21 .B \-d
22 .I display
23 ] [
24 .B \-m
25 .I mid_work
26 ] [
27 .B \-p/-P/-nop
28 ] [
29 .B \-noh
30 ]
31 .br
32 [
33 .B \-j
34 .I midas-command-line
35 ] [
36 .B \-help
37 ]
38 .SH DESCRIPTION
39 .I inmidas
40 starts a new MIDAS session.
41 .PP
42 Without arguments,
43 .I inmidas
44 initiates a MIDAS session with default definitions.
45 Some of these definitions can be modified with arguments in the command line of
46 .I inmidas
47 or by environment variables. Arguments in the command
48 line are taken with preference to environment variables.
49 .SH OPTIONS
50 .I inmidas
51 has been configured by the operator at installation time to start a release
52 of MIDAS located in
53 .IR $MIDASHOME0/$MIDVERS0
54 (defined internally in the script).
55 However alternative releases can be specified using the:
56 .IP "\fB-h\fp \fImidashome\fp"
57 Home directory for MIDAS. Absolute pathname containing, at least, one release
58 of MIDAS. It may also contain subdirectories for demo and calibration data.
59 .IP "\fB-r\fp \fImidvers\fp"
60 Release of MIDAS to be executed. It must be a subdirectory under
61 .IR midashome.
62 .IP "\fB-d\fp \fIdisplay\fp"
63 Specifies another X server for the display and graphical MIDAS windows (
64 .B NOTE:
65 be aware of allowed access to a remote X server using the
66 .IR xhost (1)
67 command.)
68 .IP "\fB-p/-P/-nop\fp"
69 Options
70 .I -p
71 and
72 .I -P
73 set the MIDAS environment variable MIDOPTION to PARALLEL while option
74 .I -nop
75 sets it to NOPARALLEL (default: NOPARALLEL).
76 In NOPARALLEL mode all intermediate MIDAS working files in the MIDAS startup
77 directory are deleted when starting MIDAS via
78 .I inmidas.
79 In PARALLEL mode no intermediate files are deleted, and this is necessary
80 to run several MIDAS sessions with the same startup directory.
81 With
82 .I -P
83 option and if not
84 .I unit
85 is given the system will select
86 automatically one free unit for you. With
87 .I -p
88 option and no
89 .I unit
90 , the user will be requested to enter one.
91 .IP "\fIunit\fp"
92 Unit to be associated to the MIDAS session (default: 00 only if MIDAS is
93 working in NOPARALLEL mode). Valid values for
94 this option are in the range (00, 01, ..., 99, xa, ..., zz) where numerical
95 values indicates that the user is working on a X11 environment (DISPLAY
96 environment or argument
97 .B -d
98 should be given),
99 and the rest indicates an ASCII or graphical terminals others than X11.
100 .IP "\fB-m\fp \fImid_work\fp"
101 Specifies the MIDAS startup directory (default: $HOME/midwork). MIDAS will
102 create this directory if it does not exist and writes in there temporary
103 files used by MIDAS (e.g.: FORGRnn.LOG that logs the MIDAS session). It is
104 also the directory for automatic start procedures like the "login.prg" file
105 and for the "devices.sh" file containing particular MIDAS device-names
106 defined by users.
107 At the end of the MIDAS session
108 .I inmidas
109 will saved the MIDAS session in a hidden file located in this directory.
110 This file will be then used later by the
111 .I gomidas
112 command to resume this MIDAS session where it exited.
113 .IP "\fB-noh\fp"
114 Starts MIDAS without clearing the terminal and without any welcome message.
115 .IP "\fB-j\fp \fImidas command line\fp"
116 .I midas-command-line
117 will be executed in MIDAS as if it were the first
118 command line typed in the MIDAS monitor. This option sets also
119 .B \-noh
120 option.
121 .B NOTE:
122 .I midas-command-line
123 should be typed between single quotes to be interpreted by
124 .I inmidas
125 as a single argument and to be passed to the MIDAS monitor as it is.
126 .IP "\fB-help\fp"
127 Display a brief description of all options and exits quietly.
128 .SH ENVIRONMENT
129 .I inmidas
130 can also use the following definitions in
131 the environment with the same performance as previous described arguments.
132 .br
133 .B NOTE:
134 Arguments in the
135 .I inmidas
136 command line are taken with preference to environment variables.
137 .IP "\fBMIDASHOME\fp"
138 Home directory for MIDAS.
139 .IP "\fBMIDVERS\fp"
140 Release of MIDAS.
141 .IP "\fBDISPLAY\fp"
142 X server for the display and graphical MIDAS windows.
143 .IP "\fBMIDOPTION\fp"
144 Set to PARALLEL or NOPARALLEL.
145 .IP "\fBMID_WORK\fp"
146 Startup directory for MIDAS.
147 .SH SEE ALSO
148 .IR gomidas(1L)