CHAPTER 2 INSTALLATION
MIIPS was originally designed to run under the VMS operating
system. Some components such the binary, grades, plot package,
and enhanced saoimage, will run under Unix and Linux as well.
There are long range plans to implement operation of the main
MIIPS program under Linux. You can receive your copy of MIIPS on
tape in BACKUP mode, or from the MIIPS website in zipped BACKUP.
This will facilitate the proper creation of subdirectories when
MIIPS is installed. One should set up either an account named
MIIPS, or some other account where a subdirectory [ACCOUNT.MIIPS]
can be created. MIIPS modules will reside in subdirectories
below the MIIPS level. In the version that you will receive, all
MIIPS modules are found in the level [MIIPS] and lower. For
multiuser activity, each user should have his or her individual
account, but be included in a group which includes the account on
which MIIPS is located. In addition to the main directory,
[MIIPS] or [ACCOUNT.MIIPS], which will contain several system
related command files, a number of subdirectories are normally
used. They are 1) [MIIPS.MIIPS] for the MIIPS executable image,
other executable images called up by global commands, include
files, and MIIPS related command files, 2) [MIIPS.C] for some C
code, 3) [MIIPS.DISPLAY] for image display code, 4) [MIIPS.DOC]
for on line and other documentation, 5) [MIIPS.FOR] for virtually
all source code (except plotting and TV modules), 6)
[MIIPS.INCLUDE] for some include files, 7) [MIIPS.LIB] for object
code libraries, and some executables, 8) [MIIPS.PHOTOM] for
response functions, spectral energy distributions, catalogues,
and related editing executables, 9) [MIIPS.PLOT] for plotting
source code and executable images, 10) [MIIPS.SAMPLES] for sample
data used for some of the tutorials, 11) [MIIPS.UNIX...] for the
unix compatible modules, and 12) [MIIPS.XWINDOW] for some X
Window code. Presently, all these modules require about 93000
blocks of storage memory. A miminal installation could include
perhaps only [MIIPS], [MIIPS.MIIPS], [MIIPS.DOC], and
[MIIPS.PLOT].
The installation procedure consists of using the VMS BACKUP
utility to restore the file and directory structure on your VAX
hard disk.
In the main directory the command file LOGIN.COM that you
receive will contain:
$! Assign the logical name MIIPS$DISK to the current disk
$ ASSIGN DISK$DISK_1 MIIPS$DISK
$!
$! Enter your site specific commands below
$ DEFINE EMACS_TERM "VT340"
$! End of site specific login commands
$!
$ IF "''F$MODE()'" .EQS. "BATCH" THEN GOTO BATCHRUN
$! Set your terminal type; default here is series VT300
$ VT100:==SET TERMINAL/DEVICE_TYPE=VT100
$ VT300:==SET TERMINAL/DEVICE_TYPE=VT300
$! VT100
Page 2
$ VT300
$ BATCHRUN:
$!
$ @MIIPS$DISK:[MIIPS]MIIPS_LOGIN.COM
Modify the file as necessary. The command file
MIIPSLOGIN.COM, after installation, will contain global
definitions pertaining to the directories and the system. In the
version you will receive it will contain
$ COPY:==COPY/LOG
$ D:==DIR/SIZE/DATE
$ DIRS:==DIR/DATE/SIZE/SINCE
$ DIRT:==DIR/TOTAL/SIZE
$ DISP:==MONITOR PROC/TOPCPU
$ DEFINE EMACS_TERM "VT100"
$ F:==FORTRAN
$ M:==SET DEF MIIPS$DISK:[MIIPS]
$ MC:==SET DEF MIIPS$DISK:[MIIPS.C]
$ MD:==SET DEF MIIPS$DISK:[MIIPS.DOC]
$ MF:==SET DEF MIIPS$DISK:[MIIPS.FOR]
$ MI:==SET DEF MIIPS$DISK:[MIIPS.DISPLAY]
$ ML:==SET DEF MIIPS$DISK:[MIIPS.LIB]
$ MM:==SET DEF MIIPS$DISK:[MIIPS.MIIPS]
$ MN:==SET DEF MIIPS$DISK:[MIIPS.NONLINFIT]
$ MP:==SET DEF MIIPS$DISK:[MIIPS.PLOT]
$ MR:==SET DEF MIIPS$DISK:[MIIPS.REDSHIFT]
$ MS:==SET DEF MIIPS$DISK:[MIIPS.SAMPLES]
$ MUG:==SET DEF MIIPS$DISK:[MIIPS.UNIX.GENERAL]
$ MUI:==SET DEF MIIPS$DISK:[MIIPS.UNIX.DISPLAY]
$ MUP:==SET DEF MIIPS$DISK:[MIIPS.UNIX.PLOT]
$ PH:==SET DEF MIIPS$DISK:[MIIPS.PHOTOM]
$ PENTOTHAL:==@MIIPS$DISK:[MIIPS]PENTOTHAL.COM
$ REN:==RENAME
$ SD:==SET DEF
$ SE:==SEARCH
$ SHD:==SHOW DEFAULT
$ SHP:==SHOW PROCESS
$ SQB:==SHO QUEUE/BATCH
$ SQBA:==SHO QUEUE/BATCH/ALL
$ SPC:==SHO PROC/CONT
$ SS:==SHOW SYMBOL
$ SSB:==SHOW SYSTEM/BATCH
$ ST:==SET TERMINAL/LINE_EDITING/OVERSTRIKE
$ T:==TYPE
$ TIME:==SH TIME
$ TREE:==@MIIPS$DISK:[MIIPS]TREE.COM
$ U:==SET DEF [-]
$ VT100:==SET TERMINAL/DEVICE_TYPE=VT100
$ W80:==SET TERMINAL/WIDTH=80
$ W132:==SET TERMINAL/WIDTH=132
$!
$ SET PROTECTION=(SYSTEM:R,OWNER:RWED,GROUP:R,WORLD:R)/DEFAULT
$!
$ IF "''F$MODE()'" .EQS. "BATCH" THEN GOTO BATCHRUN
$ SET CONTROL=T
Page 3
$ ST
$ BATCHRUN:
$!
$ @MIIPS$DISK:[MIIPS.MIIPS]MIIPSMIIPS_LOGIN.COM
In the [-.MIIPS.MIIPS] subdirectory, the command file
LOGIN.COM should contain assignments and global definitions
pertaining to MIIPS. In the version you will receive, it will be
as follows:
$ ASSIGN MIIPS$DISK:[MIIPS.DOC] DTAB:
$ ASSIGN MIIPS$DISK:[MIIPS.PHOTOM] PTAB:
$ ASSIGN MIIPS$DISK:[MIIPS.LIB] LIBS:
$ ASSIGN MIIPS$DISK:[MIIPS.INCLUDE] LBY:
$! The following assignment is used in MIIPS.FOR
$ ASSIGN MIIPS$DISK:[MIIPS.PLOT] MIIPS$PLOT:
$! The following assignment is used in XYPLOT_PROGRAM
$ ASSIGN MIIPS$DISK:[MIIPS.PLOT] XY$PLOT:
$ ASSIGN MIIPS$DISK:[MIIPS.SAMPLES] SAMPLES:
$ ASSIGN PLOT.PLT FOR079
$ ASSIGN RASTER.PLT FOR076
$ ASSIGN SYS$OUTPUT FOR078
$ ASSIGN SYS$INPUT FOR075
$ ASSIGN VECT.RPL FOR053
$ A:==RUN MIIPS$DISK:[MIIPS.PLOT]TRANSPARENT_MODE.EXE
$ AM:==RUN MIIPS$DISK:[MIIPS.PLOT]TRANSPARENT_MODE_M.EXE
$ AX:==RUN MIIPS$DISK:[MIIPS.PLOT]TRANSPARENT_MODE_X.EXE
$ AXN:==RUN MIIPS$DISK:[MIIPS.PLOT]TRANSPARENT_MODE_XN.EXE
$ BELL:==RUN MIIPS$DISK:[MIIPS.MIIPS]BELLPROG
$ BINARY:==$MIIPS$DISK:[MIIPS.FOR]BINARY.EXE
$ BONAMI:==@MIIPS$DISK:[MIIPS.MIIPS]BONAMI
$ LOCK:==RUN MIIPS$DISK:[MIIPS.MIIPS]KEYBRDLCK.EXE
$ MIIPS:==RUN/NODEB MIIPS$DISK:[MIIPS.MIIPS]MIIPS.EXE
$ MTREAD:==RUN/NODEB MIIPS$DISK:[MIIPS.MIIPS]MTREAD.EXE
$ P1LINK:==@MIIPS$DISK:[MIIPS.MIIPS]P1LINK.COM
$ PLOT:==$MIIPS$DISK:[MIIPS.PLOT]PLOTCOM.EXE
$ TEXPLOT:==$MIIPS$DISK:[MIIPS.PLOT]TEXPLOTCOM.EXE
$ X1LINK:==@MIIPS$DISK:[MIIPS.MIIPS]X1LINK.COM
$ XYPLOT:==$MIIPS$DISK:[MIIPS.PLOT]XYPLOT_PROGRAM.EXE
$ XYPLOT2:==$MIIPS$DISK:[MIIPS.PLOT]XYPLOT2_PROGRAM.EXE
$!
$ IF "''F$MODE()'" .EQS. "BATCH" THEN GOTO BATCHRUN
$ SET TERMINAL/LINE_EDITING
$ TERM:= "''F$LOGICAL("TT")'"
$ TERM1:= "''F$EXTRACT(1,7,TERM)"
$ ASSIGN 'TERM1' TEKTRONIX
$ ASSIGN 'TERM1' TEK4662
$ BATCHRUN:
Again, modify this file as necessary.
The command file BONAMI is used for cleaning up the current
subdirectory after running MIIPS. It should contain:
$ PURGE *.SVE;*
$ DELETE MIIPS.LOG;*
Page 4
$ DELETE USER.LOG;*
$ DELETE FOR*.DAT;*
When linking a new version of MIIPS, the command file
MIIPSLINK is used. It should contain:
$ TERM := "''F$LOGICAL("TT")'"
$ TERM1 := "''F$EXTRACT(1,7,TERM)"
$ MM
$! SUBMIT MIIPS_MICH/NOTIFY/PARAM='TERM1'
$! SUBMIT MIIPS_UMAST/NOTIFY/PARAM='TERM1'
$! SUBMIT MIIPS_OSU/NOTIFY/PARAM='TERM1'
$ SUBMIT MIIPS/NOTIFY/PARAM='TERM1'
The command file MIIPS.COM (or MIIPSFACILITYNAME.COM, if you
prefer) should contain:
$ SET VERIFY
$ ASSIGN DUMMY SYS$PRINT
$ MM
$ LINK/NOMAP/EXE=MIIPS.EXE MIIPS.ABJ,-
MIIPS$DISK:[MIIPS.LIB]MIIPS/LIB,-
MINUIT/LIB,-
PAN/LIB,-
NONLINFIT/LIB,-
ARITH/LIB,-
MAGTAPE/LIB,-
FITS/LIB,-
PLOT/LIB,-
PAN/LIB,-
TV/LIB,-
! Use the following line if a Trapix is available
TRAPIX/OPTIONS,-
BSAD/LIB,-
SAD/LIB,-
UTILITY/LIB,-
SYS$INPUT/OPTIONS
SYS$SYSDISK:[SYSLIB]LBRSHR/SHARE
! Use the following 4 lines for a Trapix Image Display
$ INSTALL :== $ SYS$SYSTEM:INSTALL/COMMAND
$ INSTALL
REPLACE MIIPS$DISK:[MIIPS.FOR]MIIPS.EXE;
EXIT
$ SEND 'P1' "DONE LINKING MIIPS"
$ PURGE/KEEP=1 MIIPS.EXE
$ SET PROTECTION=(SYSTEM:R,OWNER:RWED,GROUP:RWE,WORLD:R) MIIPS.EXE
The command file P1LINK which is used for linking any other
program should contain:
$ SET VERIFY
$ LINK 'P1',-
'P2'MIIPS$DISK:[MIIPS.LIB]MIIPS/LIB,-
MINUIT/LIB,-
PAN/LIB,-
NONLINFIT/LIB,-
Page 5
ARITH/LIB,-
MAGTAPE/LIB,-
FITS/LIB,-
PLOT/LIB,-
PAN/LIB,-
TV/LIB,-
! Use the following line if a Trapix is available
MIIPS$DISK:[MIIPS.LIB]TRAPIX/OPTIONS,-
MIIPS/LIB,-
PAN/LIB,-
NONLINFIT/LIB,-
ARITH/LIB,-
MAGTAPE/LIB,-
FITS/LIB,-
PLOT/LIB,-
PAN/LIB,-
TV/LIB,-
BSAD/LIB,-
SAD/LIB,-
UTILITY/LIB,-
SYS$INPUT/OPTIONS
SYS$SYSDISK:[SYSLIB]LBRSHR/SHARE
! Use the following 4 lines for a Trapix
$ INSTALL :== $ SYS$SYSTEM:INSTALL/COMMAND
$ INSTALL
REPLACE MIIPS$DISK:[MIIPS.FOR]MIIPS.EXE;
EXIT
$ SET NOVERIFY
$ SET PROTECTION=(SYSTEM:R,OWNER:RWED,GROUP:RWE,WORLD:R) 'P1'.EXE
When several people are required to use MIIPS, it is best
for each user to have his or her own account within the MIIPS
group. A user's login file should contain the user's own global
definitions and a reference to another command file on the user's
account. It therefore should contain at least:
@MIIPSLOGN
The user's command file MIIPSLOGN.COM should contain the
reference to the MIIPS definitions. It should contain:
SET PROTECTION=(SYSTEM:R,OWNER:RWED,GROUP:RE,WORLD:R)/DEFAULT
@USERVOL:[ACCOUNT.MIIPS]MIIPS_LOGIN.COM