Digital PDFs

AA-N306A-TM

May 1983

14 pages

Original

0.3MB

Document:	PASCAL Installation Guide Ver 1 Sep83
Order Number:	AA-N306A-TM
Revision:	0
Pages:	14
Original Filename:	AA-N306A-TM_PASCAL_Installation_Guide_Ver_1_Sep83.pdf

OCR Text

TOPS-20
PASCAL Installation Guide
AA-N306A-TM

September 1983
This document contains instructions for installing the TOPS-20
PASCAL. compiler on the TOPS-20 operating system.
OPERATING SYSTEM:
SOFTWARE:

TOPS-20 VS.1 (2040,2060)
TOPS-20 V4.1 (2020)

PASCAL V1.0

LINK VS.1
RMS V1.2

Software and manuals should be ordered by title and order number. In the United States. send orders
to the nearest distribution center. Outside the United States. orders should be d:lrected to the nearest
DIGITAL Field Sales Office or representati'/e.

Northeast/Mid-Atlantic Region

Centrllil Region

Digital Equipment Corporation
PO Box CS2008
Nashua. New Hampshire 03061
Telephone:(603)884-6660

Digital Equipment Corporation
Digital Equipment Corporation
Accessories and Supplies Center Accessories and Supplies Center
632 Caribbean Drive
1050 East Remington Road
Schau l1burg. Illinois 60195
Sunnyvale. California 94086
Telephone:(312)640-5612
Telephone:(408)734-4915

Western Region

digital equipment corporation. marlboro. massachusetts

First Printing, September 1983
© Digital Equipment Corporation 1983. All Rights Reserved.

The information in this document is subject to change without notice and should
not be construed as a commitment by Digital Equipment Corporation. Digital
Equipment Corporation assumes no responsibility for any errors that may
appear in this document.
The software described in this document is furnished under a license and may
only be used or copied in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment
that is not supplied by DIGITAL or its affiliated companies.
The following are trademarks of Digital Equipment Corporation:

~D~DD~D'M
DEC
DECmate
DECsystem-10
DECSYSTEM-20
DECUS
DECwriter
DIBOL

MASSBUS
PDP
PIOS
Professional
Rainbow
RSTS
RSX

UNIBUS
VAX
VMS
VT
Work Processor

The postage-prepaid READER'S COMMENTS form on the last page of this
document requests the user's critical evaluation to assist us in preparing future
documentation.

CONTENTS
PREFACE

1.0
2.0
3.0
3.1
3.2
3.3
3.4

Introduction • • • . • • • • • • • .
• . . •
Contents of the Distribution Tape
••••
Installing PASCAL
•••••
System Verification (UETP) • • • •
Clean-up • • • • • • • • •
Building with Autopatch
•.•••.•••••.
Building without Autopatch •

iii

1
1
2
L1
I)

•

. 6

PREFACg

This document is a complete installation and verification package
TOPS-20 PASCAL.

for

The audience for this document is the system manager or operator,
one
who
is familiar
with the
installation and operation of the system
software.
For more information concerning the installation of software, refer to
the TOPS-20 Software Installation Guide.
This document uses the following conventions:
This symbol
RETURN key.
Contrasting Colors

indicates

where you press the

Orange
Where examples contain both user
input and computer output,
the characters
you type are
in orange;
the characters
printed on the terminal are in black.

1.0

Introduction

This document describes the procedures for installing Version 1 of the
following software on TOPS-20:
PASCAL.EXE

PASCAL compiler

PASLIB.REL

PASCAL run-time and math library

PASOTS.EXE

PASCAL object-time system

PASDDT.REL

PASCAL debugger

Note that LINK-20 Version 5.1 and RMS-20 Version 1.2(71), or later,
are required
to
run PASCAL Version 1.
If you plan to rebuild from
command files, you also need MAKLIB Version 2.2.
PASCAL, PASLIB, PASOTS, PASDDT, and .HLP files should be installed
SYS:.

The release is in the form of a
1600 BPI
PASCAL distribution
written in TOPS-20 DUMPER format containing five savesets.

tape

2.0

Contents of the Distribution Tape

The distribution tape consists of the following savesets:
1.

PASCAL-DOCUMENTATION
This saveset includes all PASCAL documentation files.

PASCAL-SYSTEM
This saveset includes the .EXE,
should be installed on SYS:.

.REL,

and

.HLP

files

that

PASCAL-TEST
This saveset includes the UETP tests and the .VER file.
It
also
includes a
.CTL file that runs the same tests without
using UETP.

PASCAL-OTS-DEBUGGER
This saveset includes the .REL files for PASOTS and PASDDT
and all intermediate files generated when building these .REL
files.

PASCAL-COMPILER
This saveset includes the .REL files for the compiler and all
intermediate files generated when building the compiler.

3.0

Installing PASCAL

