Digital PDFs

AA-U047A-TK

April 1983

40 pages

Original

3.4MB

Document:	Professional Tool Kit PASCAL Language Reference Manual
Order Number:	AA-U047A-TK
Revision:	0
Pages:	40
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/pro3xx/POS/AA-U047A-TK_Professional_Tool_Kit_PASCAL_Language_Reference_Manual_198304.pdf

OCR Text

Professional Tool Kit
PASCAL Language
Reference Manual
Order No. AA-U047A-TK

April 1983

This manual describes the Professional Developer's Tool Kit PASCAL language, which is based on the standard proposed for the PASCAL programming language by the International Organization for Standardization. This manual is designed primarily for reference.

OPERATING SYSTEM AND VERSION:

VAX/VMS V3.2 or later
RSX-11 M V4.1 or later
RSX-11 M-PLUS V2.1 or later

SOFTWARE VERSION:

Professional Developer's Tool Kit V1 .5
Professional Tool Kit PASCAL V1 .0

DIGIT AL EQUIPMENT CORPORATION
Maynard, Massachusetts 01754

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 specifications and drawings, herein, are the property of Digital Equipment Corporation and shall not be reproduced or copied or used in whole or in part as the
basis for the manufacture or sale of items without written permission.

The following are trademarks of Digital Equipment Corporation:
CTI BUS
DEC
DECmate
DECsystem-10
DECSYSTEM-20
DEC US
DECwriter
DIBOL

MASSBUS
PDP
P/OS
PRO/BASIC
PRO/Communications
Professional
PRO/FMS
PRO/RMS
PROSE
PROSE PLUS

Rainbow
RSTS
RSX
Tool Kit
UNIBUS
VAX
VMS
VT
Work Processor

CONTENTS

CHAPTER 1
1.1
1.2
1.3
1. 4
1.5

CHAPTER 2
2.1
2.2
2.3

CHAPTER 3
3.1
3.2
3.3

CHAPTER 4
4.1
4.2
4.3
4.4
4.5

CHAPTER 5
5.1
5 .1.1
5 .1. 2
5.2
5.3
5.4
5.5

INSTALLING TOOL KIT PASCAL ON RSX-llM/M-PLUS SYSTEMS
THE DISTRIBUTION KIT • • •
REQUIREMENTS • • • . . • •
INSTALLING TOOL KIT PASCAL
INSTALLING TOOL KIT PASCAL
IF THERE IS AN ERROR . • •

• • • • • • •
• • • • • • •
FROM MAGTAPE
FROM DISK • •
. • • • • • •

•
•
•
•
•

•
•
•
•
.

•
•
•
•
•

1-1
1-2
1-2
1-4
1-7

INSTALLING TOOL KIT PASCAL ON A VAX/VMS SYSTEM
• • 2-1
• 2-2
• 2-2

THE DISTRIBUTION KIT . • •
REQUIREMENTS . • . • . • • •
INSTALLING TOOL KIT PASCAL

INSTALLING TOOL KIT PASCAL ON A PROFESSIONAL 350
SYSTEM
THE DISTRIBUTION KIT • • •
REQUIREMENTS • • • • • • •
INSTALLING TOOL KIT PASCAL •

. 3-1

. .
. .

.
.

. 3-2
. 3-2

INSTALLATION VERIFICATION PROCESS (IVP)
BUILDING THE IVP WITH AN RSX-llM/M-PLUS HOST TOOL
KIT
. . . . . . . . . . • . . . . . •
BUILDING THE IVP WITH A VAX/VMS HOST TOOL KIT
• •
BUILDING THE IVP WITH A PRO/TOOL KIT
. • • • •
INSTALLING THE IVP
• • • . . . • • • • • •
RUNNING THE IVP
• . . • • • • •
. • • • • • •

4-1
4-2
4-4
4-4
4-5

RELEASE NOTES
USING TOOL KIT PASCAL WITH THE PRO/TOOL KIT
•••
Compiling Programs • • • . • • . . • • • • • • •
Installing Applications
.••..••.
NEW FEATURES • • • • • • • •
• • • • • • • • •
COMPILER NOTES • • • • • • • • • • • • • • • • • •
GENERAL DOCUMENTATION NOTES
• . • . • • • •
•
LANGUAGE REFERENCE MANUAL NOTES
. • • . • • •

iii

5-1
5-1
5-2
5-3
5-5
5-6
5-7

FIGURES
4-1
4-2
4-3
4-4
4-5

Elementary Education Application . . . . .
Help on Elementary Education Application .
Reading the Report Card
• • . . . .
Course: Geography of North America .
Map of Northeastern United States

.
.
.
.
.

4-6
4-6
4-7
4-7
4-8

PREFACE

Document Objectives
This document describes how to install the Tool Kit
compiler on RSX-llM/M-PLUS and VAX/VMS host systems
intended to be used by system managers.

PASCAL
and is

It also contains information specific to Release 1 of Tool
PASCAL and is intended to be used by software developers.

Kit

Intended Audience
The installation chapters of this document
system managers but can be used by any
privilege.

are intended for
user with system

The release notes are intended for experienced programmers
familiar with the PASCAL programming language and with the
Professional 300 Series Developer's Tool Kit.

Documentation Conventions
red letters

Red letters indicate words that you type {to
distinguish
them
from
words that the
computer types).

Associated Documentation
Professional Develo2er's Tool Kit PASCAL Language Reference
• Manual

• Professional Develo2er's Tool Kit PASCAL User's Guide
• Professional Develo2er's Tool Kit User's Guide
• PRO/Communications Manual

