(This document is best viewed in Monaco 9 or Courier 10 font) M A C A N O V A 4.03 An Interactive Program for Statistical Analysis and Matrix Algebra Copyright 1996, Gary W. Oehlert and Christopher Bingham This file is the installation guide for the DOS/Windows versions of MacAnova and is part of the DOS/Windows distribution of MacAnova 4.03. It contains bug fixes and enhancements through December 10, 1996. MacAnova is distributed under the terms of the GNU Public License, Version 2. See file COPYING distributed with MacAnova. The latest versions of MacAnova may be obtained over the Internet from http://www.stat.umn.edu/~gary/macanova/macanova.home.html, or by anonymous ftp from ftp.stat.umn.edu in the pub/macanova directory. Documentation is also available from these sources. When distributed on diskette, there are normally two high density (DSHD) disks, labelled Macanova_1 and Macanova_2. There are three versions, BC, DJ and WX, of MacAnova included on the distribution. Version BC is a DOS real mode program. It has the advantages that it will run on virtually any DOS machine, needs relatively little memory, does not require a math chip, and works cleanly under Windows. It has the disadvantage that it cannot use any memory object (or internal data structure) larger than 65000 bytes, or 8125 REAL numbers and can use only the lower 640k of memory. Version DJ is a DOS protected mode program. It has the advantage that it can use very large memory objects and will swap out to disk when extended memory is full. The nongraphical portions run under Windows, but graphics will crash the system under Windows. It requires at least a 386 or better processor. This version can emulate the math chip, but is very slow when emulation is used. Only VGA graphics are currently supported. Version WX is the alpha-level release of the Windows version of MacAnova. This 32 bit version runs under Windows 95 or Windows 3.1 with Win32s. It allows up to 8 editable command/output windows and up to 8 graph windows. It is patterned on the Macintosh version but the matchup is incomplete. There are still some problems, particularly with "focus" (where key strokes go) when changing windows. It can access all available memory. File names can be specified by empty quotes ("") as on the Macintosh, allowing selection of files using a dialog box. To use the WX version under Windows 3.1, you *must* have Win32s installed. Win32s is a Microsoft product that you can get for free over the Internet, and perhaps in other ways. See file WIN32S.DOC for more information on obtaining Win32s. We have little experience with the use of any version of MacAnova under Windows 95. The full DOS/Windows distribution consists of the following files. For convenience, these are described as being on two distribution disks, even though you may have obtained the files over a network. Contents of disk Macanova_1 README.TXT (general intro document) INSTALL.TXT (this file) COPYING (the GNU Public License) MV403AUn.EXE (a self extracting archive for auxiliary files) MV403DJn.EXE (a self extracting archive for protected mode MacAnova) SCRNGRAB.EXE (a self extracting archive of shareware screen grabbers) LHA_E.EXE (a compressor/decompressor) INSTALL.INF (Windows installation information) WINSTALL.EXE (installer for Windows) DINSTALL.BAT (installer for DOS) Contents of disk Macanova_2 MV403BCn.EXE (a self extracting archive for real mode MacAnova) MV403WXn.EXE (a self extracting archive for alpha release of MacAnova for Windows, requiring Win32s or Windows 95) WIN32S.DOC (information on obtaining Win32s) LHA_E.EXE (a compressor/decompressor) DINSTALL.BAT (installer for DOS) The "n" in the MV403??n.EXE archive files indicates the release level. The "??" indicates the version of MacAnova contained in the archive (one of BC, DJ, or WX) or AU for auxiliary files (help, macros, etc). See below for a listing of the contents of these archive files. There are three ways to install MacAnova: 1) using WINSTALL.EXE, the Windows installer for MacAnova, 2) using DINSTALL.BAT, the DOS install script for MacAnova, or 3) "by hand". Here are instructions on the three methods. Following them are instructions on things you may have to do after the files are installed by any method. If you are not installing from disk but obtained the files over a network, put all the files in the same directory, and skip step 1 of whichever instructions you use. Using the Windows installer 1) Insert the disk Macanova_1 if all the files are not already in the same directory on your hard disk. 2) Start WINSTALL.EXE by double clicking on it from the File Manager or by choosing RUN from the File menu of the Program Manager. 3) Decide in which directory to put MacAnova. The installer will default to C:\MACANOVA, but you can change that. 4) Decide which parts of MacAnova you wish to install. You can check (yes) or uncheck (no) for auxiliary files (includes help and macro files) and/or the three versions of MacAnova. By default, all files will be installed. You will need the auxiliary files and at least one version of MacAnova. 5) Click Yes if you wish to install, and then change disks as needed. If not installing from diskette, just press 'y' if you are asked to change disks. 6) The installer will produce a MACANOVA group for the Program Manager. In this group will be icons for all three versions of MacAnova, whether or not you loaded them all. You can change The icons for the DOS versions to the MacAnova icon by selecting a DOS version in the program manager, choosing Properties from the File menu, then clicking on Change Icon..., then on OK, and again on OK. 7) See below for information on what you do next, now that the files are installed. Using the DOS install script 1) Load the disk Macanova_1. If you have obtained the files over the internet, simply put all files together in a common directory. 2) Make the disk (or directory) holding the MacAnova files the current directory. For example, if the disk is in drive B:, give the commands CD B:\ B: 3) Decide in which directory to put MacAnova; for example you might use C:\MACANOVA 4) Give the command DINSTALL with the directory where MacAnova should be put as argument. For example, DINSTALL C:\MACANOVA 5) You will be asked whether you wish to install the auxiliary, BC, and/or DJ files. You need the auxiliary files and at least one of the two versions of MacAnova. 6) You may be asked to change disks. If you have the files in one directory on a hard drive, simply press any key to continue. If you are installing from diskettes, put the disk Macanova_2 in the same disk drive as you used for Macanova_1 and then press any key. 7) See below for information on what you do next, now that the files are installed. To set up MacAnova "by hand" 1) Decide in which directory to put MacAnova, and change to that directory. For example, you might create a directory C:\MACANOVA 2) Copy the self extracting archives MV403BCn.EXE, MV403DJn.EXE, MV403WXn.EXE and MV403AUn to the current directory (C:\MACANOVA in the above example) 3) Execute MV403AUn.EXE by typing MV403AUn (e.g., MV403AU9) 4) Choose which version of MacAnova you wish to use, and execute the corresponding archive by typing MV403BCn (e.g., MV403BC9) for the real mode program, MV403DJn (e.g., MV403DJ9) for the protected mode program or MV403WXn (e.g., MV403WX9) for the Windows version. If you wish, you can extract all three. 5) See below for information on what you do next, now that the files are installed. What to do after the files are installed by any method 1) The executable files produced are named MACANOBC.EXE (real mode version), MACANODJ.EXE (protected mode version) and MACANOWX.EXE (Windows version). If you wish, you may rename one of these as MACANOVA.EXE. 2) The BC or DJ versions can be run from the DOS prompt by typing MACANOBC or MACANODJ when you are in the MacAnova directory. If you wish to be able to run MacAnova from some other directory, you must put the directory where MacAnova lives into your "path". Edit your AUTOEXEC.BAT file and add C:\MACANOVA (or whatever your MacAnova directory is called) to the PATH variable. You do this by adding ;C:\MACANOVA to the end of the SET PATH=.... line. 3) If you use the DJ version, you may need to set at least one more variable in the AUTOEXEC.BAT file. If your AUTOEXEC.BAT file does not already define one of the directories TMP or TEMP, edit your AUTOEXEC.BAT file to include SET TEMP=C:\TEMP (or whatever you name your directory for temporary files) and then create that directory. This is the directory to which memory will be paged (saved) when you run out of real ram. If you have a machine with no floating point coprocessor (a 486SX, for example), then you should add the line SET GO32=EMU C:\MACANOVA\EMU387 to your AUTOEXEC.BAT file (where MACANOVA is replaced by the directory where you have actually put MacAnova). 4) You can run the Windows version using Run on the Program Manager's File menu. Better is to install an icon on the Program Manager desktop (done automatically by WINSTALL.EXE). Don't forget, under Windows 3.1, you *must* have Win32s installed (see above). Here are the contents of the self-extracting archive files all installation methods use. Self-extracting archive file MV403BCn.EXE contains the following files: # Name Size Comments 1 MACANOBC.EXE 1012K (the MacAnova executable, DOS real mode version) 2 CGA.BGI 6K (These are graphics drivers from the 3 EGAVGA.BGI 5K Borland C package. They may be freely 4 HERC.BGI 6K distributed with MacAnova, but they are 5 IBM8514.BGI 7K Copyrighted by Borland and cannot be resold.) 6 PC3270.BGI 6K 7 ATT.BGI 6K Self-extracting archive file MV403DJn.EXE contains the following files: 1 MACANODJ.EXE 1378K (the MacAnova executable, DOS protected mode version) 2 COUR14.FNT 3K (a font file) 3 EMU387 37K (a floating point emulator) 4 PROTMODE.FAQ 2K (frequently asked questions about protected mode MacAnova) Self-extracting archive file MV403WXn.EXE contains the following files: 1 MACANOWX.EXE 1256K (The MacAnova for Windows executable) 2 CW3215.DLL 172K (DLL file from the Borland C package. It may be freely distributed with MacAnova, but it is Copyrighted by Borland and cannot be resold.) 3 MACANOVA.ICO 1K (The MacAnova icon.) Self-extracting archive file MV403AUn.EXE contains the following files: 1 MACANOVA.HLP 637K (the MacAnova help file) 2 MACANOVA.MAC 57K (a file of MacAnova macros) 3 TSER.MAC 24K (a file of macros useful in time series analysis) 4 MACANOVA.INI 9K (a sample initialization file for MacAnova) 5 MACANOVA.DAT 6K (a sample file of data sets for MacAnova) 6 DESIGN.MAC 60K (a file of macros for design of experiments) 7 DESIGN.HLP 21K (a help file for DESIGN.MAC) 8 CHANGES.TXT 29K (a file of changes since the 3.11 manual) 9 HISTORY.TXT 7K (release history of MacAnova) 10 MACANOVA.NWS 50K (MacAnova news) The uncompressed total size of these files is on the order of 5 megabytes. Thus MacAnova is most practical when installed on a hard drive. If you intend to use only one version of MacAnova, files for the other version can be deleted. The .HLP, .MAC, .INI, and .DAT files are all ASCII text files and can be customized by the user using any text editor that can handle a sufficiently large file. Comments in the MACANOVA.INI file make suggestions for customization. Alternate .HLP, .INI, .DAT, or .MAC files may also be specified on the command line, and need not have these extensions. Happy Computing! Gary W. Oehlert gary@umnstat.stat.umn.edu Christopher Bingham kb@umnstat.stat.umn.edu Department of Applied Statistics 1994 Buford Ave. St. Paul, MN 55108 December 27, 1996