BMDP/PC Release 7.01 READ.ME -- November 22, 1993



BMDP/PC CONFIGURATION FILES
---------------------------

BMDP/PC makes use of three configuration files:

    BMDP/PC Config - Text File.  Basic system info (contents of CONFIGURE 
                     screen of BMDP/PC Main Menu).  Default name is
                     BMDP90.CFG.
    Edit Config    - Binary File.  Edit keystroke and macro definitions.
                     Default name is BMDPEDIT.CFG.
    Plot Config    - Binary File.  Plot defaults and keystroke definitions.
                     Default name is BMDPPLOT.CFG.

These files are created during system installation.  Should any of them
be deleted or corrupted, BMDP/PC will automatically recreate them the next
time it tries to access the files.

When BMDP/PC starts up, it looks for the BMDP/PC configuration file.  The
search is done in the following order:

     1.  Look for the file BMDP90.CFG in your current directory.
     2.  Look for the name BMDPCFG in your environment.  If found,
         the environment string is used as the complete file name
         of the configuration file.
     3.  Look for the file BMDP90.CFG in the directory containing the
         BMDP programs.
     4.  Look for the file BMDP90.CFG in any other directory defined in 
         your PATH statement.

If all four searches fail, BMDP/PC creates BMDP90.CFG on the program
directory (non-network) or in your current directory (network).

The Edit and Plot configuration file entries of BMDP90.CFG define the
files used by EDIT and PLOT, respectively.  By default, these names are 
BMDPEDIT.CFG and BMDPLOT.CFG in the same directory as BMDP90.CFG.  Changing 
these names in the Main Menu NETWORK CONFIGURE screen will NOT create new files.  
If no file exists with the new name, it will be created the first time EDIT 
or PLOT is used.  

NOTE:  High resolution plotting is NOT available in the BMDP programs
unless the PLOT configuration file already exists.  The file is created
by PLOT the first time it is run during PLOT installation.  If you
change the name in the Main Menu NETWORK CONFIGURE screen to a nonexistent 
file name, you must run PLOT from the Main Menu to create the file before 
running a BMDP program.



BMDP/PC ON NETWORKS
-------------------

BMDP/PC has been designed to make installation and setup on a network
relatively simple.  Installation is the same for networks and single user 
systems.  However, when the INSTALL program terminates, network users will 
need to perform some or all of the following:

1.  It is ABSOLUTELY ESSENTIAL that each network user has his/her own
version of the BMDP90.CFG file, and that the Edit/Plot configuration
files defined in BMDP90.CFG be unique for each user.  We recommend that
you define the environment variable BMDPCFG in each user's AUTOEXEC.BAT
file to point to that user's own version of BMDP90.CFG.  Each user's version
of BMDP90.CFG must reside in his/her network directory.  Note that each
user's version of the BMDP90.CFG file does NOT have to be called BMDP90.CFG,
that is simply the default name.  We provide an example below.

If the environment variable BMDPCFG defines a nonexistent file, BMDP/PC 
will create the file the next time it is run (printing a warning message 
that it is doing so).  This CFG file will include Edit/Plot configuration 
file names using the path name from BMDPCFG.  For example, if you have

       SET BMDPCFG=F:\USERS\JAK\MYBMDP.CFG

in a user's AUTOEXEC.BAT file, BMDP/PC will look for F:\USERS\JAK\MYBMDP.CFG 
on program start-up.  If the file is not found, BMDP/PC will create it.  This
CFG file will define the Edit configuration file as F:\USERS\JAK\BMDPEDIT.CFG 
and the Plot configuration file as F:\USERS\JAK\BMDPPLOT.CFG.  This can be 
confirmed by viewing the last screen of the BMDP/PC Main Menu NETWORK CONFIGURE 
option.

2.  In addition to the environment variable defining BMDP90.CFG for each user,
you must define the environment variable DNEWS in each user's AUTOEXEC.BAT file
pointing to the drive and directory where the BMDP programs are installed.
For example, if the BMDP programs are installed in F:\APPS\BMDP on the
network server, the environment variable definition in each user's AUTOEXEC.BAT
should be

     SET DNEWS=F:\APPS\BMDP