CHAPTER 1
INSTALLING TOOL KIT PASCAL ON RSX-llM/M-PLUS SYSTEMS

1.1

THE DISTRIBUTION KIT

The Tool Kit PASCAL
following media:

distribution

volume

•

800 bpi (nine-track) DOS magtape

•

1600 bpi (nine-track) DOS magtape

RL02 disk

RK07 disk

available

the

The distribution volume contains the following files:
PROPAS.TSK

The PASCAL compiler

PASLIB.OLB

Non-sharable portion of PASCAL OTS

PASRES.TSK

Sharable portion of PASCAL OTS

PASRES.STB

Symbol definitions for PASCAL OTS

PASERR.MSG

Message file

PROBLD.CMD

Builds command files for RSX-llM/M-PLUS host

RMSDEFS .PAS

RMS-11 interface declarations

CGLDEFS.PAS

CORE Graphics Library declarations

MAPDEFS.PAS

Memory management directive declarations

ERROR.PAS

Sample error handling routine

ELEMENTED.PAS

Installation verification program

1-1

INSTALLING ON RSX-llM/M-PLUS

ELEMENTED.CMD

IVP Application Builder command file

ELEMENTED.ODL

IVP Overlay Descriptor Language file

ELEMENTED.INS

IVP Installation command file

1.2

REQUIREMENTS

•

Tool Kit PASCAL requires approximately
disk space.

900

blocks

free

install Tool Kit PASCAL, you must have already installed
• To
the
Peripheral Interchange Program (PIP) and the File
Exchange Program (FLX) to
disk.
a

drive

files
on

from

which

magtape

mount

the

•

You must have access
distribution volume.

•

You must have
access
to
a
privileged
login
user
identification code (UIC). If you do not have one, contact
your system manager before beginning the installation.

1.3

transfer

INSTALLING TOOL KIT PASCAL FROM MAGTAPE

You should install Tool Kit PASCAL on the same disk that contains
the Professional Developer's Tool Kit.

If you are using a DCL terminal, type:

system,

using

privileged

$ SET TERM MCR

Load the Tool Kit PASCAL distribution volume into a drive,
making sure that it's write-locked
(make sure the the
plastic ring has been removed before loading the tape).

Mount the Tool Kit distribution volume.

For example, type:

> MOU MMO: /FOR
5.

It is recommended that you now back
volume.
Use any of the standard
utilities.

1-2

up the distribution
RSX-llM/M-PLUS backup

INSTALLING ON RSX-llM/M-PLUS

from the
Copy the installation command file
(TKIP.CMD)
If
you are
distribution volume to your default directory.
copying from an 800 bpi magtape, use the command:
>FLX /RS=MMO:[l,S]TKIP.CMD/DO
If you are copying from 1600 bpi magtape, use the command:
>FLX /RS=MMO:[l,5]TKIP.CMD/DO/DNS:l600

Execute the installation command file:
>@TKIP

The following will display on your screen. When the system
prompts you,
type in the name of the device on which the
distribution volume is loaded.
(If your host system does
not have parent-offspring tasking, additional command lines
will display.)

>;-------------------------------------------------------------------;

>;
>;
>;
>;
>;
>;
>;

P R 0 F E S S I 0 N A L

>;
>;

D E V E L 0 P E R S

T 0 0 L

K I T

R s x - 1 1 MI M - p L u s
I n s t a 1 1 a t
P A S C A L

o n

P r o c e d u r e

V E R S I 0 N

• 2

;

>;-------------------------------------------------------------------;
>;
>;
>* Device containing the distribution kit? [S] :MMO:
>;

Copying the Tool Kit files

>;
>INS LB: [g,m]PROPAS
>; Compiling a sample application
>; This will take a few minutes
>TKP ELEMENTED,ELEMENTED=LB: [l,S]ELEMENTED/XR/-TR/-CH
•• lex
•• syn
•• opt
•• gen
•• 1st
>; Successful Installation of Professional/Tool Kit PASCAL
Vl. 2-1

>REM TKP
>DEL ELEMENTED.OBJ;

>
1-3

INSTALLING ON RSX-llM/M-PLUS

>DEL ELEMENTED.LST;
>;
Deleting installation files

>PIP
>PIP
>PIP

FLXFILIDX.CMD;/DE/NM
FILIDX.CMD;/DE/NM
DELFILIDX.CMD;/DE/NM

>;
>;

The Professional Tool Kit has been installed.
Please unload and store all media.

>;---------------------------------------------------------------;
>;
>;
>;
>;
>;
>;
>;

>;
>;

NOTE:

If you have previously installed a version of the
Professional Tool Kit, you may want to purge the
earlier files to recover the disk space. Please
consult your release notes for a list of the
affected directories.

*** End of Installation Procedure ***

;

>;---------------------------------------------------------------;
>@ <EOF>
NOTE
In the above message,
your system.
9.

[g,m] is

the

system

UIC

Dismount the Tool Kit PASCAL distribution volume:

> DMO MMO:
10.

Unload the Tool Kit PASCAL distribution
volume,
deallocate the drive if you allocated one earlier.

and

11.

Store the Tool Kit PASCAL
place.

safe

12.

Optionally, run VMR and install the Tool Kit PASCAL compiler
(LB: [g,m]PROPAS.TSK).
The compiler has the task name
II • • • TKP II •

13.

If you have a Professional, turn to Chapter 4 of this manual
and
follow
the
instructions
for
the
Installation
Verification Process. Otherwise, the installation of Tool
Kit PASCAL is now complete.

1.4

INSTALLING TOOL KIT PASCAL FROM DISK

distribution

volume

You should install Tool Kit PASCAL on the same disk that contains
1-4

INSTALLING ON RSX-llM/M-PLUS

the Professional Developer's Tool Kit.
1.

system,

If you are using a DCL terminal, type:

using

privileged

Load the Tool Kit PASCAL distribution volume into
making sure that it's write-locked.

Mount the Tool Kit distribution volume.

drive,

For example, type:

>
5.

It is recommended that you now back
volume.
Use any of the standard
utilities.

Copy the installation command file
(TKIP.CMD)
distribution volume to your default directory.

up the distribution
RSX-llM/M-PLUS backup
from

the

>
7.

Execute the installation command file:

>
8.

>;-------------------------------------------------------------------;

>;
>;
>;
>;
>;
>;
>;
>;
>;

p R 0 F E s

s I

D E V E L 0 P E R s

0 N A L

R s x - l
I

n s t a l
p

A s

c A L

K I T

MI M- p L u s

a t

T 0 0 L

i o n

r o c e d u r e

v E R s I 0 N

>;-------------------------------------------------------------------;

>;
>;
>* Device containing the distribution kit? [S]:

Copying the Tool Kit files
1-5

INSTALLING ON RSX-llM/M-PLUS

>;
>INS LB: [g,m]PROPAS
>; Compiling a sample application
>; This will take a few minutes
>TKP ELEMENTED,ELEMENTED=LB: [l,S]ELEMENTED/XR/-TR/-CH
.• lex
•• syn
•. opt
•• gen
•• 1st
>; Successful Installation of Professional/Tool Kit PASCAL
Vl.2-1
>REM TKP
>DEL ELEMENTED.OBJ;

>DEL ELEMENTED.LST;
>;
Deleting installation files

>;
>PIP
>PIP
>PIP

FLXFILIDX.CMD;/DE/NM
FILIDX.CMD;/DE/NM
DELFILIDX.CMD;/DE/NM

>;--------------------------------~------------------------------;

>;
>;

The Professional Tool Kit has been installed.
Please unload and store all media.

>;
>;
>;
>;
>;

NOTE:

*** End of Installation Procedure ***

;

>;---------------------------------------------------------------;

>@ <EOF>

NOTE
In the above message,
your system.
9.

[g,m]

the

system

UIC

Dismount the Tool Kit PASCAL distribution volume:

> DMO DLO:
10.

Unload the Tool Kit PASCAL distribution
volume,
deallocate the drive if you allocated one earlier.

1-6

and

INSTALLING ON RSX-llM/M-PLUS

11.

Store the Tool Kit PASCAL
place.

distribution

volume

safe

12.

Optionally, run VMR and install the Tool Kit PASCAL compiler
(LB: [g,m]PROPAS.TSK).
The compiler has the task name
" ••. TKP" •

13.

If you have a Professional, turn to Chapter 4 of this manual
and
follow
the
instructions
for
the
Installation
Verification Process. Otherwise, the installation of Tool
Kit PASCAL is now complete.

leS

IF THERE IS AN ERROR

The message "Tool Kit installation is now complete." does not
necessarily mean that the
installation was successful. Any
appearance
of
system
errors
indicates
an
unsuccessful
installation.
If an error occurs while the installation is in progress,
files copied from the distribution volume will be deleted.
example:

all
For

>;-------------------------------------------------------------------;

>;
>;
>;
>;
>;

>;
>;
>;

P R 0 F E S S I 0 N A L
R s

I n s t

D E V E L 0 P E R S

T 0 0

K I T

x - 1 1 MI M- p L us

a 1 1 a t

P A S C A L

o n

P r o c e d u r e

V E R S I 0 N

1 . 2

>;-------------------------------------------------------------------;

>;
>* Device containing the distribution kit? [S]:
>;
>;
Copying the Tool Kit files
>;

FLX
I/O error
MTO: [l,5]PROPAS.TSK -- I/O Error Code -13.

Installation Aborted - Cleanup in progress - Stand by

>;
>;

Please check the file LB: [g,m]PROPAS.TSK
If it was copied during this installation, please delete

it.

>;
1-7

INSTALLING ON RSX-llM/M-PLUS

>;
>;

Deleting the installation files

>PIP
>PIP
>PIP

FLXFILIDX.CMD;/DE/NM
FILIDX.CMD;/DE/NM
DELFILIDX.CMD;/DE/NM

>;
>;
>;

Tool Kit installation is now complete.

>@ <EOF>

NOTE
In the above message,
your system.

[g,m]

is the system UIC

Correct the error condition, then return to Section 1.2
manual and proceed with the installation again.

1-8

on
of

this

CHAPTER 2
INSTALLING TOOL KIT PASCAL ON A VAX/VMS SYSTEM

2.1

THE DISTRIBUTION KIT

The Tool Kit PASCAL distribution volume consists of:
•

Two RXOl diskettes for VAX-11/780 systems.

•

Two TU58 cartridges for VAX-11/750 systems.

The distribution kit contains the following files:
PROPAS.EXE

The PASCAL compiler

PASLIB.OLB

Non-sharable portion of PASCAL OTS

PASRES. TSK

Sharable portion of PASCAL OTS

PASRES.STB

Symbol definitions for PASCAL OTS

PASERR.MSG

Message file

PROBLD.COM

Builds command files for VAX/VMS host

RMSDEFS.PAS

RMS-11 interface declarations

CGLDEFS.PAS

CORE Graphics Library declarations

MAPDEFS.PAS

Memory managment directive declarations

ERROR.PAS

Sample error handling routine

ELEMENTED.PAS

Installation verification program

ELEMENTED.CMD

IVP Application Builder command file

