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