Digital PDFs

AA-M229A-TM

May 1982

181 pages

Original

7.4MB

view download

OCR Version

6.5MB

view download

Document:	AA-P229A-TM KL Inst 5.1 Dec82
Order Number:	AA-M229A-TM
Revision:	0
Pages:	181
Original Filename:	AA-P229A-TM_KL_Inst_5.1_Dec82.pdf

OCR Text

TOPS-20
KL Model B
Installation Guide
AA-M229A-TM, AD—-M229A-T1

December 1982

This manual describes the procedures for installing TOPS-20
Version 5.1 on a new system and updating TOPS-20 software
on an existing KL10 Model B system.

This update supersedes the information contained in the
manual numbered AA-M229A-TM. Please read it in its entirety.

OPERATING SYSTEM:

TOPS-20, V5.1

RSX-20F, V14-45E

SOFTWARE:

KLINIT, V12-27

Microcode, V275

Software and manuals should be ordered by title and order number In the United States. send orders
10 the nearest distribution center. QOutside the United States. orders should be directed to the nearest
DIGITAL Field Sales Office or representative.

Western Region

Northeast/Mid—Atlantic Region

Central Region

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

Digital Equipment Corporation
Digital Equipment Corporation
Accessories and Supplies Center Accessories and Supplies Center
632 Caribbean Drive
1050 East Remington Road
Sunnyvale. California 94086
Schaumburg, lllinois 601395
Telephone:(312)640-5612

T.1ephone:(408)721-4915

digital equipment corporatione marlooro. massachusefts

First Printing, April 1982
Updated, December 1982

The information in this document is subject to change without notice and should
not be construed as a commitment by Digital Equipment Corporation. Digital

Equipment Corporation assumes no responsibility for any errors that may
appear in this document.

The software described in this document is furnished under a license and may
only be used or copied in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment
that is not supplied by DIGITAL or its affiliated companies.

The following are trademarks of Digital Equipment Corporation:

dligliltlall

DEC

MASSBUS

UNIBUS

DECmate

PDP

VAX

DECsystem-10

P/OS

VMS

DECSYSTEM-20

Professional

DECUS

Rainbow

Work Processor

DECwriter

RSTS

DIBOL

RSX

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

documentation.

CONTENTS

PREFACE

INTRODUCTION

.
.
.
L}
.
.
.
.

SYSTFM

SPOOLING

.«

TOPS-20

FILE

SYSTEM

TOPS-20

SOFTWARE

DECSYSTEM-20

PACKAGE

for

STARTING

THE

MONITOR

CREATING

SYSTEM
DUMPER

DIRECTORIFS
FROM

RESTORING

TOPS-20

TAILORING

THE

TAPE

BUNDLED

SOFTWARE

TOPS-2C

THE

SYSTEM

CREATING

SYSTEM

MONITOR
NAME

DEFAULTS

Speeds

Setting

Terminal

Dial-Up

Defining
Defining

System Logical Names
Magnetic Tape Logical

Defining

Line

(Remote)

Printer

Validation

.
.

Llnes

Unlt

Numbers

Parameters
.
.

.
.

Performance Improvements
Scheduler Controls .
.
.
.
.
File Archiving and Migration
Drive

5-1- CONFIG CMD

Defining

Accounting

TAPE

.
.

Parameters

Allocation

Shift

Changes

CHANGING

THE

OPERATOR'S

CREATING

PS:<REMARKS>

CFEEATING

THE

BUILDING

1ii

DIRECTORY

LPFORM.INI

FRONT-END

PASSWORD
FILE

FILE

AND

USER

STRUCTURE

GROUP

SELECTING

Tape

FROM

SYSTEM

CHANGING

Account

Installatlon

Starting the TOPS-20 Monitor
TOPS-20 FILE SYSTEM

THE

Defining the Local Time Zone
Directory Parameter Setting

= O

and

HEEHEEHEWOW
OO
W

.
.

the

INITIALIZING

RUNNING

w
.
[
.
.
L]
[]
L
.
L]
.
A WWWWWWwWwWwwww
WwWwww N+~

TOOLS

[

THE

Preparing

MONITORS

AND

CHECKING

BATCH

INSTALLATION

N
W

b
= b

THE

TOPS-20

DN
OO NN
.
.
[]
s
&
8
L]
AU
WN)

INSTALLATION
THE

THE

.
SO

CHAPTER

CONTENTS

FOR

CREATING

WWWWWWwWwWwwWwWwWwwWw
www www ww

CHAPTER

PREPARING

SUMMARY

=
DWW

[]

CHAPTER

CONTENTS

HALTING THE TOPS-20 MONITOR
. . . . .
RESTARTING THE FRONT-END MONITOR . . .
COPYING FILES FROM FLOPPY DISK TO RPO4

CREATING

CHAPTER

THE

(Cont.)

FRONT-END

CHAPTER

RESTARTING

THE

CHAPTER

INSTALLING

TOPS-20

CHAPTER

RUNNING

THE

TESTING

SOFTWARE

APPENDIX

UPDATING

SYSTEM

OR RP06

.
.
.

4-1
4-2
4-3

1-5

SYSTEM

DISTRIBUTION

TOPS-20

THE

FILE

UETP

AND

UPDATE

TAPES

PACKAGE

DECSYSTEM-20

TOPS-20

VERSION

5.1

Renaming the Version 5 Monitor . .
Creating the File <KNEW-SYSTEM>5-1- CONFIG CMD
Changing System Parameters . . . .
. « « .
Setting a User Group for the Operator
.
« .

.
.
.
.

A-12
A-13
A-14
A-14

.
.

A-20
A=-21

W N

.
L .]

b b

INSTALLING

SOFTWARE

MAKING

THE

MAKING

POCKET

APPENDIX

TAILORING

W
R
oL
~

.
.

.«
PRIMARY

A-24

A-25

THE

VERSION

5.1

MONITOR

THE

PERMANENT

INSTALLATION

YOUR

s
4

GUIDE

SYSTEM

FOR

e
o

THE

e
o

o
«

e
o

DECSYSTEM-20

ARPANET

DEFINING THE HOST NUMBER . . . . ¢ v « « « «
Entering the Host Number, Name, and Other
Pertinent Information
.
. . . . . « « « «

INTRODUCTION

TAILORED
.

A-1

.
.

MONITOR

«
.

GENERATING

D
vBvivhvivlwiw)

APPENDIX

Program
5.0 .
.

5.1

SOFTWARE

THE

APPENDIX

5.1

VERSION

MONITOR

C .1

VERSION

Running the CNVDSK
REVERTING TO VERSION

MONITOR

C. 1 .1

THE

BATCH

AND

SPOOLING

C-1

C=2

SYSTEM

<«

e
.

+
.

e+
.

e«
.

e
.

e«
.

e
.

+
.

e«
.

D=
D-

ASSEMBLING THE NEW GALAXY SYSTEM .
.
SHUTTING DOWN THE OLD GALAXY SYSTEM

.
.

STARTING

+«

RESTORING THE GALAXY FILES
RUNNING THE GALGEN PROGRAM

THE

NEW GALAXY

MAKING

YOUR

NEW

GALAXY

SYSTEM

THE

D-1
D-1

D-1

PERMANENT

o«

D-19

Index-1

INDEX

CONTENTS

(Cont.)

FIGURES

FIGURE

2-1

DECSYSTEM-20

and

Front-End

Control

Panels

DECSYSTEM-20

TABLES

TABLE

Maximum
Terminal

Structure
Line

Size

Numbers

DECSYSTEM-20 Line Printers .
System Reload Abbreviations
Optional

Software

Products

PREFACE

This

manual
1.

for

the

Install

the

Update

the

person

TOPS-20

who

has

the

software

TOPS-20

responsibility
a

new

software

to:

DECSYSTEM-20.

system

existing

DECSYSTEM-20.

use

this

TOPS-20.
TOPS-20

You

manual
You

User's

not

Guide

have

experience

effectively,

should

also
and

know

the

read

familiar

TOPS-20

assembly

1installing

first

become

the

Operator's

language

TOPS-20

Getting

with

system,

have

Chapters

recovery

procedures,

software

system.

Appendix

Version

After

the

through

contains

you

Appendix

software
either

Appendix

how

both

the

set

instructions,

install

with
error
Version 5 TOPS-20

how

update

5.
Chapters

ready

installation

new

describing

Version

steps

system

are

Manual

instructions

system

your

pocket

This

step-by-step

describing

step-by-step

TOPS-20

complete

steps

contain

the

although

helpful.

Contents

With
in

Guide.

programming

software

Started

information

for

gquide

through

timesharing.

for

the

experienced

installer.
This
installation, but
in
this appendix

appendix contains the text and output from a sample
does not cover error recovery procedures.
The steps
are keyed to the body of this manual so that you can

easily

complete

refer

Appendix
ARPA

describes

the

description

procedures

for

any

step.

tailoring

your

agenerating

system

for

the

network.

Appendix

contains

the

procedures

for

tailored

batch

system.

The

commands

accurately,

verify

that

Remember

you

must

all

you

your

actual

that

type

have

systems

are
do

terminal
differ

printed
perform

in
the

output

resembles

memory

size

and

that describe configuring memory, initializing
packs,
and
assigning logical unit numbers to
to

type

the

values

that

are

RED.

correct

parameters.

vii

for

your

indicated

the

you

type

function

and

sample

peripherals,

line
tape

system

output.
so

steps

printers and
disk
drives require you
and

not

the

sample

If your terminal output does not resemble
the
sample
output,
first
read
ALL
the
instructions
after
the word "Error", then choose the
recovery

procedure

that

corrects

your

problem.

NOTE

The version and
edit
numbers
1in
this
manual
could
differ
from
the numbers
printed on your console
terminal.
The
numbers
printed on your console must be

equal
this

Time

estimates are

to or greater

than

the numbers

included

that you

know about

takes.
Times are estimated to the nearest minute,
step takes somewhat longer or shorter than this.
Checking

off

each

1in

manual.

step

you

complete

how

1long

step

so don't worry if a

a good way

keep

your

place.

Symbols

CTRL:

Used

in This Manual

Indicates where you type a control backslash.
This is
done
by
holding down the CTRL key while typing a backslash.
The
backslash key is located near the key
1labeled
LINEFEED
or
LF.

ESC

Indicates where you
PREFIX,

RET

ALT,

Indicates

where

press

the

key

1labeled

ESC,

ESCAPE,

ALTMODE.

you

press

Reference

the

RETURN

key.

Documentation

The following manuals are valuable as references
for
wusers
of
this
manual.
Their
order
numbers
are
also
shown.
These manuals are
included

the TOPS-20

Manual

TOPS-20 Commands
TOPS-20

Software

Notebook

Set.

Title

Order

Reference Manual

AA-5115B-TM

EDIT Reference Manual

TOPS-20 Monitor

Calls

No.

AA-5415A-TM

Reference Manual

AA-4166E-TM

TOPS-20 Operator's Guide

AA-4176D-TM

TOPS-20 OPR Command

AA-H600A-TM

TOPS-20

Language Reference Manual

System Manager's

TOPS-20 User

Guide

AA-4169F-TM

Utilities Guide

AA-D850A-TM

TOPS-20 User's Guide

AA-4179C-TM

viii

CHAPTER

INTRODUCTION

Installing the TOPS-20 software on the DECSYSTEM-20 is not a hard
if you follow the procedures outlined in the following chapters.

1.1

SUMMARY

Chapter

describes

CONTENTS

explains

the

task

some

tools you

need

the

procedures

install

the

follow.

software.

also

Chapter 2 describes powering up the
DECSYSTEM-20
and
obtaining
the
DECSYSTEM-20
front-end
monitor
from floppy disk.
This chapter also
describes loading the TOPS-20 bundled software from magnetic tape.
Chapter 3 describes how to select
the
proper
monitor,
declare
the
system
name,
and
change
the
system defaults for terminals, system
devices, accounting, performance improvements, scheduler controls, and
file

archiving

and

migration.

Chapter 4 describes how to create the front-end file
system
for
the
DECSYSTEM-20
and
copy files into it from the floppy disk.
Upon your
completion of this chapter, the installation is complete.

Chapter

5 describes how to boot

the system from disk.

Chapter 6 describes how to install any additional
software
you
have
purchased.
This
software
may be software for unbundled products or
periodic

updated

software.

Chapter 7 describes how to run the User Environment Test Package
program).
This program performs a cursory check of the system.

