| 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) |