The following files comprise
the
PASCAL compiler and
object-time
system.
Merely copying
these
files from the second saveset on the
distribution tape provides a working PASCAL system.
The files are:
PASCAL. HLP
PASCAL.EXE
PASOTS.EXE
PASLIB.REL
PASDDT.REL
PASDDT.HLP
Perform the following steps to install the PASCAL system:
.STEP 1

Type the ENABLE command.

Mount
the
PASCAL
Installation Guide

distribution

tape.

See

the

TOPS-20

Software

.STEP 4

Use the BUILD command to create directories for the
contents of
the
PASCAL distribution tape.
You can use directory names of your choice.
Type the following commands:
~I;nu I I...

n <DOC····,:.I i T'f'cto T'~!>

! G j. 'I (.:.:, cl:i. j""' f~ C tor ~:i

,.., a III c·~

~:i D I..l Y'

0 f

C h 0 :i.

~I; <~ (,J 0 F~ 1<

:L 0 ()
~I; ~l; F' E I~: M 1. 0 0

$$DIRECTORY
~I;~I;
~I;

G"D

~roup

! On(·:·~ of '::101..1 r u~:;c-:-~ Y' ~:.l rOI..lF··~:; •
J f non(·:·~ y
! ask ~:; ~:I ~:; t (i.~ m IT! <'i n a !.:.i f.' T' ·r Cl f' i'l !J r D 1..1 F- n ulnt:.l f.' r

nl.J I I.. D <: F\ l.J N .-. d:i. r e c tor' '::J >-

~I; ~I;W 0 f~~ 1\

~~ ~1;F' E F;:t1

4 () ()
400

$$DIRECTORY illroup
~I;$

~I;

!Same

~T'oup

as above

!Same

~rol..lp

as above

!Same

~roup

as above

!Same

~rol..lp

as above

GIQ

n l.J 1 L II <: T E ~:; Tn···· (J1. Y' pet 0 Y' ':J :::

~I; ~I; W0 F< 1<
~I; ~I; F' E r;; M

2 0 ()
2 0 ()

$$DIRECTORY

~roup

~I;~I;~
~~ n U

:r I.. D <: PAn 0 T S .... (I i J"' C:' C tOT' ':J :::-

$~~WCmK

40()

$ $ F' E f~ M

4 0 ()

$$DIRECTORY Sroup
~~~;
~I;

GID

nl.J J I.. 1:1 <: CDMP J L. E f;: _.. (11. Y' (.:, c t [) r ~~ ::-

~I;$WORI\

~~$P[F<M

noo

$ ~I; D I f~ E C T (] F~ Y !:.l r 0 I.J F'

$~> 0iD

Use the DUMPER program to restore the files from the distribution tape
to
disk.
If
you do not want to restore a particular saveset, just
replace the particular RESTORE command with a SKIP
1
command.
Type
the following:
$DUMPEI;:

DUMPER>TAPE MTAn!
nUMPEF~ >f~EW I N [I
DUMPEI;::>F I I... F
DUMPER>DENSIlY 1.6()O
DUMPEH>ACCOU ~~T

f;YS
PS:

(T D) <: II DC _.. d i
:> *.*.*
* **.,. **.** (T
D) <: l.J N .... (I
c t r :> * . *.*
. * *.* * (T <: T E r n. . d i c t >* *- • *
pC' • * *. * * (TO) <F'AGOTb .... (i:i. recto Y'\:i>*. * *
. ** *. *. * (TO) <:CDMF'I L.EF<·..·(.1 i l"\:i::'* *. *
DUMPEI:<>I;:EBTO F<E
DUMPEH>UNLClAD
DUMPEf~>RESTOI:~E

DUMPEI;:>RFnTOF<E PS:
,) •
DUMPEH>REnTO F~E PC'
[lUMPEH>I~EnTOF~E

,J +

T' (.:~ etc) l' \:J

+
+

j l' (.:.,

~:;

l' (.:~

~:~

D r' ~:I

P<:'
,) +

l'pctn

DUMPEI:<>EX I T

.STEP 6
Follow the IISpecial Instructions ll (if any) at the end of the cover
letter.
Also,
read
the PASCAL .BWR file in the <DOC-directory> for
any last minute instructions.

•

STEP

Install the PASCAL system software to SYS:

*
*.

by giving the commands:

*. *
*.*

$COPY <RUN····(i :i. )"f?cto r:J>*. !3 'f!:):
~I; C (J P Y <: F;: U N-" d:i Y' e c t () I;;! :>
H L. F' HI... f' :

3.1

System Verification (UETP)

Perform the following procedures to test the PASCAL system:

•

STEP 1
Install the PASCAL UETP test module by giving the commands:
$ C DP Y

-: : TEST S _.. d :i. T' e c t () l' ~-l :: . *. * p s : <: U E TF' • I... I B:>

*.*

Note to run UETP, you must have OPERATOR privileges, IPCF
and be in USER group 100.

•

privileges,

STEP :2
Once the PASCAL system components have been placed on SYS:,
(see
Section 3.0,
STEP 7 above) you can run the UETP test module provided
by giving the following commands:

tBUILD PS:-:::UETP.PASCAL..>
'~$DIRECTORY

100

'i>$USEF-: 100
'$$PERM 200
~~$WORK

200

'$$~

tCONNECT PS:-:::UETP.RUN>
'tiDEFINE fiSK: DSK: ,PS:<UETP.LIB>
$DELETE PASCAL.LOG,RUN.LOG,EXCEPT.LOG
'$RUN UETP
UETP>ENABLE PASCAL/DEPTH:VERIFICATION
UETP>BEGIN
UETP>STATUS !to set status of Job
UETP>EXIT
'pDEFINE DSK:
NOTE
If you have not
installed
the PASCAL
components
on
SYS:,
you must edit
PASCAL.VER in PS:<UETP.LIB>
to set up
your SYS: definition.
If any errors occur, UETP reports them at your
terminal
and
in the
file
EXCEPT. LOG.
For more
information on UETP,
see the UETP
Procedures/Reference Manual in the TOPS-20 Notebook Set.
4

If desired, run the standalone PASCAL test module
edit the file P20TST.CMD to set up SYS:
and DSK:
give the following commands:

provided.
First,
definitions.
Then

SCONNECT <TEST-director~)
SDELETE P20TST.LOG
~~ ~:;

unMIT P 2 () T S T + C T I... / T J ME! 0 : 02 : () 0

Note on a KSIO processor, you need /TIME:25:00.
When the test batch job is completed,
the P20TST.LOG file must be
examined
to make
sure that none of the tests branched to the error
label UERR: •
. . STEP 4
Run your own tests if desired.

3.2

Clean-up

After you have completed testing, you can destroy any directories you
do not need.
For each directory you want to destroy, give the
following commands:
$BUILD
KILL

<name-of-director~-to-destro~>

TO CONF I F~M
TO EXIT BUILD
Note
that a directory cannot be
subdirectories have been deleted.

3.3

Buil~.ing

deleted

unless

all

its

with Autopatch

When the installation is complete, you may want to set up PASCAL for
Autopatching.
See the TOPS-IO/TOPS-20 Autopatch Procedures Reference
Manual, and any PASCAL specific information provided with Autopatch
documentation files.

3.4

Building without Autopatch

If you have the need to make changes to
the
PASCAL
files,
you
rebuild them by using the command files provided on the tape.

can

To build the library PASLIB.REL from PAS2LI.REL, do the following:
@CONN <PASOTS-director~>
I~MAKI... I B

*(~PA!32L 1 + 1'1 K I...

*'"'Z

To build PASOTS.EXE, do the following:
I!~CONN

<PAS()T~;··-di rf..'ctoT'~»

l~I... INK

*lf1PAS201 + LNK
I~GET

F'AS(n~:;

@SAVE F'ASOTS 400 577
To build the PASCAL compiler, be sure
Then, do the following:
I~CONN

that

PASLIR.REL

1!~l..1 NI\

*(~PAS2C 1 • L..NK
(!~f;:UN

PASCAL.
@SAVE PASCAL 0 577

To build the debugger PASDDT, do the following:
@COf'Y PAS2D 1 + REL.. PASDDT + ~<EL

SYS:.

TOPS-20
PASCAL Installation Guide
AA-N306A-TM

READER'S C()MMENTS

NOTE:

This form is for document comments only. DIGITAL will use comments submitted on
this form at the company's discretion. If you require a written reply and are eligible to
receive one unljer Software Performance Report (SPR) service, submit your comments on an SPR form.

Did you find this manual understandable, usabIE~, and well-organized? Please make suggestions for improvement.

Did you find errors in this manual? If so, specify the error and the page number.

Please indicate the type of reader that you most nearly represent.

D Assembly language programmer
D Higher-level lan~luage programmer

D Occasional proglrammer (experienced)
D User with little programming experience
D Student programmer
D Other (please specify)
Name ___________._ _ _ _ _.___ Date _ _ _ _ _ _ _ _ _ _ __
Organization

Telephone _ _ _ _ _ _ _ __

Street ___________ ,________________
City _ _ _ _ _ _ _ _ _ _ ,________ State ____ Zip Code _ _ __
or Country

-~-.- _gDOmNotgTear t- fOald lIeIre and Tape - - - - - - - - - - - - - - - - - - - - -

Tfl-ll1--------~~~~;:~~~if Mailed in the
United States

POSTAGE WILL BE PAID BY ADDRESSEE

SOFTWARE PUBLICATIONS

- - - -

200 FOREST STREET

MR01-2/L12

MARLBOROUGH, MA

01752

Do Not Tear - fold Here and Tape

-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -