Digital PDFs

AA-K503B-TC

September 1981

74 pages

Original

3.1MB

view download

OCR Version

2.8MB

view download

Document:	F77inst Sep81
Order Number:	AA-K503B-TC
Revision:	0
Pages:	74
Original Filename:	AA-K503B-TC_F77inst_Sep81.pdf

OCR Text

PDP-11 FORTRAN-77
Installation Guide/Release Notes
Order No. AA-K503B-TC

September 1981
This guide describes the procedures for installing PDP-11

FORTRAN-77 on

the RSX-11M/M-PLUS, RSTS/E, and IAS operating systems.

SUPERSESSION/UPDATE INFORMATION:

This document supersedes the
FORTRAN IV-PLUS Installation

Guide, Order No. AA-1873D-TC

OPERATING SYSTEM AND VERSION:

RSX-11M V3.2

RSX-11M-PLUS V1.0
IAS V3.1

' SOFTWARE VERSION:

FORTRAN-77 V4.0

digital equipment corporation - maynard, massachusetts

First Printing, March
Revised, December
Revised, January
Revised, December
Revised, September

1975
1975
1977
1979
1981

notice
without
The information in this document is subject to change
a commitment by Digital Equipment
as
construed
be
not
should
and
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
1license
and
may be
used or copied only 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.

1975,

1977,

1979,
All

1981 by Digital

Rights

Printed

The

postage-paid

document

preparing

The

following

U.S.A.

READER'S COMMENTS form

requests
future

the

wuser's

documentation.

are

trademarks of

DEC

DECUS

Equipment Corporation

Reserved.

critical

Digital

the

1last

evaluation

this

Equipment Corporation:

DECsystem-10

PDT

DECSYSTEM=-20

RSTS

DIGITAL

DECwriter

RSX

PDP
UNIBUS

DIBOL
Edusystem

VMS
VT

MASSBUS

iAS

dlilgliltlall

DECnet

page

to assist us in

ZK2034-81

CONTENTS

Page
PREFACE

IAS

FILES

[1,2]

¢«

UFD

[11,36]

.«

UFD

[11,37]

UFD

[11,40]

UFD

DEFAULT

FORTRAN

F77

the

Selecting

FOR

o«

Default

FORTRAN

the

Default

SELECTING

FORTRAN

F77 COMPILER

OPTIONS

SELECTING

F77

using

MAKING

THE

¢«

MCR

IAS

using

.
.
MCR

IAS

using

DCL

PERFORMANCE

¢«

AVAILABLE

AFFECTING
the

RSX-11M

b=
N

Short

Size
.

Error

ONlY o
FAPMAP

¢
.

o«
v

o
¢

Files

Systems

Without

OPTIONS

FAP11IS

COMPILE-TIME

Temporary

Operating

[\o}

TASK

o
e

TAILORING

Selecting

OTS

COMPILER

o«
or

RSX-11M/M~-PLUS

RSTS/E

IAS

PROCEDURES

[)

RSTS/E

OPTIONS

OTS

INSTALLATION

the

o«

Dynamic

Supporting
.

¢«

Dynamlc

Storage

Dynamic

Area

Memory

Allocatlon

¢«

Text

o
o
o
o
o
o
o
o
o
o
o
o
o
RSX-11M/M-PLUS and RSTS/E

o
¢
o

o
4
o

o
5
o

o
o
o

FAPEIS

&«

o
v
o

FAPCVF

¢«

F4PNER

WNDNNDE

THE

Selecting

iii

NN[}JNNNNNNMNNI\)N
|
I
I
|I T
T

PLANNING

ATV

¢
¢

e b

¢
.

B wWwN
N

W
NN
=

Additional
.

¢«

OPTIONS

\S]

RESX-1IM/M-PLUS

B WN

o
o
«

SYSTEM

AT
W

o
o

TP
Ry Wy SR
S
S
R

N
RNNNDNDNDNONDNNNNDNDNONOND

MTUTUTI
TS D B
WR

PRELIMINARY

w
[]
L]
[)

RSX-1IM-PLUS

SELECTING

wwww

RSTS/E

INSTALLATION

=
b

wWwww

Allocation

wwww

CHAPTER

DISTRIBUTION

NN
N

CHAPTER

REQUIREMENTS

RSX-1IM

|
BWWWWNNN

SYSTEM
@

INTRODUCTION

DWW
N =

1
PR SN

CHAPTER

vii

FAPRES

¢«

Copying the Message File . .
INSTALLATION FROM DISK CARTRIDG E

INSTALLATION

MOUNTING (AND COPYING) THE AUTOPATCH KIT .
Mounting and Copying a Magnetic-—-Tape Ki t
Mounting (and Copying) a Disk Kit
MOUNTING THE F77 DISTRIBUTION KIT
BUILDING THE COMPILER AND THE OTS
USING MCR

o
o

e
o

| ]

-3
e
o

UTI ON

USING DCL

IAS

Preparations . « « « ¢ « o
. .
Building the Compiler
Building the OTS . . . . .
Copying the Message Files
. . .
INVOKING THE COMPILER

the

OTS

.
Copying the Message Files
INSTALLATION FROM DISK CARTRIDG E

.
.
.
.

Building

=«

[

o«

the Compiler

Building

Preparations

W
N

o
o

AT
D

the Message Files

the

the Compiler

Copying

OTS

—

Building

Uoooo

Building

[Ne

Preparations

.
Copying the Message Files
INSTALLATION FROM DISK CARTRIDG E

o
&

o
«

B W N

e
o

W N

¢« o

o
«

INSTALLATION FROM MAGNETIC TAPE DISTRIBUTION
B WN

)

INVOKING THE COMPILER

WNNNDNDNE

«
Preparations . . .
Building the Comp11er
Building the OTS . . .

nmdbwwwwdhdh
=+

the Message File

INSTALLATION FROM MAGNETIC TAPE DISTRIBUTION

WRNNDNNN -

@
o
s
o
¢
o
o
o
o
e

Copying

OTS

INVOKING THE COMPILER

wn
L]

the Compiler

the

D ISTRI BU T ION

[
T
|
P
s bdwWwww NN

o
s

Building

Preparations

S O A
R L
|
I
[
DD WwWwwN N =

&
.
.

s
o

«
.
.

e
o

o
s
o

«
.
«

o
o

GG
S

N
«

S
ST
[

Preparations . « « « «
Building the Compiler
Building the OTS . . .

Building

~
o
o
o
«

o
o
¢
o

INSTALLATION

INSTALLATION ON

¢«

NN NN NN NNNNN

=0
00 ~J

o
*

NNNDNDN

INSTALLATION ON IAS

NN NN NNNNNN

'CHAPTER

RSTS/E

o)W )We)We)We)We)
e
We) o) Wo) o) Be)l

CHAPTER

INSTALLATION FROM MAGNETIC TAPE DISTRIBUTION

5,0
W, NS WE

CHAPTER

FAPRAN

RSX-11M/M-PLUS
WNNDNDNDNDFEHEEE

CHAPTER

FAPNIO

0TS Overlay Descrlptlon F11es

-3

wwwww

CONTENTS

CONTENTS
Page

BUILD

VERIFICATION

8.1

TEST

PROGRAM

8.2

TEST

RESULTS

8.3

VERIFICATION

RELEASE

9.1
9.2
9.3

USING

INCORRECT

FATAL

TASK

INCREASES

9.4

RESTRICTION

9.5

F77

NOTES

ERROR

INSTALLATION

A. l.2

Building

the

Compller

A.l.3

Building

the

OTS

.
.

File

A.2.2

Building
Building

Compller
0TS .
. .

.
.

A,.2.4

A.3

APPENDIX

B.1

Copying

the
the
the

Message

File

COMPILER

INVOKING

THE

COMPILER

TASK-BUILD

PDP-11

FORTRAN-77

RSX-11M/M-PLUS
B.2

PDP-11
PDP-11

FORTRAN-77
FORTRAN-77

USING MCR
B.4

PDP-11
IAS

FILES

COMPILER
COMPILER

DCL

.
.

3-1

Compiler

FILE

FOR

TASK—BUILD

FILE

FOR

TASK

BUILD

FILE

FOR

TASK

BUILD

FILE

FOR

COMPILER

(F77IAS.CMD)

FIGURES

FIGURE

TASK-BUILD

COMPILER

(F7711D.CMD)

FORTRAN-77

USING

(F7711M.CMD)

RSTS/E (F77RST.CMD)

B.3

DISTRIBUTION

CARTRIDGE

Preparations

DISK

A.2.1

A. 2.3

Message
FROM

DISTRIBUTION

the

TAPE

Copying

INSTALLATION

Performance

>*>:B>*>:F>’>:>E’>

|
ABDWWNDNDHEH

MAGNETIC

Preparations

A. l.4

INSTALLATION

FROM

INSTALLATION

F4PNIO

RSTS/E

ON OUTPUT

ALTERNATIVE

.
.

OTS

F4P11S

SIZE

WITH

F4PNER

A.l.1

A.2

A.l

[

FAILURE

APPENDIX A

PROCEDURE

SYSTEM

CHAPTER

PREFACE

MANUAL

This
on

OBJECTIVES

manual
any

describes

PDP-11

operating
kits.

system,

PDP-11

Floating-Point

INTENDED

This

manual

STRUCTURE

used

FORTRAN-77

Processor

can

install

PDP-11

RSX-11M-PLUS,

operate

(FPll)

RSX-11M,

from magnetic-tape

intended

THIS

disk-cartridge
on

any

PDP-11

floating-point

FORTRAN-77

RSTS/E,

IAS

distribution

processor

microcode

with

option.

for

the

PDP-11

Chapter

organized

presents

and lists
kits.
Chapter

system

manager.

The

reader

with the host
software.

operating

system

before

DOCUMENT

FORTRAN-77

thoroughly
familiar
the PDP-11 FORTRAN-77

manual

procedures

under

AUDIENCE

should
be
installing

This

the

system

follows:

the

minimum

installation

the

software

presents

alternatives
that
actual installation

system

each

files

various

must
be
process.

requirements

the

host

supplied

system

for

PDP-11

operating

systems

the

options

considered

distribution

and

before

planning

starting

the

Chapter 3 explains the effect of
selecting
certain
compiler
options described in Chapter 2 and details the optional Object
Time System (OTS) modules distributed on the release media.

Chapter 4 describes the installation
procedures
the RSX-11M and RSX-11M-PLUS operating systems.

Chapter 5
operating

Chapter

describes
system.

the

installation

6 describes the

installation

describes the
installation
procedures
on
system that uses the DCL command language.

Chapter

explains

Chapter

the

testing

correctly

contains

procedure

installed.

release

notes.

viil

command

Chapter 7
operating

MCR

procedures

the

system

uses

operating

your

that

procedures

relevant

RSTS/E

IAS

language.

used

verify

that

Appendix
RSTS/E

A presents

operating

Appendix
for each

alternative

installation

procedure

for

systems.

B presents

listings of

the

compiler

task-build

files

system.

ASSOCIATED DOCUMENTS

The PDP-11 FORTRAN-77 User's Guide provides
detailed
information
on
using the FORTRAN-77 system.
The PDP-11 FORTRAN-77 Language Reference
Manual describes the elements of the FORTRAN language
as
implemented
in FORTRAN-77.
For information on the Object Time System, consult the
PDP-11 FORTRAN-77 Object Time System Reference Manual.
For a complete
list
of
software
documents,
see
your
host
operating-system
documentation directory.

CONVENTIONS

The

USED

following

THIS MANUAL

documentation

conventions

are

wused

throughout

this

manual
:

ALTMODE

The

symbol

ALTMODE

(ESC)

Kkevy.

key

pressed
in
specified.

is,
a
CTRL/X

with

The

the
called

key

many

terminals.

place
Unless

of
the
otherwise

the

carriage

represents
This

$),

all

nonprinting
the

This

escape

key

1is

RETURN
key when
specified
(that

commands

terminate

with

return.

notation

CTRL/X indicates that
you
must
CTRL
(control)
key
while
typing
a
1letter
key
(for
CTRL/C, CTRL/Y, CTRL/O).
-

press
the
simultaneously

example,

UPPERCASE
lowercase

In
examples,
text
printed
in
UPPERCASE
characters indicates literal information that
must
be
entered
as shown.
Text printed in
lowercase characters indicates that
you
are
to
(for

substitute
example,

viii

word

MTn:).

value

your

choice

CHAPTER

INTRODUCTION

Section

1.1

features
FORTRAN-77
PDP-11

this

and

system.

FORTRAN-77

1.1

SYSTEM

The

following

chapter

components

lists,

necessary

Section

1.2

distribution

operating

for

system,

successfully

1lists

the

files

the

building

PDP-11
a

<contained

PDP-11
in

the

kits.

REQUIREMENTS

sections

list,

system
requirements
for
only the section relevant

operating

system,

the

minimum

installing PDP-11 FORTRAN-77.
to your host operating system.

You

PDP-11

need

read

NOTE

The

term
(lowercase)

floating-point

generic
system

to encompass
processing

term
for

used

this

processor
manual as a

any device
or
floating-point

data.

1.1.1

RSX-11M

The software included in

the

PDP-11

requires
the
following PDP-11
RSX~-11M operating system:
e

PDP-11

with

processor

A minimal

22K

A minimum

the

A minimum

e
Consult

KT-11l

Chapter

running

for

normal

RSX-11M

and

use

media
on

equipped

processor

partition

for

blocks

150

blocks

System

memory
4

distribution

components

compilation

contiguous

online

disk

storage

for

task

Time

word
365

compiler

Object

capable

floating-point

FORTRAN-77

system

for

250

online

disk

storage

for

library

management
RSX-11M

unit,

installation

you

use

virtual

instructions.

arrays

the

INTRODUCTION

RSX-11M-PLUS

1.1.2

The software included in
the
PDP-11
FORTRAN-77
requires
the
following PDP-11 system components
RSX-11M-PLUS operating system:

A
PDP-11
processor
capable
of
running
equipped with a floating-point processor

A minimal

A minimum of
the

The

Object

Time

Chapter

software

RSTS/E

for compilation

365 blocks of contiguous online disk storage

for

150 to

the

System

for

250 blocks of online disk storage

for

library

RSX-11M-PLUS

included

the

following

operating

installation

the

PDP-11

instructions.

FORTRAN-77

system

components

floating-point

A minimum of 22K
words
of
installation and compilation

RT-11

media

use

RSTS/E and equipped with
maximum)

for

A minimum of

365 blocks of contiguous online disk storage

for

the

task

and

RSX run-time

compiler

A minimum of

Consult

normal

processor

distribution
for

system:

A PDP-11 processor capable of running
a

Object

Time

Chapter

150 to
System

for

user

system

space