3.  Once each user has his/her own BMDP90.CFG file defined, it is
necessary to create an appropriate Plot Config file for each user. First,
copy DEMO.PLT from the BMDP directory to each user's account.  Next, access 
PLOT from the BMDP/PC Main Menu to create the BMDPPLOT.CFG file.  To create 
the file, choose Set Hardware under the <F5> Options menu in PLOT and follow 
the screen prompts.  The procedure is the same as that done during PLOT 
initialization during BMDP/PC installation.  If several computers on the 
network have the same hardware, i.e., the same screen, printer, and plotter 
drivers will work for each computer, you can simply copy the Plot Config 
file to each user's Plot Config file entry rather than running PLOT to create 
a file for each user.

Using the previous example, suppose that you run PLOT from user JAK's
account and select drivers for IBM VGA screen and Epson LQ-850 printer.  
This information will be recorded in F:\USERS\JAK\BMDPPLOT.CFG upon exiting 
PLOT.  If another user has identical hardware, and BMDPCFG for that user is
defined as F:\USERS\ABC\ANOTHER.CFG, then you can copy 
F:\USERS\JAK\BMDPPLOT.CFG to F:\USERS\ABC\BMDPPLOT.CFG to create the same 
configuration file for that user.

4.  You can make copies of the Edit Config file in a similar manner. 
Simply copy the file BMDPEDIT.DEF from the BMDP directory to each user's
Edit Config file. Alternatively, EDIT will create its own config file
the first time it is run (issuing a warning that it is doing so).  You
can then use the RESET DEFAULTS option of the EDIT Customize dialog box to
select the defaults defined in BMDPEDIT.DEF.

5.  If you would like to make the BMDP sample input and data files available
to users, either copy the files to each user's account or change the path
for the INPUT and DATA files in the second screen of the BMDP/PC Main Menu
NETWORK CONFIGURE option to the drive and directory where the BMDP programs are 
installed.  If you choose the second option, the BMDP programs will always
look for input and data files in the BMDP directory by default.  This may
be changed at any time by modifying those path statements in NETWORK CONFIGURE.

6.  At least 512 K of free base RAM is required to run BMDP/PC effectively.
Often, after loading all necessary network drivers, less than 512 K of base
RAM remains.  To overcome this problem, you must use a memory manager such
as EMM386.EXE (comes with MS DOS 5.0) or QEMM from Quarterdeck Office Systems
to load your network drivers into upper memory.

Our experience shows that EMM386.EXE moves very little memory to UMB 
(Upper Memory Blocks) and is therefore not recommended for moving large
blocks of memory such as network drivers.  The use of QEMM is recommended
to optimize the coexistence of BMDP/PC with your network environment.  
Below we show an example of configuring your system using QEMM 386 version
6.0.  Following this configuration, 630 K of base RAM was available under
MS DOS 5.0.

     CONFIG.SYS
     ----------
       device=c:\sys\qemm\qemm386.sys r:4 ram ST:M
       dos=high
       buffers=30
       files=40
       device=c:\sys\qemm\loadhi.sys /r:1 c:\sys\dos\setver.exe
       shell=c:\command.com /p /e:1024
       stacks=0,0

     AUTOEXEC.BAT
     ------------
       @echo off
       prompt=$p$g
       path \win\word;\win\win31;\sys\ut;\sys\nu;\sys\dos;\xln\bin40
       set tmp=\lang\c700\tmp
       c:\sys\qemm\loadhi /r:3 c:\win\win31\smartdrv.exe
       cd \xln
       c:\sys\qemm\loadhi /r:1 c:\xln\netdrive\lsl.com
       c:\sys\qemm\loadhi /r:2 c:\xln\netdrive\ne2000.com
       c:\sys\qemm\loadhi /r:2 c:\sln\netdrive\ipxodi
       c:\sys\qemm\loadhi /r:3 c:\xln\bin40\tcpip
       c:\sys\qemm\loadhi /r:3 c:\xln\netdrive\net5
       c:\sys\qemm\loadhi /r:2 c:\xln\bin40\telapi


Additional Network Notes:

-- Single user versions of BMDP/PC will not install on networks.

-- Users require only "read access" to the files in the BMDP program
   directory.  With one exception, BMDP/PC will not create or modify files 
   on this directory after installation is complete.  The exception is that
   all graphics drivers for PLOT are created in the BMDP program directory
   (file names *.DRV).  See item 3 above.



NOTES FOR IBM OS/2 USERS
------------------------

If you have both DOS and OS/2 installed on your computer, select the Dual 
Boot option in OS/2 and install and run BMDP/PC under DOS.  You may then
also run BMDP/PC under the DOS Window in OS/2.