ELEMENTED.ODL

IVP Overlay Descriptor Language file

ELEMENTED.INS

IVP Installation command file
2-1

INSTALLING ON VAX/VMS

2.2

REQUIREMENTS

•

Professional Tool Kit PASCAL requires approximately 900
blocks.

•

You must have access to the console drive.

•

You must have access
account SYSTEM.

2.3

the

privileged

system

disk

manager's

INSTALLING TOOL KIT PASCAL

Proceed as follows at the console terminal.
NOTE
Some of the VMSINSTAL message lines shown in this
terminal session have been folded in order to fit
on a printed page. They will appear as single
lines on your terminal.

Invoke VMSINSTAL:
$ @SYS$UPDATE:VMSINSTAL

VAX/VMS Software Product Installation Procedure
It is (current date/time string).
Enter a question mark (?) at any time for help.

Several %VMSINSTAL-W-warning messages
by:

may

appear,

followed

* Do you want to continue anyway [NO]? YES
* Are you satisfied with the backup of your system disk
[YES]? YES
* Where will the distribution volumes be mounted: CSAl:
CSAl: allocated
Enter the products to be installed
from the first distribution volume set.
*Products [EXIT] : PROPAS
Please mount the first volume of the set on CSA!:.

2-2

INSTALLING ON VAX/VMS

Remove the VMS console medium {if mounted} and load the first
Tool Kit PASCAL distribution volume in the console drive.
Are you ready? YES
%MOUNT-I-MOUNTED, PROPASOl

mounted on CSA!:

The following products will be installed:
Vl.2

PROP AS

Beginning installation of PROPAS Vl.2 at {time}
%VMSINSTAL-I-RESTORE, Restoring product saveset A ••.
%BACKUP-I-RESUME, resuming operation on volume 2
%BACKUP-I-READYREAD, mount volume 2 on CSA!: for reading
5.

Remove the first Tool Kit PASCAL distribution volume and load
the second distribution volume in the console drive.
Press return when ready: <RET>
* Do you want to purge files
replaced by this installation [YES]? NO*
%VMSINSTAL-I-MOVEFILES,
Files will now be moved to their target directories ••.
Successful installation of PROPAS Vl.2 at {time}
Enter the products to be installed from the next distribution
volume set.
* Products [EXIT] : <RET>
Please mount the console volume on CSAl:
Are you ready? YES
%MOUNT-I-MOUNTED, CONSOLE
mounted on CSAl:
VMSINSTAL procedure done at {time}

If you have a Professional, turn to Chapter 4 of this manual
and follow the instructions for the Installation Verification
Process. Otherwise, the installation of Tool Kit PASCAL is
now complete.

* If you have Tool Kit PASCAL Vl.O or Vl.l on your system, answer
11

YES 11 here.
2-3

CHAPTER 3
INSTALLING TOOL KIT PASCAL ON A PROFESSIONAL 350 SYSTEM

3.1

THE DISTRIBUTION KIT

The Tool Kit PASCAL distribution kit consists
diskettes containing the following files:

two

PROPASCAL.TSK

The PASCAL compiler

PASLIB.OLB

Non-sharable portion of PASCAL OTS

PASRES. TSK

Sharable portion of PASCAL OTS (stub)

PASRES.STB

Symbol definitions for PASCAL OTS

PROBLD.CMD

Builds command files for PRO/Tool Kit

RMSDEFS .PAS

RMS-11 interface declarations

CGLDEFS.PAS

CORE Graphics Library declarations

MAPDEFS.PAS

Memory managment directive declarations

ERROR .PAS

Sample error handling routine

ELEMENTED.PAS

Installation verification program

ELEMENTED.CMD

IVP .A.pplication Builder command file

ELEMENTED.ODL

IVP Overlay Descriptor Language file

ELEMENTED.INS

IVP Installation command file

ELEMENTED.HLP

IVP help frame file

ELEMENTED.MNU

IVP menu frame file

ELEMENTED.MSG

IVP message file

3-1

RX50

INSTALLING ON THE PROFESSIONAL 350

DCLPASCAL.HLP

PASCAL help file
NOTE

PASRES.TSK is only a "stub" for
the Application
Builder to use.
The real OTS file are placed in
[ZZSYS] at P/OS installation time.

3.2

REQUIREMENTS

Professional Tool Kit PASCAL requires approximately 900
blocks.

disk

•

You must have a Professional 350 personal computer
PRO/Tool Kit installed.

the

with

NOTE
If your Professional
350 system has P/OS
Vl.5,
the
Tool Kit PASCAL installation
verification procedure may fail.
Turn to
Section 5.1.l (first note) for details.

3.3

INSTALLING TOOL KIT PASCAL

Start up your Professional 350 system.

If have already installed an application named
use Disk/diskette Services to remove it.

Invoke the PRO/Tool Kit.

Insert distribution diskette "PROPASCALl" in DZl.

Insert distribution diskette "PROPASCAL2" in DZ2.

Type:
$
$

3-2

"ELEMENTED",

INSTALLING ON THE PROFESSIONAL 350

The following will appear on your screen:
$
$
$

Pascal Language Installation Procedure

If you have installed
command will appear:

version,

the

following

$REMOVE ... PAS
9.

The remainder of the installation
following:

will

continue

with

the

$INSTALL APPL$DIR:TKP/TASK= ... PAS
$ ; Compiling the Installation Verification Program
$
This will take about 10 minutes
$ PAS ELEMENTED
$ ; Building the Installation Verification Program
$ LINK @ELEMENTED
$ INSTALL [ZZSYS]CGLFPU
$ ; Executing the Installation Verification Program
$ RUN ELEMENTED
10.

