<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 98.1p1 release (March 2nd, 1998)
originally by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Starting the MIDAS Monitor</TITLE>
<META NAME="description" CONTENT="Starting the MIDAS Monitor">
<META NAME="keywords" CONTENT="vol1">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<LINK REL="STYLESHEET" HREF="vol1.css">
<LINK REL="next" HREF="node24.html">
<LINK REL="previous" HREF="node22.html">
<LINK REL="up" HREF="node22.html">
<LINK REL="next" HREF="node24.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html771"
HREF="node24.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="icons.gif/next_motif.gif"></A>
<A NAME="tex2html767"
HREF="node22.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="icons.gif/up_motif.gif"></A>
<A NAME="tex2html761"
HREF="node22.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="icons.gif/previous_motif.gif"></A>
<A NAME="tex2html769"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="icons.gif/contents_motif.gif"></A>
<A NAME="tex2html770"
HREF="node216.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index"
SRC="icons.gif/index_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html772"
HREF="node24.html">MIDAS And the Host</A>
<B> Up:</B> <A NAME="tex2html768"
HREF="node22.html">Monitor and Command Language</A>
<B> Previous:</B> <A NAME="tex2html762"
HREF="node22.html">Monitor and Command Language</A>
<BR>
<BR>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION00610000000000000000"> </A> <A NAME="1311"> </A>
<A NAME="starting-the-midas-monitor"> </A>
<BR>
Starting the MIDAS Monitor
</H1>
<P>
In order to get properly initialised, MIDAS needs the following information
<UL>
<LI>the MIDAS user mode to work in: <I>Parallel</I> or <I>Single User</I>
mode, <A NAME="1316"> </A>
<BR>
the default is <I>Single User</I> mode
<LI>the MIDAS working directory for internal files and (optionally) private
procedures: <BR>
the default is a subdirectory <TT>midwork</TT> in your login directory,
<BR>
i.e. <TT>SYS$LOGIN:[MIDWORK]</TT> in VMS or
<TT>$HOME/midwork in Unix</TT>.
<BR>
This directory does not have to be (or even should not be) the same
directory where your data files are stored.
</UL> <BR>
On a VMS system type <TT>SETMIDAS</TT> and follow the dialog
if you want to change the defaults for the mode and the MIDAS work directory.
<BR>
On a Unix/Linux system use the option <I>-m </I><<I>mid_work</I>> to change
the default
working directory, and <I>-p</I> or <I>-P</I> to run MIDAS in parallel mode<A NAME="1326"> </A> when
you start MIDAS via the command <TT>inmidas</TT> (see below).
Two other variables are very important to MIDAS - <TT>MIDVERS</TT>,
which holds the MIDAS
version you use at your site, and <TT>MIDASHOME</TT>, the root directory for
the MIDAS system code.
These variables should have been set up correctly by your system manager when
MIDAS was installed or use again <TT>SETMIDAS</TT> in VMS; for Unix these
variables can again be chosen within the <TT>inmidas</TT> command.
There are many more options for the <TT>inmidas</TT> command in Unix, which can be
accessed interactively via the man page of <TT>inmidas</TT> (a complete Midas
installation should also include the setting up of the man pages for
<TT>inmidas</TT>, <TT>gomidas</TT> and <TT>helpmidas</TT>).
<BR>
The detailed command description is as follows:
<P>
<PRE>
SYNOPSIS
inmidas [ unit ] [ -h midashome ] [ -r midvers ] [ -d display ]
[ -m mid_work ] [ -p/-P/-nop ] [ -noh ] [ -j midas-command-line ] [ -help ]
Without arguments, inmidas initiates a MIDAS session with default
definitions. Some of these definitions can be modified with arguments in
the command line of inmidas or by environment variables. The arguments
in the command line override the corresponding environment variables.
OPTIONS
inmidas has been configured by the Midas system manager at installation
time to start a specific release of MIDAS. However, alternative releases
can be specified using the command line arguments:
-h midashome
Home directory for MIDAS. Absolute pathname containing, at least, one
release of MIDAS. It may also contain subdirectories for demo and
calibration data.
-r midvers
Release of MIDAS to be executed. It must be a subdirectory under
midashome.
-d display
Specifies another X server for the display and graphical MIDAS windows
NOTE: be aware of allowed access to a remote X server using the "xhost"
command.
-p/-P/-nop
Options -p and -P set the MIDAS environment variable MIDOPTION to
PARALLEL while option -nop sets it to NOPARALLEL (default: NOPARALLEL).
In NOPARALLEL mode all intermediate MIDAS files in the MIDAS startup
directory are deleted when starting MIDAS via inmidas.
In PARALLEL mode no intermediate files are deleted, and this is
necessary to run several MIDAS sessions with the same startup directory.
With -P option and if unit is not given the system will select
automatically one free unit for you. With -p option and no unit, the
user will be requested to enter one.
unit
Unit to be associated to the MIDAS session (default: 00 only if MIDAS
is working in NOPARALLEL mode). Valid values for this option are in the
range (00, 01, ..., 99, xa, ..., zz) where numerical values indicate
that the user is working in an X11 environment (DISPLAY environment
variable or argument -d should be given), and the others indicate an
ASCII terminal.
-m mid_work
Specifies the MIDAS startup directory (default: $HOME/midwork).
-noh
Starts MIDAS without clearing the terminal and without welcome message.
-j midas-command-line
midas-command-line will be executed in MIDAS as if it were the first
command line typed in the MIDAS monitor.
This option sets also the -noh option.
NOTE: midas-command-line should be typed between single quotes to be
interpreted by inmidas as a single argument and to be passed to the
MIDAS monitor as it is.
-help
Display this help page.
</PRE>
<P>
<BR>
So, to start MIDAS, type <TT>INMIDAS</TT> on a VMS system or <TT>inmidas
[arg1] ...</TT><A NAME="1341"> </A> on a Unix system.
This will initialize the MIDAS monitor as follows:<DL COMPACT><DT>-
<DD>In VMS the logical name <TT>MID_WORK</TT> is assigned to the MIDAS
working directory;
in Unix the environment variable <TT>MID_WORK</TT> is set accordingly. If the
working directory does not yet exist, it is created.
<BR>
All internal files created by the MIDAS monitor will be stored in
the MIDAS working directory.
This is also the place to store your own <TT>login.prg</TT><A NAME="1346"> </A>
as well as all your other MIDAS procedures which you want to execute from
any other directory.
<DT>-
<DD>In <I>Single User</I> mode, all MIDAS log- and
keyfiles (FORGRxy.LOG, FORGRxy.KEY - where
<TT>xy</TT> is the MIDAS unit described below) which exist in the MIDAS working
directory as well as all MIDAS internal files are deleted. <BR>
In <I>Parallel</I> mode no files are deleted.
<DT>-
<DD>In VMS the user process is renamed to <TT>MIDASxy</TT>
<DT>-
<DD>In VMS and in parallel mode in Unix
you will be asked to enter the identification of a
MIDAS unit <A NAME="1351"> </A> as a two-character (case insensitive)
string.
<BR>
Units are in the range (<TT>00, 01, ..., 99, xa, ..., zz</TT>) where numerical
values indicate that the user is working in an X11 environment (DISPLAY
environment variable should be set), and the others define a MIDAS session
with no image display capabilities.
<BR>
So <TT>23</TT>, <TT>xa</TT>, <TT>yf</TT> or <TT>Z3</TT> will all be valid units.
If you work in <I>Parallel</I>
mode you have to use different MIDAS units for each session because
the MIDAS unit is appended to the names of all MIDAS internal files.</DL> <BR>
On startup the current MIDAS version and patch level as well as the computer
and operating system you are using are displayed together with a copyright
notice.
Then the prompt string<BLOCKQUOTE>
<TT>Midas 001</TT>></BLOCKQUOTE>appears on the terminal screen and
you are ready to execute any of the available MIDAS commands. <BR>
<BR>
The internal MIDAS files all reside in the MIDAS working directory
<TT>MID_WORK</TT>,
the data files are taken from the current working directory unless the
complete file specification is given in the data file name.
<BR>
Since MIDAS executes its applications in a child process (subprocess
for VMS) which leaves no traces after termination, you cannot simply
use the host command <TT>SET DEF</TT> (VMS) or <TT>cd</TT> (Unix) to change
the working directory once you are in a MIDAS session.
Instead, use the MIDAS command <TT>change/direc</TT> for that purpose.
<BR>
Another possibility is to set the search path for your data files via the
command
<BR>
<TT>set/midas_system DPATH=directory</TT>. Use the MIDAS Help Utility
for obtaining detailed information about these commands, e.g. <TT>HELP change/direc</TT>.
<BR>
MIDAS is a case insensitive system. That means, you can type your input
with upper or lower case characters. There are, however, some
pitfalls with respect to the data files that reside in the local file
system. In VMS, the system automatically translates all file names
to upper case, so <TT>LOLA.BDF</TT> and <TT>lola.bdf</TT> specify exactly the
same file. In Unix, file names may be specified using lower and upper case, so
<TT>LOLA.BDF</TT> and <TT>lola.bdf</TT> are two different files.
The convention in MIDAS is to always use lower case file names (e.g. in
tutorial procedures) to guarantee portability between VMS and Unix.
Also, all default file types are specified in lower case,
e.g. <TT>.bdf</TT> and <TT>.tbl</TT> for images and tables.
<P>
<BLOCKQUOTE>
<DIV ALIGN="CENTER">
<B>Note</DIV>
<I>All MIDAS commands in the following sections are printed with capital letters.
This is
just for reasons of readability, i.e., to highlight them.
The commands could all be typed in lower case as well.</I></B></BLOCKQUOTE>
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html771"
HREF="node24.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="icons.gif/next_motif.gif"></A>
<A NAME="tex2html767"
HREF="node22.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="icons.gif/up_motif.gif"></A>
<A NAME="tex2html761"
HREF="node22.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="icons.gif/previous_motif.gif"></A>
<A NAME="tex2html769"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="icons.gif/contents_motif.gif"></A>
<A NAME="tex2html770"
HREF="node216.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index"
SRC="icons.gif/index_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html772"
HREF="node24.html">MIDAS And the Host</A>
<B> Up:</B> <A NAME="tex2html768"
HREF="node22.html">Monitor and Command Language</A>
<B> Previous:</B> <A NAME="tex2html762"
HREF="node22.html">Monitor and Command Language</A>
<!--End of Navigation Panel-->
<ADDRESS>
<I>Petra Nass</I>
<BR><I>1999-06-09</I>
</ADDRESS>
</BODY>
</HTML>