(UETP

Appendix A contains step-by-step instructions and pointers to
various
chapters
within
the
manual,
describing
how
to update a Version 4
TOPS-20 software system to a Version 5 TOPS-20 software system on
the
DECSYSTEM-20.

Appendix
B
1s
a
pocket
installation
guide
for
the
experienced
installer.
It contains the text and output from a sample installation
of the TOPS-20 software on a DECSYSTEM-20, Model 2060.
This
appendix
does
not
have error recovery procedures.
The steps are keyed to the
steps within the body of this manual that describe how to install
the
TOPS-20

software

DECSYSTEM-20.

Appendix C contains the steps for

tailoring your system for

the

ARPA

network.

Appendix D contains the steps for
(Galaxy)

system tailored

generating

for your particular

1-1

site.

batch

and

spooling

INTRODUCTION

The TOPS-20 System
manage
a
TOPS-20
this manual before

Manager's Guide contains helpful hints
on
how
to
timesharing
system.
A system manager should read
making timesharing generally available to users.

NOTE

Before

starting the
installation,
1listing
1labeled
TOPS20.BWR,

the

accompanies
TOPS20.BWR
software

this

1.2
A

PREPARING

DIGITAL

FOR

Field
and

Before

leaves,

The
and

software.

describes

too

late

for

Representative
vyou

obtain

channel,
whether
RPO6,

the

inclusion

when

the

will

system

following

install
runs

your

DECSYSTEM-20

diagnostics

correctly.

information:

unit, and controller number of each disk
drive,
it
1is
dual-ported.
The controller number for
and

drives

processor.
same
unit

RP0O7

1is

-1.

RP20

are

connected

The

procedures

are

installing

this

the

manual

both

Channel

Unit

drives

have

the

CPU

and

the

front-end

that

the

software

unit

Unit

which

Drives
#

dual-ported drives with the
to the front-end processor.

assume

front-end

Disk

disk

The unit number is located on
The DECSYSTEM-20 dual-ported

It 1is an error if two
number
are connected

you

Type

INSTALLATION

different
controller
number.
the display panel on the drive.
disk

The

changes

manual.

inform

RP04,

made

Service

hardware

your
file

read
which

Controller

Dual-Ported

INTRODUCTION

A list of line numbers and line speeds.
Use these numbers in
Section
3.3.1
when
you
set
the
default terminal speeds.
Also, find out which lines are remote so that you can
define
the

remote

lines

described

Section

3.3.2.

Lines
Auto

Line

Speed

Auto

Remote?

Line

Speed

Remote?

NOTE

The word Auto over the word Speed declares
line
1is
specified
as
an
autobaud line
3.3.2.

that
the
in Section

INTRODUCTION

The serial number of each magnetic
tape
drive.
Use
these
numbers in Section 3.3.4 to define magnetic tape logical unit
numbers.
The number appearing on
the
thumbwheel
does
not
necessarily
correspond
to
the
1logical
unit number of the

drive.
Magnetic

Serial

Type

Serial

Tapes

Type

Serial

Type

NOTE

The

serial

are

made

the

numbers on
of three

RH20

two-digit

channel

tape

channel

number

would

TU70 and/or
TU71
tape
factors.
These factors

number,

unit
is

the

number.
the

DX20

drives
consist

number,

Assuming

that

serial

number

for

RH20

channel

and

the

RH20

tape

unit

the

first

follows:

2003

above

example,

the

digit

the

(2),

the

DX20

number

and

last

two

digits

the

(03).
found

The
on

serial

the

back

are

the

tape

number

for

tape

drive.

each

1line

the

The unit number and type of
information in Section 3.3.5

Line

second

TU72

tape

digit

number

drive

can

printer.

initialize

(0),

wunit

the

Use

line

Printers
Programmable

Unit

Model

Lowercase

VFU

this

printers.

INTRODUCTION

1.3
You

INSTALLATION
need

the

TOOLS

following

tocls

install

the

TOPS-20

software

DECSYSTEM-20:

The

RSX-20F

System

used

the

central

System

Floppy

boot

Floppy

The

files

processor

from

this

floppy

RP04

are

RP06

disk

floppy

are

pack.
The

RSX-20F

used
for various functions
software on a DECSYSTEM-20.

The

the

floppy

contains

the

The TOPS-20
tape.
When

V5 Installation Tape and the TOPS-20
installing the TOPS-20 software on a

number

2060

should

using

This

maintaining

System
file.

you

this

and

The RSX-20F
RSX-20F map

model

Floppy

files

installing

DECSYSTEM-20

software

package

Distribution
DECSYSTEM-20

model

number

QT023,

which

the

Installation

Tape

labeled

TOPS-20

2060

the

Distribution

Tape

labeled

TOPS-20

2060

DIST.MT

The

TOPS-20

2040S,

2060,

systems

The

Installation

contains

files

this

the

Tape

TOPS-20

tape

for

monitor

TOPS-20

monitor

(SAVE

The

TOPS-20

command

processor

The

DLUSER

The

DUMPER

Four

program

(SAVE

(ASCII

file)

program

(SAVE

data

DUMPER

format

for

savesets

the

INSTL.MT

and

VS5

and

V5.
and

ARPANET

programs.

are:

The

DLUSER

20408,
contains

format)
(SAVE

format)

recorded

following

format)

1600

bpi

DUMPER

directories:

PS:<SYSTEM>
PS:<SUBSYS>
PS:<UETP.LIB>
PS:<GALAXY-SUBSYS>

The TOPS-20 Distribution Tape for all DECSYSTEM-20s
contains
the
TOPS-20
bundled
software.
There are four DUMPER save
sets recorded at 1600 bpi in DUMPER format.
The contents
of
the

savesets

are:

Saveset

Savesets

build

contains
2

the

<SUB5YS>,

through

documents
4

software
except

for

about

the

software.

contain

source

1in

directories

the

monitor

and

files
the

needed

and

TOPS-20

command

processor.

If
you
are
installing
the
TOPS-20
software
on
a
DECSYSTEM-2040S
or DECSYSTEM-2060 that contains an RP20 Disk
Subsystem,

containing

you

the

should

microcode

receive

necessary

DX20

boot

microcode

the

DX20.

tape

INTRODUCTION

A separate
purchased.

you
have
each optional software product
6 describes the format of these tapes.

tape for
Chapter

NOTE

The term "bundled software" refers to the
contents
of
the
Installation
and
Distribution
tapes
considered together, or
to
the
<contents
of
the
Distribution
tape
alone.
The
term
"unbundled

software"”

refers

disk

packs.

tapes

Formatted
ask

for

1.4

to the

contents

Chapter

your

disk

packs

the

are

wvarious

not

formatted,

your DIGITAL Field Service Representative to format

them

you.

THE TOPS-20

S5ix monitors
DECSYSTEM-20

described

MONITORS

V5
software
for
TOPS-20
are distributed with the
They are:
Models 2040S, 2060, and ARPANET systems.

the

2060-MONBIG.EXE
2060-MONMAX.EXE
AN-MONSML.EXE
AN-MONMED.EXE
AN-MONBIG.EXE
AN-MONLGE.EXE

All

the

monitors

the

monitor

mentioned

above

are

described

installation will proceed more smoothly if you

1.5

THE

vou

BATCH

want

AND

Chapter

The

use.

SPOOLING

Your TOPS-20 software system
batch
and
spooling system.
system,

take time now to decide

SYSTEM

initialization
If you need a

first install the standard system;
of
this
manual for instructions on how to
batch and spooling system.

includes

standard

Galaxy

special batch and spooling
then refer to
Appendix
D
build your own specialized

CREATING

This

chapter

describes

CHAPTER

THE

TOPS-20

FILE

SYSTEM

create

new

TOPS-20

how

file

system

the

Check

DECSYSTEM-20.

STOP:

These

ycu

Procedures

the

are

Install

procedures

1installing

scftware

new

this

New

chapter

TOPS-20

system,

System
if

Version
if

you

are

creating
a
new file system on a set of
disk packs.
Use Appendix
A
to
update
from
TOPS-20
Version
4
to
Version 5
scftware

2.1
The
be

CHECKING
TOPS-20
sure

THE

TOPS-20

software

that

you

all

existing

SOFTWARE

System

Floppy

RSX20F

System

Floppy

RSX20F

System

Floppy

TOPS-20

Installation

TOPS-20

The

rest

DX20

Microcode

separate

Chapter

tapes.

tape

following

items.

Tape
of

this

text,

this

tape

Customer

only)

referred

tape.

Distribution

Chapter 6
format of

magnetic

the

them.

RSX20F

Installation

system.

PACKAGE

contains

the

and

package

have

Throughout

Refer

for

Tape

(RP20

each

optional

software

lists the optional software
the tapes, and tells how to
Section

1.3

for

the

product

purchased.

products, describes
install them.

contents

the

floppy

the

disks

CREATING THE TOPS-20

FILE

Preparing the DECSYSTEM-20 for

2.1.1

SYSTEM

Installation

Prepare the system for installation by powering it up and mounting the
disk

packs.

I’ Step 1:

Read the Listing Labeled TOPS20.BWR.

last-minute
any
learn about
Read the listing labeled TOPS20.BWR to
changes made to the installation procedure or to the TOPS-20 software.

Ask Your DIGITAL Field Service Representative

l} Step 2:

Packs Are

the

Disk

Formatted.

are
packs
disk
Ask your DIGITAL Field Service Representative if the
to
him
ask
not,
are
they
If
DECSYSTEM-20.
the
with
use
for
formatted
The
You cannot use the RP20 for the system structure.
format them.
packs must be formatted before you proceed

I)'Step 3:

further.

Power Up the System.

the
Turn on the power by pressing the POWER switch if the light under
(Do not touch the
off.
1is
operator's panel
the
POWER on
word
the
emergency power switch unless you see smoke or sparks coming from
The system is ready after a few seconds, and the power light
system.)
comes

on.

Be sure that

the system is completely powered on:
the disk

drives.

Check

the
press
If power is off,
Check the magnetic tape drives.
i.e., the white switch containing the ON/OFF
switch,
rocker
If you have trouble with the disk
light, on the front panel.
your DIGITAL Field
call
tape drives,
magnetic
or
drives
Service Representative

Be sure that

Turn on the console terminal.
has

l"Step 4:

assistance.

or
LP20A
an
for
1If power is off
Check the line printers.
LP20B printer (which has four buttons on the right of the top
The
panel), reset the knee-level breaker on the lower panel.
If you have an LP20F or
disregard it.
TAPE light may be on;
of
LP20H printer (which has four rocker switches on the left
cover just above the lights and
the
1lift
panel),
top
the
reset the breaker.

for

the printer has paper.

Be sure that it is on line and

paper.

Label the Disk Packs.

This manual contains

the procedures

for creating the system

structure

The system structure name can be up to six
system.
for your
The
system.
the
run
to
needed
characters and contains the files

If the system
drives.
disk
RP20
include
cannot
system structure
system must
file
front-end
structure is on an RP07 disk drive, the
how many
Decide
drive.
disk
dual-ported
RP06
or
RP04
a
reside on

packs you
numbers,"
referred

unit
"logical
them consecutive
and assign
will have,
pack numbers
1logical
the
are
These
0.
with
starting

Step

25.

CREATING

Identify
pack
is:

each

pack

with

TOPS-20

Disk

Pack

Logical

gummed

ID:

TOPS-20

writing

cover

Structure

THE

these

label.

structure

Unit:

FILE

SYSTEM

numbers

with

sample

the

felt-tip
format

pen
the

the

label

name

CAUTION

not

use

gummed

~the pack 1tself,

off

and

cause

label

the

surface

because 1t can spin

severe

damage

the

drive.

mp Step 5:

Mounting an RP04 or RP06 Disk Pack.

Mount the disk packs on the proper drives.
RP04 and RP06
disk
packs
are similar in appearance but can be distinguished by the name RP04 or
RP06 written on the upper surface of the pack.
Make
sure
you
place
one
pack
on
the drive that is unit 0, dual ported, and connected to
the front-end.
The installation procedure stores the
files
used
by
the
front-end
on this pack.
After the installation is complete, you
may dismount the disk packs so that the
drives
can
be
<cleaned
and
maintained.
However, during system operation, the pack that contains
the front-end files must be on dual-ported drive 0 as
it
was
during
installation.
Be careful when mounting a disk pack because the drive
shaft
can
be
damaged if the pack is jammed off center into the drive.
Follow these
instructions when mounting a pack:

NOTE

RPO7

and

RP20

disk

packs

are

non-removable.

another

RP04

and
spinning,
drive stops.

the

RP06

already mounted

START/STOP

the

Pick

down over

drive

until

Lift the pack
bottom cover.

pack

cover

the

pack

on
wait

Turn the cover handle counterclockwise a few turns
until
it
turns
freely.
Gently lift the pack vertically.
1If there is
any
resistance,
turn
the
handle
a
few
more
turns
counterclockwise and lift again.

cover

the

and

out
Be

slide

button

Push

back;

disk

the

bottom

door

press

pack.

of the drive and place it on the protective
sure that the cover clicks closed.
to

mounted

squeezing

the

and

handle

remove
of

the

protective

bottom

cover.

pack
without
removing
the
be unable to use or remove the

bottom
pack.

CAUTION

If you
cover,

insert a
you will

2-3

CREATING

THE

TOPS-20

FILE

SYSTEM

Gently lower
the
pack
vertically
into
the
careful
not
to
hit
the sides of the drive.
centered in the drive while lowering it.

drive,
being
Keep the pack

Turn the handle clockwise about two
full
turns.
You
will
feel
a
resistance
roughly equal to the power steering on a
car.
When the resistance increases noticeably, stop
turning
or damage will result.

Lift

Start the drive by pressing the START/STOP button.
The
disk
is
ready
to
be used when the READY light comes on.
(On an
RP06 the DOOR LOCKED light ensures that the disk
1is
mounted

off

the

cover

door

vertically.

the

drive.

properly.)

10.

sure

labeled

that

the

WRITE

drive

PROTECT

not

write

must

off.

protected.

The

switch

drive
SELECT

0
is
switch

CAUTION

Do not leave a
disk
pack
or
magnetic
tape
on
top
of
a
disk
drive.
The
vibration from the drive can cause these
items
to
fall
to
the
floor, causing
expensive and irreparable damage.

B Step 6:

Check the CONTROLLER SELECT Switches.

Be sure that the CONTROLLER SELECT switch
set to A/B and that every other drive has

set

to A.

change

the

on dual-ported
the CONTROLLER

CONTROLLER SELECT

switch,

set

the

switch

the
desired
position
and
press
the STOP button to cycle the drive
down.
When the drive has stopped spinning, press the START button and

wait

for

’Step 7:

the

READY

light

come

on.

Mount System Floppy A in Drive 0.
CAUTION

Make

sure

disk

floppy

damage
drive.

Place

the

floppy

System

in the
floppy
the

disk

Floppy

left floppy
disk
with

label

until
until

it
it

facing

contacts
clicks.

that

sometimes
not

the

sticking

disk.
the

paper

included
to

Failure

floppy

disk

directory

with

the

back

and

the

that

floppy
of

the

so will

floppy

labeled:

drive
your

thumb

upward,

slide

the

(drive

back

0).
To mount
the label.

the

floppy

drive

disk

and

floppy disk,
with your

Then

into

stops.

the

Press

hold
thumb

floppy

down

the
and

drive

the

bar

CREATING

I} Step 8:
In

the

THE

TOPS-20

FILE

SYSTEM

Mount System Floppy B in Drive 1.
right

System

floppy drive
Floppy

(drive

1),

place

the

floppy disk

labeled:

HINT

sure

that

you

disks in the
will develop

l"Step 9:
Remove

the

mount

lowest

mounted

drives,
12.

the

floppy

problems

Mount the Installation Tape on MTAOQ:.
write

TOPS-20

and

have

correct
in Step

ring

(if

Installation

the

present)

drive

the

lowest

Your DIGITAL Field Service
If
you
cannot
determine
drives are off line except

the

magnetic

the

tape

labeled:

Tape

tap=s

channel

from

Drive

TM03,

TMO2

1lowest

controller

Representative gives you
which drive is drive 0,
the one you want to use.

unit

DX20

this
make

the

controller.

information.
sure that all

NOTE

Be sure to mount the correct version
of
the Installation tape.
Refer to Chapter
1,
Section
1.3
for
the
correct
Installation tape for your system.

CAUTION

The logical
tape
drive

numbered

unit
1s

number for
a
magnetic
not
determined
by the

thumbwheel
on the

left

side

TU45 drives.
The numbered thumbwheel is
the slave number of
the
drive.
Never
change the setting of this thumbwheel.

To mount
1.

tape

Place

the

reel

the

tape

facing

Lock

the

reel

the

TU45
top

tape

drive:

hub with

the

labeled

side

the

you.

reel

the

hub

pressing

the

rocker

the

center

hub.

Thread the tape through the slot in
by
following
the
arrows.
Move
easier access to the tape slot.

Wind

the

tape

one

turn

clockwise

front of
the head

onto

the

the
tape
heads
shields back for

take-up

reel.

CREATING

Press

the

LOAD

THE

TOPS-20

button.

The

take-up
reel and moves to
I1f the
drive
overshoots
repositions itself.
6.

Make
ON

mount
1.

sure

LINE

reel

the

LINE

SYSTEM

tape

the
the

button

slowly

advances

onto

logical beginning of
beginning
of
the

lit;

1if

the

the tape.
tape,
it

not,

press

the

button.

tape

TU77

Place the reel of tape on
of the tape facing you.

FILE

Lock the reel
the hub.

the

hub

TU78

the

tape

top

drive:

hub

pressing

with

the

labeled

rocker

the

side

center

Press, in order, the RESET and LOAD
buttons.
The
tape
1is
wound
counterclockwise a few turns.
Then the tape leader is
threaded
automatically
through
the
slot
near
the
wupper
right-hand corner of the drive, and the tape is positioned at
the logical beginning of tape.

4.,

Press

the

LINE

button.

Cn completion, the LOAD, ON LINE, and FILE PROTECT (FPT) lights should
be
on, indicating that the tape is positioned at the beginning.
When
the FILE PROTECT 1light is on, the system cannot write on the tape.
1If
the

FILE

the

mount

PROTECT

1light

not

tape

on,

remove

the

write

ring

from

the

reel

Place

side

TU72

tape

drive:

the reel of tape on the
of the tape facing you.

rightmost

with

the

Press, in order, the RESET, LOAD,
and
START
buttons.
tape leader 1is threaded automatically on the take-up reel
the tape is positioned at the logical beginning of tape.

and

Starting

To create the TOPS-20 file
monitor
into
the
system
routine.
Perform steps 10

the

TOPS-20

slot
until
the read/write

labeled

Thread
the
tape
leader
approximately three inches

down
the
in front of

hub

2.1.2

back

tape.

it
is
head.
The
and

Monitor

system,
vyou
need
to
1load
the
TOPS-20
and
start
the file system initialization
through 19 to load and
start
the
TOPS-20

monitor.
1.

Load

the

front

Use

front-end

end

the

monitor

initialize

front-end

Bootstrap
central

monitor

(MTBOOT)

from

the

central

load

program

from

floppy

disks.

processor

the

and

TOPS-20

System

Use

the

memory.

Magnetic

Floppy

Tape

into

the

processor.

Use MTBOOT to
into memory.

load

Use

start

MTBOOT

initialization

the

routine.

TOPS-20

monitor

from

the

magnetic

file

tape

system

CREATING

l"Step 10:
Open

TOPS-20

FILE

SYSTEM

Place the Front-End HALT Switch in the ENABLE Position.

the

under

THE

second
the

door

from

the

left

DECSYSTEM-20

control

the

HALT

side

the

©panel,

+to

switches.
Be

sure

that

front-end

(Figure
2-1).
If
the ENABLE position.
the

front

end

BStep 11:
The

will

Set

not

control

them

the

front

000007

panel

has

from

the

switch

floppy

front-end

initialization dialog.
This
central processor

Hold

(octal)

configures

»Step 12:

front-end

the

ENABLE

position

(octal).
register

setting

switches

(Figure

and

down.
(Refer to Part 4, Chapter 1 of the
a detailed description of all switches.)

end

causes

the

operate.

000007

and leaving the rest
Operator's Guide for
Booting

directly

access

the switch is in the HALT position, move it up to
When the HALT switch is in
the
HALT
position,

Set the Switch Register to 000007

front-end

2-1).

switch

DECSYSTEM-20,

disk

with

monitor

loads

the

the
run

central

switch
the

central

processor

up,

TOPS-20

set

processor

microcode

and

memory.

Hold ENABLE and Press the SWITCH REGISTER Button.

ENABLE

and

(Figure
2-1);
initialization
RSX-20F

press

the

this
dialog.

YB14-44

6:11

[SYO0O:

REDIRECTED

[DX0:
[DX1:

MOUNTED]
MOUNTED]

KLI

VERSION

KLI

ENTEE

SWITCH

1loads
the
The system

the

monitor

control

and

panel

starts

the

5-MAR-82

DXO0:]

VB12-27

DIALOG

button

front-end
prints:

RUNNING

[NO,YES,EXIT,BOOT]?