Turn to Section 4.5, Step 2 of this manual and follow the
instructions
for running the Installation Verification
Process.

11.

The following will appear on your screen:
$ REMOVE/REGION CGLFPU
$
Installation complete
$ @ <EOF>

12.

Remove and store the distribution diskettes.

3-3

CHAPTER 4
INSTALLATION VERIFICATION PROCESS (IVP)

The Installation Verification Process
{IVP}
verifies
the
successful installation of Tool Kit PASCAL. The process consists
of successfully compiling, building, installing, and running a
sample PASCAL application. The sample is a partially-developed
Elementary Education Application that is intended only
to
exercise specific features of the Tool Kit.
If you are using the Professional Developer's Tool Kit on a
RSX-llM/M-PLUS system, proceed to Section 4.1.

host

If you are using the Professional Developer's Tool Kit on a
VAX/VMS system, proceed to Section 4.2.

host

If you are using the PRO/Tool Kit on a Professional
proceed to Section 4.3.

4.1

350

system,

BUILDING THE IVP WITH AN RSX-llM/M-PLUS HOST TOOL KIT

The Installation
Verification
Process
assumes
that
the
Professional Developer's Tool Kit and Tool Kit PASCAL have been
installed on your host RSX-llM/M-PLUS system and that the
PRO/Communications application and the Fast Install program have
been installed on your Professional.
Proceed as follows:
1.

Start your Professional 300 Series system.

Use Disk/diskette Services
ELEMENTED on BIGVOLUME.

Insert the Tool Kit RXSO diskette, volume label PRO/ APP
DSKT BLDR Vl.7 RXSO (the diskette that contains Fast Install
and the Application Diskette Builder).

4-1

create

directory

named

from

files

ELEMENTED.MSG
ELEMENTED.MNU
ELEMENTED.HLP

Using the instructions in the
invoke the terminal emulator.

Log onto your host VAX/VMS system.

This file
is
Compile the source file ELEMENTED.PAS.
provided with Tool Kit PASCAL and is automatically copied to
LB: [ 1, 5] when you install Tool Kit PASCAL on your host
system. Type:

PRO/Communications

Manual,

$ RUN SYS$SYSTEM:PROPAS
PAS>SY:ELEMENTED=LB:[l,S]ELEMENTED

The file ELEMENTED.OBJ is produced by the compiler.
8.

To build the IVP,
directory. Type:
$

you

must

have

the

ODL

file

your

COPY LB:[l,S]ELEMENTED.ODL *

Invoke the Professional Application Builder.

RUN SYS$SYSTEM: PROTKB
PAB> @LB: [l,S]ELEMENTED

The file
Builder.

ELEMENTED.TSK

4-3

produced

the

Application

INSTALLATION VERIFICATION PROCESS

10.

Using the instructions in the PRO/Communications Manual,
transfer
ELEMENTED.TSK
and
LB: [l,S]ELEMENTED.INS
to
BIGVOLUME: [ELEMENTED] on your Professional.

11.

Log off your host system.

12.

Using the instructions in the PRO/Communications
exit from the terminal emulator.

13.

Proceed to Section 4.4.

4.3

BUILDING THE IVP WITH A PRO/TOOL KIT

Manual,

If you are using a Professional 350 system, the Tool Kit PASCAL
installation procedure compiles, builds, and runs the IVP for
you. If you want to perform the process yourself, proceed as
follows:

Start your Professional
PRO/Tool Kit.

Type these commands in the order shown:
$

300

Series

system

and

run

the

SET DEFAULT [ELEMENT.ED]

$ PASCAL ELEMENTED/XRAY
.. lex
.. syn
.. opt
.. gen
$

LINK @ELEMENTED

EXIT

Proceed to Section 4.4.

4.4

INSTALLING THE IVP

Select Fast Install from the appropriate menu.
When Fast
Install prompts for the disk directory name in which the
application resides, type:
ELEMENTED

4-4

INSTALLATION VERIFICATION PROCESS

When the Application Group Menu appears, select a group
press DO.

A form will appear displaying the name of the application,
and the name of the group.
Follow the instructions on the
form and press DO.

Proceed to Section 4.5.

4.5

RUNNING THE IVP

Select ELEMENTED installed it.

A static, single-choice menu titled "Elementary
Application" will appear (see Figure 4-1).

Press HELP.
A help menu titled "Help on
Elementary
Education Application" will appear (see Figure 4-2).

Select Reading the Report Card.
appear {see Figure 4-3).

Press RESUME to return to the first menu.

Select Geography.
A multiple-choice menu titled ''Course:
Geography of North America" will appear (see Figure 4-4).

(including
Using the SELECT key, select all of the options
the
incorrect ones)
and press DO. An error message will
appear and, after a few seconds,
the multiple-choice menu
will reappear.

Select Mt.

Teton,

PASCAL

IVP

Rushmore, Mt.
Mt.
Rainier, Mt.

from

the

help

text

Washington, Mt.
St. Helens, Mt.

press DO.
A message indicating
correct answer will appear.

you

have

where

and

you

Education

frame

will

Hood, Grand
McKinley, and
supplied the

After a few seconds, a map of the Northeastern United States
will appear on your screen (see Figure 4-5). This completes
the Installation Verification Process. Tool Kit PASCAL has
been successfully installed.

10.

Proceed to Chapter 5 for
information
PASCAL with the PRO/Tool Kit.

4-5

using

Tool

Kit

INSTALLATION VERIFICATION PROCESS

This application offers elementary education in seven
fields of study.

Select one of the courses listed here:

-,.:·