If you have only OS/2 installed on your computer and are installing BMDP/PC 
from the DOS Window or DOS Full Screen in OS/2, answer NO when you are asked 
whether the AUTOEXEC.BAT and CONFIG.SYS files may be modified.  Instead, you 
should modify the two files by hand.  In AUTOEXEC.BAT, add your BMDP 
directory to the PATH statement and add the statement:

     SET DNEWS=C:\BMDP         (assuming BMDP/PC is installed in C:\BMDP).

In CONFIG.SYS, make sure that both FILES and BUFFERS are set to at least 30.



A NOTE ON COLOR SELECTION
-------------------------

BMDP/PC attempts to use the "Text" color defined in the Main Menu
CONFIGURE screen for all program output.  Under certain circumstances,
particularly if you have ANSI.SYS installed, program screen output will 
instead be displayed in whatever color you normally use.  For example, 
if your screen is normally white on black, and you select white on blue for 
the BMDP/PC "Text" color, program output may appear in black bands on a blue
background.

To avoid this problem, you should select "Text" color to be the same as
that which is normally displayed at the DOS prompt.  

Note that changing colors with the Main Menu CONFIGURE screen will affect
colors in the BMDP/PC Main Menu, Editor, View, and Plot only.  Data Entry
colors may be changed from within Data Entry.  Colors for Mentor and
Import/Export cannot be changed from their default values.



NOTES ON BMDP/PC PLOT
---------------------

1.  Printing plots uses expanded memory.  When printing plots directly, your 
computer must have at least 1 MB free RAM.  Some plots, depending on the 
complexity of the plots and the dataset size, may require more memory.  You 
may encounter a DEVICE SETUP ERROR message when you have insufficient memory
for direct printing.  For this reason we recommend direct printing when PLOT 
is called from the BMDP Main Menu, but not during interactive program runs.

2.  When saving HPGL and PostScript files, we recommend that the files be 
saved on your hard disk since some files may exceed the storage capacity of 
floppy disks.

3.  To read a Plot File exported from HPGL Export into WordPerfect 5.0 or 
later, the HPGL file must first be converted to a WordPerfect Graphics file 
by issuing the following command at the DOS prompt,

          GRAPHCNV /W

You will be asked for the name of the HPGL file and the name of the resulting 
file.

4.  If you have a plotter or printer attached to a serial port, then you
must use the appropriate DOS MODE command to set line speed/parity for
that COMx: port.  Normally, the correct command is:

     MODE COMx:9600,N,8,1

where "x" is 1,2,3, or 4 (the number of the serial port to which your
plotter is attached).  If you forget to issue this command before
running PLOT, you can issue it from the DOS COMMAND option of the
OPTIONS Menu.

5.  If you press ESCAPE while plots are being drawn, PLOT will stop
before the plot(s) are complete.  This is most useful for matrix plots
and when producing output for plotters.  Note that when output is to a
printer, you cannot stop the plot after the message "Copying Plot to
printer..." appears on your screen.

6.  When you press the APPLY DEFAULTS key within the PLOT DEFAULTS dialog 
box of the OPTIONS Menu, the program recomputes sizes based on the physical
dimensions of your current hard copy device.  The calculation assumes
that the default Title Location is TOP.  If you display a plot using
these computed defaults and the Title Location is BOTTOM, the X-axis
Label and Plot Title may overprint one another.  Solution: Either
increase the Y-axis offset or change Title Location to TOP.



MISCELLANEOUS NOTES ABOUT BMDP/PC
---------------------------------

1.  Both PLOT and EDIT reserve the Alt-F10 key shortcut for invoking a
debugging dump.  You cannot redefine this key and the information
produced by using this function is not for general use. If you
accidentally press this key, simply press ESCAPE at each prompt until
you return to where you were.

2.  The following files are temporary files used by BMDP/PC.  

     BMDPEDIT.TMP   - Editor work file (contents of last edit session)
     BMDPRUN&.TMP   - Editor "Run" file
     BMDPPLOT&.TMP  - Plot work file
     BMDPIMEX.INP   - Input file created when importing/exporting to SAS or SPSS
     BMDPIMEX.OUT   - Output file created when importing/exporting to SAS or 
                      SPSS.  File can be viewed to "debug" conversion errors.

If necessary, you can delete these files.  Deleting BMDPEDIT.TMP means that 
the EDIT buffer will be empty the next time you enter the BMDP/PC Editor.

3.  MENTOR can now use both ASCII data files and already existing BMDP PORT 
files.  Follow the screen prompts in MENTOR to use BMDP PORT files.

4.  IMPORT/EXPORT can now read Excel Version 4 files.  Follow the screen 
prompts in IMPORT/EXPORT to import Excel Version 4 files.