KLI>

Item

Identifies

RSX-20F
YB14-44
6:11 5-MAR-82

SYOQ:

The
The
The

name

of the front-end monitor.
version of the front-end monitor.
time and date that the front-end

was

built.

The

area

from which

files.
If
SY0:
front end obtains

KLI

SY0:

1is

end

obtains

the

The

name

and

KLI>

The

prompt

initialization

Error:

front

end

redirected
files from

redirected

files

version

initialization

the

1is
the

the

obtains

its

to DX0:, the
floppy drive

DBO:,

from disk

monitor

the

drive

central

front

processor

dialog.
for

the

central

processor

dialog.

the system does not print the above
the
floppy
disks
are mounted in the
HALT switch is in the ENABLE position.

heading,

be sure that
proper drives and the
Then retry Step 12.

CREATING THE TOPS-20

FILE SYSTEM

NOTE

could
manual
this
The version and edit numbers in
printed on your console.
numbers
the
from
differ
The numbers printed on your console must be equal to
or greater than the numbers in this manual.

—— LOAD SWITCHES ——

ENABLE

DISK

SW REG

FAULT

LIGHT

FLOPPY

POWER

LIGHT

POWER

SWITCH

EMERGENCY

POWER OFF

ENABLE/HALT

SWITCH REGISTER

SWITCH

CREATING

* Step 13:
To

enter

press

THE

TOPS-20

FILE

SYSTEM

Type YES and Press the RETURN Key.
the

the

central

RETURN

processor

key.

initialization

Following

this,

dialog,

you

answer

type
either

YES
NO

and
YES

to this
question,
you
will
see
a
description
of
your
system's
hardware.
First comes the serial number
(S/N) of the CPU, followed by
its type and power line frequency (either 50 or 60 Hertz).
Then comes
a
1list of hardware options present on your system.
If an item is not
present, it will not be listed.
The example below shows all available
options.

Following

this,

the

system prints

KLI

RELOAD

MICROCODE

[YES,VERIFY,FIX,NO]?:
KLI

ENTER

DIALOG

[NO,YES,EXIT,BOOT]?

KLI>YES
@

KL1

KL10

S/N:

KL1

KL10

HARDWARE

MOS

2102.,

MASTER

MODEL

HERTZ

ENVIRONMENT:

OSCILLATOR

EXTENDED

ADDRESSING

INTERNAL

CHANNELS

CACHE

KLI

RELOAD

MICROCODE

[YES,VERIFY,FIX,NO]?

KLI>

Error:

the

system

floppy

return

Step

you

erase
del=te

»Step 14:

does

not

disks

are

the

above

mounted

1in

sure

that

drives,

then

make

typing

DELETE

KEY

error,

press

a single character
the entire line.

the

time.

DELETE

Type

key

CTRL/U

Type YES and Press the RETURN Key.

followed

KLI

proper

12.

To load the central processor microcode, type
key.
After
30
seconds,
during
which the
microcode is loaded and the system prints KLI
LOADED

heading,

the

RELOAD

KLI

RECONFIGURE

MICROCODE

CACHE

YES and press the RETURN
floppy drives click, the
-- MICROCODE VERSION 273

[FILE,ALL,YES,NO]?

[YES,VERIFY,FIX,NO]?

KLI>YESG

KLI

MICROCODE

VERSION

273

LOADED

B step 15: STOP.
Go

Step
KLI

Step
KLI
KLI>

the

system

RECONFIGURE

the

CONFIGURE

CACHE

system
KL

prints:
[FILE,ALL,YES,NO]}?

prints:

MEMORY

[FILE,ALL,REVERSE,FORCE,YES,NO]?

CREATING

Step

16:

Type ALL

and

THE

Press

TOPS-20

the

FILE

RETURN

SYSTEM

Key.

l’fk>reconfigure the central processor cache,

type

ALL

and

press

the

RETURN
Kkey.
Upon
receiving
this
reply, the system configures all
available cache.
After the
configuration
1s
complete,
the
system

prints:

KLI>ALLRED
KLI

ALL

KLI

CONFIGURE

CACHES

ENABLED

KL MEMORY

[FILE,ALL,REVERSE,FORCE,YES,NO]?

KLI>

Error:

If the system does not print one of the headings
above,
be
sure that the floppy disks are mounted in the proper drives,
then

mp Step 17:

return

Step

12.

Type ALL and Press the RETURN Key.

To configure the central processor memory,
type
ALL
and
press
the
RETURN
key.
This answer configures all available memory in the most
useful manner and then prints a message indicating the results.
These
results will be different, depending on the type of hardware you have.
See below, for the sample output that pertains to your system.
(Refer
to the TOPS-20 Operator's Guide for details on memory configuration.)
After the configuration is complete, the system prints KLI -- LOAD
KL
BOOTSTRAP

KLI

[YES,NO,FILENAME]?:

CONFIGURE

KL MEMORY

([FILE,ALL,REVERSE,FORCE,YES,6NO}?

KLI>ALLGRED

Depending on
the

the

size of

your

system,

your

output will

resemble

one

following:

LOGICAL

MEMORY

CONFIGURATION

ADDRESS

SIZE

INT

TYPE

<CONTROLLER

0000000

768K

MF20

LOGICAL

MEMORY

CONFIGURATION

ADDRESS

SIZE

INT

TYPE

00000000
00400000
02400000

128K
512K
256K

4
4
4

MB20
MF20
MF20

03400000

3200K

CONTROLLER

0 %
10
14

NON-EXISTENT

NOTE

The

MOS

memory

configurator

capable

of
configuring
4096K
of
memory.
The
message
concerning
the
NON-EXISTENT
memory
may be ignored.
This message 1is
specifying the
difference
between
the

actual

Error:

physical

memory

and

4096K.

If the system does not print a heading
similar
to
one
those
above,
be
sure
that
the
correct floppy disks
mounted in the proper drives, then return to Step 12.

of
are

CREATING

.Step 18:
After

the

THE

TOPS-20

FILE

SYSTEM

Type MTBOOT and Press the RETURN Key.
prompt

KLI>,

type

MTBOOT

and

press

the

RETURN

key:

KLI

-- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?
KLI>MTBOOT
RED
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>

The system asks whether it should write
the
front-end
file
KL.CFG,
which
describes your current configuration and the method you used to
bring up the system (disk, floppy disks, or magnetic tape).
If
this
file is written, the front end will attempt to use the same method and
the same configuration when you next install
or
reload
the
system.
The
default
answer
to
the
question,
WRITE
CONFIGURATION
FILE
[YES,NO]?, is YES.
Therefore, it is recommended that you answer NO to
this
question
for
the
present.
Later,
when you have a front-end
configuration that should be recorded (Step 136, in
Chapter
5),
the
configuration

l’ Step 19:
After

the

file

BOOT

written

for

you.

Type NO and Press the RETURN Key.
prompt

KLI>,

KLI -- WRITE
KLI>NO
RE)
KLI

will

and

CONFIGURATION

BOOTSTRAP

V10.0

type NO

LOADED

press

FILE

AND

the

RETURN

key.

[YES,NO]?

STARTED

(151)

MTBOOT>

The front end loads
program
from
the
bootstrap
program.
seconds),

the

Error:

the central processor memory
with
the
bootstrap
floppy
mounted
on
drive
0, and then starts the
When
at
bootstrap
command
level
(about
45

system prints

the

MTBOOT>.

system prints:

KLI>

?BOOTSTRAP

LOAD

FAILED

or any other error message, you may have
the
wrong
floppy
disk
mounted
in
drive
0
or you may not have stopped the
central processor.
Type CTRL/\.
(The backslash key (\)
1is
near the LINEFEED key.)
After 10 seconds, the system prints
PAR>.
Type the command ABORT and press the RETURN key.
The
system
prints
PAR%,
which means the central processor has
stopped.

the

back

system prints

Step

the

KLI
KLI

---

2BOOT FILE
?BOOTSTRAP

KLI

ENTER DIALOG

12.

following message

exactly:

NOT FOUND
LOAD FAILED

[NO,YES,EXIT,BOOT]?

KLI>

You either have the wrong floppies mounted or
you
mistyped
the
name
of
the
bootstrap.
Go back to Step 13.
If the
error recurs, make sure that you
have
mounted
the
proper
floppy
disks.
If
the
error
continues,
contact Digital
Software

Support.

CREATING

’Step 20:
To

load

and

TOPS-20

FILE

SYSTEM

Type /L and Press the RETURN Key.
the

TOPS-20

press

the

resident

loads

THE

monitor

RETURN

from

key.

monitor,

magnetic

The

tape

system

skips

into

rewinds

1line,

memory,

type

tape

drive

the

and

prints

the

MTBOOT>

prompt:

MTBOOT>
/L D

[BOOT:

STARTING

CHN:1

[BOOT:

RESIDENT

DX20X:0

MICROCODE
MONITOR]
[OK]

V7(0)]

[OK]

MTBOOT>

NOTE

The

message

microcode
installing

concerning

1is

printed

the

DECSYSTEM-20

TOPS-20
with

the

only

1if

DX20

you

software
DX20

tape

are

on
or

disk

controller.

Error:

you

the

have

made

system

correct

typing

prints

error

the

and

MTBOOT>

pressed

prompt

the

RETURN

again.

key,

Reissue

the

command.

If you did
prints:
?NO

not

RDY

put

the

magnetic

tape

and

the

1line,

the

system

DRIVE

MTBOOT>

Place
If

the

tape

system

line

prints

?BAD

FIL

FMT,

?BAD

EXE

DIR

the

are

off

line.

command

again.

message:

Make
sure
that
you
Installation
tape on

command

give

have

mounted

the

correct

TOPS-20

drive 0 and that all other tape drives
rewind the tape and try
giving
the
/L

Then

again.

system

does

the

error

recurs,

call

DIGITAL

Software

Support.

Error:

the

probably

mistyped

not

the

name

the

MTBOOT.

MTBOOT>

The

prompt,

system

you

prints

the

message:

KLI

?BOOT

FILE

NOT

KLI

?BOOT

LOAD

FAILED

KLI

ENTER

DIALOG

FOUND

[NO,YES,EXIT,BOOT]?

KLI>

the

floppy

disks

MTBOOT

properly,

contact

DIGITAL

are
go

mounted

back

Software

to Step
Support.

properly
12.

1If

and
the

you

error

typed
recurs,

CREATING THE

TOPS-20

FILE

SYSTEM

The system will use the
magnetic
tape
that
1is
on
1line.
Check
to
see if you have more than one tape drive on line.
If so, press the ON LINE button to take each unwanted
drive
off line.
Try typing /L again.

NOTE

The following procedure is intended for
use
during
installation
only.
1If you are trying to bring up a
monitor that has already been installed on a set
of
TOPS-20
disk
packs, refer to Step 136 in Chapter 4
of this manual or to the
TOPS-20
Operator's
Guide
for

.Step 21:

the

correct

procedure.

Type /Gl43 and Press the RETURN Key.

To start the TOPS-20 file-system initialization
routine,
type
/G143
and
press
the
RETURN key.
The system starts the TOPS-20 monitor at
the

file-system

initialization

routine:

MTBOOT>/G14 3@

[FOR ADDITIONAL

INFORMATION TYPE

"?"

TO ANY OF THE

FOLLOWING

|
QUESTIONS.

DO YOU WANT TO REPLACE THE

Error:

If you make an error

prompt,

reissue

the

FILE SYSTEM ON THE SYSTEM STRUCTURE?

and

the

correct

If the system does not print
typescript.
Go back to Step
If

the

system

command.

the
12.

MTBOOT>

prompt,

MTBOOT>

check

your

DIR

EXE

you probably typed the wrong command.
command
again.
If
you
still
get

2.2

the

system prints:

?BAD

Step

reprints

Try giving the
/G143
an
error, go back to

12.

INITIALIZING THE TOPS-20

FILE SYSTEM

To initialize the TOPS-20 file system, you must define the name of the
system structure and the number and location of each disk pack that 1is
part

the

The steps

system

in this

structure.

section

1initialize

the

TOPS-20

file

system

beginning

pointers

creating:

New home blocks

The directory

The

the

all

file

the

(which contain pointers to the

system).

<ROOT-DIRECTORY>

directories

the

(which

system).

<SYSTEM>,

contains

<{SUBSYS>,

<NEW-SUBSYS>,
<UETP>,
<UETP.LIB>,
<UETP.RUN>,
<SYSTEM-ERROR>, <OPERATOR>, and <SPOOL>.

{NEW-SYSTEM>,
<ACCOUNTS>,

CREATING

GSpace

The

for

the

system

movement,

THE

TOPS-20

front-end
swapping

the

FILE

file

system.

space

monitor,

SYSTEM

(the

area

allocated

pages

between

memory

for

and

the

disk).

NOTE

Refer

Guide
the

mp Step 22:
To

TOPS-20

the

structure,

INFORMATION

YOU

WANT

REPLACE

YOU

WANT

DEFINE

‘Step 23:

THE
THE

FILE

YES

"?2"

SYSTEM

all

and
ANY

press
OF

THE

the

THE

RETURN

FOLLOWING

SYSTEM

key.
QUESTIONS.]

STRUCTURE?

YESGEED

STRUCTURE?

Type YES and Press the RETURN Key.

write

the

home

blocks

for

YES

and

press

the

RETURN

key.

YOU

HOW

WANT

MANY

l"Step 24:

PACKS

each

DEFINE

THE

ARE

THIS

unit

SYSTEM

the

system

STRUCTURE?

structure,

type

YESGED

STRUCTURE:

Type the Number of Packs and Press the RETURN Key.

the

number

structure.

Type

example

uses

disk
the

PACKS

"CHANNEL,

WHICH
If

you

After
press
that

Step

ARE

the

system

wrong

RETURN

and

<central

start

the

STRUCTURE:
UNIT"

number

prints

key.

plan

press

CONTROLLER,

type

the

you

and

THIS

the
the

packs

answer

HOW MANY

Error:

type

TYPE

Count

Manager's

explanation

above.

system

ADDITIONAL

System

detailed

Type YES and Press the RETURN Key.

create

[FOR

the

for

The

LOGICAL

disk
(10

system

processor

again.

your

key.

The

system

following

1 GeD

PAR>

have

RETURN

has

PACK

packs,

seconds),
prints

type
type

PAR%

stopped).

MOUNTED:
CTRL/\.
ABORT

and

(indicating
Go

back

CREATING

mp Step 25:
You

must

Dbe

Type

inform

the

controller,

the

system

WHICH
[ENTER A

system
file

unit

"CHANNEL,

TRIPLE

the

the
of

CONTROLLER,
THE

AND

FOLLOWING

UNIT

UPON

LIST

you
disk

and

Key).

each

are

not

pack,

number

IS
BY

LOGICAL
A COMMA

WHICH

THE

VALID

disk
sure

type

unit

CONTROLLER, UNIT"
NUMBERS SEPARATED

CHANNEL,

SYSTEM

RETURN

each

channel

FILE

location

system.

numbers

the

TOPS-20

Press

the

MOUNTED.
UNIT

Not

public

and

(Do

THE

pack
of

disk

causes

drive:

# 0 MOUNTED:
SPECIFY THE

APPROPRIATE

CHANNEL,

channel,

This

each

PACK
THAT

that

the

PACK

CONTROLLER,

NUMBERS:

1,-1,0

;TYPE=RP06,DUAL

l1,-1,1
1,-1,2

;TYPE=RP06,0FFLINE,DUAL
;TYPE=RP04,0FFLINE,DUAL

PORT

l1,-1,3

;TYPE=RP07,

PORT
PORT

OFFLINE

]
ON

WHICH

"CHANNEL,CONTROLLER,UNIT"

LOGICAL

PACK

MOUNTED:

NOTE

The

controller

all

system

those

that

structure

listed

contain

the

will

listed

drive

that

press

RETURN

the

Step

Type

the
the

you

want

always

that

switch

Step 6
seconds,

packs

line.

select

procedure
After
10

for

start

drive

you

want

and

wait

use
is

system
halt

are

All

other

listed,

the

use

the

processor.

Return

off

line,

come

on.

number,

drive,

No.,

and

the

and

Controller

controller

press

the

No.,

The

number

-1.

Since

each

number

disk

the

controller

RP20

should

cannot

always

there

give

used

turn

back

"CHANNEL,CONTROLLER,UNIT"

THE

DEFAULT

SWAPPING

any
you

the

You

unit

must

number

all

this

ask

your

channel

drives

the

system

answer

problem,
the

Press

and

unit

except

the

structure,

LOGICAL

l,"l,o
WANT

and

key.

drive.

for

Unit

number,

RETURN

each

YOU

the

Then type CTRL/\.
PAR>.
Type ABORT and

light

drive's

listed

pack.
1If
representative

WHICH

will

Service

the
B.

READY

Field

controller

system

drives

central

once

the

set

it to
prints

DIGITAL

1is

not

your

again.

for

the Channel
RETURN Key.

channel

6
exactly,
drive
0
the remaining drives,

12.

dual-ported

number

for

line.

question

RP20

-1

probably

changing

the

key

and

line

* Step 26:

off

controller

the

If you followed the procedure in
Step
will
be
1listed
as
dual-ported.
Of

Error:

Type

number

structures.

SPACE?

PACK

MOUNTED:

CREATING

Error:

If your answer
messages
and
the

Error:

current

THE

TOPS-20

FILE

is invalid, the system prints one of
several
repeats
the question.
You can simply repeat

step.

If your answer is valid but is
CTRL/\.
After
10
seconds,
ABORT
and
press
the
RETURN
processor.
Go back to Step 12

mp step 27:

Type ?

SYSTEM

not the one you wanted,
type
the system prints PAR>.
Type
key
to
halt
the
central
and start again.

(Do Not Press the RETURN Key).

To determine the default size of the swapping space for
type
2.
The system prints the default swapping space
for

2060

your
which

system,
is 15010

2040S.

If you are planning on using a monitor other than MONBIG for the
2060
or
2040S,
refer
to
Chapter 3, Section 3.1 for the correct swapping
space

for

the

you

choose.

DO YOU WANT THE
[THE DEFAULT IS

DEFAULT SWAPPING SPACE? ?
15010 PAGES]
(for a 2060 or

DEFAULT

YOU

l.»Step 28:

WANT

THE

SWAPPING

2040S)

SPACE?

Type YES or NO and Press the RETURN Key.

If you want
the

monitor

RETURN

to accept

key,

and

the default

proceed

swapping

Step

30.

DO YOU WANT THE DEFAULT SWAPPING
DO YOU

WANT THE DEFAULT SIZE

space size,

SPACE?

FRONT

END

type YES,

press

YESGE
FILE

SYSTEM?

If you want to specify the size of the swapping
space,
type
NO
and
press the RETURN key.
The formula for determining the proper swapping
space for your system is found in the TOPS-20 System Manager's
Guide,
Chapter

After you determine
to

Step

29.

the size of

the

swapping

space you

need,

proceed

DO YOU WANT THE DEFAULT SWAPPING SPACE? NOGED
HOW MANY

Error:

PAGES

FOR

SWAPPING?

I1f you
type
the
wrong
answer,
seconds,
the
system prints PAR>.

RETURN
Step 12

key
and

to
halt
the
start again.

central

type
CTRL/\.
After
10
Type ABORT and press the
processor.

Return

CREATING

l"Step 29:

THE

TOPS-20

FILE

SYSTEM

Type the Decimal Number of Pages and Press the RETURN Key.

Type

the

and

press

decimal
the

the

amount

maximum

number

RETURN

swapping

amount

key.

disk

pages

you

This

option

space

that

your

want

assign

provided

the

future.

The

present

monitor

will

for

you

default

use

swapping

can

increase

size

the

1s
swapping.

for

1If

you decide to increase the amount used by the monitor in
the
future,
you
must already have assigned that much space on the disk during the
installation procedure.
Otherwise, you must repeat
the
installation
procedure
number
disk.

and

HOW MANY
DO

Error:

specify

pages

YOU

PAGES

WANT

FOR

THE

type

INVALID

NUMBER

returns

1is

wvalid

After

seconds,

M) Step 30:

Step

Type ?

the

and

YOU

[THE
DO

The

number

FRONT

the

not

system

key

END

SWAPPING

1is
to

will

round

cylinders

FILE

SYSTEM?

system

prnts:

PAGES

Step

the

28.

one

prints

halt

the

FOR

1If

you

THIS

TYPE

you

type

wanted,

PAR>.

central

type

Type

WANT

THE

WANT

press

answer

and
back

again.

950

SIZE

FRONT

END

FILE

SYSTEM?

FRONT

END

FILE

SYSTEM?

PAGES]

DEFAULT

SIZE

you

are

using

RP07

disk

system
structure,
do
pages for the front-end

drive

not resesrve
file system.

Type YES and Press the RETURN Key.

YES,

the

CTRL/\.

size of the front-end file
system,
type
the default is, you may omit this step.

DEFAULT

THE

the
any

Type

the

DISK

ABORT

processor.

NOTE

l"Step 31:

(EeD

number,

system

(Do Not Press the RETURN Key).

DEFAULT

YOU

number.
integral

question

start

determine the default
you already know what
DO

SIZE

but

RETURN

invalid

that

larger

SWAPPING?

and

the

DEFAULT

you

press

To
If

the

specified

the

RETURN

key,

and

proceed

YOU

WANT

THE

DEFAULT

SIZE

FRONT

END

YOU

WANT

THE

DEFAULT

SIZE

BOOTSTRAP

Step

FILE
AREA?

32.

SYSTEM?

YESGED

CREATING THE TOPS-20

»Stzep 32:

allocated

file
boot
default
the
as
assigned
The system responds with the number of

the

for

boot

file

DO YOU WANT THE DEFAULT SIZE
[THE

DEFAULT

and

space.

BOOTSTRAP AREATY

PAGES]

DO YOU WANT THE DEFAULT SIZE

) Step 33:

SYSTEM

(Do Not Press the RETURN Key).

Type ?

To find out how many pages are
a question mark.
type
space,
pages

FILE

BOOTSTRAP AREA?Y

Type YES and Press the RETURN Key.

is recommended that you take the default bootstrap space.
press

the

DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA?
WHAT

l}'Step 34:

IS THE NAME

YES

WHAT

Type the Name of the Structure and Press the RETURN Key.

examples

uses

PS:

the

structure

"PS"

name.
structure
The
RETURN key.

name.

PS: (&)

IS THE NAME OF THIS STRUCTURE?

[STRUCTURE

mp step 35:

STRUCTURE?

OF THIS

TOPS-20 recognizes any six-character name as a valid
the
press
and
structure
the
of
name
the
Type
following

Type YES

key.

RETURN

SUCCESSFULLY DEFINED]

STOP.

The system now recognizes the structure you just defined and prints
[STRUCTURE
[PS

MOUNTED]

$%NO

SETSPD

[BOOT:

"PS"

SUCCESSFULLY DEFINED]

LOADING SWAPPABLE MONITOR,

the system prints a message
?PS

UNIT

HAS

BAT

similar

PASS 1]

[OK]

to:

BLOCKS

DO YOU WANT TO WRITE A SET OF PROTOTYPE BAT BLOCKS?

Type YES and press the RETURN key.

Continue with the next step.

This
$3NO SETSPD means that the system cannot run the SETSPD program.
you have not yet loaded the SETSPD program into
because
expected
is
the
Dbefore
This message may be printed at any time
the file system.
system requests the date and time.

CREATING

Error:

THE

TOPS-20

THE

PROBLEMS

When the problem has
RETURN key.
Go back

STARTING

THE

l”Step 36:

ENTER

the

restarting,
CURRENT

date

the

and

RETURN

format.

The

type

CORRECTED

YET:

and

press

the

is initialized,
steps.

you

can

start

the

system

For
as

wait...

DATE

time

day-month-year

entered

been corrected,
to Step 12.

BEEN

prints

System

Press

ABOVE

Type the Date and Time, and Press the RETURN Key.

system

Type

MENTIONED

while
the
monitor
1is
1is write protected, for
message followed by:

MONITOR

Now that the file system
performing the following

The

SYSTEM

If certain error
conditions
occur
mounting
the
structure
(a
drive
example), the system prints an error
?HAVE

2.3

FILE

AND

the

key.

Type

CURRENT

DATE

system

responds

the

4:30

ENTER

format:

time

1in

AM/PM

format

the

second

day

24-hour

March

may

AND

TIME:

retyping

HAVE-

ENTERED

SUNDAY,

THIS

CORRECT

(Y,N)

5-MAR-82

the

date

1630QED

and

5-MARCH-1982

time.

4:30PM,

Type Y and Press the RETURN Key if the Date Is Correct.

If the date and time are correct, type Y and press the RETURN key.
the date and time are incorrect, type N and press the RETURN key.
system again asks for the date and time:
YOU

HAVE

ENTERED

SUNDAY,

THIS

CORRECT

(Y,N)

WHY

PM:

YOU

W) Step 37:

following

hhmm

example,

2-MAR-81

TIME:

5-MARCH-1982

If
The

4:30PM,

RELOAD?

l"Step 38:

Type NEW and Press the RETURN Key.

Type NEW and press the RETURN key.
Whatever text you
type
following
this
question
is
entered
into
the
system
error
file,
PS:<SYSTEM-ERROR>ERROR.SYS.
The TOPS-20 monitor starts
running,
and
the

system

VALIDATION

prints
IS

<SYSTEM>ACCOUNTS-TABLE.BIN

DISABLED

and

RUNNING

NOT

FOUND

ACCOUNT

DDMP.

WHY

RELOAD? NEW (RED
<{SYSTEM>ACCOUNTS-TABLE.BIN

RUNNING
NO

DDMP

SYSJOB

NOT

FOUND

ACCOUNT

VALIDATION

DISABLED

CREATING

The

system

ACCOUNT

prints

message

DISABLED

run.

(Refer

information.)

Chapter
on

If
you
type
question, the
prompts

Step

39:

Type

The

program is not stored
ignore this message.

Error:

you

because

the

disk.

SYSTEM

the

TOPS-20

System

prints

This

ACTGEN

program

for

Tell

the

NOT

program

because

not

FOUND

has

Manager's

SYSJOB

an
incorrect
string
system prints the valid

again

CTRL/C

FILE

<SYSTEM>ACCOUNTS-TABLE.BIN

system

<SYSTEM>ACCOUNTS.TABLE.BIN
RUNNING

TOPS-20

the

VALIDATION

THE

not

been

Guide

for

the

needed

SYSJOB

yet,

to
the
WHY
abbreviations

RELOAD?
and then

abbreviation.

System

FOUND

that

You Want

ACCOUNT

Start

VALIDATION

Job.

DISABLED

DDMP

SYSJOB

{TRLC)
NO

EXEC

MX>

Step

40:

Type

Then

MTAQ0:

and

Press

the

RETURN

Key.

The system is now at the miniexec command level, and you can type
any
miniexec
command.
Use
this
command
1language
to load the TOPS-20
command processor from tape.
Type CTRL/U if you want to erase a
1line
while at miniexec command level.

The
system
prints
NO
EXEC
because
the
file
PS:<SYSTEM>EXEC.EXE
{containing
the
TOPS-20
command
processor)
does
not
exist.
The
command processor is not needed at this point, so ignore this message.
To

skip

over

prints

skips

over

prompt

the

end

FILE.

the

Type

end

monitor

MTAO:

the

save

and

monitor

file,

press

save

the

file

type

RETURN

and

The

key.

prints

system

The

the

system
miniexec

MX>.

EXEC

MX>GET

MTAO: /)

FILE

MX>

NOTE

you

tape

are

using

drive

following

steps

procedures,

Error:

you

where

get

message

location

and

continue

the

than

the

recovery

MTAZ2:.

octal
with

other

error

MTAl:,

INTERRUPT

message

drive

accordingly

and/or

e.g.,

error

tape

the

form:

number,
next

you

step.

can

ignore

this

CREATING

mp Sstep 41:

THE

TOPS-20

FILE

SYSTEM

Again Type G, Then MTAO:, and Press the RETURN Key.

To load the TOPS-20 command processor from magnetic tape into
memory,
type
G.
The system prints ET FILE.
Type MTAO:
and press the RETURN
key.
The system reads the program from MTAO0:
into memory and
prints
the miniexec prompt when it is finished:

MX>GET FILE MTAQ: R
MX>

Error:

If you get
the
tape

another error in the form INTERRUPT AT
location,
could
be
bad or you may be specifying the wrong
tape drive.
Start at Step 10
once
more.
If
the
errors
continue, call DIGITAL Software Support.
If you make a
system prints

key,

the

the TOPS-20 command
processor
that
you
just
1loaded
type
S.
The system prints TART.
Press the RETURN key.

1into
The

.Step 42:
To start
memory,
the

RETURN

Type S and Press the RETURN Key.

system prints

and

typing mistake and press the
the MX> prompt.
Try again.

the

TOPS-20

name

and

prompt,

version

the

TOPS-20

command

processor

MX>START
GED
TOPS-20

Command

processor

5(514)

@
Error:

If the system prints INTERRUPT AT 1, you typed
only
one
G
command
to
the miniexec.
Repeat the command in this step.
If you still get the error, go back
to
Step
12.
If
the
errors continue, contact DIGITAL Software Support.
If you receive the
the error recovery

Rewind

the

tape

#7al &)

MX>GET FILE
@e)
MX>START

MTAOQ :@e)

Step

If you make a
system prints

and

give

CREATING

running

following

commands:

43.

typing error and
the MX> prompt.

press
the
Try again.

RETURN

key,

the

tape.

SYSTEM

DIRECTORIES

With the system running, you must create
files
and files for testing the system.
by

the

601772,

If many error messages
are
repeatedly
printed,
the
tape
could
Dbe bad.
Press the front-end HALT switch and wait one
minute.
Go back to Step 12.
1If the errors persist, ask for
another

2.4

manually

MX>CET FILE
MX>KESET
G

Proceed

Error:

error message INTERRUPT AT
procedures listed below.

the

DLUSER program

from

tape.

directories
You create

to
store
system
these directories

CREATING

mp Step 43:
To be

THE

Give the Comma:

able

load

files

TOPS-20

ENABLE
into

FILE

SYSTEM

(CAPABILITIES).

privileged

areas

and

create

user

names

and
directories,
give
the
ENABLE
command
to
obtain the required
capabilities.
Type ENABLE and press the ESC key.
The
system
prints
(CAPABILITIES) .
Press
the RETURN key.
The system prints a $ prompt
instead

550

}

@ENABLE

(CAPABILITIES) GED

) Step 44:

Give the Command:

RUN (PROGRAM) MTAO:.

To run the DLUSER program from the magnetic tape, type RUN
and
press
the
ESC key.
The system prints (PROGRAM).
Type MTAO:
and press the
RETURN key.
After you issue
this
command,
the
system
prints
the
prompt

DLUSER>:

€O
SRUN

(PROGRAM)

MTAO
: @D

DLUSER>

Error:

I1f you
files,
shows

receive an error message, rewind the tape,
skip
two
and
reissue
this
command.
The following example
how

this

for

MTAO:

£SO
SREWIND

(DEVICE)

MTAOQ
: @D

€9

SSKIP

(DEVICE)

MTAO:

FILESGED

€50
SRUN

(PROGRAM)

MTAQ :®RED

DLUSER>

) Step 45:

Give the DLUSER Command:

LOAD (FROM FILE) MTAO:.

To load the directory structure from the tape into
the
file
systen,
type LOAD and press the ESC key.
The system prints (FROM FILE).
Type
MTAO:

and

prints

DONE.

press

and

the

RETURN

key.

the

DLUSER

prompt:

After

few

seconds,

the

system

the
and

RETURN
reissue

£50
DLUSER>LOAD

(FROM

FILE)

MTAQ: G

DONE.
DLUSER>

Error:

If you mistype the command and have not pressed
key,
delete the entire line by typing a CTRL/U,
the

command.

If you mistyped the command
and
pressed
the
follow the error recovery procedure in Step 44.

RETURN

Kkey,

CREATING

THE

TOPS-20

If you get a group of
not
give
the ENABLE
type ENABLE, give the

reissue

the

command

FILE

SYSTEM

JSYS

error messages, you probably
did
command in Step 43.
Type two CTRL/Cs,
commands in the following example, and

this

step:

ES0)

SREWIND

(DEVICE)

?DEVICE

MTAO:

$CLOSE
3

JFN?

MTAO:

MTAO :E

OPEN

JFN

YESGED

[OK]

ESC

$SSKIP

(DEVICE)

MTAQ:

SRUN

FILESGE

ESC

(PROGRAM)

MTAO :@m

DLUSER>

B Step 46 Type EXIT and Press the RETURN Key.
Type

EXIT

system

and

press

prints

the

RETURN

FROM

TAPE

key

end

the

DLUSER

program.

The

T
RED
DLUSER>EXI

2.5

RUNNING

DUMPER

The DUMPER program places
files
from
the
magnetic
tape
into
TOPS-20
file
system.
The
DUMPER
program is the fifth file on
Installation

B) Step 47:
The

program

the

already

Tape.

Give the Command:

DUMPER

press

ESC

RETURN

key.

DUMPER

prompt:

key.

positionec¢

After

DUMPER>

tape

system

mounted

prints

(PROGRAM).

the

DUMPER program,

the

DUMPER

(PROGRAM)

RUN (PROGRAM) MTAO:.

the

The

SRUN

the
the

MTAO
: RED

program

drive

type

MTAO:

starts,

the

Type
Since

RUN

the

tape

and
is

and

press

the

system

prints

the

CREATING THE

Error:

TOPS-20

FILE

SYSTEM

If you get errors, the magnetic tape was either not recorded
properly
or not positioned properly.
Rewind the tape, skip
five files, and try again.
The following lines show how
to
do
this
for MTAO:.
If the errors persist, contact DIGITAL
Software

Support.

(DEVICE)

SREWIND

€s0
!

(DEVICE)

$SKIP

: Gl
MTAO

MTAQ:

5 FILESGEH

ESC

SRUN

(PROGRAM)

MTAQ
: G

DUMPER>

’Step 48:

Give the DUMPER Command:

TAPE

(DEVICE)

MTAO:.

Tell DUMPER which tape drive to use by giving the DUMPER command TAPE.
Type
TAPE
and
press the ESC key.
The system prints (DEVICE).
Type
MTAO:
and press the RETURN key.
The system prints the DUMPER prompt:
ESC

DUMPER>TAPE

(DEVICE)

MTAOQ
: R

DUMPER>

Error:

2.6

you

RESTORING

Restore

the

make

TOPS-20

files

PS:<UETP.LIB>

for

from

typing

BUNDLED

the

error,

reissue

SOFTWARE

directories

FROM

the

command.

TAPE

PS:<SYSTEM>,

PS:<SUBSYS>,

and

tape.

Give the DUMPER command FILES just before the RESTORE command
1if
you
want
the
system
to
print
the
file
specification of each file it
restores.
The
installation
takes
1longer
if
you
print
this
information.
To
stop
printing each file specification, give the NO
FILES

command

after

the

current

RESTORE

command

finishes.

(Refer to Chapter 7
of
the
TOPS-20
User
Utilities
Guide
for
an
explanation of any messages that DUMPER may print on your terminal.)

CREATING

THE

TOPS-20

FILE

SYSTEM

NOTE

The

following

restoring
tape

Step

steps

the

files

assume
on

the

you

are

Installation

structure

called

PS:.

manual

you

gave

this

than

PS:,

1in

type

structure

name

other

the

structure
PS:
in

name
the

you specified in place of
following
steps.
For

example:
ESC

RESTORE

(FROM)

PGSk >* ok *

(TO)

FOO::

<SYSTEM>
[RED
Notice the files
structure called

are being
FOO:
and

restored to a
the directory

<SYSTEM>.

Step

49:

copy

Give

the

(TO)

PS:<SYSTEM>*
* *
magnetic

the

The

DUMPER command

its

prints

restores

*.*.,*,

all

the
directory
PS:<SYSTEM>.
system prints END OF SAVESET

the

When
and the

ESC)

programs

PS:<*>*
* _*

and press
press the
and press

system

and

FILES)

from

key.

monitor

(TAPE

give the DUMPER RESTORE command.
Type RESTORE
The system prints (TAPE FILES).
Type PS:
and
system prints <*>*
* * (TQO).
Type PS:<SYSTEM>

This

TOPS-20

RESTORE

tape to disk,
the ESC key.
ESC key.
The
ESC

the

DUMPER Command:

Press

files

the

RETURN

key.

the

first

save

all
the
files
DUMPER prompt:

are

€SO

set

restored,

the

ESC

DUMPER>RESTORE
DUMPER
LOADING
END

TAPE

(TAPE
1,

FILES(S)

FILES)

"SYSTEM
INTO

pPS:<*>*.*
*

FILES

FOR

(TO)

TOPS-20

PS:<SYSTEM>*.*.*GR)

V5",

WEDNESDAY

5-MAR-82

2150

PS:<SYSTEM>

SAVESET

DUMPER>

The

system prints

was

written.

Error:

you

tape

1is

tape.

header

type

not

FILE(S)

CTRL/E,

containing

the

correct

positioned

the

date

input

correctly,

and

time

structure,
no

files

that

PS:,
are

the

tape

the

restored

from

this
INTO

give

case you will not see
the
message,
LOADING
PS:<SYSTEM>.
To
<correct
this
error, type
the following commands, and begin again at Step

49.

CRUE)
INTERRUPTING...
DUMPER>REWIND

¥DO
YES

YOU
OR

DUMPER>

REALLY
NO?

WANT

YES @

ABORT

YOUR

INTERRUPTED

COMMAND?

CREATING

Error:

you

not

PS:<SYSTEM>,

correct
to

TOPS-20

type

the

files

this

commands,
sure

THE

and

correct

are

error,
reissue

delete

and

FILE

structure

restored

type
the

SYSTEM

CTRL/E,

RESTORE

expunge

and

the

files

name,

directory.

give

command

the

directory

wrong

in
in

the

following

this

step.

the

incorrect

directory.

CIRLEE)
!

INTERRUPTING.
..

DUMPER>SKIP
$DO

YOU

O @D

REALLY

WANT

ABORT

YOUR

INTERRUPTED

COMMAND?

DUMPER>

) Step 50:

Give the DUMPER Command:
(TO)

Restore

the

system

RESTORE

and

PS:

press

and

PS:<SUB

press

and

the

RETURN

END

RESTORE (TAPE

FILES)

PS:<*>*
* *

the

PS:<SUBSYS>.

Type

(TAPE

Type

PS:<SUBSYS>*.*
*,

the

program

files

the

ESC

key.

The

ESC

key.

press

key.

SAVESET

the

When
and

ESC

all

the

The

system

key.

The

the

DUMPER

files

directory

system

prints

prints
system

are

<(*>*
prints

restored,

FILES).

*_*

(TQ).

Type

SYS>*.*.*,

Press

the

system

prints

prompt:

DUMPER>RESTORE

DUMPER
LOADING
END

TAPE

(TAPE

FILE(S)

FILES)

"SUBSYS
INTO

PS:<*>*
.* *

FILES

FOR

(TO)

TOPS-20

PS:<SUBSYS>

V5"

*.*,
* i)

,WEDNESDAY,

5-MAR-82

2153

PS:<SUBSYS>

SAVESET

DUMPER>

Error:

If you do
the
tape

from

not

1is

tape.

type the correct input structure,
not positioned correctly, no files

this

FILE(S)

type

CTRL/E,

Step

49.

case

INTO

give

the

vyou

will

PS:<SUBSYS>.

following

not

see

correct

commands,

and

PS:
are

, or
|if
restored

the

message

this

begin

error,

again

CIRLE)

INTERRUPTING...

DUMPER>REWIND
(ED

$DO

YOU

YES

DUMPER>

REALLY
NO?

WANT

YESRED

ABORT

YOUR

INTERRUPTED

COMMAND?

CREATING

Error:

you

are

TOPS-20

forget

type

the

restored

the

wrong

following
RESTORE

the

THE

commands

command

files

the

FILE

directory

PS:<SUBSYS>,

directory.

correct

this

SYSTEM

the

step.

incorrect

Type

error,

sure

the

CTRL/E,

and

files

give

reissue

delete

and

the

expunge

directory.

CTRUE)
INTERRUPTING.
..

DUMPER>SKIP
¥DO

YOU

YES

0 @)

REALLY

NO?

WANT

ABORT

YOUR

INTERRUPTED

COMMAND?

YESGE

DUMPER>

l’ Step 51:

Give the DUMPER Command:
(TO)

RESTORE (TAPE

FILES)

PS:<*>*%
* %

PS:<UETP.LIB>*
., * *,

restore the files into the directory <UETP.LIB>, type
RESTORE
and
the
ESC
key.
The system prints
(TAPE FILES).
Type PS:
and
press the ESC key.
The system prints <*>*
% * (TQO).
Type
PS:<UETP.L
press
and

press

the

ESC

key.

When

all

the

files

SAVESET

and

the

DUMPER

The

system

are

DUMPER
LOADING
END

TAPE

system

ESC

(TAPE

FILE(S)

IB>*.*,.*_,
the

FILES)

"UETP
INTO

©Press

the

prints

RETURN
END

prompt:

@%@
DUMPER>RESTORE

prints

restored,

ESC

PS:<*>*.,*
. *

FILES

FOR

(TO)

PS:<UETP.LIB>*.*
. * @

V5"

,MONDAY,

TOPS-20

5-MAR-82

2013

PS:<UETP.LIB>

SAVESET

DUMPER>

Error:

not

type

example,

files

restored

the

you

are

message

this error,
begin again

the
the

correct

input

tape

not

from

1is

tape.

FILE(S)

type CTRL/E,
at Step 49.

1In
INTO

give

the

structure,

positioned

this

case

you

will

PS:<UETP.LIB>.

following

PS:,

correctly,

not

for
no

see

correct

commands,

and

CFL/E)
INTERRUPTING.
. .

DUMPER>REWIND
®E)

300

YOU

YES

DUMPER>

REALLY

NO?

WANT

YESGREH)

ABORT

YOUR

INTERRUPTED

COMMAND?

CREATING THE TOPS-20

mp Step 52:

Give the DUMPER Command:
(TO)

FILE

SYSTEM

* *
RESTORE (TAPE FILES) PS:<*>*

PS:<SUBSYS>*.*
*

PS:<SUBSYS>,
directory
the
into
files
To restore the GALAXY
The system prints (TAPE FILES).
and press the ESC key.
RESTORE
(TO).
<*>* *.*
The system prints
and press the ESC key.
PS:
The system prints SYS>*.*.*.
the ESC key.
press
and
PS:<SUB

the RETURN key.

END OF

SAVESET

When all the files are restored,

and

DUMPER>RESTORE

DUMPER TAPE #1,

system

prints

DUMPER prompt.

the

ESC

the

type
Type
Type
Press

ESC

(TAPE FILES)

ESC

PS:<*>*.*.*

(TO)

PS:<SUBSYS>*.*.*G@H

"GALAXY V4.0 SUBSYS FILES FOR TOPS-20 V5"

TUESDAY, 5-0CT-81 2015
LOADING FILE(S) INTO PS:<SUBSYS>
END

SAVLSET

If you forget to type PS:<SUBSYS>,

Error:

files

the wrong

directory.

the system

Type CTRL/E

restores

the

to stop DUMPER,

command.
RESTORE
the
give the SKIP 0 command, and reissue
Be
sure
to
delete
and expunge the files in the incorrect
directory.
CTRUE )

INTERRUPTING...

DUMPER>SKIP

0@ED

$DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND?
YES

NO?

YES @)

DUMPER>

NOTE

I1f you
have
an
RP20
disk
subsystem,
perform Steps 53 through 55.
Otherwise,
continue the installation procedures
at
Step

mp Step 53:

56.

Give the DUMPER Command:

DUMPER>UNLOAD

type
drive,
tape
the
from
To remove the TOPS-20 Installation tape
The system rewinds the tape onto the
UNLOAD and press the RETURN key.
source

reel.

DUMPER>UNLOAD
RED
DUMPER>

I’Enep 54:

Remove the TOPS-20 Installation Tape

and

the RP20 Microcode Tape on the Tape Drive.

Physical’

.ount

CREATING

W) Step 55:
copy

TOPS-20

Give the DUMPER Command:
(TO)

THE

the

RESTORE

PS:<SUBSYS>*.*.*

RP20

from

Type

RESTORE

FILES).

Type

RESTORE (TAPE

magnetic

PS:

and

prints

(TAPE

prints
prints

<*>*
. % * (T0).
Type PS:<SUB
SYS>*.*_.*,
Press the RETURN

@%@
DUMPER>RESTORE

DUMPER

TAPE

5-0CT-1981

FILE(S)

FILES)

"RP20

TUESDAY

END

FILES)

and

tape

disk

give

press

the

ESC

key.

press

the

ESC

DX20

PS:<*>*
% %

and press
key.

the

ESC

DUMPER

The

Kkey.

ESC

(TAPE

#1,

SYSTEM

<RET>

Microcode

command.

FILE

system

The

key.

system

The

system

ESC

PS:<*>*_.*_
*

MICROCODE

(TO)

FOR

PS:<SUBSYS>*.*_
*

TOPS-20

V5",

2200

INTO

PS:<SUBSYS>

SAVESET

DUMPER>

Error:

you

not

PS:<SUBSYS>,

To correct
commands,
sure

type

the

files

this
and

correct
are

error,
reissue

delete

and

structure

restored

and
the

type
CTRL/E,
give
the RESTORE command

expunge

the

files

directory
wrong

name,

directory.

the
following
in Step 55.
Be
the

incorrect

directory.
Qfififl
INTERRUPTING.
..
DUMPER>SKIP

$DO

YOU

YES

REALLY
NO?

WANT

YES

ABORT

YOUR

INTERRUPTED

COMMAND?

DUMPER>

’Step 56:

Type EXIT and Press the RETURN Key.

Type

EXIT

the

TOPS-20

and

press

enabled

the

RETURN

key

end

DUMPER.

The

system

prints

prompt:

DUMPER>EXI
@D
T

mpStep 57:
To

the

Give the Command:

remove

tape

the TOPS-20
drive, type

(DEVICE).
the

tape

Type
onto

MTA0:

the

UNLOAD (DEVICE) MTAO:.

Installation Tape or
UNLOAD and press the
and

source

press

the

RP20
Microcode
Tape
from
ESC key.
The system prints

RETURN

key.

The

Installation

Tape

from

system

rewinds

reel.

ESC

SUNLOAD

(DEVICE)

$
You

can

now

remove

the

MTAOQ: @D

TOPS-20

the

tape

drive.

CREATING

Error:

the

system

THE

TOPS-20

YES

and

SYSTEM

prints:

¢$Device open in lower
$Kill lower fork?
type

FILE

press

the

fork

RETURN

key.

The

system

unloads

your

DISK-USAGE

(OF

tape.

Step

58:

Give

the

DIRECTORY)

Command:

INFORMATION

PS:<*>

Press

and

the

(ABOUT)

RETURN

Key.

If you give the command INFORMATION (ABOUT) DISK-USAGE (OF
DIRECTORY)
PS:<*>,
the
system
will
print
the
size of every directory on the
public structure,
PS:.
The
example
below
was
obtained
using
a

DECSYSTEM-20,
model
2060.
You
will
notice
that
there
are
two
directories called <NEW-SYSTEM> and <NEW-SUBSYS>.
These
directories
should
have
no files associated with them.
They were created by the
monitor and will be used 1n the event you
update
vyour
system
to
a
newer release of the TOPS-20 operating system.
ESC

S$INFORMATION

ESC

(ABOUT)

DISK-USAGE

(OF

DIRECTORY)

PS:<*>RE

PS:<ROOT-DIRECTORY>

108

Pages

+INF

assigned

Working

pages,

+INF

Permanent

pages

allowed

+INF

Permanent

pages

allowed

+INF

Permanent

pages

allowed

+INF

Permanent

pages

allowed

PS:<ACCOUNTS>

Pages

+INF

assigned

Working

pages,

PS:<KNEW-SUBSYS>

Pages

+INF

assigned

Working

pages,

PS:<KNEW-SYSTEM>

Pages

+INF

assigned

Working

pages,

PS:<OPERATOR>

0 Pages assigned
250 Working pages,

250

Permanent

pages

allowed:

PS:<SPOOL>

Pages

+INF

assigned

Working

pages,

+INF

Permanent

pages

allowed

+INF

Permanent

pages

allowed

+INF

Permanent

pages

allowed

+INF

Permanent

pages

allowed

PS:<SUBSYS>

2319

Pages

+INF

Working

assigned
pages,

PS:<SYSTEM>

5493

Pages

+INF

Working

assigned
pages,

PS:<SYSTEM-ERROR>

Pages

+INF

assigned

Working

pages,

CREATING

THE

TOPS-20

FILE

SYSTEM

PS:<UETP>

0 Pages assigned
100000 Working pages,

100000

Permanent

pages

allowed

PS:<UETP.LIB>

1740

Pages

4000

Working

assigned

pages,

4000

Permanent

pages

allowed

PS:<UETP.RUN>

Pages

500

assigned

Working

Total

57943

Pages

Error:

pages,

9675

Pages

free

the

"Pages

PS:,

create
and

for

used.

each

tape,

begin

Mount

again

the

RETURN

DUMP.EXE

press

+the

PS5:<SUBSYS>MAKDMP.EXE

some

the

shown

not

may

again

not

have

MTAO0:,

skip

been

copied

four

files

47.

RUN (PROGRAM)

PS:<SUBSYS>MAKDMP.EXE

and

Key.

file,

which

ESCAPE

key.

and

directory

shown in this manual or the
listing shipped
with
vyour

files

tape

Step

allowed

directories.

Installation

Press

RUN

pages

match
the
value
from the directory

Give the Command:

18057

assigned"

pages

approximately
value derived

and

prompt

Permanent

assigned,

correctly.

I’Efifip 59:

500

press

records
The

the

any

system

failures,

type

system

prints

(PROGRAM).

Type

RETURN

key.

The

system

prints

the

MAKDMP>.

€S0
SRUN

(PROGRAM)

PS:<SUBSYS>MAKDMP.EXE
®E)

MAKDMP>

NOTE

you

system
press

know

the

RETURN

MAKDMP> .
of

the

MAKDMP

PS:<SYSTEM>DUMP.EXE
RETURN

To overwrite the
CREATE and press

memory

the

RETURN

system

prints

memory

number

size

with

words.

Command:
(MEMORY

and

the

CREATE
Memory

existing DUMP.EXE file with
the ESCAPE key.
The system

prints

(DUMP
Size

and

FILE)
Press

and

press

Type

the

key.

the

ESCAPE

key.

total

amount

the

following

new
The

memory

example

DUMP.EXE file,
(DUMP FILE).

Type

system

(FOR

your

2048K

prints

system
words

has
was

size.
ES

—f

ESC

l
MAKDMP>CREATE

the

EKey.

press

SIZE).

The

vyour

command

SIZE)

PS:<SYSTEM>DUMP.EXE
MEMORY

memory

HELP

after

physical

corresponding

much

the

key

examples

Give

how

type

prints
the

mp Step 60:

not

has,

(DUMP

FILE)PS:<SYSTEM>DUMP.EXE

2-31

(MEMORY

SIZE)

2048

type

and
the

CREATING THE TOPS-20

l’»Step 6l:

Give the MAKDMP Command:

FILE

SYSTEM

EXIT and Press the RETURN Key.

To exit the MAKDMP program and return to TOPS-20 command
EXIT

and

press

the

RETURN

Kkey.

MAKDMP>EXIT RED

NOTE

If in the future you add some additional
should
you
system,
your
to
memory
allow
to
reconfigure the DUMP.EXE file
it to accomodate the additional memory.

level,

type

CHAPTER
TAILORING

After you
have
installed
Installation
Tape,
tailor

THE

3
SYSTEM

the
bundled
vyour system

TOPS-20
for your

software
from
specific needs.

the
You

must:

Select

a monitor

Change

the

logical
system
1lines,
remote
define
Set terminal speeds;
printer
line
parameters,
drive
tape
magnetic
names,
recycle
migration
parameters, time zone, file archiving and
and enable or
parameters;
shift
accounting
and
periods,
wvalidation,
account
setting,
parameter
directory
disable
class scheduling, working set swapping, latency optimization,
located
All these parameters are
and tape drive allocation.
in

3.1

that

system

is correct

file PS:<SYSTEM>5-1-CONFIG.CMD.

password

and

4.,

Change

the operator's

Create

the directory

Create

the PS:<SYSTEM>LPFORM.INI

SELECTING A TOPS-20

this

should

time you

now

requirements.

file.

the TOPS5-20 monitor

the monitor

available

lines

2060-MONBIG.EXE.

You

that most closely meets your system's

that

supports at

system

your

memory than your

least:

contains.

monitor

system contains will

that

not use

memory.

need.
The number of terminal lines you
number.
this
in
console
operator's
terminal

running

less

group.

PS:<REMARKS>.

Choose a monitor

supports

user

MONITOR

As much memory as
all

are

select

system.

name.

system parameter

the

for your

and

remote

the
count
not
Do
Just count the local

lines.

(one
two
The number of user jobs that you plan to run, plus
For example, if you expect to run
and job 0).
Jjob
operator
least
20 user jobs, the monitor you select should support at
22

jobs.

TOPS-20 Version 5.1

3-1

December 1982

TAILORING

The

number

needs

program,

and

example,

which

batch

two

for

SYSTEM

pseudo- terminals

least

one

THE

turn

usually

unplanned

you

system,

want

you

that

vyou

pseudo-terminals,

need

runs

the

situations

run

five

need.
one

The
run

operator

that

monitor

that

peripheral

devices

supports

PTYCON

program

may

OPR,

arise,

pseudo-terminals

system

the

For

your

least

seven

pseudo-terminals.

5.
All

The

monitors

timesharing

number

are

stored

and

batch

fewer

resources

large.

The

below.

Refer

than

the

you

need,

TOPS-20

monitors

3-1

Table

2060-MONBIG.EXE

directory

concurrently.

for

large

their

maximum

100

jobs
1lines

8
2
1

million

7000

128

1
120

swapping

timesharing

storage

RP20

for

monitor

(six

spindles,

RPO04,
or

one

space

monitor.

This

monitor

to:

memory

tape

1line

printers

card

reader
words
RP06,

drives

structure

pages

for

swapping

timesharing

(six

spindles,

RPO04
or

one

space
monitor.

This

monitor

to:

jobs
lines

20
20

pseudo-terminals
NVT's

storage

RP20

per

256K

disk

three

RP(07)

ARPANET

supports

memory

magnetic tape
line printers
card

drives

reader

million

three

5.1

disk

pages

million

10000

Version

three

structure

three

TOPS-20

words
RP06,

magnetic

5035

This

1lines

listed

pseudo-terminals

2048K

120

are

size.

Jjobs

8
2

unnecessarily

drives

per

128

small

monitor.

RP07)

largest

supports

that

memory

three

AN-MONSML.EXE

has

structure

magnetic tape
1line printers
card reader

120

The

run

that

pseudo-terminals

512K

2060-MONMAX . EXE

all

monitor

to:

128
30

They

select

characteristics

timesharing

supports

system.

<SYSTEM>.

not

monitor

and
the

your

words

RP06,

disk

three

RP(07)

per

structure

pages

for

swapping

storage

RP20

(six

spindles,

RPO04,

one

December

1982

space

TAILORING

THE

A medium-size

AN-MONMED.
EXE

monitor

SYSTEM

ARPANET

supports

Jjobs

128

1lines

timesharing

monitor.

This

to:

pseudo-terminals
30
NVT's
30
256K of memory
8

magnetic

2
1

line
card

120

large

per

structure

for

swapping

100

NVT's

of memory
magnetic tape
1line printers

card

120

100
128

50
40
2048K
8

RP07)

per

structure

for

swapping

page

TOPS-20

512

of memory
magnetic tape
1line printers
card

reader

Version

5.1

bit

drives

million words of disk storage (six RPO04,
RP06, three RP20 spindles, or one
three
RP07)

per

structure

pages

for

swapping

Table

3-1

Max.

This

NVT's

Structure

No.

Packs

Per Structure

monitor.

1lines

6
3
1
3
=

timesharing
to:

pseudo-terminals

RP04
RPO6
RPO7
RP20
*

ARPANET

space

jobs

Maximum

Disk Drive

reader

supports

10000

draives

pages

largest

120

monitor

million words of disk storage (six RP04,
three
RP06, three RP20 spindles, or one

7000

2
1

This

1lines

pseudo-terminals

monitor

monitor.

to:

30
512K
8
2

Type

timesharing

space

Jjobs

128

The

RP07)

pages

ARPANET

supports

AN-MONLGE.EXE

drives

million words of disk storage (six RP04,
three
RP06, three RP20 spindles, or one

7000
AN-MONBIG.
EXE

tape

printers
reader

space

Size

No.

Pages

Per Pack

38,000
76,000
216,376
201,420

words

3-3

December

1982

TAILORING

WpStep 62:

Give the Command:

Connect

the

ESC

key.

and

press

the

Copy
the

name

key.

The

MONITR.EXE

that

you

press

the

monitor

and

SCOPY

press

different

COPY

ESC

that

typing

CONNECT

DIRECTORY).

the

monitors

montyp.EXE

selected

the

The

have

the

system

selected

generation

RETURN

montyp.EXE.l

(FROM)

key.

you

(FROM)

(TO

and

pressing

Type

PS:<SYSTEM>

(TO)

MONITR.EXE.

PS:<SYSTEM>(rer)

have

the

prints

montyp.EXE.1
The

prints

PS:<SYSTEM>.

key:

and

system

(TO DIRECTORY)

directory

system

(TO DIRECTORY)

monitor

COPY

SYSTEM

CONNECT

Give the Command:

the

Type

The
RETURN

SCONNECT
$

mpStep 63:

PS:<SYSTEM>

THE

file

prints

and

MONITR.EXE.
(FROM).

press

number

and

Type

the

ESC

(TO).

Type

key.

(TO)

MONITR.EXE.1

MONITR.EXE (rer)
([OK]

are:

TOPS-20

2060/2040s

ARPANET

2060-MONBIG.EXE

AN-MONSML.EXE

2060-MONMAX .EXE

AN-MONMED.
EXE
AN-MONLGE.EXE
AN-MONBIG.
EXE

Error:

3.2

CHANGING

Whenever

similar

can

wrong

name,

reissue

the

command.

SYSTEM NAME
types

SMALL

change

contains

The

the

CTRL/C

VERSION

before

command,

1loaging
the

system

gives

prints

the

message

to:

you

RAISE

THE

(ABOUT)

TOPS-20

name

type

wuser

INFORMATION

You

you

want

the

text

practical

system

into

lowercase

before

SYSTEM,

name

the

system

purposes,

the

give

5.1(5050)

SMALL

SYSTEM"

entering

PS:<SYSTEM>MONNAM.TXT.

the

command

TERMINAL

the

name

(MODE

1IS)

name.

name
it

MONITOR

"TOPS-20

file

letters,

entering

the

TOPS-20

can

contain

should

not

exceed

to
32

105

characters.

characters

fit

For
on

single 72-character line of terminal output.
The following two
steps
show how to change the system name to "Installation-test System."

TOPS-20

Version

5.1

3-4

December

1982

TATILORING

mpStep 64:
If

you

press
press

Give the Command:

want

lowercase

the

ESC

the

terminal

RETURN
is

not

The

key.

SYSTEM

TERMINAL

letters

key.

THE

the

system

Make

(MODE IS) NO RAISE.
system

name,

prints

(MODE

the

CAPS

sure

depressed.

The

system

(MODE

RAISE (rer)

type

IS).
LOCKED

prints

TERMINAL

Type

and

RAISE

and

the

button

ESC

STERMINAL

IS)

mpStep 65:

Give the Command:

Type

COPY

and

press

the

RETURN

press

and

new

name

the

RETURN

the

System

COPY (FROM)

type-system-name-here

ESC

the

your

SCOPY

(FROM)

TTY:

The

system

system.

After

you

then

new

key.

The

type

prompt.
the

ESC

key.

key;

$
as

press

system

TTY:

system
prints

now

CTRL/Z.

the

TTY:

“3Z.

prints
(TO).

waiting

enter

The

example

(TO)

the

(FROM).
Type

for
new

system

below,

MONNAM.TXT<RET>

you

system

prints

use

Type

TTY:

MONNAM.TXT

type
name,

“Z,

and

the
press

followed

Installation-test

name.

(TO)

MONNAM.TXT (rer)

MONNAM.TXT.1

Installation-test

System

(CTRLIZ)
~

$
You
name

can

change

only

BMpsStep 66:

when

this

file

the

monitor

any
is

Give the Command:

time,

started

should also
volume
header

change

entering

this

the

system

(whenever

COPY (FROM)

type-short-system-name-here

You

but

you

TTY:

“%.

(TO)

the system name that will
of any tape initialized by

label

PS:<SYSTEM>TAPNAM,.TXT.
characters, so you will

the

step.

name

appearing

tape

The

$SCOPY

(FROM)

TTY:

TTY:=>

TAPNAM.TXT.1

following

labels

name

This
system
probably have

(TO)

you

the

TAPNAM.TXT<RET>

written
users of the

want

system

system).

into

the
system.

the

file

name
must contain ten or fewer
to abbreviate the name given
in

step

written

reads
boot

shows

how

the

system

change
to

the

system

"Instal-tst".

TAPNAM.TXT(rer)

Instal-tst
(rer)

!Z
$

TOPS~20

Version

5.1

3-5

December

1982

TAILORING

3.3

CREATING

You must

create

parameters

The

SYSTEM DEFAULTS

the

line

Logical

names

Magnetic

tape

Line

Local

directory

DISABLE

prevents
unless

their

this,

into

the
user

has

example

decide

should

the

command

default

you

directory

system

parameters,

is
1is:

not

enter

the

5-1-CONFIG.CMD
from

WHEEL

changing

OPERATOR

disallowing

users

parameters.

DIRECTORY-PARAMETER-SETTING

and

Press

the

parameters,

type

key.

wusers

from

changing

their

DIRECTORY-PARAMETER-SETTING

02600
02700

change
to

because

directory

following

their

RETURN

file,

users

DIRECTORY-PARAMETER-SETTING

command

The

changing

BpStep 76:

their

directory

capabilities.
from

5-1-CONFIG.CMD

users
allow

1nto

users

SYSTEM

Setting

entered

allow

the

THE

DISABLE

and

directory
press

the

RETURN

key.

DIRECTORY-PARAMETER-SETTING (®r)

NOTE

the

default

allowed

directory
DIRECTORY

3.3.8
You

Account

have

name

the

when

option

they

are

account

WpsStep 77:
If
and

you

parameters

with

the

requiring

you
do
file,

enter

5-1-CONFIG.CMD

the

users

some

are
their
SET

commands.

logging

ACCOUNT-VALIDATION.

must

taken,

Validation

valid accounts,
5-1-CONFIG.CMD
you

1is

change

1if

command

file.

The

validation

users

the

system.

not
have
because

However,

the

all

to
the

you

enter

decide

you

valid

account

require

enter
any
command
into
the
system
default
1is:
ENABLE

decide

DISABLE

following

step

not

validate

ACCOUNT-VALIDATION
is

example

accounts,

1into
not

the
using

facility.

Type DISABLE ACCOUNT-VALIDATION and Press the RETURN Key.

are

press

not
the

02700

validating
RETURN

DISABLE

accounts,

type

DISABLE

ACCOUNT-VALIDATION

key.
ACCOUNT~VALIDATION
(Crer)

02800

3.3.9

Performance

Sections

3.3.9.1

working

set

TOPS-20

Version

Improvements

and

swapping,

5.1

3.3.9.2

discuss

full

1latency

optimization

and

December

1982

respectively.

3--14

TAILORING

3.3.9.1

Full

Latency

revolutions

SYSTEM

Optimization

FULL-LATENCY-OPTIMIZATION

number

THE

needed

When

entered

into

pages

read

the

command,

5-1-CONFIG.CMD

off

the

disk

ENABLE
file,

the

minimized.

NOTE

Before

you

feature,
DIGITAL

can

you
Field

following

wuse

this

must

performance

obtain

Service

from

your

Representative

information

about

the

your

hardware.
l.

TIf

you

must
2.

have

you

revision

have

board

wversion

level

KL10-E

M7772,

1level
or

processor,
level

you

and
may

3.
it

must

revision

have

board

M7786.

your

hardware

does

not

requirements,

take

which

DISABLE

the

meet

the

system

above

default,

FULL-LATENCY-

OPTIMIZATION.

WpStep 78:

Type ENABLE FULL-LATENCY-OPTIMIZATION and Press

the

RETURN

Key.

your

hardware

meets

FULL-LATENCY-OPTIMIZATION

02800

ENABLE

the
and

above
press

the

requirements,
RETURN

type

ENABLE

key.

FULL-LATENCY-OPTIMIZATION
(rer)

02900

3.3.9.2

Working

PRELOADING,
set

process

process's

Set
is

turn

page-by-page

Swapping

entered

brought
to

the

command,

5-1-CONFIG.CMD

into

run.

memory

Otherwise,

ENABLE

file,

once

this

the

when

action

WORKING-SET-

entire
it
occurs

working
1is

the
on

basis.

NOTE

You
only

should

enable

working

your

system

compute-bound

jobs.

set

swapping

runs

However,

large

1if

vyour

system
runs many interactive jobs or if
you are unsure which description
better
fits
your
system,
take
the
system

default,

which

DISABLE

.’Step 79:
02900

is:

WORKING-SET-PRELOADING

Type ENABLE WORKING-SET-PRELOADING and Press the RETURN Key.
ENABLE

WORKING-SET-PRELOADING
(rer)

03000

TOPS-20 Version 5.1

3-15%

December 1982

TAILORING

3.3.10

Scheduler

Sections

3.3.10.1

and

3.3.10.2

file,

Bias

where

the

describe

Controls

any

1larger

You

have

the

option

integer

the

between

percentage

and

interactive

jobs.

and

batch

20.

CPU

you do not give this
calling
for
-equal

and

class

deciding

The

how

vyour

and batch jobs.
5-1-CONFIG.CMD

smaller

time

that

command,
division

the

value

given

default
of
time

value of
between

Type the BIAS n Command.

The

example

which

value

controls

be divided between interactive
the command, BIAS n, into
the

interactive jobs.
If
11
will
be
taken,

I}Step 80:

bias

respectively.

system's CPU time is to
You do this by entering
of

SYSTEM

Controls

3.3.10.1

scheduling,

THE

below

shows

favors

for

03000

how

enter

interactive

your

own

BIAS

jobs.

system.

You

command

must

with

determine

value

the

correct

BTAS 6 (re1)

03100

3.3.10.2
Class Scheduling
your
system's
CPU
time
scheduling

account
vyour

assigns

number

- You
among

percentages

according

can

use class
scheduling
to
different
classes
of
jobs.

CPU

time

policy

jobs

according

program written

divide

Class

their
especially for

site.

NOTE

you

not

scheduling,

command
because

you

into
the

want

not

have

use
to

class

enter

any
the
5-1-CONFIG.CMD
file,
system default is:
DISABLE

CLASS-SCHEDULING.

If you use
CPU
time
The

either kind of class scheduling you can allocate any unused
(windfall)
among active jobs, or withhold it from all jobs.

command

allocating
ALLOCATED.
program

for

and

POLICY-PROGRAM

policy

and

class

is:
for

you

should

scheduling

ENABLE
enabling

withholding
WITHHELD.

program,

accounts,
two

enabling

windfall
The command

windfall

vyou

cannot

skip

using

1is:

enable

also

Section

policy

©program

and

CLASS-SCHEDULING
POLICY-PROGRAM
class scheduling using
a
policy
ENABLE
<class

enable
3.3.11

<class
after

CLASS-SCHEDULING

scheduling

wusing
a
scheduling
wusing

giving

one

these

commands.

Tf you do not have a policy program to
your
site, you can still enable class
classes

according

(Refer

Chapter

the
6

account
of

the

use

with
class
scheduling
scheduling by assigning jobs

under

which

TOPS-20

each

System

job

Manager's

running.
Guide

for

information about associating accounts with particular
classes.)
To
do
this
you
must first enter commands into the 5-1-CONFIG.CMD file,
specifying
each

the

percentage

CPU

time

that

given

jobs

1in

December

1982

class.

TOPS-20

Version

5.1

3-16

TAILORING

The command,

CREATE 1

.20,

THE

SYSTEM

specifies that jobs running under

accounts

1 are to be given a total of 20% of your system's CPU time.
class
in
system will
You must enter a CREATE command for each class that your
The sum of the
each class.
for
percentage
different
a
with
use,
although
100%,
than
percentages you specify must not add up to more
100%,
than
less
to
up
add
they
If
100%.
than
less
to
up
add
they may
the
of
part
the percentage of CPU time that is not assigned becomes
The following commands are an example of dividing
windfall.
system's
You must
up 75% of the system's CPU time among three classes of jobs.
class numbers and percentages for your

supply the correct

I’Step 81:

own system.

Enter CREATE Commands for Scheduler Classes.

Enter CREATE commands for your system's classes into 5-1-CONFIG.CMD.
03100
03200
03300

CREATE 1
CREATE 2
CREATE 3

.20 Crer)
.40(®D)
.15 (®r)

03400

Batch jobs can be put into a special class of their own
the

BATCH-CLASS

and

assigning

where

command,

includina

is the number of the class you

a BATCH-CLASS command,
enter
If you do not
choose for batch jobs.
are given CPU time according to the class associated with
jobs
batch
The
submission.
of
time
the
at
owner
Jjob's
the account of the
are an example of creating a class for batch jobs
commands
following

*Step 82:

Enter the BATCH-CLASS n Command and Assign a

This

03400

03500

to this class.

25% of CPU time

Percentage

Class.

BATCH-CLASS

CREATE

4 (rer)

.25 (rer)

03600

using
scheduling
<class
enables
Now you must enter the command that
must also decide whether to allocate any windfall CPU
You
accounts.
The
windfall.
time to the jobs that are running or to withhold this
It is recommended that you
1is ALLOCATED.
command
this
for
default
take

this

mpStep 83:

default,

Type ENABLE CLASS-SCHEDULING ACCOUNTS
the

ALLOCATED

and

Press

RETURN Key.

Now you actually enable

class

scheduling

giving

the

following

command
.

03600

ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED (rer)

03700

CAUTION

Do not enter the above command
until
file
5-1-CONFIG.CMD

entered

the

that
section
If you enable

creating
not

TOPS-20 Version 5.1

commands
<create
<class

classes,

shown

the
into
have
you

1in

this

scheduler classes.
before
scheduling

class scheduling will

function properly.

3-17

December 1982

TAILORING

3.3.11

File

Archiving

Sections

3.3.11.1

with

file

the

3.3.11.1

that
long
saved

days,

the

Tape

inserting
recycle

and

describe

tape

Period

TOPS-20

command
of

for

five

into

the

years,

For

you

1825

(because

1825

not

insert

command

1in

the

years)

will

BpsStep 84:
The

periods

provides

you

5-1-CONFIG.CMD

file,

for

wuse

would

example,

years

feature

magnetic tape
these
files

5-1-CONFIG.CMD

tapes.

ARCHIVE-TAPE-RECYCLE-PERIOD

days).

recycle

features.

storage of selected files on
You can specify for how long

period

tape

Parameters

migration

Recycle

off-line
of time.

SYSTEM

Migration

3.3.11.2

archiving

DIRECTORY

directory

PS:<REMARKS>

the
the

operator.
operator

directory

the

used

receive

messages

sent

Creating this directory avoids constant
from
wusers
1issuing
PLEASE
reguests.

operator

can

read

the

messages

users

interruption
With
this

specified

time

each

December

1982

day.

TOPS-20

Version

5.1

3-22

TAILORING

-}Step 96:
Type

THE

Give the Command

"ECREATE

Press

RETURN

Key.

and

press

CTRL/E

(DIRECTORY

the

CREATE,
NAME).

S"ECREATE

Type

SYSTEM

(DIRECTORY NAME)

the

PS:<REMARKS>

(DIRECTORY

NAME)

ESC
and

key.

press

PS:<REMARKS>

The

the

system

RETURN

and

prints

key.

PS:<REMARKS>
(rer)

[NEW]

l}Step 97:
Upon

Press the RETURN Key.

completion

Press

the

RETURN

the

key

above

and

step,

proceed

the

system

prints

the

step.

each

time

LPTSPL

[NEW]

and

S$S.

$$ (rer)
$

3.6
If

CREATING
the

for

THE

LPFORM.INI

the

line

file

printer,

Prints

the

FILE

created,

the

system

does

the

name

the

user

who

name

the

file

that

receives

request

following:
requested

the

1line

printer.

(BANNER)

Prints

After
the

this

file

received,

BpStep 98:

the
all

Type

will

again.
each

use

and

the

RETURN

file

printed,

(HEADER)
it

prints

reguest

for

the

line

©printer

1is

default.

CONNECT (TO

must

reside

the

ESC

Kkey.

press

that

printed.

DIRECTORY)

PS:<SUBSYS>

and

Key.

file
and

system

press

PS:<SUBSYS>

being

(TRAILER)

time

the

Give the Command:

LPFORM.INI

CONNECT

information

name

omitted,

LPTSPL

Press

The

the

user's

the

RETURN

The

directory

PS:<SUBSYS>.

system

(TO

prints

Type

DIRECTORY).

key.

(B
$SCONNECT
$

TOPS-20

(TO DIRECTORY)

Version

5.1

PS:<SUBSYS>
(®r)

3-23

December

1982

TAILORING

*Step 99:

Give the Command:
RETURN

THE

SYSTEM

CREATE (FILE) LPFORM.INI

and

Press

the

Key.

Use your system's text editing program to create the LPFORM.INI
file.
(The
example
below uses the editing program, EDIT.)
Type CREATE and
press the ESC key.
The system prints
(FILE).
Type
LPFORM.INI
and
press
the
RETURN key.
The system proceeds into edit mode and prints
00100.
The
parameters
in
the
example
below
are
used
only
for
explanatory
purposes.
You
must decide the parameters to be used on
your

system.
ESC

SCREATE
INPUT:

00100
00200

(FILE)

LPFORM.INI
Crer)

LPFORM.INI.1

NORMAL/BANNER:2/HEADER:2/TRAILER:2(xer)
NARROW/BANNER:2/HEADER:2/TRAILER:2/WIDTH:72
(rer)

00300

The above example causes the
user's
name
and
the
filename
to
be
printed
twice
on both normal and narrow forms before the actual data
is printed.
Also, after all the data is printed,
the
system
prints
the
wuser's
name
twice
again
on both normal and narrow forms.
The
parameter WIDTH:72 informs the system that a maximum of 72
characters
can
be
printed
horizontally on narrow forms.
(Refer to the TOPS-20
Operator's Guide for a complete
description
of
all
the
LPFORM.INI
parameters.)

mpStep 100:

Press the ESC Key.

Type EU and Press the RETURN Key.

To leave edit mode and save the file without line numbers,
press
the
EsC
key.
The
system prints the edit prompt.
Type EU and press the
RETURN key.
The system prints the filename and the generation number,
then

the

TOPS-20

00300

command

prompt.

ESC

*EU( rer )

[LPFORM.INI.1]

NOTE

If your system is going to
be
part
the ARPA network, you should perform
steps

Chapter

Appendix

before

going

of
the
to

NOTE

Perform
if
vyou
your

TOPS-20

Version

5.1

Step 101 through Step
are using an RP07 disk

system

111
only
drive for

structure.

3-24

December

1982

TAILORING

3.7

BUILDING

FRONT-END

FILE

Steps

101 through
the front-end

111

describe

for

file

system

the

TOPS-20

I’Step 101:

file

run

type

Give the

CHECKD

RUN

CHECKD

and

SYSTEM

STRUCTURE
bhow
when

to build an RP04
you are using an

RP06
structure
RP07 disk pack for

system.

RETURN

THE

Command:

RUN

(PROGRAM)

CHECKD

and

Press

the

Key.

create

press

the

structure

for

your

ESC

The

system

key.

RETURN

key.

The

front-end

prints

system

file

system,

(PROGRAM).

prints

the

FILE

SYSTEM

Type
prompt

CHECKD>.

SRUN

‘ (PROGRAM)

i e-

((rer)

CHECKD

CHECKD>

mpStep 102:

Give the CHECKD

Command:

CREATE

(NEW

FOR)

FE-SYS

inform

the

system

and

press

the

ESC

the

name

the

alphanumeric
key.

The

characters.
prints

CHECKD>CREATE

l’ffiep 103:
To
and

you

The

structure.

system

ENTER

that

key.

are

creating

system

prints

(NEW

FILE

SYSTEM

The

structure

name

can

consist

The

example

ENTER

(NEW FILE

CREATE

FOR).
of

Press

Type

the

RETURN

SYSTEM

FOR)

FE-SYS

(xer)

ALIAS:

the

press

FE-SYS.

type

ALIAS:.

Give the Command:

inform

uses

structure,

system

the

RETURN

the

FE-SYS and Press the RETURN Key.
alias

key.

name

The

system

the

structure,

prints

HOW

MANY

type
UNITS

FE-SYS
IN

THIS

STRUCTURE:
ENTER

HOW

I}Step 104:
The
1l
AND

ALIAS:

MANY

UNIT

FE-SYS

THIS

1 and Press the RETURN Key.

file

system

can

the

RETURN

key.

press
NUMBER

FOR

system

STRUCTURE:

UNITS

CONTROLLER,

5.1

reside

The

UNIT

HOW MANY

Version

only

LOGICAL

CHANNEL,

TOPS-20

STRUCTURE:

Give the Command:

front-end
and

UNITS

THIS

AND

single

prints

structure.

CHANNEL,

Type

CONTROLLER,

O:.

UNIT

NUMBER

3-25

()
FOR

LOGICAL

UNIT

O0:

December

1982

TAILORING

mpStep 105:
The

Give the Command:

front-end

drive

that

file

sure,

system

connected

are

not

type

the

information

needed

SYSTEM

1, -1, 0 and Press the RETURN Key.

must

reside

both

and

press

1, controller -1
(which
this
information,
the

THE

make

the

either

KL10

and

the

RP04

PDPll

RETURN

key.

decision.

The

RP06

front-end.

The

system

example

disk
TIf

you

prints

uses

channel

is the default), and unit 0.
After
vyou
type
system prints NUMBER OF PAGES TO ALLOCATE FOR

SWAPPING?

CHANNEL,

CONTROLLER,

NUMBER OF

PAGES

I’Step 106:
you

plan

RETURN

use

type

key.

Otherwise,

you

decimal

will

SWAPPING?

-1,

0Cs)

Key.

this

structure

number
type

using

this

between
and

press

structure

secondary

2000

and

the

RETURN

40,000

secondary

FOR SWAPPING?
FOR

PAGES

ALLOCATE

THE

system

and

key.

NUMBER

structure,

press

The

the

example

RETURN
assumes

structure.

7035

FRONT-END

(®1)

FILE

SYSTEM?

Type the Number of Pages to Allocate for the Front-End File
System

allocate

system,

‘

NUMBER OF PAGES TO ALLOCATE

I'Step 107:
To

FOR

Type the Number of Pages to Allocate for Swapping and Press
the

AND UNIT NUMBERS FOR LOGICAL UNIT 0:

TO ALLOCATE

the

type

and

Press

number

950

and

the

pages

press

RETURN
to

the

Key.

reserve
RETURN

for

key.

the

The

front-end

system

prints

file
OWNER

NAME?

NUMBER

OWNER

NAME?

I’Step 108:
Type

the

owner's
uses
FOR

owner's

name

the

ALLOCATE

FOR THE

FRONT-END

FILE

SYSTEM?

950 (1)

Type the Owner's Name and Press the RETURN Key.
can

name

from

OPERATOR.

the

The

structure

and

press

alphanumeric

system

prints

the

RETURN

characters.
THIS

Kkey.

The

SYSTEM

wused

The

example

STRUCTURE

STARTUP?

OWNER
IS

NAME?

THIS

mpStep 109:
To

PAGES

inform

OPERATOR

SYSTEM

the

system

type

YES

NUMBER

CPU

THIS

SERIAL

TOPS-20

FOR

STARTUP?

Type YES And Press the RETURN Key.

startup,
OF

STRUCTURE

STARTED

SYSTEM

NUMBER

Version

5.1

that

and

this

press
FROM

THIS

STRUCTURE
CPU

structure

the

RETURN

key.

will
The

system

prints

system
SERIAL

STRUCTURE?

FOR

STARTED

STARTUP?

FROM

3-26

THIS

YES
STRUCTURE?

December

1982

TAILORING

I’Step 110:
The

the

THE

SYSTEM

Type the Serial Number of the CPU and Press the RETURN Key.

system prints
structure and
SERIAL

information pertaining to
then the CHECKD prompt.

NUMBER

[FE-SYS:

CPU

STARTED

FE-SYS:]

MOUNTED

[DISMOUNTING

STRUCTURE

FROM

THIS

mounting

and

STRUCTURE?

dismounting

2102

FE-SYS:]

CHECKD>

mpsStep 111:
To

exit

system

the

Give the CHECKD Command:
CHECKD

prints

the

CHECKD>ZXIT

program,
TOPS-20

type

EXIT and Press the RETURN Key.

EXIT

command

and

prompt

press

the

RETURN

key.

The

December

1982

()

NOTE

When

performing

be
sure
system on

vyou
the

the

steps

Chapter

install the front-end
structure
you
have

4,
file
just

created.

TOPS-20

Version

5.1

3-27

CHAPTER
CREATING

THE

FRONT-END

FILE

SYSTEM

when
you
steps in this chapter restore the front-end file system
reinitialize
it
or change the front-end hardware.
They also restore
if
the
front-end
file
system
on
disk
1is
the front- end sofrware

The

destroyed.

These

steps

front-end

following

copy
file

front-end

Adds

MOU

the front-end software
space
on
the
public

the

a directory

list
in

the

front-end

devices.

front-end

file

space

public

structure.

PIP

Copies

files

RED

Changes the definition of the front-end
1logical
from the floppy disk to the public structure.

SAV

Saves

the

from the

front-end

Initializes

INI

the
the

programs:

a device

Creates

UFD

from the floppy disks
to
structure.
They involve

the

floppy disk

the public

the

structure.
name

SYO:

monitor.

front-end

file

system

the

public

structure.

4.1

HALTING THE

mp Step 112:
Be
and

sure

Make

'TOPS-20

Sure

that

MONITOR

the

that System Floppy A
System
Floppy
B

mp Step 113:

Step

Type

Chapter

Floppy Disks Are Mounted.

is mounted in the left
drive
1is mounted in the right drive

that

(Refer

Correct

you

have

CTRL/\.

type
CRL)
to
return
vyou
are at Command Parser

system

PAR>:

CTRL/\

PAR>

0)
1).

trouble.)

At the console terminal,
Command
Parser.
When
prints

(drive
(drive

the

prompt

to
the
front-end
command level, the

CREATING

mp Step 114:
To

stop

The

THE

FRONT-END

FILE

SYSTEM

Type SHUTDOWN and Press the RETURN Key.

the

system

TOPS-20
prints

monitor,

list

type

SHUTDOWN

and

press

the

RETURN

key.

messages.

PAR> SHUTDOWN (RED)
**HALTED**

$DECSYSTEM-20

Error:

you

which

The

4.2

RESTARTING

This

entire

rest

the

type

SHUTDOWN
reissue

the

(Rl
)

error

message

$DECSYSTEM-20

and

printed,

after

command.

give

the

NOT

RUNNING.

ABORT

command.

back

does
to

113.

THE

FRONT-END

procedure
described

W step 115:
Set

can

system must

Step

RUNNING

mistype
you

not,

monitor

NOT

is
in

MONITOR

invalid
Section

you

did

not

stop

the

TOPS-20

4.1.

Set the Switch Register to 000003 (Octal).

front-end

switch

000003

(switches

and

up,

the

down).

l"Step 116:

Hold ENABLE and Press the SWITCH REGISTER Button.

Hold ENABLE
and
press
the
SWITCH
REGISTER
button
to
start
the
front-end
monitor from drive 0.
The system will print a few lines of
information.
After
the
system
prints
[DX1: MOUNTED]
proceed
to
Section 4.3.
RSX-20F

VBl14-44

6:11

[SYO:
[DX0:

REDIRECTED
MOUNTED]

[DX1:

MOUNTED]

Error:

you

left

the

5-MAR-82
DXO0:]

switch

starts
the
KL
1Initialization
printout looks like this:
RSX-20F

[SYO:

VB14-44

6:11

REDIRECTED

[DX0: MOUNTED]
[DX1: MOUNTED]
KLI -- VERSION
KLI

ENTER

5-MAR-82

DXO0:]

VB12-27

DIALOG

set to
000007,
the
system
routine.
1In this case, the

RUNNING

[NO,YES,EXIT,BOOT]?

KLI>

Set the switch register
SWITCH REGISTER buttons

to 000003
again.

and

press

the

ENABLE

and

CREATING

If you
print:

set

THE

the

FRONT-END

switch

FILE

CONTAIN

SYSTEM

000003,

the

system

may

11-HALT
T04
or

**This
Set

VOLUME

the

SWITCH

4.3

COPYING

Use

the

typing
before

switch
REGISTER

FILES

following

want

line

FROM

FLOPPY

correctly

DISK

€wy ).

the

DELETE

HARDWARE-BOOTABLE
and

press

the

SYSTEM**

ENABLE

and

again.

copy

RP04

the

to the front end and
answer.
There is no

type

press

NOT

procedures

commands
typing the

you

DOES

You

key

RPO6

files.

Remember

that you must wait
type-ahead feature

can

type

erase

(hRL/U)

that

erase

single

you

are

for a prompt
except
when
an

entire

character

per

keystroke.

Many of the steps in this chapter and
disk
pack is mounted on drive 0.
To
drive 0, make the following changes:
1.

Where a step
the
actual

Messages
2.

the

printed

disk

pressing
set

the

and

SWITCH

start

about
You

are

not

system

be typed,
example:

will

reflect

mounted

drive

and

Step

151

DISK

switch

type the
DB1l:,

this

other

will

switches

number
of
DB2:, etc.

change.

than

not

drive

work.
and

the
than

Instead,
in

the

switches 10, 9, and 8 to the binary number of
For example, for drive 1, set switch
8
up;

set switch 9 up;
for drive 3, set switches 9
this has been completed,
press
the
ENABLE

After

buttons.

Type CTRL/\.
the

prompt

the

to
For

that
other

Set
used.

drive
up.

for DBO:
used.

front-end

and

mp Step 117:

ENABLE

position.
the drive
for

calls
drive

in Chapter
5
assume
use a dual-port drive

front-end

seconds
Command

PAR%.

The

Command

1load

Parser
%

after

Parser,

the

command
PAR

type

Command
level

indicates

CmrLy
).

Parser
when
that

from

The

system

takes

the

floppy

disks.

the

system

prints

the

central

processor

running:
[DX1:

MOUNTED]

CRL
)
PARS

mp Step 118:
The

central

halted
is not

STOP.
processor

before
halted,

front-end

file

is stopped, the
Parser
prompt.
command

and

(as

opposed

the

front-end

you proceed to the next step.
the
front-end
monitor
will

type

system

usable state.
When
percent sign, %,

system prints a
If
it prints
CWRLL)

before

angle

bracket,

continuing.

4-3

processor)

must

1If the central processor
not
be
saved
in
the

the central processor
following the Command
>,

give

the

SHUTDOWN

CREATING THE

.Step 119:

FRONT-END

FILE

SYSTEM

Type MCR INI and Press the RETURN Key.

To start the INITIALIZE program, type MCR INI
and
press
the
RETURN
key.
When
the
INITIALIZE program is ready for you to type commands
(after a few seconds), it prints the prompt INI>:
PAR¥MCR

INIGD)

INI>

l}:;tep 120:

Type DBO0:, and Press the RETURN Key.
Perform

the

Wait

Seconds

and

Step.

To initialize the front-end file system on the public structure,
type
DBO:
and
press the RETURN key.
In about 5 seconds, the INI program
finishes.
It does not reprint the prompt.
Proceed
directly
to
the
next

step.

INI>DBO
: ReD

message,
error
If you type the wrong device name or get an
start again at Step 117.
1If you still get an error message,
press the front-end HALT switch and
wait
one
minute.
Go

Error:

back

‘Step 121:

Step

116.

Type CTRL/\.

To start the front-end Command Parser, type
€RUY ).
When the
Command
Parser is ready for you to type commands (about 10 seconds), it prints
the

prompt

PAR%:

CTRL/
PAR%

NOTE

Nothing

mp Step 122:

happens

until

you

type

CTRL

Type MCR MOU and Press the RETURN Key.

To start the MOUNT program again, type MCR MOU and
press
the
RETURN
key.
When you are at MOUNT command level, the system prints MOU>:
PAR$MCR

MOURED

MOU>

Error:

If you make

’Step 123:

Type DBO:

and Press the RETURN Key.

To allow the

front end

(the
one
with
the RETURN key.

prints

typing

to use

MOU>

message

its

reissue

the command.

reserved area on the dual-port

disk

the channel selector set to A/B), type DBO:
and press
When the mount
operation
1is
complete,
the
system
and

the

prompt,

MOU>DBO : RED
MOU

error,

MOUNT

COMPLETE

MOU>:

CREATING

Error:

you

mistype

happens

and

command.

M) Step 124:

THE

FRONT-END

DBO:,

the

system

Otherwise,

FILE

mount

operation

reprints

back

SYSTEM

may

the

prompt

Step

121.

fail.

MOU>,

this

reissue

the

Type CTRL/Z and CTRL/\.

To terminate the MOUNT program and start the front-end Command Parser,
type
(€RUzZ)
,
followed
by
CRI ).
After about 10 seconds, when the
system is at Command Parser command level,
it prints the prompt PAR%:

CRL/Z)

MOU>"Z
€L )

PAR%

B Step 125:
To

run

the

system

few

Type MCR UFD and Press the RETURN Key.
UFD

loads

seconds,

prompt

program,
the

UFD

type

program

MCR

from

ready

for

UFD

the

you

and

press

the

floppy

disk

and

type

RETURN
starts

commands

key.
it.

and

The

After

prints

the

Seconds

and

UFD>:

PAR$MCR

UFD @D

UFD>

Error:

W) step 126:

you

make

create

the

structure)

press

the

reprint
next

typing

error,

Type DBO:[5,5], Press
Perform

directory

that

key.

the

When

prompt.

Wait

RETURN

the

Key,

command.

Wait

Step.

(in

contains

RETURN

the

reissue

front-end

the

UFD

reserved

file

system,

program

seconds

and

space
type

finishes,

then

proceed

the

public

DB0:[5,5]

and

not

does

directly

the

step:

UFD>DBO:[5,5]
Error:

the

system

UFD

Error:

FAILED

you

probably

you

ran

the

you
on.

did
MOU

system

UFD

should

not

DIRECTORY

the
Go

correct
back

command
Step

the

last

time

118.

prints:

delete

PAE$MCR

skip

give

program.

the

all
steps

DIRECTORY
PIP

PIF>DB0O:*.*/DE

Now

CREATE

DIRECTORY

Perform
UFD

prints:

Step

129.

ALREADY

files

EXISTS

the

below:
ALREADY

EXISTS

directory

before

going

CREATING THE

FRONT-END

FILE

SYSTEM

Type CTRL/\.

B Step 127:

type
disk,
floppy
the
from
Parser
Command
To load the front-end
After 10 seconds, the Command Parser is at command level and
CTRL/: )
the

system

prints

the

prompt

PAR%:

CRL
)
PAR%

NOTE

Nothing

happens

until

you

).
CTRL

type

Type MCR PIP and Press the RETURN Key.

l}:Step 128:

MCR
type
it,
To load the PIP program from the floppy disk and start
After 10 seconds, PIP is ready for you
and press the RETURN key.
PIP
to

PAR%MCR

system prints

The

type commands.

the prompt

PIP>:

PIP (RED

PIP>

If you make a typing error,

Error:

reissue the command.

Type DBO:/NV=DX0:*.*,DXl:*.* and Press the RETURN Key.

BStep 129:

disks
floppy
the
from
files
To copy the newest version of all the
drive 0 and drive 1) to the front-end file system on the public
(both
Kkey.
RETURN
the
press
and
structure, type DBO:/NV=DX0:*.*,DX1:*.*
the DELETE key to help type this line and
and
(WRUY)
use
can
(You
others

the

and

in this chapter.)

the

You will hear clicking as the system accesses

After about 10 minutes,

disks.

floppy

system prints

the prompt

the transfer

is complete

PIP>:

PIP>DB0:/NV=DX0:*.*,DX1:*,
* @D
PIP>

If you make a typing error,

Error:

Type CTRL/Z and CTRL/\.

)Step 130:
To end PIP
followed

commands

reissue the command.

and

start

€’ ).

prints

the

After

front-end

10 seconds,

prompt

Command

Parser,

PAR%:

CrRLZ)

PIP>"Z

CTRL/
PAR%

Error:

If you make a typing error,

type

CRL/Z)

the system is ready to accept

reissue the command.

CREATING

l"step 131:

THE

FRONT-END

FILE

SYSTEM

Type MCR RED and Press the RETURN Key.

To load and start the REDIRECT program from floppy disk, type MCR
RED
and
press
the
RETURN
key.
After the REDIRECT program is ready to
accept commands (about five seconds), the system prints
the
REDIRECT
prompt

RED>:

PAR$MCR

REDGRE

RED>

Error:

If you

l’»Step 132:

make

typing

Type DB0:=SY0:
and

Perform

the

error,

reissue

the

command.

and Press the RETURN Key.

Step.

Wait

Seconds

To redirect the primary front-end file structure from the floppy disks
to
the
front-end file system on the public structure, type DB0:=5Y0:
and press the RETURN key.
After 5 seconds, the
REDIRECT
program
is
finished
and
does
not
reprint the prompt.
Proceed directly to the
next

step.

RED>DB0 :=SY( : RED

Error:

If this operation fails or if you make
a
mistake
and
the
system has printed the prompt RED>, reissue the command.
If
it still fails, perform Steps 115 through 117 and Steps
122
through
124, then continue at Step 131.
(Even this may not
work.
You
may
have
to
perform
all
the
steps
again,
beginning with Step 115.)

® Step 133:

Type CTRL/\.

To start the
the
system

front-end Command Parser, type
{RU.J).
After one second,
loads and starts the Command Parser and prints the prompt

PAR%:

CTRL:)
PAR%

I"Step 134:

Type MCR SAV and Press the RETURN Key.

To start the SAVE program, type MCR SAV
and
press
the
RETURN
Kkey.
After one second, the SAVE program is ready to accept commands and the
system

prints

PARRMCR

the

prompt

SAV>:

SAV G

SAV>

Error:

‘Step 135:

If you

make

typing

error,

reissue

the

command.

=zero

Set the Switch Register to Zero.

Before proceeding,
down)
.

set

the

switch

(all

switches

CREATING

l"Step 136:
To

save

FRONT-END

FILE

SYSTEM

Type SY0:/WB and Press the RETURN Key.
the

front-end

system

file

the

RETURN

and

the

end

THE

key

(WB

monitor

restarts

bootstrap

system

the

stands

for

are

itself

saved,

the

and

the

front-end

public

structure,

write

bootstrap).

the

save

system
entry

prints

monitor

type

SY0:/WB

After

the

message

and

the

press

Dbootstrap

and

the

front

point:

YO
: /WBGRET
SAV>S
[DBO:

DISMOUNTED]

[DX0:
[DX1:

DISMOUNTED]
DISMOUNTED]

RSX-20F

VB14-44

6:28

[SYO:

REDIRECTED

[DBO:

MOUNTED]

The

last
files on

Error:

two

messages

the

TOPS-20

l"Step 137:

you

5-MAR-82
DBO:]

inform you
file system

make

typing

that

the front end is using the
instead of on the floppy disks.

error,

reissue

the

command.

Store the Floppy Disks A and B.

Remove the floppy
in a safe place.

disks,

insert

them

their

covers,

and

store

them

NOTE

vyou

have

some

spare

floppies

available,
it
1is
a
good idea to copy
System Floppies A and
B
to
the
spare
floppies
for backup purposes.
Refer to
the

this

TOPS-20

System

Manager's

Guide

for

procedure.

»Step 138: Mount System Floppy C on Drive 0
Mount System
in Chapter 2

Floppy
if you

C in
have

the left drive
trouble.)

(drive

0).

(Refer

Step

m) Step 139: Type CTRL/\
To

start

second,
prompt

the

front-end

the

system

PAR%:

CTRL
]
PAR%

Command

loads

and

Parser
starts

again,
the

type

Command

(CRU
Parser

).
and

After

one

prints

the

CREATING THE

FRONT-END

FILE

SYSTEM

mp Step 140: Type MCER MOU and Press the RETURN Key.
To start the MOUNT program, type MCR MOU and
press
When
the
system
1is
at
MOUNT
command level, the
prompt

the
RETURN
Kkey.
system prints the

MOU>:

PAR$MCR

MOUGRE)

MOU>

Error:

If you

make

»Step 141: Type DX0:
The

typing

error,

reissue

the

command.

and Press the RETURN Key.

MOUNT program mounts

floppy drive

then prints

the message MOUNT

COMPLETE:

MOU>DX:O0
ReD
MOU

l"Step 142:

MOUNT

COMPLETE

Type CTRL/Z and CTRL/\.

To terminate the MOUNT program and start the front-end Command Parser,
type
¢rUz),
followed
by
€R/ ).
After about one second, when the
system is at Commeand Parser command level, it prints the prompt PAR%:

PAR%

l"Step 143: Type MCR PIP and Press the RETURN Key.
To run
PIP is

the PIP program, type MCR PIP and press the RETURN
at command level, it prints the prompt PIP>:

PARSMCR

Kkey.

When

PIPRE:

PIP>

Error:

you

make

typing

error,

retype

the

command.

’ Step 144: Type DB0:/NV=DX0:*.* and Press the RETURN Key.
Copy
the
contents
of
DBO:/NV=DX0:*,*,
This
is

copied,

PIP

prints

the

System
Floppy
C
to
the
disk
by
typing
copies RSX20F.MAP to the disk.
When the file
prompt

PIP>:

PIP>DBO:/NV=DX0:*,
* ReD)
PIP>

M) Step 145:

Type DBO:/LI and Press the RETURN Key.

To get a list of the files on the front-end file system, type
DBO:/LI
and
press
the
RETURN
key.
The system prints the list of the files
copied from floppies A, B, and C.
Check
1t
against
the
directory
listing shown in the TOPS-20.BWR file to
files shown there.
The TOPS-20.BWR file
Installation tape.

be
is

sure that you
1located
on

have
the

all the
TOPS-20

CREATING

The

directory
order

comparing

the

256-word

the

system

THE

FRONT-END

FILE

SYSTEM

Do not worry about
listing shown here is only a sample.
the files, generation numbers, or dates and times when
The file sizes (indicated in the
second
column
files.

blocks)

prints

should

the

prompt

the

same.

When

the

listing

finished,

the
the

front-end

PIP>:

PIP>MB)
: /LI REY
DIRECTORY
5-0CT-81

DBO:[5,5]
16:36

F11ACP.TSK;1

77.

24-NOV-80

16:30

KLDISC.TSK;1

24-NOV-80

16:30

KLRING.TSK; 1
KLXFER.TSK; 1

6.
5

C
C

24-NOV-80
24-NOV-80

16:30
16:30

MIDNIT.TSK;1

4.,

24-NOV-80