Biola9';j
Computer Science
Geography
Government
Historlj
Literature

l'lathemati.cs

Make a selection and press the DO kelj:

Figure 4-1:

Elementary Education Application

Yau can displa';j helpful information about the subjects listed below.

Select an option then press the DO ke~.

Press the RESUME ke~ to return

to the Main Menu.

COl'IPLETING TEST AND QUIZZES
READING THE REPORT CARD
SELECTING COURSES
USING THE l'IAP

Make a selection and press the DO key:

Figure 4-2:

Help on Elementary Education Application
4-6

INSTALLATION VERIFICATION PROCESS

You can display helpful information about the subjects listed below.
Select an option then press the DO ke~. Press the RESUME ke~ to return
to the Main Menu.

CCl1PLETING TEST AND QUIZZES
READING THE REPIJH CARO
SELECTING CllJRSES
USING THE MP

The Report Card presents an objective evaluation of ~our work in courses
offered by the Elementar~ Education Application. The Report Card lists
all the courses ~ou have taken. For each course, it indicates the number of correct and incorrect answers given on tests and quizzes, the
number of times the course was taken, the date of the last quiz and test
taken, and, if the course was completed, the passin9 or failin9 9rade.

Figure 4-3:

Reading the Report Card

This course covers rivers, lakes, and mountains.

The first topic is

mountains.

The mountains listed below ;ire located in different parts of

the world.

Select all the mountains located in North Amerlca:

->
->
->
->
->

MT. RUSHMORE
MT. WASHINGTON

MT. ST. HELENS

MT. HOOD

GRAND TETON

MT. RAINIER
MT. FUJI

KILIMANJARO

->-> MT. MCKINLEY

Choose one or more options with the SELECT key and press the DO key:
Select up to
!

Figure 4-4:

Course:

9 items
7 chosen )

Geography of North America

4-7

INSTALLATION VERIFICATION PROCESS