KNOWN BUGS AND RESTRICTIONS
---------------------------

1.  For hard copy output to plotters, legends for plot symbols always
show lines, even if there is no line connecting the points.  This
problem occurs only for plotters, and only for plots produced while
running the BMDP programs.  Output produced by the stand-alone version
of PLOT is correct.  

2.  There is a problem running stepwise regression problems in 2R and LR
directly from Mentor.  To avoid the problem, save the 2R or LR input file
created by Mentor, exit Mentor, and then run 2R or LR from either the RUN
or EDIT option of the BMDP Main Menu.

3.  If the PATH statement in your AUTOEXEC.BAT file is longer than 127
characters (the maximum allowable DOS length), you should answer NO when
asked if your AUTOEXEC.BAT file may be modified during the installation
procedure and then hand-edit AUTOEXEC.BAT to add the BMDP directory to
your path.  You must also define the DNEWS environment variable pointing 
to your BMDP directory in AUTOEXEC.BAT.  For example,

     PATH=C:\;C:\DOS;C:\WP;C:\NORTON;C:\NAV;C:\WINDOWS;C:\BMDP;
     SET DNEWS=C:\BMDP

4.  In 1L, when using the product-limit method for estimating the probability
of survival, the estimates of the 75th, 50th (median survival), and 25th 
percentiles of the survivor function are calculated by linear interpolation,
not by the method described in Appendix B.4 on page 1389 of the BMDP 
Statistical Software Manual, Vol. 2.  See Example 1L.1 on pages 796-801 for
more information.



ANNOTATED DIRECTORY OF BMDP/PC FILES
------------------------------------

The following is a complete list of BMDP/PC files as they exist on your
hard disk after installation and a description of what they are.  The files 
are listed in alphabetical order by extension.  IMPORTANT:  Many of these 
files are binary files, not text files.  Attempts to view and/or modify these 
files with a text editor may corrupt them and make them unusable by BMDP/PC.

BMDP.@@@             File identifying your User Name and License Number
BMDP.BAT             Batch file to run BMDP/PC
BMDP90.CFG           Configuration file for BMDP/PC system
BMDPEDIT.CFG         BMDP/PC Editor configuration file
BMDPPLOT.CFG         BMDP/PC Plot configuration file
*.DAT                BMDP sample datasets (from BMDP manuals)
BMDPEDIT.DEF         Standard BMDP/PC Editor keystrokes & macros
DEDEF.DEF            BMDP/PC Data Entry color definitions
*.DRV                Device driver files for BMDP/PC Plot
DRIVERS.DRV          Binary file containing all BMDP/PC graphics drivers
F77L.EER             FORTRAN error message file for BMDP/PC
BMDPARSE.EXE         Command line parser for BMDP command
BMDPC90.EXE          BMDP/PC Main Menu and Editor
BMDPDE.EXE           BMDP/PC Data Entry program
BMDPDMPC.EXE         Support routine for SAS & SPSS Import/Export
BMDPGRP?.EXE         Root modules for BMDP programs.  ? is 1, 2, ..., 8
BMDPHPGL.EXE         Support routine for HPGL Export
BMDPLOT2.EXE         Support routine for graphics printer output
BMDPLT90.EXE         BMDP/PC Plot program
BMDPPS.EXE           Support routine for PostScript Export
IMEX.EXE             BMDP/PC Import/Export program
MENTOR.EXE           BMDP/PC Mentor program
BMDPNEWS.FIL         Text file summarizing BMDP program changes in this release
NEWS.FIL             Text file summarizing BMDP program changes in this release
*.FNT                BMDP/PC graphics fonts
BMDPHELP.HLP         BMDP/PC General Help file (includes Plot)
DEHLP.HLP            BMDP/PC Data Entry Help file
IMEX.HLP             BMDP/PC Import/Export Help file
MENTOR.HLP           BMDP/PC Mentor Help file
LOGO.ICO             BMDP/PC Icon file for MS Windows installation
*.INP                BMDP sample program inputs (from BMDP manuals)
DRIVERS.LST          Text file listing all BMDP/PC graphics devices
READ.ME              Text file with important information about BMDP/PC
BMDPSITE.NUM         Support routine for BMDP/PC Plot
BMDP???.OVL          Overlay modules for BMDP Programs.  ??? is the
                     BMDP program name and group number (e.g., 1D1, 2R7)
DEMO.PLT             Sample BMDP/PC Plotfile 



-- End of READ.ME --