(swap

support

250 blocks of online disk storage

for

the

library

RSTS/E

installation

instructions.

1IAS

1.1.4

software

requires
IAS

and

RSTS/E

requires

The

RSX-11M-PLUS

task

compiler

A minimum of

Consult

1.1.3

22K word partition

distribution
media
for normal use on an

included

the

following

the

PDP-11

FORTRAN-77

system

components

distribution
for

normal

use

media
on

IAS and equipped with

operating system:

A PDP-11 processor capable of running
floating—-point

processor

A minimal 23K word partition
are provided by the standard

A minimum of
the

compiler

365

for compilation when I/O services
IAS shared library SYSRES

blocks of contiguous online disk

storage

for

task

A minimum of 150 to 250 blocks
Object Time System library

A KT-11

memory management

unit

1-2

of online disk

storage

for

the

INTRODUCTION

l.2

The

DISTRIBUTION

software

$X-11M,

FILES

necessary

for

RSX-11M-PLUS,

building

RSTS/E,

PDP-11

or.IAS

on magnhetic-tape and disk-cartridge media.
files described in the following sections.
the user file directory (UFD) on which they

l1.2.1
File

UFD

Name

Compiler

diagnostic

F770TS.MSG

Object

Time

RSTS/E

Build

File

system
is

These
media
files are
reside in the

for

distributed

contain
the
listed under
kit.

The

Description

F77.CTL

UFD

system

[1,2]

F77COM.MSG

l.2.2

FORTRAN-77

operating

System

messages

(OTS)

command

file

diagnostic

messages

file

[11,36]

Name

F77.0LB

Description
PDP-11

Fortran-77

compiler

F7711M.CMD

PDP-11

FORTRAN-77

compiler-build

command

files

for

F7711M.0DL

RSX-11M/M-PLUS
FORTRAN-77

compiler-build

command

files

for

FORTRAN-77

compiler-build

command

files

for

compiler-build

command

files

for

F77RST.CMD

PDP-11

F77RST.ODL

RSTS/E

F7711D.CMD

PDP-11

F7711D.0DL

IAS

using

F77IAS.CMD

PDP-11

F77IAS5.0DL

IAS

l1.2.3
File

UFD

library

MCR

FORTRAN-77

using

object-module

DCL

[11,37]

Name

F4POTS.0BJ
FCS11M.0BJ

Description
Object

Time

Specific

using

OTS

System

concatenated

object

modules

for

RSX-11M/M-PLUS

and

RSTS/E

FCS-11

FCS11D.OBJ

Specific

OTS

modules

for

IAS

with

MCR

using

FCS-11

FCSIAS.OBJ

Specific

OTS

modules

for

IAS

with

DCL

using

FCS-11

RMS11M.OBJ

Specific OTS modules for RSX—llM/M—PLUS
using

and

RSTS/E

RMS-11

RMS11D.0OBJ

Specific

OTS

modules

for

IAS with

MCR

using

RMS-11

RMSIAS.OBJ

Specific

OTS

modules

for

IAS

DCL

using

RMS-11

SHORT.OBJ

gggsjgort—error

text

module

with
for

RSX-11M/M-PLUS

and

INTRODUCTION

1.2.4

UFD

File

[11,40]

Description

Name

OTS modules

F4P11S.0BJ

Specific

F4PMAP,OBJ

PDF name-mapping

FAPCVFEF.OBJ

Optional
conversion

F4PEIS.OBJ

EIS

replacements

use

the

RSX-115 subset

for

object module

concatenated

floating-point
0TS
routine

for

OTS

integer

output

formatted

functions that make

FPP

F4PNIO.OBJ

Optional

OTS modules without

FORTRAN I/O capability

F4PNER.OBJ

Optional

OTS error-reporting

module

FA4PRAN.OBJ

Optional

random—-number

OTS Assembly

Parameter

generator

Files

F77.MAC
FPP.MAC

FPPDP.MAC

FCS.MAC
RMS.MAC

RSXD.MAC
RSXM.MAC
RSXS5.MAC

File

Description

Name

installation-verification

test program

F77TST.FTN

System

F4PRES.MAC

OTS shared-library source

FCS11M.ODL

OTS overlay-description

file

for RSX-11M/M-PLUS

FCSIAS.ODL

OTS overlay-description

file

for

IAS using

RMS11M.ODL

OTS

file

for

RSX-11IM/M-PLUS

file

for

IAS using

RSTS/E

using

and

FCS-11

overlay-description

RSTS/E
RMSIAS.
ODL

using

file

FCS-11

RMS-11

OTS overlay-description

RMS-11

and

CHAPTER
INSTALLATION

This

chapter

start

the

discusses

some

installation

alternatives

SELECTING

THE

DEFAULT

This

section

1is

applicable

PDP-11

FOR

IAS.

FORTRAN-77

F77

you

the

only
you

the

wish

When

building

compiler

combined

with

from

the

F77

The

F77

same

default

the

task,

from

run

system,

You

0TS

and

the

located

you

choose

library

FORTRAN

this

searches

the

use

searching
Before
you

both

SYSLIB

OTS

Task

1like

will

task-build

time,

Selecting

select

only

OTS

one

you

make

F77

module

part

use

this

Builder

separate

command
1in

you

the

named

system

the

must

OTS

library,

line.

(The

1invoking

same

object-module

this library
the F77
OTS

not

you

F4POTS.)

build

you

FOR

not

compiler

Task Builder searches
Either the FOR OTS or

FORTRAN

the

must

1in

decision

(OTS)

and

whether

this

produced

the

either
(FOR)

decide

System

cannot

OTS

FORTRAN systems,

named

must

Separate
put

explicitly

Task

Builder

always

command

1line

before

:
default
to

not

2.1.1
you

F77

The
task.

FORTRAN,

easier

require

and

F77

the

two

FOR

OTS

modules,

contains

FOR

OTS

the

will

Default

default

ways:
or

modules,

by
by

use.

which

The

explicit

therefore

F77

consider

effort.

FOR

OTS

(The

whichever

Ilibrary

selecting

must

SYSLIB.)

would

use

library.

contain

LB: [1,1]SYSLIB.OLB.

name

produced

FOR

library.

LB:[1,1]SYSLIB.OLB.
automatically when linking a
be

Time

that

OTS.

default

before

FORTRAN
must

modules

Object

modules

library

can

FOR

both
you

FORTRAN.

object

the

object

object-module
Normally,

consider

systems

because:
e

must

FORTRAN

1If

(F77)

PLANNING

process.

2.1

R5X~-11M/M-PLUS

OTS

the

FORTRAN
library

consistently

two

whose

FORTRANS
OTS

reference

save

in
at

you

time

and

use

the

FORTRAN

FORTRAN,
building

renaming

you
a

can

continue

separate

the

library

current

LB:[1l,1]FOROTS.OLB.

containing

SYSLIB,

INSTALLATION

PLANNING

Selecting FOR as the Default FORTRAN

2.1.2

If you select FOR as the default FORTRAN,

follow the

instructions

1in

the IAS/RSX FORTRAN IV Installation Guide for including the FOR OTS in
SYSLIB.
Then build
a
separate
F77
OTS
1library
as
described
1in
"Building
the
OTS"TM
in
the
installation chapter pertaining to your
operating

2.2

The

system

SELECTING

following

e
e

(Chapter

F77

COMPILER

7).

OPTIONS

options are available when you build

the F77 compiler:

other

You can assign the compiler work file to a device
the

system device,

enhance compiler

You can specify the number of pages that are to

You can
devices

make

the

A larger
enhances

performance.

specify the lines per page and line width for
1listing
that will be using non-U.S.-standard paper stock.

You can specify compiler command-switch default settings

differ

than

performance.

dynamic
storage
area
to
be used by the compiler.
paging memory decreases work-file paging activity and
compiler

from

the

DIGITAL-provided

You can alter the values of the
-

Number of

actual

defaults.

that

following compiler limits:

arguments

per

CALL

function

/F77

compiler

reference

Number

named

COMMON

Number

OPEN

statement

DO and

block

You can choose the
switch

keywords

IF statement nesting

default

either

blocks

/F77

setting

/NOF77.

for

depth

the

You can edit the compiler-build
file
to
select
any
of
the
above
options.
Documentation
within
the
file
describes
the
options
available and any limitations on choices (see Appendix A).
Chapter
3
describes
the
magnitude
of the performance improvements that result
from various combinations of the first two options.

2.3

SELECTING F77

The
for

F77 Object Time
1/0 processing:

e
e

OTS

File Control

direct

Record

System

access

indexed

supports

Services
to

direct,

one

(FCS-11),

sequential

Management

sequential,
and

OPTIONS

the

following

file

keyed

systems

which supports sequential

files

Services

and

(RMS-11),

access

which

sequential,

and

supports

relative,

files

When you build the OTS, you must choose either the FCS-11 file
system
or
the
RMS-11
file
system;
the F77 OTS does not support both file
systems

one

time.
2-2

INSTALLATION

The

distribution

FCS-11

The

kit

contains

PLANNING

alternate

files

for

RMS-11.

files

for

FCS-11

FCS11IM.0BJ

support

(used

incorporating

either

are:

RSTS/E

well

RSX-11M/M-PLUS)

well

RSX-11M/M-PLUS)

FCS11D.OBJ
FCSIAS.OBJ

The

files

for

RMS-11

RMS11M.OBJ

support

