.input(u~)
.margin(r66)
.option(r+ f+ u+ j30)
.paragraph(f& p4 s1 k1)
.form( [ t #62 e / s // l53 /// #33 '- ' pn:1 ' -' /// ] )
&
&
.tit Pascal-2 V2.0/RT-11 Installation
.opt(l-r-)
~PASCAL-2 V2.0/RT-11 INSTALLATION~
.opt
.ski 3
&
.tit Pascal-2 V2.0/RT-11 Installation
.opt(l-r-)
~PASCAL-2 V2.0/RT-11 INSTALLATION~
.opt
.ski 3
To install Pascal-2, V2.0 for RT-11 V3 and V4, follow the steps below:
&
.mar(l5)
&
.und 5
1.   Copy all of the Pascal-2 files to the system device ("SY:");
&
.und 5
2.   Select a compiler depending on your system monitor;
&
.und 5
3.   Select a run-time library depending on your processor hardware
options;
&
.und 5
4.   Compile the Pascal-2 utility programs;
&
.und 5
5.   Delete files no longer needed (optional).
.mar
&
These steps are described in detail in the following paragraphs, and
are illustrated by an example that can be found in Appendix B of this
Installation Guide.  At the completion of installation, the Pascal-2
system will be fully operational as described in the User's Guide.
&
.ski 3
&
.pag 4
.sub Copying the Pascal-2 Files to the System Device
~COPYING THE PASCAL-2 FILES TO THE SYSTEM DEVICE~
.ski 2
Copy all of the distribution files to the system device ("SY:") using
the "PIP" program.  This will speed the installation process if there is
sufficient disk space available.
&
.ski 1
&
.pag 4
.mar(l5 r80)
.opt(f-)
 ~.R PIP~
 *~SY: = MT0:*.*~     replace MT0: with your distribution medium
&
.pag 4
.opt
.mar
.ski 1
&
If your system disk is a floppy disk, or is otherwise limited in
available space, you should first read the following sections and select
the files that will be necessary for your system.  The minimal system
requires one compiler file and one library file.  You may wish to
build more than one system disk and, for example, install the compiler,
library, and Debugger on one disk and the utility programs on a second
system disk.
&
After selecting the necessary files, you can examine the directory
listings supplied with the Pascal-2 system and copy only the required
files to your system.
&
.ski 3
&
.pag 4
.sub Selecting a compiler for your system monitor
~SELECTING A COMPILER FOR YOUR SYSTEM MONITOR~
.ski 2
There are two compilers supplied with Pascal-2.  Your choice of a
compiler depends on the version of the RT-11 monitor you will use.
There are four possibilities: the Base-Line (BL) monitor, the Single-Job
(SJ) monitor, the Foreground-Background (FB) monitor, and the eXtended-Memory
(XM) monitor.
&
If you will be using either the BL or the SJ monitor, choose the
compiler called "SJ.SAV".  If you use the XM monitor, select the
compiler called "XM.SAV".
&
The FB monitor does not leave sufficient memory to run the Pascal-2
compiler.  If you are using the FB monitor, you will need to switch to
either the SJ or XM monitors (using the "BOOT" command) before compiling
a Pascal program.  Once compiled, programs may be linked and run under
the FB monitor.
&
The XM compiler should be chosen over the SJ compiler where possible
because it uses the virtual overlay capability and will give faster
compilations.
&
When you have selected a compiler file, copy it to "SY:PASCAL.SAV".
This compiler will operate as described in the User's Guide.  You may
then delete "SJ.SAV" and "XM.SAV", or you may leave them on your system
disk for use under their respective monitors.
&
.ski 3
&
.pag 4
.sub Selecting a run-time library
~SELECTING A RUN-TIME LIBRARY~
.ski 2
There are four run-time libraries supplied with Pascal-2, one for each
combination of processor instruction sets.  Choose the library that
matches the configuration of the processor that will run your compiled
programs.
&
The possible configurations are:
.mar(l5)
&
.und 5
*    FPP - a processor with the Floating Point Processor instruction
set.  The FPP is standard equipment on the PDP-11/60, and optional on
all new PDP-11's and the LSI-11/23.  If your processor includes the FPP,
select the "LIBFPP.OBJ" library.
.mar
&
.mar(l5)
&
.und 5
*    FIS - the Floating Instruction Set.  The FIS hardware is an option
available for the LSI-11, LSI-11/2, and some older PDP-11 processors.
If your processor has FIS, select the "LIBFIS.OBJ" library.
.mar
&
.mar(l5)
&
.und 5
*    EIS - Extended Instruction Set, for hardware support of multiply,
divide, and long shift instructions.  EIS is standard equipment on all
new PDP-11 and LSI-11/23 processors, and an option available for all
older LSI-11's and PDP-11's.  If your processor has neither FPP nor FIS,
but does have EIS, then select the "LIBEIS.OBJ" library.
.mar
&
.mar(l5)
&
.und 5
*    For processors with no extended or floating instructions, select
the "LIBSIM.OBJ" library.  This library will operate on any LSI-11
or PDP-11 regardless of its actual configuration, but will not take
advantage of any optional hardware.
.mar
&
After selecting a library file, copy it to "SY:PASCAL.OBJ" to be used as
described in the User's Guide.  You may then remove the other library
files, or leave them on the system for use with other configurations.
&
.ski 3
&
.pag 4
.sub Compiling the utility programs
~COMPILING THE UTILITY PROGRAMS~
.ski 2
Six utility programs are supplied in source form.  Each of the utilities
should be compiled following the procedure in Appendix B. The utility
programs will then be available for use as described in the Utilities
Guide.
&
.ski 3
&
.pag 4
.sub Installing Pascal-2 With Pascal-1
~INSTALLING PASCAL-2 WITH PASCAL-1~
.ski 2
The Pascal-1 system compiler can be renamed to allow simultaneous use of
Pascal-1 and Pascal-2.  Then, the files for both systems can be present
on the system device without conflict.
&
The object library "PASCAL.OBJ" can be shared by the two systems; the
libraries supplied with Pascal-2 include all of the Pascal-1 routines.
&
For versions of Pascal-1 prior to revision V1.2H, a change in the
Pascal-2 run-time library may affect existing Pascal-1 programs: Pascal-1
global variables are now initialized to bit patterns of all ones
(minus one).  Prior to V1.2H, global variables were not initialized
but were often zero.  Programs that have uninitialized variables are
now more likely to fail.  This helps to identify latent problems with
uninitialized variables.  Pascal-1 programs that worked, but fail when
linked with the Pascal-2 libraries, should be carefully examined for
variables that are used before acquiring a value.
&
.sub Appendix A - Pascal-2 System Distribution Files
.pag
~APPENDIX A - PASCAL-2 SYSTEM DISTRIBUTION FILES~
.ski 2
&
.opt(f-).mar(r80)
.ski 2
Compilers
.ski 1
    SJ    .SAV  Pascal-2 Compiler for SJ monitor
    XM    .SAV  Pascal-2 Compiler for XM monitor
.ski 2
Object Libraries
.ski 1
    LIBFPP.OBJ  Library for processors with FPP and EIS
    LIBFIS.OBJ  Library for processors with FIS and EIS
    LIBEIS.OBJ  Library for processors with EIS only
    LIBSIM.OBJ  Library for base-level processors
    VIRJOB.OBJ  Header module for XM virtual jobs
.ski 2
Debugger and Profiler Modules
.ski 1
    DBRUN .OBJ  Debugger root module
    DBUSER.OBJ  Debugger user load module
    DBUG  .OBJ  Debugger overlay module
    PRFILE.OBJ  Profiler
.ski 2
Utility Programs
.ski 1
    PASMAT.PAS  Program formatter
    PB    .PAS  Pascal Beautifier
    XREF  .PAS  Cross-referencer
    PROCRE.PAS  Procedure cross-referencer
    PROSE .PAS  Text formatter
    CONVRS.PAS  Pascal-1 conversion aid
    ERROR .PAS  System Error procedure
    STRING.PAS  String package
    PASMAC.MAC  MACRO-11 interface package
.ski 2
Documentation Files
.ski 1
    INTRO .PRS  Introduction
    USER  .PRS  User's Guide
    GUIDE .PRS  Programmer's Guide
    PASCAL.PRS  Language Specification
    DEBUG .PRS  Debugger Manual
    UTILIT.PRS  Utilities Guide
    CONVER.PRS  Conversion Guide
    INSTAL.PRS  Installation Guide
    VT100 .PRS  VT100 header
    PRINTE.PRS  Line printer header
.ski 2
Demonstration Programs
.ski 1
    HEARTS.PAS  Four-handed game of Hearts
    LIFE  .PAS  The game of Life
    CHECKR.PAS  A Checkers game
    PL0   .PAS  PL/0 - a simple compiler
    RANDOM.PAS  Random number generator
    MAZE  .PAS  Amazing Demonstration
.opt.mar
&
.sub Appendix B - Sample Installation Command File
.pag
~APPENDIX B - SAMPLE INSTALLATION COMMAND FILE~
.ski 2
The following steps illustrate the installation of Pascal-2 from magtape
on a processor that includes the FPP floating point processor.  The
Pascal-2 compiler for the single job (SJ) monitor is selected.  The
commands below will work for both V3 and V4 RT-11 systems.
.ski 1
&
.pag 4
.mar(l5 r80)
.opt(f-)
 .ASSIGN  SY:  DK:              assign SY: as the default device
 .R PIP
 *SY: = MT0:*.*                copy all files to the system disk
 *PASCAL.OBJ = LIBFPP.OBJ        select the FPP run-time library
 *PASCAL.SAV = SJ.SAV                     select the SJ compiler
 *^C
                                      Build the utility programs
 .R PASCAL                            Build the PASMAT formatter
 *PASMAT
 .R LINK
 *PASMAT = PASMAT,SY:PASCAL
 *^C
 .R PASCAL                                Build the PB formatter
 *PB
 .R LINK
 *PB = PB,SY:PASCAL
 *^C
 .R PASCAL                       Build the XREF cross-referencer
 *XREF
 .R LINK
 *XREF = XREF,SY:PASCAL
 *^C
 .R PASCAL                    Build the PROCREF cross-referencer
 *PROCREF
 .R LINK
 *PROCREF = PROCREF,SY:PASCAL
 *^C
 .R PASCAL                        Build the PROSE text formatter
 *PROSE
 .R LINK
 *PROSE = PROSE,SY:PASCAL
 *^C
 .R PASCAL              Build the CONVRS Pascal-1 conversion aid
 *CONVRS
 .R LINK
 *CONVRS = CONVRS,SY:PASCAL
 *^C
 .R PIP                      Clean up the system disk (optional)
 *SJ.SAV,XM.SAV/D       Remove the compilers, leaving PASCAL.SAV
                        Delete the libraries, leaving PASCAL.OBJ
 *LIBFPP.OBJ,LIBFIS.OBJ,LIBEIS.OBJ,LIBSIM.OBJ/D
                            Delete the utility compilation files
 *PASMAT.OBJ,PB.OBJ,XREF.OBJ,PROCREF.OBJ,PROSE.OBJ,CONVRS.OBJ/D
 *^C
&
.pag 4
.opt
.mar
.ski 1
&