~""""

·-----~
_,.-

l,f
I
I

_,,/

•-

!~~...__,,,--!:?-~ MT. WASHINGTO~-~ MAjlNE

'"'

MINN

!
1

~-, _,,-\./~-·-:,,,,__,___

,,,..1

,
ly/
/
,; n
'"- WISCONSiN i.!/
I

} --· -----~\

~.';v-\.~

·~,_.,

-'J

_______

. ._

""'-- "'
\"'-....:i

;,,

f")
•:

~IT'))., ',
" , T , 1\1
·
(
-~ :> l
\I
I NH \ '
/'

,.,,..L

/.,,..--

~ .,.

V \ )

.·

J ~ _ ·~~ ~~~f.. ,...

V"i / - - ~ - ·\~
,.·[
-. . . , -,,...- ../ ~ - - i

PENNSYLVANIA

,_CONN'

)

J,
r"'( i
(, - - "."~-'\ - ~ ,..\
/
\._ ILLINOIS 1 IND ,
/../ · 1_,./f . , . . ....,MO ., ~
.· · · · · · - , t;,..._· ..~
r-'
/' i
(' ~ )
v
·-·-{ W VA 1
~ i' DEL
./
1

OHIO

I! MISSOURI '"·- ·.,

-~ /

•

'·

f
\ .r... ..t V~i\fTI ·r···-'\
~Uvt·...

,.,,.··

Figure 4-5:

'·

t,..--...--" -·

•

..._.,....,~

t}H"

) .,

Map of Northeastern United States

4-8

tM(!S~~ (

, '-,,.{ .
(NJ '

c:---'
,r·

;

\,~1ICµ

•·., - - - \
)

(

-......

i \

IOWA

r~·

CHAPTER 5
RELEASE NOTES

5.1

USING TOOL KIT PASCAL WITH THE PRO/TOOL KIT

Using Tool Kit PASCAL with the PRO/Tool Kit is similar to using
Tool Kit PASCAL with RSX-llM/M-PLUS or VAX/VMS DCL without the
file transfer step. This section describes the differences.

5.1.1

Compiling Programs

Before invoking the PRO/Tool Kit PASCAL compiler, type:
$

INSTALL APPL$DIR: PROPASCAL

The PASCAL command format is described in the PRO/Tool
Command Language/Utilities Manual. The defaults are:

Kit

/CHECK=ALL
/CODE=FPP
/DEBUG=TRACEBACK
/NOLI ST
/NOMACHINE CODE
/OBJECT
/NOSTANDARD
/NOXRAY
If you omit a file name, the PAS> prompt will appear and you can
enter a command in the format described in the Tool Kit PASCAL
User's Guide. For example:
$ PASCAL
PAS> ELEMENTED=ELEMENTED/XR

5-1

RELEASE NOTES

Notes
•

If your Professional 350 system has P/OS Vl.5, the Tool Kit
PASCAL compiler may produce apparently invalid error messages
because of inadequate memory.
If that happens, you can
obtain more memory by following these steps:
1.

Start the PRO/Tool Kit and set your default directory
APPL$DIR.

Edit START.CMD and comment out any tasks that are
essential
to
your program development cycle.
example, if you do not use the DIFFERENCES command,
semicolons as shown in bold:

not
For
add

;

.'
.'

Install the Compare Utility - DIFFERENCES command
.DISABLE QUIET
.IFNINS •.• CMP
.ENABLE QUIET

INSTALL APPL$DIR:CMP

Do not comment out the Professional Application Builder.
3.

Return to the Main Menu
restart the PRO/Tool Kit.

(use

the

EXIT

command)

and

If you find that you need one of the DCL commands that no
longer work, type "RUN $program", where "program" is the
name of the task you commented out.
For example, you
could say "RUN $CMP".

•

Because of a slight DCL incompatibility, /MACHINE CODE=file
results
in
an
error.
To use this option, specify
/MACHINE CODE and allow the output (.MAC) file to default to
the same-name as the input file.

•

You cannot use /OBJECT and /MACHINE CODE at the
If you want /MACHINE_CODE, specify /NOOBJECT.

5.1.2

same

time.

Installing Applications

The following information is also present in the Tool Kit User's
Guide.
To install a Tool Kit PASCAL applicatTOri'"; you can use
Disk/diskette Services, Fast Install (as demonstrated in the
IVP), or PRO/Tool Kit DCL.
Ultimately, end users will use
Disk/diskette Services to install your application.
It

recommended

that

you

use
5-2

Fast

Install

during

the

RELEASE NOTES

development process because your application's run-time context
will be similar to that produced by Disk/diskette Services.
users.
This is particularly important if your application opens
files:
your application can use PROLOG to translate APPL$DIR in
order
to specify the location of its files.
Also,
your
installation command file can use ASSIGN MENU and ASSIGN HELP to
open menu and help files and RDMSG will work as documented.
If you use the DCL INSTALL command, APPL$DIR will refer to the
PRO/Tool Kit directory, rather than your application directory,
because the PRO/Tool Kit is itself an application.
Thus, you
must use one of the following methods to specify the locations of
files:
•

Write your source code with exact file
specifications.
You
will have to change it and recompile when you test your
application with Fast Install or Disk/diskette Services.

•

Copy the application files into the PRO/Tool Kit directory so
that APPL$DIR will "point" to the right place. This solution
will not require any code change when you test
your
application with Fast Install or Disk/diskette Services:
you
simply copy the files to a different directory.
NOTE
Do not reassign the logical name APPL$DIR. To do
so can cause the PRO/Tool Kit to stop working.

The first method is preferable because
it is undesirable to
change the contents of the PRO/Tool Kit directory.
If you remove
the PRO/Tool Kit
(to install a new version or whatever),
extraneous files can cause the removal to fail.

5.2

NEW FEATURES

A routine can be declared as EXTERNAL in the same module
that contains the routine definition (heading and body).
The formal parameter lists must be identical.
This occurs primarily when using an include file to declare
external
routines.
For
example,
the
include file
EXTERNALS.PAS declares, among other things:
procedure foo (a,b,c : integer); external;
The module that actually contains the procedure is:

5-3

RELEASE NOTES

module five;
%include 'EXTERNALS/nolist'
[GLOBAL] procedure foo {a,b,c
begin

end
end

integer);

foo l;

five J.

This module is valid, even though the procedure heading
appears twice.
In Tool Kit PASCAL Vl.O, if a routine is
declared as external and defined in the same module,
the
routine definition heading cannot have a formal parameter
list.
NOTE
Although the external declaration and the global
definition
of
a
procedure can occur in one
compilation unit, the same is NOT true of variables.
An external declaration and a global definition of a
variable in the same unit will result in an error.
2•

The compiler now supports RAD50 string constants which are
useful when calling P/OS executive directives. The syntax
is similar to that for octal, hexadecimal, and binary
constants. The flag character is "R".
A RAD50 string constant of fewer than three characters
returns an integer constant {one word). A RAD50 string
constant of four to six characters returns a long integer
constant {two words). For example:
var
i : integer; 1

long_integer;

begin
i : = %R 'GEN I i
1 := %R'GENPAR';
end;
3.

%0 I 26226 I l
%0'26226' %0'62072'

The compiler now allows expression results
{including
function calls and elements of packed structures) to be
passed as actual parameters to formal VAR
parameters
declared with the READONLY attribute. This feature will
make CORE Graphics Library programming easier because you no
5-4

RELEASE NOTES

longer have to declare and use an explicit temporary
variable for expression results.
When
you
pass
an
expression to a [READONLY] VAR parameter, PASCAL pushes the
expression value onto the stack and creates a pointer to
that location.
4.

The compiler now supports default parameters for SEQll
procedures to facilitate the use of P/OS services directly
from Pascal.
If a SEQll procedure call fails to specify actual parameters
for any of the formal parameters declared with the procedure
header, PASCAL will pass minus one (-1) as the address of
the missing parameter.

5.3

COMPILER NOTES

On VAX/VMS
systems,
compiler
command
lines
behave
incorrectly when your default device is a rooted directory
such as SYS$SYSROOT. To avoid the problem, include "SY:" in
each file specification that does not already contain a
device name.

The default floating point option for Tool Kit PASCAL Vl.l
or later is /FP (/CODE=FPP), rather than /-FP, as in Vl.O.

The include file RMSDEFS.PAS contains type declarations for
PRO/RMS-11 data structures well as the PRO/RMS-11 completion
and fatal error codes. Unless you intend to use the data
structures,
it is recommended that you create a new file
containing only the PRO/RMS-11 completion and fatal error
codes and use it instead.
This will improve compiler
performance.

On a VAX/VMS system, if your disk usage is close to your
quota, the compiler may hang or generate spurious error
messages.
To avoid this problem, keep at least 1500
available blocks. Large compiles may require more.

If you get the compiler diagnostic message:
"Register <n> not saved during actual parameter list."
where <n> is the register which was not saved, you should
simplify the surrounding environment. Several registers are
required to push large structures onto the stack so if the
problem is a large value param, it may help to use a VAR
param instead as this will only push the address of the
item.
Another heavy register user is intermediate level
5-5

RELEASE NOTES

data references.
That is, accessing data declared in
procedures enclosing the one giving the problem. Accessing
data at the outer mqst level (PROGRAM or MODULE level} is
not a problem as the stack does not have to be walked to
locate the data. Use of the /CHECK option also uses extra
registers.

5.4

GENERAL DOCUMENTATION NOTES

The Professional Application Builder requires that all
identifiers declared with the GLOBAL attribute be unique
within the first six characters.

All Tool Kit PASCAL programs contain a GLOBAL procedure
named ERROR that receives control when a run-time error
occurs. By default, the Professional Application Builder
extracts your program's ERROR procedure from the Tool Kit
PASCAL object module library (PASLIB.OLB}.
That ERROR
procedure displays information useful for debugging your
application. The source code for that procedure (ERROR.PAS}
is included in the distribution kit.
When you supply your own GLOBAL procedure named ERROR, it
will receive control when a run-time error occurs. It is
recommended that you use your own ERROR procedure.
If an
unanticipated run-time error occurs, your application can
display useful information and instructions for the user.
NOTE
When you declare your own ERROR procedure,
/NOCHECK and /NODEBUG (/-CH/-TR}.

compile

Input/output on a relative file cannot cause the EOF
function to return TRUE. Thus, when working with relative
files, you must use some other means to detect end-of-file.
Alternatives are:
•

Put a sentinal record in the file.
solution.

This is the simplest

•

Write a user-action OPEN routine that sets a maximum
cell number. The default maximum cell number is 2
31
which, for all intents and purposes, is infinity.
A

5-6

RELEASE NOTES

•

Store the number of the last record written to the
somewhere.

file

•

If you know that the valid portion of the file does not
contain deleted records, you can check the UFB function
for TRUE or the STATUS function for a "record not found"
error.

If the Professional Application Builder returns an undefined
symbol error for a symbol such as "$B81" or "$B83", edit
your .ODL file and add an explicit OTS reference to the
appropriate segment.
For example, if segment F002 had an
undefined symbol error, you would add the characters shown
in bold:
FOO-PASLB-RMSROT-OVRLY
.ROOT
*(OV1,0V2,0V3)
OVRLY:
.FCTR
OVl:
.FCTR
FOOl
F002-PASLB
OV2:
.FCTR
OV3:
.FCTR
F003
LB: [l,5]PASLIB/LB
PASLB:
.FCTR
@LB: [l,5]RMSRLX
.END

5.5

LANGUAGE REFERENCE MANUAL NOTES

Page 2-18, paragraph two:
replace
7.5.3" with "Sections 7.17 and 7.9".

Page 3-8, paragraph
"Section 10.13".

Page 6-19, Section 6.6.4, paragraph two:
10.7" with "Section 10.9".

replace

Page 6-19, Section 6.6.4, paragraph three:
10.8" with "Section 10.11".

replace "Section

Page 7-9, Section 7.17, example
Node;" with "Ptr = -Node;".

program:

replace

"Ptr

Page 7-10, example program in first note:
Node;" with "Ptr = -Node;".

replace

"Ptr

Page 8-10, Section 8.10, Positional
format:
"default file name" with "default_file_spec".

replace

one:

5-7

"Sections
"Section

7.5.2

and

10.21"

with

"Section

replace

RELEASE NOTES

Page 8-10, Section 8.10, Non-positional
"FILE SHARING" with "SHARING".

format:

replace

Page 8-10, Section 8.10, Non-positional format:
"default file name" with "default_file_spec".

replace

10.

Page 8-11,
"SHARING".

11.

Page 8-15, Section
"SHARING".

12.

The OPEN procedure has several parameters that are shown in
Section 8.10 (syntax diagram) and Table 8-1 (Summary of OPEN
Procedure Parameters) but not described in detail.
They
are:
e

Table

8-1:

replace

8.10.10:

replace

"FILE SHARING"

with

"FILE SHARING"

with

DEFAULT
The DEFAULT
parameter
provides
a
default
file
specification for the FILE NAME parameter. When RMS-11
parses the FILE NAME, it uses the DEFAULT value to fill
in any missing-fields.
If the DEFAULT parameter is not
present,
RMS-11
uses
the
P/OS
current
file
specification.
Refer to the Tool Kit User's Guide for
detailed information on file specifications.

FILE SIZE
The FILE SIZE parameter specifies an initial
file
allocation in 512-byte blocks. The default FILE SIZE
value is three blocks. Use this parameter whenever- you
have a reasonable idea of how much space a file will
require.
It is much more efficient to specify a large
initial allocation than to allocate additional blocks as
needed.

FILE EXTENSION
The FILE EXTENSION parameter specifies the number of
512-byte blocks to allocate when PASCAL must obtain
additional space for a file. The default FILE EXTENSION
value is five blocks.

5-8

PASCAL Language
Reference Manual
Order No. AA-U047A-TK
READER'S COMMENTS
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 under Software Performance Report (SPR) service, submit your comments
on an SPR form.
Did you find this manual understandable, usable, 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 language programmer
D Occasional programmer (experienced)
D User with little programming experience
D Student programmer
D Other (please specify) _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __

Name _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Date _ _ _ _ _ _ _ _ _ __
Organization-------------------------------Street _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __
City ________________ State _ _ _ _ _ _ _ Zip Code _ _ _ _ _ __
or
Country

I
I
I
Do Not Tear - Fold Here and Tape - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1

,.,a,aa~a
~ W
~

11111

,.:~: ~:~ he !
United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO. 33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

Professional 300 Series Publications
DIGITAL EQUIPMENT CORPORATION
146 MAIN STREET
MAYNARD, MASSACHUSETTS 01754

- - - Do Not Tear - Fold H e r e - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

I
I
I