(used

are:

RSTS/E

RMS11D.0OBJ
RMSIAS.OBJ

The

"Building

the OTS" sections in Chapters
4,
6,
and
7
(Sections
4.2.3, 6.1.3, 6.2.3, 7.1.3, 7.2.3, A.l.3, and A.2.3)
include a
of commands that determines whether your system supports
RMS-11

4.1.3,
choice
or

FCS-11.

Section
the

2.4

3.2

basic

describes

PRELIMINARY

The

following

your

system

the

rest

OTS

options

that

you

system.

INSTALLATION

utility
uses

the

add

after

you

1install

PROCEDURES

programs

MCR,

can

are

install

required

these

for

programs

systems
before

installation:

using

you

MCR.

proceed

If
with

PIP

FLX

(if

using

magnetic-tape

TKB

distribution)

LBR

For

systems

added.

using

The

RSTS/E,

following

the

RT-11

utility

and

RSX

programs

run-time

are

system:

systems

required

must

RSTS/E

PIP.SAV
TKB.TSK
LBR.TSK

The

RT-11

run-time

system

process—--specifically

support

you

are

not

required

replacing

preliminary
If

steps
the

for

any

are

required

enable

the

use

version

use

PDP-11

FORTRAN

for

the

PIP.

The

FORTRAN

IV-PLUS

you

with

the

following

REM

...F4P

RUN

SUTILTY

are

compiler

installing

the

IV-PLUS,

installed

F77

compiler

code:

(for

(FOR

RSX-11M/M-PLUS, IAS)

RSTS/E)

#CCL

run-time

FORTRAN-77.

required:

and

installation
RT-11

F4pP-=

the

in
as

following

the

F4P,

system

remove

INSTALLATION PLANNING

will be on the system disk:

files

(All operating systems)

F4PCOM.MSG

[1,2)

following

the

If you currently have FORTRAN IV-PLUS,

(IAS)
(IAS)

[1,2] F4POTS.MSG
[11,1] F4P.TSK

(R&X-11M/M-PLUS)
(RSTS/E)

[libuic] F4P.TSK
[1,2] F4P.TSK

After PDP-11 FORTRAN-77 has been successfully installed,
following files will be on the system disks:

(All operating systemns)

[1,2] F77COM.MSG

(IAS)
(IAS)

[1,2] F770TS.MSG
[11,1] F77.TSK

(RSX-11M/M-PLUS)
(RSTS/E)

[libuic] F77.TSK
[1,2] F77.TSK

After PDP-11 FORTRAN-77 has been successfully

you

delete the

longer

following

intend

files:

installed

and

wuse FORTRAN IV-PLUS, you can

(A1l operating systems)

[1,2] F4APCOM.MSG

(IAS)
(IAS)

[1,2] F4POTS.MSG
[11,1] F4P.TSK

(RSX-11M/M-PLUS)
(RSTS/E)

[1ibuic] F4P.TSK
[1,2] F4P.TSK

Delete all files in reserved UFD ([11,36], or, in the case

the

RSTS/E, the particular UFD on which FORTRAN IV-PLUS resides.

the F77 OTS into SYSLIB.OLB,
You must either obtain a copy of

If you want to incorporate
obtain a copy of SYSLIB.

except
SYSLIB
in
SYSLIB that contains everything currently
PDP-11 FORTRAN OTS and incorporate the PDP-11 FORTRAN-77
the
fresh copy of SYSLIB from the
OTS into it, or obtain a
reincorporate all
kit and
system distribution
operating
a
OTS modules cannot be added to
optional software modules.
library containing a previous version of the OTS.

F77

the

If you want to incorporate

OTS

into

existing

library, make sure that the library-module name table and the
entry-point name table can accommodate the OTS.
Module names:
Entry points:

necessary,

librarian

RSX-11M

account--for
used

compress

the

compress command.

using

the

privileged

user

library

existing

RSX-11M/M-PLUS

2.4.1

200
450

RSX-11M-PLUS

example,

system,

use

the account with UIC [1l,1]--for all operations

in building the FORTRAN-77 system.

During the build process, always run a program that 1is to <create a
file, under the UIC that corresponds to the UFD in which the file will
be created. You can use the SET command to set the UIC as required.

The F77 compiler is built into a system UIC called
reserved

for

DIGITAL products.

LIBUIC,

which

1is

INSTALLATION

RSX-11M

value

systems,

SYSUIC

>SET

command

>SET

the

2.4,2
On

equivalent

SET

command

systems,

you

can

find

SYSUIC.

follows:

You

can

find

the

value

LIBUIC

using

the

follows:

/LIBUIC

LIBUIC

Use

the

[x,y]

RSX-11M-PLUS

SET

LIBUIC

using

/SYSUIC

SYSUIC

PLANNING

[x,y]

value

[x,y]

required

during

the

installation.

RSTS/E
RSTS/E

system,

use

privileged

account

with
UIC
[1,1], but
UIC[1l,2]--for all operations used

user

account--for

preferably
in

building

example,

not

the

PDP-11

the

account

with
FORTRAN-77

system.

2.4.3
On

IAS
IAS

the

building

the

made

available

2.5.1
On

from

the

DCL,

use

UIC

[1,1]

privileged
--

for

all

account

operations

for

used

system.

task

for

has

use

been

created,

(installed).
compiler

the

The

under

task-image

following

each

file

must

sections

tell

how

operating

system.

RSX-11M/M-PLUS
RSX-11M

RSX-11M-PLUS

the

library area

>INS

[libuic]F77

can

install

part

startup,

the

F77

system

include

LIBUIC

the

system,

compiler

startup

you

follows:

either

consult

appropriate

INS

install
has

RSX-11lM
System Generation

PDP-11

FORTRAN-77

existing

following

command:

>INS

[libuic]

command

F77/TASK=

and

...F4P

the
To

F77
and

which

that

the

saved

F77

system

install

F77

(above)

compiler

image

during

system

startup

in the saved system image,
Management
Guide
or
the

Management

F4P,

files

install

command

To
install
System Generation

the

procedures.

[1,2]STARTUP.CMD.

RSX-11M-PLUS

with

FORTRAN-77

site

MCR

COMPILER TASK AVAILABLE

compiler

You

file

using

DCL

FORTRAN-77

MAKING THE

install

account

After
to

MCR

system

example,

2.5

using

Guide.

may

call

the

desirable
F4P

compiler,

if
use

your
the

PLANNING

INSTALLATION

RSTS/E

2.5.2

On a RSTS/E system, you may install
as

the F77 compiler as a CCL command,

follows:

RUN SUTILTY
#CCL F77-=5Y:[1,2]F77.TSK

To install F77 during system startup, include the above CCL command in
system startup file

[1,2]CCL.CMD.

your
1if
To install PDP-11 FORTRAN-77 as F4P, which may be desirable
command files that may call the F4P compiler, use
existing
has
site
following

the

commands:

SUTILTY
#CCL F4P-=SY:[1,2]F77.TSK

RUN

IAS using MCR

2.5.3

On an IAS system with MCR, you install the F77 compiler as follows:
MCR>

INS

[11,1]F77

Consult the IAS System Generation Startup Guide for the procedures you
must follow to save the system image with the F77 compiler

installed.

vyour
if
To install PDP-11 FORTRAN-77 as F4P, which may be desirable
the
use
compiler,
F4P
the
call
that
files
command
existing
has
site
following

MCR>

2.5.4

command:

INS

(11,1]F77/TASK=

using

1IAS

...F4P

DCL

On an IAS system with DCL, you install the F77 compiler as follows:
PDS>INSTALL

[11,1]F77

If the F77 compiler is installed as F77, you can invoke it

MCR.

FOR

The

DCL command

FORTRAN/F77

only

PDP-11 FORTRAN-77 as the system default FORTRAN, but

install
instead

F77,

use

the

following

PDS>INSTALL/TASK:...FOR

with

is not supported.

named

command:

[11,1]1F77

your
1if
To install PDP-11 FORTRAN-77 as F4P, which may be desirable
command files that call the F4P compiler, use the
existing
has
site
following

PDS>

command:

INSTALL/TASK:...F4pP

[11,11F77

procedures
the
for
Consult the IAS System Generation Startup Guide
required to save the system image with the F77 compiler installed.

CHAPTER
SYSTEM

This

chapter

describes

FORTRAN-77

into

performance

and

use

3.1

tailor

OPTIONS

There

are

your

you

system.

three

about

FORTRAN-77

AFFECTING

TAILORING

options

information

PDP-11

may

choose

includes

optional

your

COMPILE-TIME

options

open

when

factors

OTS

building
affecting

modules

particular

PDP-11
compiler

that

vyou

can

applications.

PERFORMANCE

vyou

that

affect

compile-time

performance:
e

You

may

choose

one

two

the
compiler
to
wuse
compilation process.
e

You

may

alter

additional

for

the

size

the

compiler

temporary

storing

the

disk

information

dynamic

storage

files

for

during

the

area

the

compiler.
e
The

You

PDP-11

may

FORTRAN-77

information
least

one

place

during

temporary

The

work

random

file

(for

The

dynamic

storage

compiler

the

uses

compilation

file,

contains

work

called

the

information

example,
area

the

within

file

disk

files

The

compiler

work

that

the

compiler

between

Information

the

must

compiler.

storage

moved

into

Therefore,

area

the

compiler

and

forth

for

storing

requires

the

normally

accesses

constants

table).

wused

manipulate

work file is in memory at
move
information
back

and

the

dynamic

increasing

disk.

file.

table

information.,
(Only
part
of the
time.
Software paging
techniques
dynamic

fixed-head

temporary

this
given

the

process.

symbol
the

the

work

file.)

storage

area

when

size

the

dynamic

any
and

needed

storage

area increases compilation speed, by reducing the number of
disk
1I/O
operations
(see
Section
3.1.3).
Similarly, speeding up the average
disk I/O operation, by placing the work
file
on
a
fixed-head
disk
instead

Section

3.1.6).

3.1.1
The

moving-head

Additional

/WF:w

that

compiler

Temporary

compiler

are

stores

PDP-11

code

/WF:2

(or

disk,

switch

also

improves

the

representations

just

file,

/WF:3),

the

representations
in
the
option is the default.)

the

work

compiler

one

number

compiler.

internal
one

compilation

rate

(see

Files

specifies

available

the

two
3-1

temporary

you

optimized

file.

source

However,

stores

some

other

temporary

disk

specify

(or

if
all)

files.

files

/WF:1,

the

code

and

you

specify

these

(The

/WF:2

SYSTEM

TAILORING

Using additional temporary files slows the compilation process, but it
significantly
increases
the capacity of the compiler.
For instance,
with three temporary files (/WF:3) available to it, the
compiler
can
compile a program that is approximately three times larger than any it
can compile with only one temporary file (/WF:1l).
No

significant

change

occurs

the

compilation

temporary
files on a fixed-head
and read sequentially.

disk,

3.1.2

Dynamic

Selecting

the

Size

the

Increasing the size of the dynamic
compilation.
Experimental
data
dynamic storage results in optimal
Figure

size

3-1

FORTRAN

(/WF:2),
(RP04).

The

dynamic

programs,

measured

illustrates

the

area.

Storage

between

The

length

PDP-11/60.

The

compile

from

compiler

with the work file residing on the
The dynamic storage area varied in

output

listing

measurements

compilation
Continuation

was

rate

these

you

files

place

are

the

written

Area

storage area increases the rate
of
1indicates
that
using
14 pages of
improvement in compilation speed.

correlation

storage

varying

because

compile

time

four

450

wused

and

the

different

statements,

was

temporary

files

two

system
moving-head
disk
size from 4 to 26 pages.

produced.

the

end

points

rate
measured
and comment lines

in
were

each

curve

denote

approximate

statements
compiled
not counted.

per

minute.

As the figure shows, compilation
greater when 26 pages of dynamic

speed is
approximately
three
times
storage are used than it is when only
4 pages are used.
However, using 14 pages results in optimal compiler
performance.
Building the compiler with more than 14 pages of dynamic
storage achieves minimal improvement in the rate of compilation.
The
default size of the dynamic storage area is 12 pages.

3.1.2.1

Under

Operating

RSTS/E,

Systems

IAS,

Supporting

Dynamic

RSX-11M-PLUS,

Memory

RSX-11M

Allocation

system,

with

dynamic

memory

allocation, you specify
the
size
of
the
PDP-11
FORTRAN-77
compiler's
dynamic
storage
area
by
wusing the EXTTSK option in the
task-build command file.
The value specified by EXTTSK is the size of
the
dynamic
storage
area in decimal words.
The size of the dynamic
Storage

area

computed

follows:

256* (n+w+1)

where:
n

the

number

the

value

You

can

override

installation
The

task

the

specified

dynamic

by means

extension

pages

size

of
is

the

for
in

the

dynamic

the

/WF:w

storage

area

INC

switch

specified

storage

area.

switch.

specified
the

decimal

INSTALL
words.

EXTTSK

(INS)

command.
.

SYSTEM
160
-

6 Resident Pages

TAILORING
14 Resident Pages

150
-+

181

135

120

138

COMPILE TIME (seconds)

105
A

90
-

159

60
-

138

PROGRAM T

450 statements

PROGRAM Q

30
-

250 statements

PROGRAM D
210 statements

PROGRAM M

15
4

90 statements

RESIDENT WORK FILE PAGES (1 PAGE-256 WORDS)
ZK-209-81

Figure

3-1

Compiler

Performance

SYSTEM

TAILORING

The following table shows the correlation between
the
size,
the
EXTTSK
value,
and
the
number
of pages
storage area under /WF:2.
Number

Pages

EXTTSK = Value
INS/INC Value

compiler
task
the dynamic

for

Size of
Compiler Task
(words)

8
12

1792
2816
3840

22K
23K
24K

4864

25K

For
RSX-11M/M-PLUS
installations
magnetic-tape
version
of
FCS-11
task

size

3.1.2.2

increases

approximately

RSX-11M Without

system

without

memory

determines

the

and

all

memory

the

500

words.

Dynamic Memory Allocation - On

dynamic

compiler

uses

that
wuse
by
default
the
ANSI
(LB:[1,1]ANSLIB.OLB), the compiler

size

allocation,
the

that

partition

The

OTS

which

Install
run

PDP-11
it

the

with

RSX-11M
FORTRAN-77
operating

compiler
the

[11,40].

kit

includes

After

building

the

number

of these optional modules to the
modules
separately
and
refer
modules to the library, refer to

OTS

optional

library,

you

OTS
can

modules
add

one

4.1.3

and

4.2.3

for

RSX-11M/M-PLUS

Sections

A.1l.3

and

A.2.3

for

RSTS/E

Sections

6.1.3

and

6.2.3

for

IAS

using

MCR

Sections

7.1.3

and

7.2.3

for

IAS

using

DCL

The installation procedures copy these modules to LB:[1l,1]
(LB:
RSTS/E) .
The
PDP-11
FORTRAN-77
system does not require any

3.2.1

modules

for

normal

under
or

library, or you
can
maintain
these
to
them
only as needed.
To add the
procedures in the following sections:

Sections

optional

desired

OPTIONS

distribution

UFD

partition.

a partition large enough for the compiler
number of pages of dynamic storage.

3.2

the

wunder
of the

use.

F4P11s

F4P11S.0BJ

1is

versions

FORTRAN sequential

concatenated

object

module

<containing

I/O support modules.

These

alternate

I/O

support

modules, designed for use with
RSX-11S,
provide
sequential
1I/0
to
non-file~-structured
devices
(for example, terminals, nonspooled card
readers, and line printers).
These modules do not use the file system
but
perform
direct
QIO
operations;
they
reduce
task
size
by
approximately 2500 words.

NOTE

the

following

using
the
occurrences

sections,

RSTS/E
system,
of LB:[1,1] with

you

replace
LB:.

are

all

SYSTEM

You

can

use

F4P11S5.0BJ

You

can

include

two

TAILORING

ways:

object module

task-build

time,

follows:
TKB>MAIN/FP=MAIN,LB: [1,1]F4P11S.0BJ

you

can

build

separate

LB:[1,1]F4P11S.0LB,

OTS

this,

library.

F77

OTS

addition

when

library for
the

host

building

RSX-11S5

operating

the

OTS

use,

system's

substitute

module
LB:[1,1]F4P11S.0BJ (or, for RSTS/E, LB:F4P11S.0BJ) for
the file-system module selected in Section 2.3.
For
example,
replace the reference to FCS1IM.OBJ with LB:[1,1]F4P11S.0OBJ.
Use

this

OTS

library,

OTS

library,
when

rather

building

than

tasks

the
for

host

operating

RSX-115,

system's

follows:

TKB>MAIN/FP=MAIN,LB:[1,1]F4P11S/LB

3.2.2
For

Short

error

Error

messages,

containing
RSX-11M-PLUS,

task

with

FORTRAN-77

text.

RSTS/E,

the

you

OTS

your

can

use

RSTS/E Only

references

operating

system

long

error—-text

short

module

RSX-11M,
error-text

error-text module requires approximately 1000 words
the alternate version (SHORT.OBJ) requires only one

short

error

F77

list
0TS,

error-text

reports,

condition.

complete
The

- RSX-11M/M-PLUS and

memory.

complete

error

the

ASCII

module.
The long
of memory, whereas
word

Text

The

OTS

PDP-11

error

built

error—-text

error-text

module

but

default.

module

omits

FORTRAN-77

numbers
the

You

the

and

1loading

build

module

1into

User's

message

following

can

built
one-line

Guide

generates
of

the

contains

text.

chapters,

description

task

S$SHORT

uses

the

wusing

from

the

1long

short

library.

Therefore,
for example, if the F77 OTS is part of SYSLIB, you use the
following command to build the short error-text module into a task, if
your operating system is RSX-11M or RSX-11M-PLUS:
TKB>MAIN/FP=MAIN,LB:
[1, 1]SYSLIB/LB: $SHORT
If

you

your

may

operating

use

the

system

short

RSTS/E,

and

error-text

F4POTS

module

resident

typing

the

SYSLIB,

following

command
:

TKB
You
so,

MAIN/FP=MAIN,LB:SYSLIB/LB:$SHORT

may prefer to use
reorder the steps

the short error-text as the
in the OTS build procedures

SHORT.OBJ into the library is the
are using the BUILD procedure for
the relevant interactive question

system default.
that insertion

If
of

last step rather than first;
if you
a RSTS/E installation, simply answer
by typing SHORT.

SYSTEM

TAILORING

For example, instead of
wusing
the
sequence
of
commands
given
in
Sections 4.1.3 and A.1.3 for installing the F77 OTS into SYSLIB, order
the commands as follows.
(If you are using a RSTS/E
system,
replace

all

occurrences

were copied during

[11,36]

with the account where the object modules

installation.)

LBR>LB:SYSLIB.OLB=[11,36]FCS11M.0OBJ
or

LBR>LB:SYSLIB.OLB=[11,36]RMS11M.OBJ

LBR>LB:SYSLIB.OLB/DG:
SERTXT
LBR>LB:SYSLIB.OLB=[11, 36]F4POTS.OBJ
LBR>LB:SYSLIB,OLB=[11,
36] SHORT.OBJ/RP

Reorder

the

commands

Section

4.2.3 and

A.2.3 as

follows:

LBR>LB:SYSLIB,OLB=FP: [11,37]FCS11M.0OBJ
or

LBR>LB:SYSLIB.OLB=FP: [11,37]RMS11M.0BJ

LBR>LB:SYSLIB.OLB/DG:
SERTXT
IBR>LB:SYSLIB.OLB=FP:
[11, 37]F4POTS.0OBJ

LBR>LB:SYSLIB,OLB=FP:
[11, 37]SHORT.OBJ/RP

the

short

complete
library.

error-text

error-text
by
The
following

the

system

default,

you

can

wuse

the

explicitly
loading
module
S$ERTXT from the
command
1loads
the
SERTXT
module
for

RSX-11IM/M-PLUS:

TKB>MAIN/FP=MAIN,LB:[1,1]SYSLIB/LB:SERTXT

For

RSTS/E,
TKB>

3.2.3

the

command

the

task builder

takes

the

following

form:

MAIN/FP=MAIN,LB:SYSLIB/LB:
SERTXT

FAPMAP

Module F4PMAP.OBJ consists of a set
of
concatenated
object
modules
that
can
be used to transform intrinsic-function names into internal
names at task-build time.
(The PDP-11 FORTRAN-77 compiler
transforms
intrinsic-function names into internal names at compile time.)
Without F4PMAP.OBJ, if a
program
written
in
MACRO-l11l
attempts
to
reference a PDP-11 FORTRAN-77 intrinsic function with the FORTRAN name
of the function instead of the internal name, an unresolved
reference
will

For

occur

during

example,.

following

SIN::

task

build.

FAPMAP.OBJ maps

the

FORTRAN name

SIN

means

the

module

for

module:

. TITLE

SMSIN

JMP

$SIN

. END

FAPMAP.OBJ contains an object module similar to the
each of the PDP-11 FORTRAN-77 intrinsic functions.

above

SYSTEM

You

can

build

(MCR

F4PMAP

command

library

TAILORING

follows:

format)

LBR>LB: [1,1]F4PMAP.OLB/CR:40.=LB:
[1, 1]F4PMAP.OBJ
(IAS

PDS

command

PDS>LIBR
(RSTS/E

format)

CREATE/SIZE:40

command

LB:[1l,1]F4PMAP

format)

LBR>LB: F4PMAP.OLB/CR: 40=LB:F4PMAP.OBJ

3.2.4

FA4PEIS

FAPEIS.OBJ

1is

concatenated

object

module

containing

extended

instruction
set
(EIS)
versions
of
certain
integer functions that
normally use a floating-point processor.
This module
allows
FORTRAN
programs
that do not do floating-point arithmetic to run on a machine

that

has

the

extended

instruction

set

but

not

floating-point

processor.
The
modules provided in the F77 OTS use a floating-point
processor for maximum efficiency in certain INTEGER*4 computations.
Use one of the
normal modules
(MCR

following commands to replace at
task-build
in file INTEGER with their EIS versions:

command

time

the

format)

TKB>INTEGER/-FP=INTEGER,LB: [1,1]F4PEIS.OBJ
(IAS

PDS

command

format)

PDS>LINK/NOFLOATING
(RSTS/E

command

INTEGER,LB: [1,1]1F4PEIS

format)

TKB>INTEGER/--FP=INTEGER,LB:F4PEIS.OBJ

3.2.5

FAPCVF

Object

module

formatted
F,

and

F4PCVF.0OBJ

output
field

1is

alternative

floating-point

specifiers.

The

values

standard

module

under

module

for

control

provided

performing

of
as

the

part

E,
of

the F77 OTS uses multiple-precision, fixed-point integer techniques to
maintain maximum accuracy during the conversion of data (FPP
hardware
is
not
used).
The
alternative
module performs the same functions
using the FPP hardware.
It is approximately twice as fast as, but
1in
some cases slightly less accurate than, the standard module.
You
as

can

substitute

the

F4PCVF module

for

the

default

conversion

follows:
(MCR

command

format)

LBR>LB: [1,1]SYSLIB=LB: [1,1]1F4PCVF/RP
(IAS

PDS

PDS>LIBR
(RSTS/E

command

format)

REPLACE
command

IB:[1,1]SYSLIB

format)

LBR>LB:SYSLIB=LB:F4PCVF/RP

LB:[1,1]F4PCVF

module

SYSTEM

TAILORING

FA4PNER

3.2.6

Object module

F4PNER.OBJ

run-time

errors.

report

suppressed.

1is

you

an
wuse

However,

alternative
this

error

module

module,

the

processing

and

and ERRTST continue to operate normally;
message on the user's terminal is suppressed.

calls

ERRSNS,

only

the

The

statement
messages are
by about 375 words over

3.2.7

for

reporting

error—-message

also suppressed.
F4PNER.OBJ
the standard module.

text

ERRSET,

the logging of
STOP and
PAUSE

reduces

task

size

FA4PNIO

F4PNIO.OBJ is a

concatenated

object

module

containing

alternative

versions
of
certain OTS routines that are always present in the user
task and
that
provide
support
for
FORTRAN
I/0
operations.
The
alternate
routines
in
F4PNIO.OBJ
do
not
support FORTRAN I/O, and
reduce task size by approximately 1000 words for programs that do
not
require

FORTRAN

I/0

(such

process

control).

FAPRAN

3.2.8

F4PRAN.OBJ is a concatenated object module containing
an
alternative
random-number
generator
that is compatible with previous releases of
PDP-11 FORTRAN.
If
vyou
require
this
random-number
generator
for

compatibility

purposes,

include

file

LB:[1,1]F4PRAN.OBJ at task-build

time.

3.2.9

FAPRES

F4PRES.MAC is a
all
modules of
or SGA) is
an
FORTRAN-77
F4PRES.MAC

on
of

MACRO-11

source file containing global
references
to
the OTS.
An OTS resident library (shared global area,
option
available
to
installations
that
have
many

programs
contains the

logical
groups
an OTS resident

particular

The
that

includes

any

Consult the task
operating system

The

four

FORTRAN-77
the OTS and

development.
documentation

of OTS modules.
This feature aids in the building
1library
that
1is
tailored
to
the
needs: of
a

installation.

RMS version of

3.2.10

as
well
as
PDP-11
global references to

OTS
OTS

the

OTS cannot be built

into

shareable

1library

RMS modules.

builder
for more

and
system
generation
information on shareable

Overlay Description
overlay-description

manuals
for
libraries.

Files
files

are:

FCS11M.ODL

- FCS-11 support

for

RSX-11M/M-PLUS

FCSIAS.ODL

for

IAS

RMS11M.ODL

- RMS-11(K)

support

for

RSX-11M/M-PLUS,

RMSIAS.ODL

support

for

IAS

FCS-11

support

RMS-11(K)

and

RSTS/E
and

RSTS/E

your

SYSTEM

TAILORING

Each

file is an ODL fragment file that you can use for overlaying
FORTRAN-77 OTS modules.
Each file contains documentation
describes OTS options as well as procedures for using the file.
PDP-11

NOTE

you

files

are

using

FCS11M.ODL

the
and

RSTS/E

RMS11M.ODL

systen,
contain

references to LB:[1,1].
All occurrences
of LB:[1,1] should be changed to LB:.

the
that

CHAPTER

RSX-11M/M-PLUS

This

chapter

describes

on
the RSX-11M
relevant to the

for

the

INSTALLATION

procedures

for

installing

PDP-11

FORTRAN-77

and RSX-11M-PLUS operating systems.
Read the sections
type of distribution kit you are
using
(Section
4.1

magnetic—-tape
distribution
and
Section
4.2
for
distribution).
Section 4.3 presents
1instructions

the

disk-cartridge
invoking

The

the

basic

compiler.

installation

Building

the

Building

Copying

the

INSTALLATION

The

following

magnetic-tape

4,1.1
UFD

procedure

F77
F77

OTS

FORTRAN-77

from

the

explain

how

of:

library

object modules

system

TAPE

consists

object-module

diagnostic-message

FROM MAGNETIC

distribution

PDP-11

task

library

medium

sections

for

compiler

distribution

4.1

for

file

from

the

disk

DISTRIBUTION

build

PDP-11

FORTRAN-77

from

kit.

Preparations
[11,36]

therefore,
system,

1if

create

wused

this
it

1in

user

the

building

file

the

directory

system

disk

PDP-11

with

not
the

FORTRAN-77

system;

already present
following

your

command:

.. >UFD SY:[11,36]
Once

the

UFD

[11,36]

logical
>ASN

Now place
and

the

load

magnetic

(or

system

already

device

present),

assign

FP:

follows:

magnetic
tape

tape,

handler,

write-locked,
1if

not

already

that the device name for some magnetic tape
you are using such a device, substitute MM:

following

drive

resident,

units is
or MS:

MM:
for

commands):

MT:

Now mount

the

magnetic

tape

>ALL

the

distribution

the

>LOA

present

for

SY:=FP:

follows (Note
or
MS:.
If
MT:

name

MT:

magnetic

tape.

follows:

you

are

using

RSX-11M,

allocate

the

RSX-11M/M-PLUS

RSX-11M-PLUS,

device,

>MOU

4.1.2

the

magnetic

INSTALLATION

tape

must

follows:

mounted

foreign

MT:/FOR

Building

the

Compiler

You build the compiler from the object-module library supplied on
the
distribution
medium.
First,
set
the
UIC
to [11,36] and copy the
required files from the magnetic tape to the system disk, as follows:

>SET

Now

/UIC=[11,
36]

>FLX

SY:=MTO:F77.0LB

>FLX

SY:=MTO:F7711M.*

edit

compiler

task-build

installation

options,

Then

UIC

set

the

>SET
Now

build -the

compiler

the

4.1.3

Building

You

file

build

edited

the

files

system-library

command

the

OTS,

from

select

and Appendix

LIBUIC

follows:

[1l1,36]

set

magnetic

the

UIC

[11,36]

and

the

system

disk,

of two

ways:

SY:[11,36]=MTO:[11,37]*.0BJ

build

One

way

object

the

F77

OTS

build

the

OTS

modules

into

LB:[1,1]SYSLIB.OLB).

system

and

SYSLIB.OLB,

First,

reference.

tape

/UIC=[11,
36]

now

for

OTS

first

the

files

>SET

area

2.2

follows:

>FLX

can

[11,36]F7711M.CMD

Section

@[11,36]F7711M

Retain

OTS

the

command

described

/UIC=[libuic]

>TKB

either

RMSLIB.OLB

you

invoke

cannot

and

use

merge

existing
you

has

place

the

LBR

plan

copy

the

OTS

1library:
to

required

follows:

concatenated

(for

example,

wuse

the

already

been

incorporated

F4POTS.OLB

RMS-11

file

into

SYSLIB.OLB.

utility program

follows:

LBR>LB:SYSLIB.OLB=
36]SHORT.
[11,
OBJ/RP
LBR>LB:SYSLIB.OLB/
$SERTXT
DG:
LBR>LB:SYSLIB,OLB=[11
36] F4POTS.OBJ
,

Now

use

one

the

RMS-11

support

2.3)

follows:

following
FCS-11

commands

support,

but

incorporate
not

LBR>LB:SYSLIB.OLB=[11,36]FCS11M.O0OBJ
or

LBR>LB:SYSLIB.OLB=[11, 36]RMS11M.OBJ

both

(see

either
Section

RSX-11M/M-PLUS

The

second

library
follows:
designate
modules

That

way

using
(If
file

set

the

OTS

generate

the
OTS
concatenated
you
build
a
separate
LB:[1,1]F4POTS.OLB when

produced

is,

build

INSTALLATION

the

UIC

>SET/UIC=[1,1],

and

PDP-11

that

FORTRAN-77

invoke

the

separate

compiler.)

new library,

the

object
modules,
as
1library,
you
must
building a task from

LBR

for

utility

example

program

follows:
LBR>LB:F4POTS.0OLB/CR:150.=[11,
36 ] SHORT.OBJ

LBR>LB:F4POTS.OLB/DG:
SERTXT
LBR>LB:F4POTS.OLB=[11, 36]F4POTS.0OBJ

Now

use

RMS-11

one

the

support

following
FCS-11

commands

support,

but

incorporate

not

both:

either

LBR>LB:F4POTS.OLB=[11,36]FCS11M.OBJ
or

LBR>LB:F4POTS.OLB=[11,36]RMS11IM.0BJ

After

the

completing

system
>FLX

4.1.4

At
to

disk

one

the

above,

copy

the

Copying

the

Message

this point, set
the system disk

the UIC to [1,2]
as follows:

and

copy

compiler

/UIC=[1,
2]
LB:[1,2]=MTO: [1,2]F77COM.MSG/IM:64./BL: 14,

INSTALLATION

The

following

disk-cartridge
device type as

FROM

DISK CARTRIDGE

disk.

sections

explain

how

build

message

FORTRAN-77

distribution
kit.
If the system disk is
that of the distribution disk, place
the

distribution

file

the
the

same device
system disk

from

not the same
distribution

type as that
and drive
1

disk.

directions

that
follow,
1logical-unit
assignment
Dxn:=FP:
1logical-device name FP: to the drive of the distribution

the

this

take the value
Use DKO or DKl

assignment,

can

take

the

value

0 or 1
(on the basis of the
for the RKO05 distribution;

or
RKO7
distribution;
distribution.

4.2.1

DISTRIBUTION

disk
in
drive 0.
If the system disk is
of the distribution disk, use drive 0 for

UFD

the

>FLX

In
the
assigns

modules

File

>SET

the

OTS

LB:[1,1]=MTO:[11,40]*%.0BJ,*.0DL,*
. MAC,* . FTN

4,2

for

optional

follows:

and

wuse

DLO

type of
use DMO

DL1

and

the system
or DM1 for

for

the

RLOl

can

device).
the RKO06

RLO2

Preparations
[11,36]

therefore,

system,

1is

1if

create

wused

this

>UFD SY:[11,36]

user

the

building

file

the

directory

system

disk

with

PDP-11

not

the

FORTRAN-77

already

following

present

system;

command:

your

INSTALLATION

RSX-11M/M-PLUS

Once

UFD[11,36]

handler,

is present

not

(or

already resident,

>LOA Dx:

already
as

present),

load

the

disk

follows:

(not needed

the

system device

same
device
type
distribution disk)

that

the

Now place the distribution disk cartridge in drive
n
(write-locked),
and make the logical assignment and mount the volume as follows:
Dxn:=FP:
FP:F77

>ASN
>MQU

4.2.,2

Building

the

Compiler

You
build
the
compiler
from
the
object-module
1library
on
the
distribution
disk.
First,
set
the
UIC
to
[11,36]
and copy the
compiler-build files from the distribution disk to the system disk, as
follows:

36]
>SET /UIC=[11,
>PIP SY:=FP:F77.0LB
S>PIP SY:=FP:F7711M.*

Now edit compiler task-build command file [11,36]F7711M.CMD to
select
installation options, as described in Section 2.2 and in Appendix B.
Then

set

the

UIC

system-library area

LIBUIC

follows:

>SET /UIC=[libuic]
Now build

the

>TKB

compiler

the

4,2.3

Building

can
l.

the

following

command:

@[11,36]F7711M

Retain

You

with

edited

build
One

the

the
way

object

command

build

modules

either

the

OTS

into

IB:[1,1]SYSLIB.OLB).

system
and
SYSLIB.OLB,
First,

[11,36]

for

reference.

ways:

OTS

F77 OTS
to

files

and

use

the

merge

existing

you plan

RMSLIB,OLB
has
you cannot place

invoke

two

LBR

the

OTS

library:
wuse

the

concatenated

(for

example,

RMS-11

file

already
been incorporated
F4POTS.OLB in SYSLIB.OLB.
utility

program

into

follows:

LBR>LB:SYSLIB,.OLB=FP:
[11, 37]SHORT.OBJ/RP
LBR>LB:SYSLIB.OLB/DG:
SERTXT
LBR>LB:SYSLIB,OLB=FP:[11,37]F4POTS.OBJ

Now use one of the following commands to
RMS-11 support or

FCS-11 support,

incorporate

but not both:

either

LBR>LB:SYSLIB,.OLB=FP: [11,37]FCS11M.0OBJ
or

LBR>LB:SYSLIB.OLB=FP: [11,37]RMS11M.OBJ

(See

Section

FCS-11

file

2.3 for

explanation

systems.)
4-4

the

RMS-11

and

the

RSX-11M/M-PLUS

INSTALLATION

The

second way to build the OTS is
to
generate
a
separate
library
wusing
the OTS concatenated object modules.
(If you
build
a
separate
library,
you
must
designate
file
IB: [1,1]F4POTS.OLB

by the
That

the

PDP-11

when

building

FORTRAN-77

task

from

modules

produced

compiler.)

is, set the UIC to that of the new
LBR utility program, as follows:

1library

and

invoke

incorporate

either

not

both:

LBR>LB:F4POTS.OLB/CR:150.=FP:
{11, 37]SHORT.OBJ

LBR>LB:F4POTS.,OLB/DG:
SERTXT
LBR>LB:F4POTS.OLB=FP:
[11, 37]F4POTS,0BJ

Now

use

RMS-11

one

the

support

following
FCS-11

commands

support,

but

LBR>LB:F4POTS.OLB=FP: [11,37]FCS11M.0BJ
or

LBR>LB:F4POTS,.OLB=FP: [11,37]RMS11M.0BJ

After
the

completing

system

disk

one
as

the

above,

copy

the

optional

OTS

modules

follows:

>PIP LB:[1,1]=FP:[11,40]*,0BJ,*,.0DL,*
.MAC,* ,FTN

4.2.4

this

file

Copying

the

Message

File

point,

set

the

system

UIC

disk,

[1l,2]

and

copy

the

F77

compiler

message

follows:

SSET /UIC=[1,
2]
SPIP LB:[1,2]=FP:[1l,2]F77COM.MSG

4.3
You

INVOKING THE

COMPILER

invoke

the

F77

the

compiler

2.5.1),

compiler

you

invoke

either

installed
the

compiler

two

ways:

MCR

with

function

the

(see

following

Section

command:

>E77

If the compiler is not installed, you invoke the
follows:

>RUN

SF77

compiler

CHAPTER 5
RSTS/E

INSTALLATION

This chapter describes the procedures for

installing FORTRAN-77 on the

RSTS/E operating system, using the RSTS/E BUILD procedure.
If you are
more familiar with RSX-11 installations and command language than
vyou

are
with RSTS/E installations and command language, refer to Appendix
RSTS/E
a
on
FORTRAN-77
A for an alternative installation of PDP-11
system.

installation procedure consists of:

The basic

(and

Mounting

the

Building the compiler and the Object Time System

Autopatch

the

BUILD

disk)

the

(OTS)

with

in some cases copying to the system

Mounting

Kit

PDP-11 FORTRAN-77 distribution kit

program

The RSTS/E Autopatch Kit contains any patches that must be made to
PDP-11

FORTRAN-77

compiler

and/or

the

Object Time

System.

The Autopatch Kit and the distribution kit are contained
tapes

disk

MOUNTING

5.1

magnetic

cartridges.

(AND COPYING)

THE AUTOPATCH KIT

If your Autopatch Kit is on magnetic tape, follow the instructions

Section

the

5.1.1;

if it is on disk,

follow the instructions in Section

5.1. 2,

5.1.1

Mounting and Copying a Magnetic-Tape Kit

Place the tape containing the Autopatch Kit, write-locked, on
drive;
then
place
the tape online.
It is not necessary to
the MOUNT command for magnetic tape.

tape
a
specify

the

system

Now use the

disk.
on

how

PATCPY program to copy the Autopatch

Refer

use

Kit

the

PATCPY program.

After the Autopatch Kit has been copied to the system
the

tape

and

to the RSTS/E System Generation Manual for instructions

refer

Section

5.2.

disk,

dismount

RSTS/E

5.1.2

Mounting

Place

the

disk

drive,

disk

MOUNT

where

(and

Copying)

cartridge

INSTALLATION

Disk

containing

write-locked;

then

Kit
the

enter

Autopatch

the

Kit

available

the

command:

Dxn:PATCHE/RO

the

value

and

1is

the

number

disk

drive.
If

second

follow
If

the

only

Kit

disk

one

drive

remaining
disk

drive

mounted),

available,

instructions
is

you

available

must

refer

this
(the

now copy

Section

5.2;

otherwise,

section.
one

the

which

Autopatch

the

Kit

Autopatch

the

system

disk, using the RSTS/E PATCPY program.
Refer
to
the
RSTS/E
System
Generation Manual for instruction on how to use the PATCPY program.
After

the

disk

5.2

Autopatch

and

refer

MOUNTING THE

To
mount
a
write-locked,
necessary
To

mount

to
a

where

has

been

Section

F77

copied

the

specify

DISTRIBUTION

disk

the

mount

distribution

and

enter

the

system

disk,

dismount

5.2

KIT

magnetic-tape
distribution
on a tape drive;
then place

write—-locked,
MOUNT

Kit

kit,
place
the
the tape online.
It

tape,
is not

command.

kit,

place

the

disk

cartridge

1is

the

number

drive

command:

Dxn:F77/RO

the

value

and

the

disk

drive.

5.3

BUILDING

You

use

the

OTS.

First,

the

log

[1,0],

RUN
After

COMPILER

RSTS/E

BUILD

into

but

following

THE

and

THE

program

privileged

preferably

command

AND

build

(install)

(for

example,

account

not

press

OTS

the

one

with

PPN

the

[1,2]);

compiler

one

with

then

and

PPN

type

the

series

RETURN:

S$BUILD

you

press

RETURN,

BUILD

prints

the

following

message:

BUILD V7.0-07 RSTS V7.0-07 Time Sharing
BUILD

then

prompts

questions.
SYSTEM
Press

RETURN
SOURCE

you

for

These

questions

BUILD

<NO>

INPUT

information

are

given

?
the

DEVICE

<SY¥:>

default.
?

and

asking

discussed

you

below:

RSTS/E

Enter

the

mnemonic

the
FORTRAN-77
example, if you
on

tape

drive

LIBRARY

BUILD asks
containing

and

unit

number

distribution
received your

you

OUTPUT

type

INSTALLATION

the

medium,
software

device

which

you

placed

followed
by a colon (:).
For
on magnetic tape and mounted it

MTO:.

DEVICE

<SY¥:>

for the
mnemonic
name
the
system
1library.

and
unit
number
of
the
device
Because
the
FORTRAN-77
compiler

assumes the library is on SY:
in account [1,2], it is more convenient
to have the system library on that device.
1If your library is on SY:,
press RETURN.
If not, specify the name of the
device
that
contains
your

system

library.

TARGET

SYSTEM

Press

RETURN

DEVICE

LIBRARY ACCOUNT

<S5Y0:>

the

SY0:

<[1,2]>

default.

The system library account contains programs that
the installation.
BUILD must know the location of
the account number for
your
system
library
1is
default
by
pressing
RETURN.
If the library is
type

this

account

CONTROL

The control
FORTRAN-77.

number

FILE

file,
To

the

form,

BUILD
uses
during
these programs.
If
[1,2],
accept
the
in another account,

[p,pn].

F77.CTL, contains the
commands
tell
BUILD
which file to use,

needed
to
install
type F77, then press

RETURN,

BUILD
it

then

1is

prints

copying

temporary

file

the

following

the

F77.CTL

did
the

NOT accept
question:

LOCATE

LOGICAL

recommended

Storing
slows

these

access

device
account

the

FUNCTION

dev:

[1,2]

the

SY:

'LB:'

that

files
user

mnemonic,
number you

location

from

your

terminal,

the

distribution

telling

vyou

medium

BLDOl.TMP.

COPYING FILE
If you
prints

message
file

place

1in

[1,1]

TO BLDOl.TMP

LIBRARY OUTPUT

[1,11>

LB:

clutters

and

DEVICE,

BUILD

than

[1,1].

account

other

the

Master

File

files.

Therefore,

directory

system

device

PDP-11
not

FORTRAN-77

already

system;

present

your

follows:

SY:[11,36]

the

distribution

magnetic

tape,

write-locked,

drive

and
1load
the
magnetic
tape
handler,
1if
not already resident,
follows (Note that the device mnemonic for some magnetic tape units

MM: .,

Preparations

therefore,

Now

F77

for

INSTALLATION

The following
magnetic-tape

procedure

following

you are

MCR>LOA

Finally,

using

such

a device,

substitute MM:

commands.):
MT:

mount

the

magnetic

MCR>MOU MTO:/CHA=[FOR,

tape
ATCH]

follows:

for MT:

1in

as
is

the

INSTALLATION

6.1.2
You

Building

build

the

F77

USING MCR

Compiler

compiler

from

the
distribution
medium.
magnetic tape to the system
MCR>FLX

IAS

object-module library supplied
copy
the required files from

the

First,
disk as

on
the

follows:

SY:[11,36]=MTO0:[11,36]F77.0LB

MCR>FLX SY:[1l1,36]=MTO: [11,36]F7711D,*
Then

edit

compiler

installation
Now build

the

MCR>TKB

6.1.3

Building

build
to

edited

the
the

MCR>FLX

Now you

can

the

file

[11,36]F7711D.CMD

Section

2.2 and

select

Appendix

files

[11,36]

for

reference.

OTS

OTS,

first

system

disk

copy
as

the

required

OTS

files

from

the

magnetic

follows:

SY:[11,36]=MTO0:(11,37]*.0BJ

way

the

object

F77

OTS

build

the

OTS

modules

system

and

use

you

the

MCR>LBR
use

RMS-11

one

cannot

LBR

two

plan

the

OTS

1library

concatenated

(for

example,

use

the

already

been

incorporated

F4POTS.OLB

has
place

ways:

merge

existing

you

RMSLIB,OLB

SYSLIB.OLB,

First,

either

1into

IB:[1,1]SYSLIB.OLB).

Now

follows:

command

build

One

command

described

@[11,36]1F7711D

the

tape

compiler

Retain

task-build

options,

utility program

RMS-11

file

into

SYSLIB.OLB.

follows:

LB:[1,1]SYSLIB.OLB/RP=[11,36]F4POTS.0OBJ
of

the

support

following

FCS-11

commands

support,

but

incorporate
not

both

(see

either
Section

2.3):
MCR>LBR

LB:[1,1]SYSLIB.OLB/RP={11,36]FCS11D.0OBJ

MCR>LBR

LB:[1,1]SYSLIB.OLB/RP=[11,
36 ] RMS11D.0OBJ

The

second

way

library using

the

(If

you build
PDP-11

MCR>LBR

Now

use

RMS-11

one

OTS

the

OTS

concatenated

separate

LB: [1,1]F4POTS.OLB

by the

build

when

library,
building

FORTRAN-77

generate

object

modules,

you

must

task

from

separate

follows

designate
modules

file

produced

compiler.):

LB:[1l,1]F4POTS.OLB/CR:150.=[11, 36]F4POTS.O0BJ

support

the
or

following
FCS-11

commands

support,

but

incorporate

not

both:

MCR>LBR

LB:[1,1]F4POTS.0OLB=[11,36]FCS11D.0OBJ

MCR>LBR

ILB:[1,1]F4POTS.OLB=[11,36]RMS11D.0OBJ

either

After

the

completing

system

disk

MCR>FLX

one

the

above,

copy

the

optional

OoTSs

follows:

LB:[1,1]=MTO:[11,40)*.0BJ,*.0DL,*.MAC,*.FTN

6-2

modules

INSTALLATION

6.1.4

Copying

the

point,

copy

this

system

6.2

disk

the

Files

FORTRAN-77

the
the

FROM

sections

files

DISK

CARTRIDGE

same,

except

directions

unit

this

explain

the

and

DLO

use

6.2.1

for

that

which

notation,

or 1
RKO5

the

how

DISTRIBUTION

build

PDP-11

FORTRAN-77

distribution
kit.
If the system disk is
that of the distribution disk, place
the

drive

value 0
for the

UFD

message

LB:[1,2]=MTO:([1,2]F770TS.MSG/IM:
64./BL: 16.

disk

For

compiler

LB:[1,2]=MTO:[1,2]F77COM.MSG/IM:
64./BL: 14,

system

of the distribution disk, use
for
the
distribution
disk.

MCR

MCR>FLX

following

drive

USING

MCR>FLX

disk-cartridge
device type as

are

IAS

follows:

INSTALLATION

The

Message

DL1

the

same

the
for

system disk and drive
1
these two configurations

different
the

PDP-11

can

take

(on the basis
distribution;
for

the

wused

1in

drive 0 for
Procedures

follow,

the
x

the

disk

from

not the same
distribution

unit

notation

FORTRAN-77
the

value

device

"Dxn"

refers

RL0O2

the

pack

and

of the system device type).
use DMO or DMl for the RK06
RL0O1

that

assignments.

distribution

type

can

disk

placed.
take

the

Use DKO or DKl
distribution;

distribution.

Preparations
[11,36]

therefore,
system,

1is

1if

this

create

user

the

building

file

the

directory

system

device

PDP-11

is
as

not

FORTRAN-77

already

system;

present

follows,

using

resident,

the

your

following

command:
MCR>UFD

Now

load

SY: {11, 36]

the

disk

MCR>LOA

Dxn:

handler,

(not

not

needed

device

6.2.2
You

build

the

Now

the

system

that

the

same

distribution
in

disk)

drive

Compiler

compiler

disk.
disk to

from

the

object-module

First,
copy
the
the system disk as

SY:[11,36]=Dxn:[11,36]F7711D.*
SY:(11,361=Dxn:[11,36]F77.0LB

compiler

task-build

options,

command

described

library

<compiler
follows:

MCR>PIP

edit

device

the

disk
cartridge
as follows:

MCR>PIP

installation

follows:

Dxn:F77

Building

distribution
distribution

type

Finally,
place
the
distribution
write-locked, and mount the volume
MCR>MOU

already

file

supplied

build

files

[11l,36]F7711D.CMD

Section

2.2

and

from

the

select

Appendix

INSTALLATION

IAS

USING MCR

Edit
the
compiler
overlay-description
file
[11,36]F7711D.ODL
specify
the
disk
wunit on which the distribution disk is mounted,

to
as

follows:
MCR>EDI

SY:[11,36]F7711D.ODL

*PA/SY:/Dxn:/
*EX

Now

build

the

MCR>TKB

compiler

the edited

6.2.3

Building

can

follows:

@[11,36]F7711D

Retain

You

build

command

the

files

[11,36]

for

reference.

ways:

OTS

F77

OTS

either

two

One way to build the OTS is to
merge
the
OTS
concatenated
into an existing library (for example, LB:[1,1]
file
object
SYSLIB.OLB).
If you plan to use the RMS-11 file
system
and
RMSLIB.OLB has already been incorporated into SYSLIB.OLB, you
cannot

place

First,

use

F4POTS.OLB

the

MCR>LBR

SYSLIB.OLB.

LBR utility program

follows:

LB:[1l,1]1SYSLIB.OLB/RP=Dxn:[11,37]F4POTS.0OBJ

Now use one of the following commands to
incorporate
either
RMS-11 support or FCS-11, but not both (see Section 2.3):
MCR>LBR

LB:[1,1]SYSLIB.OLB/RP=Dxn:[11,37]1FCS11D.OBJ

MCR>LBR

L[B:[1,1]SYSLIB.OLB/RP=Dxn:[11,37]RMS11D.0OBJ

The

second

way to

build

the

OTS

generate

separate

library
using
the
OTS
concatenated
object
modules,
as
follows:
(If
you
build
a
separate
1library,
you
must
designate
file
LB:[1,1]F4POTS.OLB when building a task from
modules produced by the PDP-11 FORTRAN-77 compiler.)
MCR>LBR

LB:[1l,1]F4POTS.OLB/CR:150,=Dxn:[11,37]F4POTS.OBJ

Now use one of the following ccmmands to
incorporate
RMS-11 support or FCS-11 support, but not both:
MCR>LBR

LB:[1,1]F4POTS.OLB=Dxn:[11,37]FCS11D.0OBJ

MCR>LBR

LB:[1,1]F4POTS.OLB=Dxn:[11,37]RMS11D.0OBJ

either

After completing
the

system

disk

one of the above,
as

copy the optional

OTS

modules

follows:

MCR>PIP LB:[1,1)=Dxn:[11,40]*.0BJ,*.0ODL,*.MAC,*.FTN

6.2.4

Copying

the Message

At this point,

copy the

system

follows:

disk

Files

FORTRAN-77

compiler

message

MCR>PIP LB:[1l,2]=Dxn:[1, 2]JF77COM.MSG,F770T5.MSG

files

the

INSTALLATION

6.3
You

IAS

USING MCR

INVOKING THE COMPILER
invoke

the

FORTRAN-77

compiler

MCR

function,

follows:

MCR>F 77

For

Section

information

2.5.3.

making

the

F77

compiler

task

available,

see

CHAPTER

INSTALLATION

This

chapter

IAS

operating

sections

describes

relevant

(Section

7.1

The

the

basic

the

Building

Copying

the
to

INSTALLATION

following

[11,36]

this

user file

the

(Note

F77

distribution

7.3

FORTRAN-77

language.

kit

distribution;

F77

OTS

system

gives

you

Section

Read

the

for

the

are
7.2

using

instructions

for

task

from

message

FORTRAN-77
an

object-module

object

files

consists

of:

library

modules

from

the

distribution

disk

MAGNETIC

sections

PDP-11

library

diagnostic

FROM

for

compiler

explain

distribution

used

TAPE

how

DISTRIBUTION

build

PDP-11

FORTRAN-77

from

kit.

device

following

the

are

the

not

FORTRAN-77

tape

device

wusing

magnetic
handler,

mnemonic

such

for

tape,
if

not

the

your

some

device,

write-locked,
already

therefore,

system,

magnetic

tape

MM:

magnetic

PDS>MOUNT/FOREIGN

MTO:

tape
F77

follows:

create

drive

resident,

substitute

commands.):

mount

system;

already present

follows

distribution

SCI>RUN/HANDLER

Finally,

[11, 36]

magnetic

that

you

building

directory

system

place

load

installing
command

Section

procedure

the

PDS>CREATE/DIR

Now

DCL

Preparations

UFD

for

DCL

magnetic-tape

installation

magnetic-tape

type

USING

compiler.

Building

7.1.,1

the

distribution).

medium

The

IAS

procedures

using

the

7.1

for

disk-cartridge
invoking

the

system

units

for

MT:

and

follows
is

MM:,

the

INSTALLATION ON

IAS USING DCL

Building the Compiler

7.1.2

You build the F77 compiler from the object-module library supplied on
files from the
copy the needed
First,
the distribution medium.

magnetic tape to the system disk as follows:
PDS>COPY MTO:[11,36]F77.0LB/DO
PDS>COPY MTO:[11,36]F77IAS.*/DO

[11,36]*.*
[1l1l,36]*.%*

select
Now edit compiler task-build command file [11,36]F77IAS.CMD to
installation options, as described in Section 2.2 and in Appendix B.
Then

build

compiler

the

follows:

PDS>LINK @[11,36]F77IAS
Retain the edited command files in [11,36]

Building

7.1.3

the

for reference.

OTS

To build the OTS, first copy the required OTS files from the
tape to

the

system disk as

magnetic

follows:

PDS>COPY MTO: [11,37]*.0BJ/DO

[1l1l,36]%*.%*

You can now build the F77 OTS in either of two ways:

OTS concatenated
One way to build the OTS is to merge the
example,
(for
library
an existing
into
modules
object
file
RMS~-11
the
use
to
If you plan
LB:[1,1]SYSLIB.OLB).
already been incorporated into
RMSLIB.OLB has
and
system
SYSLIB.OLB, you cannot place F4POTS.OLB in SYSLIB.OLB.

First,

use the

LIBR utility program as follows:

PDS>LIBR INSERT

L[B:[1,1]1SYSLIB

[11,36]F4POTS

either
incorporate
Now use one of the following commands to
support or FCS-11 support, but not both (see Section
RMS-11
2.3):

PDS>LIBR INSERT LB:[1,1]SYSLIB

[1l1,36]FCSIAS.OBJ

PDS>LIBR INSERT LB:[1,1]SYSLIB

[1l1,36]RMSIAS.OBJ

separate
a
generate
to
The second way to build the OTS is
library using the OTS concatenated object modules, as follows

file
(If you build a separate library, you must designate
LB:[1,1]F4POTS.OLB when building a task from modules produced

by the

PDP-11 FORTRAN-77 compiler.):

PDS>LIBR CREATE/SIZE:150 LB:[1,1]F4POTS

Now use one of the following commands to

[11,36]F4POTS

incorporate

RMS-11 support or FCS-11 support, but not both:

either

PDS>LIBR INSERT LB:[1l,1]F4POTS

[11,36]FCSIAS.OBJ

PDS>LIBR INSERT LB:[1,1]F4POTS

[11,36]RMSIAS.OBJ

INSTALLATION

After

the

completing

system

the

above,

copy

USING

the

optional

MTO:[11,40]*.0BJ/DO

LB:[1l,1]*.*

MTO: [11,40]*.0DL/DO

LB:[l,1]%*.*

PDS>COPY

MTO: [11,40]*.MAC/DO

LB:[1l,1]%*.*

PDS>COPY

MTO:[11,40]*.FTN/DO

LB:([1l,1]*.*

Copying

the

point,

copy

system

disk

DCL

OTS

modules

files

follows:

PDS>COPY

this

7.2

one

IAS

PDS>COPY

7.1.4

disk

Message

the

Files

PDP-11

FORTRAN-77

compiler

message

follows:

PDS>COPY/IMAGE: 64

MTO:[1,2]F77COM.MSG/DO

LB: [1,2]%*.*

PDS>COPY/IMAGE: 64

MTO: [1,2]F770TS.MSG/DO

LB:[1l,2]*,*

INSTALLATION

FROM

DISK

CARTRIDGE

DISTRIBUTION

The
following
sections
explain
how
to
build
FORTRAN~-77
from
a
disk-cartridge
distribution
kit.
If the system disk is not the same
device type as that of the distribution disk, place
the
distribution
disk
in
drive 0.
If the system disk is the same device type as that
of the distribution disk, use drive 0 for the system disk and drive
1
for
the distribution disk.
Procedures for the two configurations are
the
In

same,
the

except

for

directions

the

that

different

follow,

unit

the

assignments.

notation

"Dxn"

refers

drive
wunit
on
which the FORTRAN-77 distribution disk
this notation, x can take the value K, M, or L, and
n
value
0
or 1.
Use DKO or DKl
DMl for the RKO06 distribution;
RL02 distribution.

7.2.1
UFD

the
use

the

disk

1In
the
DMO or

RKO05 distribution;
use
DLO or DL1
for
the
RLOl

Preparations
[11,36]

therefore,
system,

1is

1if

create

wused

this
it

PDS>CREATE/DIR
Now

for
and

is placed.
can
take

load

the

disk

place
(write-locked),

PDS>MOUNT

the

building

file

device

PDP-11

not

FORTRAN-77

system;

already present

follows::

already

resident,

your

[11, 36]
if

not

follows:

Dx:

the
distribution
and mount the volume

Dxn:

the

directory

system

handler,

SCI>RUN/HANDLER

Finally,

user

F77

disk

cartridge
follows:

drive

INSTALLATION

7.2.2

Building

IAS

USING

DCL

the Compiler

You build the compiler from the object-module library supplied on

distribution

disk.

distribution disk

First,

the

copy

the

compiler build

system disk as

follows:

files

the

from the

PDS>COPY Dxn:[11,36]F77IAS.* [11,36]*.%*
PDS>COPY Dxn:[11,36]F77.0LB [11,36]%*.%*

Now edit

compiler

task-build

installation options,
Edit

the

specify

compiler

the

disk

command

as described

file

[11,36]F77IAS.CMD to

Section

overlay-description

2.2 and

file

select

in Appendix

[11,36]F77IAS.0DL

wunit on which the distribution disk

is mounted,

follows:
PDS>EDIT [11,36]}F77IAS.0DL
*PA/SY:/Dxn:/
*EX

Now build

the

PDS>LINK

compiler

the

7.2.3

Building

can

edited

build

follows:

@[1l1l,36]F771IAS

Retain

You

command

the

files

[11,36]

for

reference.

ways:

OTS

F77

OTS

either

two

One way to build the OTS is to
merge
the
OTS
concatenated
object
modules
1into
an
existing
1library
(for
example,
ILB:[1,1]SYSLIB.OLB).
If you plan
to
wuse
the
RMS-11
file
system
and
RMSLIB.OLB
has
already
been incorporated into
SYSLIB.OLB, you cannot place F4POTS.OLB in SYSLIB.OLB.
First,

use

the

PDS>LIBR

Now use
RMS-11

LIBR utility program

INSERT

LB:[1,1]SYSLIB

follows:

Dxn:[11l,37]F4POTS

one of the following commands to
incorporate
support
or FCS-11 support, but not both (see

either
Section

2.3):

PDS>LIBR

INSERT

LB:[1,1]SYSLIB

Dxn:[11l,37]FCSIAS.OBJ

PDS>LIBR

INSERT

LB:[1,1]SYSLIB

Dxn:[11l,37]RMSIAS.OBJ

The second way to build the OTS is
to
generate
a
separate
library using the OTS concatenated object modules, as follows
(If you use a
separate
library,
you
must
designate
file
IB:[1,1]F4POTS.OLB when building a task from modules produced
by the PDP-11 FORTRAN-77 compiler.)

PDS>LIBR CREATE/SIZE:150 LB:[1,1]F4POTS Dxn:[11l,37]F4POTS
Now use one of the following commands to
incorporate
RMS-11 support or FCS-11 support, but not both:

either

PDS>LIBR

INSERT

LB:[1,1]F4POTS

Dxn:[11,37]FCSIAS.OBJ

PDS>LIBR

INSERT

LB:[l,1]F4POTS

Dxn:[11, 37]RMSIAS.OBJ

7-4

INSTALLATION

After

the

completing

system

You

the

above,

copy

USING

the

Dxn:[11,40]
.0OBJ

LB:[l,1]*.%*

Dxn:[11,40]*.0DL

LB:[1l,1]*.%*

PDS>COPY

Dxn:{11,40]*.MAC

LB:[1l,1]%*.%*

PDS>COPY

Dxn:[11,40]*.FTN

LB:[1l,1]*.%*

Copying

the

Message

invoke

command,

Dxn:[1,2]#*%.MSG

the

OTS

modules

FORTRAN-77

compiler

the

message

files

LB:[1,2]*.*

COMPILER

PDP-11

the

optional

Files

this point, copy the PDP-11
the system disk as follows:

INVOKING THE

DCL

follows:

PDS>COPY

7.3

one

IAS

PDS>COPY

7.2.4

disk

system

FORTRAN-77
default

compiler
PDP-11

using

FORTRAN-77,

the

PDS

follows:

FORTRAN

PDS >FORTRAN

the

compiler

installed

F4P,

invoke

the

follows:

PDS>FORTRAN/F4P

Otherwise,
as

PDS>

For

you

must

use

MCR

PDP-11

FORTRAN-77

follows:

Section

MCR

F77

information
2.5.4.

compiler,

making

the

F77

compiler

task

available,

see

CHAPTER

SYSTEM

The

PDP-11

verify

FORTRAN-77

that

the

The

test

one

occurs

during

8.1

TEST

PROGRAM

use

the

program,

BUILD

VERIFICATION

distribution

system
F77TST,

kit

includes

correctly

contains

compilation

and

installed

two
one

simple

and

intentional
occurs

during

test

ready

for

nonfatal

program

use.
errors:

execution.

the test program, first copy file F77TST.FTN from
UFD
[11,40]
distribution medium to a user account on the system disk.
Then
compile, link, and execute the
test
program
as
described
in
this
section.

NOTE

MCR

and

RSTS/E

The

following

and

execute

wusing

RSTS/E

occurrences

IB:

the

following

1in

system,

LB:[1,1]

with

commands.

Commands

command

Compile:

test

F77

sequences
program

show you
RSX

and

how

RSTS/E

compile,

taskbuild,

systems.

F77TST=F77TST/TR:ALL

if using an OTS located in SYSLIB,

or,

(if

using

TKB

F77TST/FP=F77TST

(if

using

TKB

F77TST/FP=F77TST,LB:[1,1]SYSLIB.OLB/LB,LB:[1,1]RMSLIB/LB

FCS-11)
RMS-11)

separate

library

used,

(if

using

TKB

F77TST/FP=F77TST,LB:[1,1]F4POTS/LB

(if

Execute:

are

all

the

Link:

you

replace

using

FCS-11)

RMS-11)

TKB

F77TST/FP=F77TST,LB:[1,1]F4POTS/LB,LB:[1,1]RMSLIB/LB

RUN

F77TST

SYSTEM BUILD VERIFICATION

DCL Commands

(for use on

IAS)

The following command sequences show you how

compile,

and execute the test program on an IAS system using pCL. 1
FORT/LIST/SWIT: (/TR:ALL)

Compile:
Link:

if using

OTS located

taskbuild,

F77TST

in SYSLIB

(if using FCS-11)
LINK/FLOATING F77TST
(if using RMS-11)

LINK/FLOATING F77TST,LB:[l,l]SYSLIB.OLB/LB,LB:[l,l]RMSLIB/LIB

or,

if a separate library is used,
(if

using

FCS-11)

(if

using

RMS-11)

RUN

F77TST

LINK/FLOATING F77TST LB: [1,1]F4POTS/LIB

LINK/FLOATING F77TST,LB:[l,l]F4POTS/LIB,LB:[l,l]RMSLIB/LIB
Execute:

8.2

TEST RESULTS

During compilation, an overflow error should occur on source 1line 6.
a floating zero-divide error should be reported at
During execution,
line

8.3

VERIFICATION PROCEDURE FAILURE

The preceding verification procedure can fail if the FORTRAN-77 system
Possible failures include:
is incorrectly installed.
@

The F77 compiler produces the message:

F77 -- FATAL 08 * COMPILER DYNAMIC MEMORY OVERFLOW

the compiler
This message indicates that dynamic memory for
was not correctly allocated by EXTTSK or INS/INC (see Section
INC
Remove and reinstall the compiler with a correct
3.1.4).
value.

ILB:[1,2]F77COM.MSG
file,
message
compiler
the
If
RSTS/E), has not been transferred
(SY: [1,2]F77COM.MSG for
correctly, the compiler treats the compile-time overflow in
The compiler does not create object
F77TST as a fatal error.

module

F77TST.OBJ.

1.You may need an additional compilation

according to how FORTRAN-77 was installed.
8-2

switch,

for

example

/F77,

SYSTEM

For

IAS,

the

OTS

BUILD VERIFICATION

message

file,

LB:[1,2]F770TS.MSG,

been
transferred
correctly, or if
is not loaded, run-time subroutine
not

produced.

For

RSX-11M

and

RSX-11M-PLUS,

the

has

not

the MO message-output task
traceback
information
1is

task

exits

with

OTS

"Task
Initialization Failure," if the task builder
was omitted, or if the operating system
does
not
floating-point processor.

error

/FP switch
support
a

CHAPTER
RELEASE

9.1

USING

F4PNER WITH

F4P11S

NOTES

F4PNIO

If you use F4PNER,
the
optional
OTS
error-reporting
module,
with
F4P11S
or
F4PNIO -- other optional OTS modules -~ a multiply defined
symbol error may result during task-build.
Two correct
ways
to
use
FAPNER

with

F4P11S

Build
use

F4P11S

them

F4PNIO

(or

follow:

F4PNIO)

and

F4PNER as separate libraries

and

follows:

TKB>MAIN/FP=MAIN, LB:[1l,1]F4PNER/LB: SNERRL,
IB: [1,1]F4P11S/LB, LB:[1,1]F4POTS/LB
e

Build an OTS
into F4POTS.
F4PNER

by incorporating F4P11S.0BJ
Name the resulting library
separate

library.

TKB>MAIN/FP=MAIN,

Use

those

instead of FCS11M.OBJ
F4P11S.0OLB, and build
libraries

LB:[l,1]F4PNER/LB:

follows:

SNERRL,

IB:[1,1]F4P11S/LB

9.2

INCORRECT FATAL

ERROR

If you include in the range of an IMPLICIT
CHARACTER
statement
both
the
function
name
and
one of the formal parameters, you receive an
incorrect error message
during
compilation.
Instead
of
receiving
Error
105
(function
or
entry
name
not
numeric), you receive the
following incorrect error message:
FATAL

I/0

error

workfile

The following program illustrates
CHARACTER statement that produces
FUNCTION

FUNC

IMPLICIT

CHARACTER

the
the

(LUNG6)

illegal
wuse
of
the
IMPLICIT
above incorrect error message:

(TIME)

(A-T)

RETURN

END

The incorrect error message results because
both
FUNC
and
the
formal parameter TIME are included
IMPLICIT

This

CHARACTER

problem

FORTRAN-77.

will

the
function
name
in the range of the

statement.

corrected

future

release

PDP-11

RELEASE

9.3

TASK

SIZE

NOTES

INCREASES

The

size of some of the OTS modules has been increased to
accommodate
new ANSI FORTRAN-77 features.
The features affected and the amount of
increase are listed below.
The list indicates the
expected
increase
in
size
of
FORTRAN IV-PLUS V3.0 programs task built with the PDP-11
FORTRAN-77

OTS.

Feature
Formatted

Task

I/0

Increase

375 words

Logical

conversion

4 words

Integer

conversion

55 words

Real

conversion

Octal

80 words

conversion

320 words

List-directed

input

250 words

List-directed

output

40 words

OPEN

statement

Other

I/0O

25 words

and

initialization

9.4

Size

RESTRICTION

modules

OUTPUT

75 words

During output, if the format descriptor nIw.0, nOw.0, or nZw.0
and the internal datum is zero, the character 0 is output.
The

This

output

should

incorrect behavior

PDP-11

9.5

field

consist

will

only of

blank

corrected

used

characters.

future

version

FORTRAN-77.

F77

OTS

INSTALLATION

If you want to put the
F77
0TS
in
SYSLIB.OLB,
save
the
original
SYSLIB.OLB
by
renaming
it
to SYSLIB,.OLD.
The renaming facilitates
recovery of the original SYSLIB if the build is unsuccessful.

APPENDIX

ALTERNATIVE

This

appendix

FORTRAN-77
on
RSTS/E command

describes

RSTS/E

INSTALLATION

alternative

procedure

a
RSTS/E
operating system.
language, you may wish to use

for

If
the

installing

PDP-11

you are familiar with
procedure
described

in
Chapter
5,
which uses the RSTS/E BUILD program;
but
are
familiar
with
RSX-11M/M-PLUS
and
command
following installation procedure may be more suitable.

if you are
language,

The

consists

basic

installation

Building

the

Building

Copying

the

F77

your

A.l

The

distribution

disk

following

A.l.1

FROM

object-module

of:

library

object modules

diagnostic-message
system disk

file

from

the

Section

A.1;

the

refer

sections describe
kit.

from

on magnetic

MAGNETIC

FORTRAN-77

TAPE

tape,

Section

refer

A. 2,

DISTRIBUTION

how to

build

PDP-11

the

RT-11

and

not

been

FORTRAN-77

from

distribution

Preparations

Before

have

medium

PDP-11

task

library

cartridge,

INSTALLATION

magnetic-tape

OTS

kit

for

compiler

compiler
to

distribution

procedure

not,
the

proceeding,

been
RUN

added.

see

they have

added,

RSX

add

run-time

them

systems

follows:

SY:[1, 2]JUTILTY

#ADD

RTI11

#ADD

RSX

Now place
that
the

check

the distribution
device name for

tape, write-locked, on
some tape units is MM:

using such a device, substitute
that
follow.
If you are using
the tape as follows:

MM:
1600

tape drive.
Note
or MS:.
If you are
or MS:
for MT:
1in the
commands
BPI magnetic tape, you must mount

MOUNT MTO:/DENSITY:1600

your magnetic
issue a specific

tape distribution
mount command.

800

BPI,

you

not

need

ALTERNATIVE

A.1.2

You
the

Building

the

using
but

required

privileged
preferably

files

RUN

from

INSTALLATION

Compiler

build the compiler from
distribution medium.

First,
[1,01;

RSTS/E

the

object-module

library

F77.0LB

supplied

account (for example, the account
with
the
account
with PPN
[1,2]), copy

the

not

tape

the

system

disk,

PPN

follows:

SY:[1,2]PIP.SAV

*SY:*,*=MT0: [11,36]F77.0LB
*SY:*,*=MT0: [11,36]F77RST.*

You can now edit compiler task-build command file F77RST.CMD to select
installation options, as described in Section 2.2 and Appendix B.
Now build
RUN

the

compiler

SY:[1,2]TKB.TSK

@F77RST

TKB>

Then copy the compiler
protection code <104>:
RUN

follows:

system

library

account

[1,2],

giving

tape

SY:[1,2]PIP.SAV

*SY: [1,2]F77.TSK<104>=F77.TSK

*SY:F77.TSK/DE
Retain

the

edited

A.1.3

Building

(unless

command

the

you are

files

for

into

[1,2])

reference.

OTS

To build the 0TS, first copy
the system disk, as follows:
RUN

logged

the

required

OTS

files

from

the

SY:[1,2]PIP.SAV

*SY:*,*=MT0: [11,37]*.0BJ

You

can
1.

now build
One

way

the
to

object

F77

OTS

build

the

OTS

modules

LB:SYSLIB.OLB).

and

RMSLIB.OLB

you

cannot

First,

invoke

into
If

has

place

either
is

you

plan

been

F4POTS.OLB

use

the

ways:

merge

already

and

two

the

existing

LBR

making
sure
the
module
accommodate the OTS:
RUN

use

OTS

library
the

concatenated

(for

RMS-11

incorporated

example,

file

into

system

SYSLIB.OLB,

SYSLIB.OLB.
utility

program

and

entry-point

name

follows,

tables

can

SY:[1l, 2]LBR.TSK

LBR>LB:SYSLIB.OLB/CO:200.:2048.:512.=LB:SYSLIB.OLB
LBR>LB:SYSLIB.OLB=SHORT.OBJ/RP

LBR>LB:SYSLIB.OLB/DG:
SERTXT
LBR>LB:SYSLIB,OLB=F4POTS.0BJ

Now use

one

FCS-11

support.

management

the

following
You

must

commands
select

systems:

LBR>LB:SYSLIB.OLB=RMS11M.OBJ
or

LBR>LB:SYSLIB.OLB=FCS11M.OBJ
A-=2

incorporate

only

one

RMS-11
these

file

ALTERNATIVE

However,

using
2.

The

you

may

wish

FCS-11

and

one

using

second

way

library

using

the

(If

build

you

LB:F4POTS.OLB

the

RSTS/E

PDP-11
RUN

build

OTS

build

two

separate

RMS-11.

the

OTS

building

FORTRAN-77

libraries,

Section

2.3):

generate

object

library,

OTS

(See

concatenated

separate
when

INSTALLATION

you

task

modules,

must

from

separate

follows

designate

modules

one

file

produced

compiler.):

SY:[1, 2]LBR.TSK

LBR>F4POTS.OLB/CR:150.=SHORT.OBJ

LBR>F4POTS.OLB/DG:
SERTXT
LBR>F4POTS.OLB=F4POTS.,
OBJ

Now

use

FCS-11

one

the

following

follows:

support,

commands

incorporate

file

management

RMS-11

LBR>F4POTS.OLB=RMS11M.OBJ
or

LBR>F4POTS.OLB=FCS11M.0OBJ
You

must

select

however, you
using FCS-11
Copy

the

1library

protection
RUN

only

one

these

may wish to build two
and one using RMS-11.

code

<40>,

the

systems;

separate OTS libraries,
(See Section 2.3):

1library

one

account

LB:,

giving

optional

OTS

modules

follows:

SY:([1,2]PIP.SAV

*LB: F4POTS. OLB<40>=F4POTS.
OLB
*F4POTS. OLB/DE

After completing
the system disk,
RUN

one of the above,
as follows:

copy

the

5Y:[1,2]PIP.SAV

*LB:*,.*=MTO: [11,40]*.0BJ,MTO0:[11,40]*.0DL,MTO:[11,40]*.MAC/NO,
MTO: [11,40]*.FTN

A.l1.4

Copying

the

Message

File

At this point, copy the PDP-11
system disk, as follows:
RUN

FORTRAN-77

compiler

message

file

the

SY:([1,2]PIP,SAV

*5Y: [1,2] *.*=MTO0: [1,2]F77COM.MSG

A.2

INSTALLATION

FROM

DISK

CARTRIDGE

The following section explains how
disk-cartridge distribution kit.

DISTRIBUTION
build

PDP-11

In the directions that follow, logical-unit
assigns
the logical-device name FP:
to the

disk.
take
DKl

1In
the

for

the

RKO5

distribution;

and

use

DLO

use

DL1

DMO

for

the

from

assignment
Dxn:
to
FP
drive of the distribution

the assignment, x can take the value
wvalue 0, 1 or any available drive.

distribution;

FORTRAN-77

K, M, or L, and
For example, use

DMl

for

the

RLOl

RL02

RKO06

n
can
DKO or
RKO7

distribution.

ALTERNATIVE

A.2.1

Preparations

Before

proceeding,

have
been
commands in

check

RSTS/E

see

added.
If they have
the sequence below.

Now place the distribution disk
mount
the
volume,
and
make

INSTALLATION

the

not

RT-11]

been

and

RSX

added,

run-time

include

cartridge in drive
n
the logical assignment

the

systems

last

two

(write-locked),
shown below, as

follows:
MOUNT
RUN

Dxn:F77/RO

SY:[1,2]JUTILTY

#ADD

LOGICAL

#ADD

RT11

#ADD

RSX

A.2.2

Building

Dxn:

the

Compiler

You build the compiler from object-module library F77.0LB supplied
on
the
distribution
medium.
First,
using
a
privileged account (for
example, the account with UIC[l,1];
but preferably not the
one
with
UIC([1l,2]),
system

copy

the

follows:

disk,

RUN

required

files

from

the

distribution

disk

the

SY:[1,2]PIP.SAV

*SY:*,*=FP: [11,36]F77.0LB
*SY:* ,%=FP: [11,36]F77RST.
*

You

can now edit compiler task-build command file
installation options, as described in Section 2.2

Now

build
RUN

follows:

@F77RST

copy

the

protection
RUN

compiler

SY:[1,2]TKB.TSK

TKB>

Then

the

F77RST.CMD to select
and Appendix B.

compiler

code

<104>,

system

follows:

1library

account

[1,2],

giving

SY:[1,2]PIP.SAV

*SY: [1,2]F77.TSK<104>=F77.TSK
*SY:F77.TSK/DE

Retain

the

A.2.3

Building

You

can
1.

edited

build
One

command

the

the
way

(unless

are

files

logged

for

into

[1,2])

reference.

OTS

F77
to

you

OTS

build

either

the

OTS

of
to

two

ways:

merge

the

OTS

concatenated

object
modules
into
an
existing
1library
(for
example
LB:SYSLIB.OLB).
If you plan to use the
RMS-11
file
system
and RMSLIB.OLB has already been incorporated into SYSLIB.OLB,

you cannot

place

F4POTS.OLB

SYSLIB,OLB.

ALTERNATIVE RSTS/E

First,
making

invoke and
sure
the

accommodate

use the
module

LBR
utility
program
as
follows,
name
and
entry-point
tables can

OTS:

the

INSTALLATION

SY:[1l,2]LBR.TSK

RUN

LBR>LB:SYSLIB.OLB/CO:200.:2048.:512,=LB:SYSLIB.OLB
LBR>LB:SYSLIB.OLB=FP:
[11, 37]SHORT.OBJ/RP
LBR>LB:SYSLIB.OLB/DG:
SERTXT
LBR>LB:SYSLIB,OLB=FP:
[11, 37]F4POTS.OBJ

incorporate

Now use one of the following commands to
FCS-11 support

Section

(see

2.3):

RMS-11

LBR>LB:SYSLIB.OLB=FP: [11,37]RMS11M.OBJ
or

LBR>LB:SYSLIB.OLB=FP: [11,37]FCS11M.0OBJ

You must select only one of these

however,

using

one

you

file

systems;

management

wish to build two separate OTS libraries,

may

FCS-11 and one

using

RMS-11.

separate
a
generate
to
The second way to build the OTS is
as
modules,
object
concatenated
OTS
the
using
library
must
you
1library,
separate
a
build
you
(If
follows.,
LB:F4POTS.OLB when building a task from
file
the
designate
modules produced by the PDP-11 FORTRAN-77 compiler.)

RUN

SY:[1,2]LBR.TSK

37]SHORT.OBJ
150.=FP:
[11,
LBR>F4POTS.OLB/CR:
SERTXT
LBR>F4POTS.OLB/DG:
LBR>F4POTS.OLB=FP: [11,37]F4POTS.OBJ

Now use one of the
FCS-11

support.

following

(See

commands to

Section

incorporate RMS-11 or

2.3).

LBR>F4POTS.OLB=FP:
[11, 37]RMS11M.0OBJ
or

LBR>F4POTS.OLB=FP: [11,37]FCS11M.0OBJ

You must select only one of

these

file

systems;

management

however, you may wish to build two separate OTS libraries, one
using

1library

Copy the
protection
RUN

code

using

one

FCS-11 and

the

RMS-11l.

account

LB:,

giving

copy the optional

OTS

modules

1library

<40>:

SY:[1,2]PIP.SAV

*LB: F4POTS.OLB<40>=F4POTS.OLB
*F4POTS.OLB/DE

After completing
the

system
RUN

disk,

one of the

follows:

SY:[1,2]PIP.SAV

above,

*.MAC,
DL,FP:
[11,40]
*[B:*,*=FP: [11,40]*.0BJ,FP:[11,40]1*.0
FP: [11,40]*.FTN

ALTERNATIVE

A.2.4

Copying

the

point,

copy

this

follows:
RUN

Message

the

RSTS/E

INSTALLATION

File

F77

compiler

message

files

the

system

disk,

you

invoke

SY:[1,2]PIP.SAV

*SY: [1,2]*.*=FP:[1,2]F77COM.MSG

A.3
You

INVOKING
can

THE

invoke

the

COMPILER
F77

installed

the

compiler

one

CCL command

(see

two

ways:

Section

2.5.2),

with:

F77

the
RUN

compiler

not

SY:[1,2]F77.TSK

installed,

you

invoke

follows:

APPENDIX

COMPILER TASK-BUILD FILES

B.l.

PDP-11 FORTRAN-77 COMPILER TASK-BUILD FILE FOR RSX-11M/M-PLUS
(F7711M.CMD)

e\. W WME We WY Me MY MY M NS MY WO MY WP MWE W W We Wy

F77/,CP/~-FP,[11,36]F77/SP=[11,36]F7711M.ODL/MP

PDP-11

FORTRAN-77

FDP-11

FORTRAN-77 VERSION 4
RSX-11M VERSION 3.2
RSX-11M-PLUS

SUMMARY

24k

g ~e we ~o
w~
)~ we

VERSION

FILE

PARAMETERS:

PARTITION

COMPILER

"GEN"

TASK

FRAMES

COMMON

BLOCKS,

RESIDENT

OPTION

DO/BLOCK IF STATEMENT STACK
MAXIMUM
PAGES FOR WORKFILE SYSTEM

INPUT

=lt ® .F77

BUILD FOR PARTITION "GEN",
PARTITION MUST BE AT LEAST

MAPPED
22K

11M

SYSTEM

=GEN

STACK

512 WORDS

STACK MUST NEVER BE
=512

F77

COMPILER

LOGICAL

THAN

384 WORDS

UNIT ASSIGNMENTS

b W

TACK

LESS

COMMAND

(o))

1)
BT
T I

SYSTEM

TASK BUILD

512 WORD STACK
FRAMES IN EXPRESSION ANALYZER STACK

REFERENCES

ASK

INPUT

COMMAND

OUTPUT

COMPILER WORKFILE

(RANDOM

ACCESS)

CAN

SWAPPING

DISK

.OBJ OUTPUT
.LST

OUTPUT

.FTN

INPUT

T RI

COMPILER

DISK MUST
BUT
oo ~J

T
TR T
T

REASSIGNED TO

THE

BE MOUNTED AS

WORKFILE

DOES

WRITABLE

NOT

REQUIRE

AVAILABLE

FILES-11
A

UFD

VOLUME,
THE

VOLUME.

COMPILER TEMP FILES
(SEQUENTIAL ACCESS)
DISK MUST BE MOUNTED AS WRITABLE FILES-11 VOLUME,
BUT THE TEMP FILES DO NOT REQUIRE A UFD ON THE VOLUME.

B-1

COMPILER TASK-BUILD FILES

’

COMPILER MESSAGE

TEXT

FILE

UNITS

ASG

=TI:1,TI:2

ASG

=5Y0:6,5Y0:7,5Y0:8

ASG

=LB0:9

FOR WORKFILE

VIRTUAL MEMORY

SYSTEM

RESIDENT MEMORY

INCREASING THE NUMBER OF RESIDENT WORKFILE PAGES WILL MAKE THE COMPILER
FASTER BY REDUCING PAGING I/0, BUT IT DOES NOT AFFECT THE SIZE
OF THE MAXIMUM SOURCE PROGRAM WHICH CAN BE COMPILED.

RUN

XTTSK

F77

=3840

USES CONTROL SECTION "STACK1" FOR:
EXPRESSION ANALYZER STACK DURING PASS 1
NAMED COMMON BLOCK DEFINITIONS IN LATER

PASSES

Ne S W

IT]
me Se me

N0 Se

we Ne N0

UNDER RSX-11M/M-PLUS WORKFILE RESIDENT MEMORY IS DYNAMICALLY DETERMINED.
IF THE OPERATING SYSTEM SUPPORTS DYNAMIC MEMORY ALLOCATION,
THE SIZE OF THE COMPILER DYNAMIC STORAGE IS DETERMINED BY "EXTTSK".
OTHERWISE, THE COMPILER WILL USE ALL MEMORY AVAILABLE IN THE PARTITION.

DEFINED BELOW, STACKl IS 312(10) WORDS, PROVIDING:
312/8
= 39 EXPRESSION ANALYZER STACK FRAMES
312/6
= 52 CONTROL SECTIONS
UP TO 7 CONTROL SECTIONS MAY BE USED FOR
COMPILER-GENERATED CODE AND DATA, LEAVING

XTSCT

F77

45 COMMON

BLOCKS.

=STACKl:1160

USES CONTROL SECTION "DOSTKI1" FOR:
DO STATEMENT NESTING STACK DURING

PASS

we we

[T]
ws ~e

~e w6 ws

DEFINED BELOW, DOSTK1l IS 60(10) WORDS, PROVIDING:
60/3
= 20 NESTED DO/BLOCK IF STATEMENTS
=DOSTK1l:170

XTSCT

DEFINE

[T] we¢ e

F77

PRINTER WIDTH AND NUMBER

SOURCE

LINES

PER

LISTING

PAGE

ARE:

VALUES

SOURCE

LINES

DEFAULT
132

COLUMN

LINE

PER

PAGE

(PLUS

LINES

132(10)

204 (8)

HEADING)

PRINTER

67(8)

80(10)

120 (8)

55(10)

WMe

NOTE:

[

=FORTRN:LPLINE:67

GBLPAT

=FORTRN:LPWDTH:
204

Q\a “s We TMo

GBLPAT

DEFINE

DEFAULT

INDICATES
OBJECT

FILES;

THE
A

FILE

SUPERCEDE

COMPILER

VALUE

SHOULD
ALLOWS

DEFINITION

A COMPLETE

DESCRIPTION OF THE

SUPERCEDE

VALUE
OUTPUT

(DEFAULT)

LISTING AND

SUPERCEDING.

COMPILER

SWITCH OPTION

VALUES

WMy

BEHAVIOR:

NOT

=COMAND:SUPO00O:0

WTMy

BLPAT

OUTPUT

THAT

CONTAINED

SECTION

1.2

EFFECTS
THE

OF THE COMPILER OPTION SWITCHES

PDP-11

FORTRAN-77

USER'S

GUIDE.

“e

SWITCH

NAME

SETTING

TASK-BUILD

VALUE

FILES

GBLPAT

/CK

ARRAY

/CO:19,

NUMBER

SUBSCRIPT

BOUNDS

CHECKING

Cco

CONTINUATION

LINES

/CO:N,

/-DE

/DE

INCLUDE

DEBUG

LINES

/-14
/14

DEFAULT

INTEGER*2

DEFAULT

INTEGER*4

/-LA

REINITIALIZE

H O

/LA

SWITCHES

NI
M

/LI:3

SOURCE
SOURCE,

MAP

SOURCE,

MAP,

GENERATED CODE

R/W

CODE

SECTIONS

R/0

CODE

SECTIONS

/-SP

/SP

SPOOLING

WME
MY

/TR
: NAMES

/TR :BLOCKS

/TR:ALL
/TR

NUMBER

/WF:
2

/WF:N

TEMPORARY

FILES

/-WR

OPTIONAL WARNINGS

/WR
F77

/-F77

FORTRAN

INTERPRETATION

/F77

FORTRAN

INTERPRETATION

THE

FOLLOWING

"GBLPAT"

DEFINITIONS

EFFECT

DEFAULTS

OF:

/-CK/C0:19./-DE/-14/-LA/LI:2/-RO/SP/TR:BLOCKS/WF:
2/WR/F77

DEFAULT

WMe

MNP

/TR
: NONE

NJWERHEOO

/-TR

= O

/RO

= O

/-RO

/LI:1
/LI:2

whhro

/LI:0

WMe

/—-CK

SWITCH

COMPILER

VALUES

"GBLPAT"

FOR

SWITCH

GLOBAL

GBLPAT

=FORTRN: LAQ0O: 0

GE LPAT

=COMAND:CKO000:
0

GBLPAT

=COMAND:C0O000:
23

GBLPAT

=COMAND: DEQQOQ: 0

GELPAT

=COMAND:I4000:0

GBLPAT

=COMAND: LI000: 2

GBLPAT

=COMAND:RO000:
0

GELPAT

=COMAND:SP000:
1

GBELPAT

=COMAND: TR000: 3

GBLPAT

=COMAND:WFO000:
2

GBLPAT

=COMAND:WR000:1

GBLPAT

=COMAND:F7700:1

ARE

VARIABLE

DEFINED

"XXooo0".

COMPILER

B.2

PDP-11

FORTRAN-77

=
N6 e Ne e Ne N NS Ne Mo NE W Ne Ne Ne No N e N

F77/CP/-FP,
PDP-11

PDP-11

F77=

COMPILER

FORTRAN-77

VERSION

SUMMARY

VERSION

SYSTEM

TASK-BUILD

FILE

FOR RSTS/E (F77RST.CMD)

TASK

BUILD

FILE

7.0

PARAMETERS:

REFERENCES

24K

FILES

F77RST.ODL/MP

FORTRAN-77

RSTS/E

TASK-BUILD

PARTITION

COMPILER

"GEN"

TASK

512 WORD STACK
FRAMES

EXPRESSION

FRAMES

DO/BLOCK

COMMON

BLOCKS,

RESIDENT

OPTION

PAGES

ANALYZER

STACK

STATEMENT

STACK

MAXIMUM
FOR

WORKFILE

SYSTEM

INPUT

=,..F77

ASK

;

The

;

BUILD

RSX-11M

;

PARTITION

FOR

Emulator

must

PARTITION
MUST

"GEN",

MAPPED

LEAST

11M

SYSTEM

28K

=GEN

PAR
;

;

STACK

F77

MUST

512

WORDS

NEVER

LESS

THAN

384

WORDS

=512

COMPILER

LOGICAL

UNIT

ASSIGNMENTS

;

COMMAND

INPUT

;

COMMAND

OUTPUT

;

.0BJ

OUTPUT

;

(LST

OUTPUT

JFTN

INPUT

COMPILER WORKFILE

H
;

CAN

;

DISK

;

BUT

REASSIGNED

MUST
THE

WORKFILE

COMPILER

TEMP

;

DISK MUST

BUT

THE

;

i
UNITS

ASG

=TI:1,TI:2

ASG

ACCESS)
DISK

DOES

FILES

NOT

COMPILER MESSAGE

REQUIRE

(SEQUENTIAL

MOUNTED AS
FILES

WRITABLE

TEXT

WRITABLE

NOT

REQUIRE

AVAILABLE

VOLUME,
A

UFD

THE

VOLUME.

ACCESS)
FILES-11
A

UFD

VOLUME,

THE

VOLUME.

FILE

=5Y0:6,5Y0:7,SY0:8
.

=SY¥:9

RESIDENT

MEMORY

FOR

WORKFILE

VIRTUAL

MEMORY

SYSTEM

INCREASING

THE

NUMBER

WMe

RUN

REDUCING

PAGING

I/0,

“e

ASG

TEMP

(RANDOM
SWAPPING

MOUNTED AS

;
;

SOURCE

PROGRAM

WHICH

FASTER
THE

MAXIMUM

RESIDENT

WORKFILE

BUT
CAN

IT
BE

PAGES

DOES

WILL

NOT

MAKE

AFFECT

COMPILED.

THE

COMPILER

SIZE

COMPILER

F77

USES

%o w¢ %o
[T]
¢ wo me

SECTION

"STACK1l"

ANALYZER

STACK

COMMON

DEFINED BELOW,

BLOCK

DEFINITIONS

STACK1l

312(10)

312/8

EXPRESSION

312/6

CONTROL

FOR:

DURING

XTSCT

F77

LATER

WORDS,

PASSES

PROVIDING:

STACK

FRAMES

SECTIONS

CONTROL

SECTIONS
CODE

MAY
AND

USED

DATA,

FOR

LEAVING

COMMON

BLOCKS.

=STACKl:1160

USES
DO

PASS

ANALYZER

COMPILER-GENERATED

We “e

NAMED

CONTROL

BELOW,

60/3
XTSCT

SECTION

STATEMENT

DEFINED

"DOSTK1"

NESTING
DOSTK1l

STACK

FOR:
DURING

60(10)

PASS

WORDS,

NESTED DO/BLOCK

PROVIDING:

STATEMENTS

=DOSTK1l:170

DEFINE

WMy

|II e We Wme

CONTROL

EXPRESSION

FILES

=3840

e ws ws

EXTTSK

TASK-BUILD

F77

PRINTER

DEFAULT

WMo

55
132

WIDTH

VALUES

SOURCE
COLUMN

AND

NUMBER

SOURCE

LINES

PER

LISTING

PAGE

ARE:

LINES PER PAGE
LINE PRINTER

(PLUS

LINES

132(10)

204 (8)

HEADING)

WMy

80(10)

67(8)
120(8)

55(10)

WMe

NOTE:

’

=FORTRN:LPLINE:67
=FORTRN:LPWDTH:
204

G) NS¢~ we w

GBLPAT
GBLPAT
DEFINE

DEFAULT

INDICATES
OBJECT

FILES;

THE
A

VALUE

SUPERCEDE

SHOULD
ALLOWS

BEHAVIOR:

NOT

SUPERCEDE

VALUE

OUTPUT

(DEFAULT)

LISTING

AND

SUPERCEDING,

“e

=COMAND:SUPQ00:0

DEFINITION
A

DESCRIPTION

COMPILER

SWITCH

OPTION

VALUES

EFFECTS

FILE

COMPILER

WMo

BLPAT

OUTPUT

THAT

COMPLETE

SECTION

THE

1.2

THE

PDP-11

THE

COMPILER

FORTRAN-77

OPTION
USER'S

SWITCHES
GUIDE.

SWITCH

NAME

SETTING

VALUE

GBLPAT

/-CK

/CK

ARRAY

/C0:109.

NUMBER

/CO:N,

/-DE
/DE

INCLUDE

DEBUG

/=14
/14

0
1

DEFAULT
DEFAULT

INTEGER*2
INTEGER%*4

/—-LA

REINITIALIZE SWITCHES

/LA

SUBSCRIPT

BOUNDS

CHECKING

coO

CONTINUATION

0
LINES

SWITCH

CONTAINED

LINES

COMPILER

WN
= O

R/W

CODE

SECTIONS

R/0

CODE

SECTIONS

= O

“Ne
NS
NE

/LI:3

SOURCE
SOURCE,

MAP

SOURCE,

MAP,

GENERATED

CODE

/LI:1

/LI:2

/LI:0

TASK-BUILD FILES

/-RO

/RO

/-SP

SPOOLING

/SP

/TR:BLOCKS

/TR:ALL

W
We
NI

/TR :NAMES

/TR

NUMBER

/WF:2

/WF:N

TEMPORARY

FILES

/-WR

OPTIONAL WARNINGS

/WR

F77

/-F77

FORTRAN

INTERPRETATION

/E7T7

FORTRAN

INTERPRETATION

THE

FOLOWING

"GBLPAT"

DEFINITIONS

EFFECT

DEFAULTS

OF:

/-CK/C0:19./-DE/-I14/-LA/LI: 2/-RO/SP/TR:BLOCKS/WF:2/WR/F77

DEFAULT

MNP

WME

MNP

/TR
: NONE

NN WO O

/-TR

VALUES

"GBLPAT"

FOR

SWITCH

GLOBAL

GBLPAT

=FORTRN:LAC0O0:0

GBLPAT

=COMAND:CK(000:0

GBLPAT

=COMAND:C0O000:
23

GBLPAT

=COMAND:DE000:
0

GBLPAT

=COMAND:I4000:0

GBLPAT

=COMAND: LIO000: 2

GBLPAT

=COMAND:RO000:
0

GBLPAT

=COMAND:SP000:1

GBLPAT

=COMAND:TR00O0:
3

GBLPAT

=COMAND:WF000:
2

GBLPAT

=CQMAND:WRO000:1

GBLPAT

=COMAND:F7700:1

" XXII

ARE

VARIABLE

DEFINED

"XXoo0o0".

COMPILER TASK-BUILD

R.3

PDP-11

FORTRAN-77

COMPILER TASK

FILES

BUILD

FILE

FOR

IAS

USING

MCR

(F7711D.CMD)

f11,11r77/CP/-FP/RW/MU, [11,36]F77/SP=[11,36]F7711D.ODL/MP
’

PDP-11

FORTRAN-77 COMPILER TASK BUILD FILE

PDP-11

FORTRAN-77 VERSION

7
[

SYSTEM

SUMMARY OF

;

3,1

VERSION

IAS

USING MCR

PARAMETERGS:

USES SYSTEM RESIDENT LIBRARY "SYSRES"

;
;

24K COMPILER TASK
512 WORD STACK

H
;
;

20
45
12

FRAMES

IN EXPRESSION ANALYZER STACK

FRAMES IN DO/BLOCK IF STATEMENT STACK
COMMON BLOCKS, MAXIMUM
RESIDENT PAGES FOR WORKFILE SYSTEM

OPTION

INPUT

TASK
LIBR

=,..F77
=SYSRES:RO

POOL

=100

i
i

STACK

512 WORDS

F77 COMPILER
w

OUTPUT
OUTPUT

OUTPUT

WMy

INPUT

COMMAND

.0BJ
.LST
.FTN

INPUT

384 WORDS

LOGICAL UNIT ASSIGNMENTS

COMMAND

LESS THAN

=512

STACK MUST NEVER BE

(SEQUENTIAL ACCESS)
COMPILER TEMP FILES
DISK MUST BE MOUNTED AS WRITABLE FILES-11 VOLUME,
BUT THE TEMP FILES DO NOT REQUIRE A UFD ON THE VOLUME.

00 ~J

WMo

(RANDOM ACCESS)
COMPILER WORKFILE
CAN BE REASSIGNED TO SWAPPING DISK IF AVAILABLE
DISK MUST BE MOUNTED AS WRITABLE FILES-11 VOLUME,
BUT THE WORKFILE DOES NOT REQUIRE A UFD ON THE VOLUME.

COMPILER MESSAGE

TEXT FILE

UNITS

ASG
ASG

=TI:1,TI:2
=5Y0:6,5Y0:7,5Y0:8

ASG

=LB0:
9

RESIDENT MEMORY FOR WORKFILE VIRTUAL MEMORY SYSTEM

UNDER IAS WORKFILE RESIDENT MEMORY IS DYNAMICALLY ALLOCATED
BY THE COMPILER BASED ON A PARAMETER SPECIFIED BY "EXTTSK".
THIS VALUE MAY BE OVERRIDDEN AT INSTALL BY "INSTALL F77/INC=NNNN",

; INCREASING THE NUMBER OF RESIDENT WORKFILE PAGES WILL MAKE THE COMPILER
RUN FASTER BY REDUCING PAGING I,/0,

BUT

IT DOES NOT AFFECT THE SIZk

: OF THE MAXIMUM SOURCE PROGRAM WHICH CAN BE COMPILED.

E XTTSK

=3840

F77

CONTROL

USES

EXPRESSION

COMPILER

NAMED

TASK-BUILD

SECTION

"STACKl1"

ANALYZER

STACK

COMMON

BLOCK

FILES

FOR:

DURING

DEFINITIONS

PASS

LATER

DEFINED

BELOW,

STACK1l

312(10)

312/8

EXPRESSION

TM|

PASSES

312/6

CONTROL

USES
DO

CONTROL

BELOW,

60/3
XTSCT

SECTION

STATEMENT

DEFINED

SECTIONS
CODE

MAY
AND

USED

DATA,

FOR

LEAVING

COMMON

BLOCKS.

"DOSTK1"

NESTING
DOSTK1l

STACK

FOR:
DURING

60(10)

PASS

WORDS,

NESTED DO/BLOCK

PROVIDING:

STATEMENTS

=DOSTK1:170

DEFINE

%Ny

[T ~e me

FRAMES

=STACK1l:1160

s we

F77

PROVIDING:

STACK

SECTIONS

COMPILER-GENERATED

EXTSCT

WORDS,

ANALYZER

F77

PRINTER

WIDTH

AND

NUMBER

SOURCE

LINES

PER

LISTING

PAGE

ARE:

VALUES

SOURCE

LINES

DEFAULT

132

COLUMN

LINE

PER

PAGE

(PLUS

LINES

132(10)

204 (8)

HEADING)

PRINTER

80(10)

67(8)
120(8)

55(10)

NOTE:

[

=FORTRN:LPLINE:67

=FORTRN:LPWDTH:
204

e ~s wo we

GBLPAT

GBLPAT
DEFINE

DEFAULT

INDICATES
OBJECT

FILES;

THE
A

VALUE

SUPERCEDE

SHOULD
ALLOWS

BEHAVIOR:

NOT

SUPERCEDE

VALUE

OUTPUT

(DEFAULT)

LISTING

AND

SUPERCEDING.

=COMAND:SUP00:0

DEFINITION
A

DESCRIPTION

COMPILER

SWITCH

OPTION

EFFECTS

VALUES

w»

FILE

COMPILER

BLPAT

OUTPUT

THAT

COMPLETE

SECTION

THE

1.2

THE

PDP-11

THE

COMPILER

FORTRAN-77

OPTION
USER'S

SWITCHES
GUIDE.

SWITCH

CONTAINED

NAME

SETTING

;

————————————————————————————

VALUE

GBLPAT

;

/-CK

/CK

ARRAY

/C0:19,

NUMBER

/CO:N,

/-DE

/DE

SUBSCRIPT

BOUNDS

CHECKING

;

;
7
;

INCLUDE

CONTINUATION

DEBUG

LINES

;

/=14

DEFAULT

INTEGER*2

/14

DEFAULT

INTEGER*4

/—-LA

REINITIALIZE

/LA

;

SWITCHES

;

/LI: 0

;
;

/LI:1
JLI:2

1
2

SOURCE
SOURCE,

MAP

;

/LI:3

SOURCE,

MAP,

GENERATED CODE

TASK-BUILD

[l
]

COMPILER

/-RO

R/W CODE

SECTIONS

R/0

SECTIONS

CODE

= o

/-SP

/SP

SPOOLING

NUMBER

/-WR
/WR

= O

/-F77

J/WF:
2

/WF:N

TEMPORARY

FILES

OPTIONAL

WARNINGS

F77

/ET7

FORTRAN

INTERPRETATION

FORTRAN

INTERPRETATION

THE

FOLOWING

"GBLPAT"

DEFINITIONS

EFFECT

DEFAULTS

OF:

/-CK/C0:19,/-DE/-I14/-LA/LI:2/-RO/SP/TR:BLOCKS/WF:2/WR/F77

WME

DEFAULT

NWE

/TR:ALL

/TR

N
WM

/TR:BLOCKS

/TR :NAMES

/TR :NONE

WHOO

/-TR

WMo

/RO

FILES

VALUES

"GBLPAT"

FOR

SWITCH

GLOBAL

GBLPAT

=FORTRN: LAO0O:0

GBLPAT

=COMAND:CK000:
0

GB LPAT

=COMAND:C0000:
23

GBLPAT

=COMAND:DE000:
0

GBLPAT

=COMAND:I4000:0

GBLPAT

=COMAND: LI000: 2

GBLPAT

=COMAND:RO000:
0

GBLPAT

=COMAND:SP000:
1

GBLPAT

=COMAND:TR000:
3

GB LPAT

=COMAND:WF000:
2

GBLPAT

=COMAND:WR000:1

GBLPAT

=COMAND:F7700:1

IIXX"

ARE

VARIABLE

DEFINED

"XX000".

BE.4

PDP-11

FORTRAN-77

COMPILER

TASK

BUILD

FILE

FOR

IAS

USING

DCL

(F771AS.CMD)

/TASK: [11,1]F77/MAP: [11,36]F77/0OVERLAY: [11, 36]F77IAS/OPTIONS/MULTIUSER/NOFLOATING /CHECKPOINT/READ

WRITE

PDP-11

FORTRAN-77

COMPILER

PDP-11

FORTRAN-77

VERSION

TASK

BUILD

FILE

!
!

IAS

VERSION

3.1

4.0

USING

PDS

SYSTEM

PARAMETERS:

SUMMARY

USES

SYSTEM

RESIDENT

24K

COMPILER

!
!
!
!
!

512 WORD STACK
39
FRAMES IN EXPRESSION ANALYZER STACK
20
FRAMES IN DO/BLOCK IF STATEMENT STACK
45
COMMON BLOCKS, MAXIMUM
12
RESIDENT PAGES FOR WORKFILE SYSTEM

LIBRARY

"SYSRES"

TASK

!
]

OPTION

INPUT

=SYSRES:RO

POOL

=100

ten e Sem pw Pen G fem Gew S b bem bem S S P Gem fem bem [f) S

0= 4

LIBR

STACK

MUST

512

WORDS

NEVER

LOGICAL

UNIT

COMMAND
COMMAND

.LST

COMPILER WORKFILE

(RANDOM

ACCESS)

CAN

SWAPPING

DISK

INPUT
OUTPUT

.0OBJ

OUTPUT
OUTPUT

.FTN

INPUT

DISK
BUT

REASSIGNED TO

MUST
THE

MOUNTED AS

WORKFILE

COMPILER

TEMP

DISK MUST

BUT

THE

TEMP

COMPILER

FILES
FILES

MESSAGE

UNITS

=9
=TI:1,TI:2

ASG

=S5P0:6,S5P0:7,SP0:
8

ASG

=LB0:9

RESIDENT

IAS

THE

THIS

MEMORY

FOR

WORKFILE

COMPILER

NOT

WRITABLE

NOT

TEXT

RESIDENT

REQUIRE

VIRTUAL
MEMORY

INCREASING

THE

NUMBER

RUN

REDUCING

PAGING

I/O,

SOURCE

PROGRAM

WHICH

THE

MAXIMUM

UFD

VOLUME,

OVERRIDDEN

FILES-11
A

MEMORY

PARAMETER

MAY

AVAILABLE
THE

VOLUME.

UFD

VOLUME,

THE

VOLUME.

FILE

VALUE

FASTER

FILES-11

(SEQUENTIAL ACCESS)

WORKFILE

BASED
BE

DOES

WRITABLE

MOUNTED AS

ASG

UNDER

ASSIGNMENTS

COMPILER

WORDS

F77

384

=512

THAN

TACK

LESS

DYNAMICALLY

SPECIFIED

INSTALL

RESIDENT

SYSTEM

WORKFILE
BUT

CAN

ALLOCATED

"EXTTSK".

"INSTALL/INC:NNNN
PAGES
DOES

WILL

NOT

MAKE

AFFECT

COMPILED.

([11,1}1F77".

THE
THE

COMPILER
SIZE

COMPILER

TASK-BUILD

FILES

EXTTSK

=3840

]

F77

USES CONTROL SECTION "STACK1l" FOR:
EXPRESSION ANALYZER STACK DURING PASS 1
NAMED COMMON BLOCK DEFINITIONS IN LATER

!
!

PASSES

DEFINED BELOW,
312/8
312/6

!
!

STACKl

312(10)

WORDS,

39 EXPRESSION ANALYZER
52 CONTROL SECTIONS

UP TO

FRAMES

7 CONTROL SECTIONS MAY BE

COMPILER-GENERATED CODE

PROVIDING:

STACK

AND

USED FOR

DATA,

LEAVING

COMMON

BLOCKS.

]

EXTSCT

=STACKl:1160

F77

]

USES

CONTROL

SECTION "DOSTK1" FOR:
STATEMENT NESTING STACK DURING

PASS

DEFINED BELOW,

60/3

DOSTKl

60 (10)

20 NESTED DO/BLOCK

WORDS,

PROVIDING:

STATEMENTS

EXTSCT

=DOSTK1l:170

!
1

DEFINE

F77

PRINTER WIDTH AND NUMBER

DEFAULT

VALUES

SOURCE

LINES

132

COLUMN

LINE

SOURCE

LINES

PER

LISTING PAGE

ARE:

PER

PAGE

(PLUS

LINES

132(10)

204 (8)

HEADING)

PRINTER

NOTE:

55(10)

80(10)

67(8)
120(8)

]

GBLPAT
GBLPAT

=FORTRN:LPLINE:67
=FORTRN:LPWDTH:
204

DEFINE

INDICATES THAT THE COMPILER SHOULD NOT SUPERCEDE
OBJECT FILES! A VALUE OF 1 ALLOWS SUPERCEDING.

!
G BLPAT

DEFAULT

OUTPUT

FILE

SUPERCEDE

BEHAVIOR:

VALUE

OUTPUT

(DEFAULT)

LISTING AND

=COMAND:SUP00:0

DEFINITION

A COMPLETE

DESCRIPTION

COMPILER

SWITCH

OPTION

VALUES

EFFECTS

CONTAINED

SECTION

THE

1.2 OF

THE

PDP-11

THE

COMPILER

FORTRAN-77

OPTION

USER'S

SWITCHES

GUIDE.

SWITCH

NAME

SETTING

mmameamem e

cmememmmmmmem——

/~CK

/C0:19.
/CO: N,

VALUE
———————

GBLPAT

—_———— ——

ARRAY SUBSCRIPT BOUNDS CHECKING

NUMBER OF CONTINUATION LINES

/~DE
/DE

0
1

INCLUDE

DEBUG

/-14
/14

0
1

DEFAULT
DEFAULT

INTEGER*2
INTEGER*4

/-LA

REINITIALIZE

/CK

!
)

!
!

LINES

)

1
!
1

!
1

/LA

SWITCHES

COMPILER

WN+-=O

/LI:0

/LI:1
/LI:2
/LI:3
RO

/RO

FILES

SOURCE

= o

/-RO

TASK-BUILD

SOURCE,

MAP

SOURCE,

MAP,

GENERATED CODE

R/W CODE

SECTIONS

R/0

SECTIONS

CODE

/=SP

/SP

SPOOLING

/-TR

/TR
: NONE

/TR:NAMES
/TR:BLOCKS
/TR:ALL
/TR
/WF:
2

NUMBER

TEMPORARY

FILES

/WF:N
WR

/-WR

OPTIONAL WARNINGS

/WR
F77

/-F77
/E77

THE

FOLOWING

"GBLPAT"

DEFINITIONS

FORTRAN

INTERPRETATION

FORTRAN

INTERPRETATION

EFFECT

DEFAULTS

OF:

/-CK/C0:19./-DE/-14/-LA/LI: 2/-RO/SP/TR:BLOCKS/WF:2/WR/F77
DEFAULT

VALUES

"GBLPAT"

FOR

SWITCH

GLOBAL

GBLPAT

=FORTRN: LA00O: 0

GBLPAT

=COMAND:CK000:
0

GBLPAT

=COMAND:CO0000:
23

GBLPAT

=COMAND:DEQ0O:
0O

GBLPAT

=COMAND:I4000:0

GBLPAT

=COMAND:LI000:
2

GBLPAT

=COMAND:RO000:
0

GBLPAT

=COMAND: SP000: 1

GBLPAT

=COMAND: TR00O0: 3

GBLPAT

=COMAND:WFQ000:
2

GBLPAT

=COMAND:WR000:1

GBLPAT

=COMAND:F7700:1

ARE

VARIABLE

DEFINED

"XXo000".

INDEX

Disk cartridge installation,

Additional temporary files,
Altering values of compiler
limits, 2-2
Area, dynamic storage, 3-1

3-1

IAS

using

DCL,

7-3

IAS

using

MCR,

6-3

RSTS/E,

minimum
E3
Building

the

F77

7-2
6-2
5-4

RSX-11M/M-PLUS,

Building

the

to
to

A-3

for

A-6

4-3

compiler

task,

to 1-2
minimum for Object Time
tem Library, 1-1 to

compiler,

IAS using DCL,
IAS using MCR,
RSTS/E, 5-2 to

5-3,

RSX-11M/M-PLUS,
Disk storage,

7-3
6-3

D%str%but%on f]'.].?s,
Distribution media,
files on the, 1-3

4-2 to 4-3

IAS using DCL, 7-2 to 7-3
IAS using MCR, 6-2 to 6-3
RSX-11M/M-PLUS, 4-2 to 4-3

Sys1-2

1-4

Dynamic memory allocation,

3-2

types of,

F77 OTS,

1-3

1-1

1-3

RSX-11M without, 3-4
Dynamic storage area, 3-1
size of, 2-2, 3-1 to 3-4

C
Compilation rate,
effects of dynamic storage
area size and device type

EIS (extended instruction set),
Error messages,
default version, 3-5

improving, 3-1 to 3-2
Compiler,
command switch default settings, 2-2
limits, altering values of,
options, 2-2, 3-1 to 3-4

suppressing run-time, 3-8
SERTXT module, 3-6
Experimental data: compiler
performance, 3-3
Extended instruction set (EIS),
3-7

on,

3-1

3-4

2-2

performance, options affecting,
/WF:w

switch,

Compiler,
IAS

3-1

DCL,

EXTTSK option,

3-5

3-6

3-2

3-1

building

using

OTS short version,

3-2

the,

7-2

IAS using MCR, 6-2
RSTS/E, 5-2, A-2
RSEX-11M/M-PLUS, 4-2
Compiler task, minimum disk
storage for,
1-1 to 1-2
Compiler task-build files,
IAS using DCL, B-10 to B-12
IAS using MCR, B-7 to B-9

RSTS/E, B-4 to B-6
RSX-11M/M-PLUS, B-1

to B-3
Computing the size of the dynamic storage area, 3-2

3-7
3-7

F4PMAP,.OBJ
F4PNER.OBJ
F4PNIO.OBJ
F4PRAN,OBJ
F4PRES.MAC
F4P11S.0BJ

3-6
3-8
3-8
3-8
3-8
3-4

module,
module,
module,
module,
module,
module,

3-5

F77IAS.CMD (IAS
piler build

using DCL comfile), B-10

F77TST.FIN test
F7711D.CMD (IAS

using

F77RST.CMD (RSTS/E compiler
build file), B-4 to B-6

program, 8-1
MCR com-

piler build file), B-7 to

D
Default FORTRAN, 2-1
selecting F77 as the,
selecting FOR as the,

F4PCVF.OBJ module,
F4PEIS.OBJ module,

B-9

2-1
2-2

F7711M.CMD (RSX-11M/M-PLUS compiler build file), B-1 to
B-3

Index-1

3-7

INDEX

F77

OTS

options,

Failure

procedure,
PCs-11,

2-2

system

INSTALL command,
IAS using DCL,
IAS using MCR,

2-3

verification

8-2

8-3

2-5

systems,

FCS-11,

2-2

Library,

incorporating
2-2,
to
on

FCS-11

4-2,

6-3,

RMS-11,

Files

4-4,

7-2,

5-3,

RMS-11,

F4PMAP,

5-5,

object module,

6-2

7-4

Library

distribution

2
O

1-1,

media,

M
|

IAS,

Magtape

installation,

IAS
IAS

MCR,

using
using

RSTS/E,

system requirements,
IAS using DCL,

1-2

compiler build file B-10
using DCL installation,

IAS

7-1

disk cartridge distribution,
building the compiler, 7-4
building the 0TS, 7-4
copying the message files,

7-3

compiler,

MCR,

compiler build file B-7
IAS using MCR installation,

6-1

cartridge distribution,
6-3

building the compiler, 6-3
building the 0TS, 6-4
copying the message files,

the

6-4

6-3

0TS,

compiler

9-1

Object

module,
library, 2-1
optional OTS, 3-4
copying to system
using bpcL, 7-2,
copying to system
using MCR, 6-3,
copying to system

files,
options,

IAS

disk,
7-3

disk,

IAS

6-4

disk,

RSTS/E,

5-5

copying

to system

RSX-11M/M-PLUS,
Options,

compiler,

2—2'

oTs,

3-4

2-2,

3-1

disk,
4-3,

4--5

3-43,

OTsS,

building the,
IAS using DCL,
IAS

6-2

copying the message
preparations, 6-1
selecting

A-3

5-3,

selecting compiler options,
6-3
invoking the compiler, 6-5
magtape distribution, 6-1
building the compiler, 6-2
building

release,

7-2

building the OTS, 7-2
copying the message files, 7-3
preparations, 7-1
selecting compiler options, 7-2

preparations,

7-3
6-3

7-5

magtape distribution,
building the compiler,

using

A-1

to
to

RSX-11IM/M-PLUS, 4-1 to 4-3
Message file(s), copying,
IAS using DCL, 7-3, 7-5
IAS using MCR, 6-3, 6-4
RSTS/E, 5-3,
5-5
RSX-11M/M-PLUS, 4-3, 4-5
Modules, optional OTS, 3-4

Notes,

the

5-1,

7-1
6-1

options,

7-3
invoking

DCL,

preparations, 7-3
selecting compiler

disk

storage,

System,

2-2

the

3-6

1-3

IAS

2-6

RSTS/E, 2-6
RSX-11M/M-PLUS,

2-2

file names, 2-3
incorporating, 4-2, 4-4, 6-2,
6-4, 7-2,
7-4
File, compiler work, 2-2,
3-1

File

2-6

using

MCR,

7-2,

7-4

6-2,

6-4

RSTS/E,
5-2,
5-4
RSX-11M/M-PLUS,
4-2,

6-3

IV,

2-1

FORTRAN-77,

2-1

FORTRAN

6-2

Index-2

4-4

INDEX

OTS,

RSX-11M/M~-PLUS

installation, (Cont.)
building the compiler, 4-4
building the 0TS, 4-4
copying the message file, 4-5
preparations, 4-3
selecting compiler options,

(Cont.)

optional object modules, 3-4
options, selecting F-77, 2-2
overlay description files, 3-8
resident library, 3-8
Overlay description files, oTs,

4-4

3-8

invoking the compiler, 4-5
magtape distribution, 4-1
building the compiler, 4-2

building

Pages

for

3-2

Paging

dynamic

work

Partitions

for compilation,

min-

imum,

3-1

1-1,

Per formance,

1-2

enhancing

3-1, 3-2
IAS using DCL,
IAS using MCR,
RSTS/E,

compiler,

3-5

Run-time

error

reporting,

messages,

3-5

2-5

2-4

functions,

3-6

Shareable library, 3-8
Shared global area, 3-8
$SSHORT, 3-5
Short

number

generator alternate
3-8
Release notes, 9-1
Resident library, OTS, 3-8
RMS-11, 2-2
file names, 2-3

module,

incorporating, 4-2, 4-4, 5-2,
5-5, 6-2, 6-4, 7-2, 7-4,
8-3

shared

library,

4-2

3-5

suppressing,

RMS-0TS

RSX-11s,

2-4

Processor-~defined

0TS,

4-2

2-5

RSX-11M/M-PLUS,

Random

the

copying the message file, 4-3
preparations, 4-1
selecting compiler options,

area,

decreasing

activity,

file,

storage

3-8

error-text

module,

3-5

3-6
SHORT.OBJ
Storage,

module,

3-5

compiler task, 1-1,
Object Time System,

3-6

1-2

1-1, 1-2
Storage area, dynamic, 3-1
Switch default settings, compiler
command, 2-2
System build verification, 8-1
System requirements,
IAS,
1-2
RSTS/E,
1-2

RSTS/E,

compiler build file, B-4
system requirements, 1-2
RSTS/E installation, 5-1

RSX-11M,

1-1

RSX-11M-PLUS,

disk cartridge distribution,

5-2'

System

1-1

tailoring,

3-1

A-3

building the compiler, 5-2, A-4
building the 0TS, 5-2, A-4
maghetic tape installation, 5_1’

A=2

Temporary file,
additional, 3-2
work file, 3-1

system requirements, 1-1
without dynamic memory allocation, 3-4

A-1

building
building

the compiler,
the 0TS, 5-2,

5-'2’

A-2

Test program,

RSX-11M,

RSX-11M/M-PLUS,

compiler build file, B-1
system requirements, 1l-1
RSX-11M/M~-PLUS installation,
4-1

disk cartridge distribution,

4-3

UFD files,
(1,21, 1-3
(11,3631, 1 -3
(11,371, 1 -3
[11,40], 1 1-4

Index-~3

system build,

8-1

INDEX

Verification,

/WF:w

system
Version,

Work file, 2-2, 3-1
device, 2-2, 3-1,

build, 8-1
previous, 2-3

Index~-4

compiler

switch,
3-4

3-1,

3-2

PDP-11 FORTRAN-77

Installation Guide/Release Notes
AA-K503B-TC

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 user/reader that you most nearly represent.

] Assembly language programmer
[]

Higher-level language programmer

(1
[

Occasional programmer (experienced)
User with little programming experience

(]

Student programmer

(]

Other (please specify)

Date

Name
Organization
Street

City

State

Zip Code
or Country

I
I

|
—

—

DoNotT
Fold earHereand Tape —

—

No Postage

Necessary
if Mailed in the

United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 MAYNARD MASS.

POSTAGE WILL BE PAID BY ADDRESSEE

BSSG PUBLICATIONS ZK1-3/J3-5
DIGITAL EQUIPMENT CORPORATION
110 SPIT BROOK ROAD
NASHUA, NEW HAMPSHIRE 03061

—

DoNotTear-FoldHere

—

Cut Along Dotted Line