Digital PDFs

AA-4195F-TM

May 1978

186 pages

Original

13MB

view download

OCR Version

40MB

view download

Document:	(TOPS20Instl)
Order Number:	AA-4195F-TM
Revision:	0
Pages:	186
Original Filename:	AA-4195F-TM(TOPS20Instl).pdf

OCR Text

TOPS-20

SOFTWARE
INSTALLATION GUIDE
Order Number: AA-4195F-TM

October 1978
This manual describes installing the TOPS-20 software on a new DECSYSTEM-20 or
DECSYSTEM-2020. It also describes the procedures for updating the TOPS-20 software
on an existing DECSYSTEM-20 or DECSYSTEM-2020.

This manual supersedes the following manuals.

1. DECSYSTEM-20 Software tnstallation Guide.
Order No: AA-4195E-TM
Published January 1978

2. DECSYSTEM-2020 Software Installation Guide.
Order No: AA-C894A-TM
Published May 1978

OPERATING SYSTEM:

TOPS-20 V3A (2007)

SOFTWARE:

RSX-20F VB12-32(2040/2050) VB12-34(2060)
KLINIT VB07-04(2040/2050) VB10-45(2060)
MICROCODE 202(2040) 212(2050/2060)

To order additional copies of this document, contact the Software Distribution

Center, Digital Equipment Corporation, Maynard, Massachusetts 01754

digital equipment corporation - maynard. massachusetts

First Printing,

October

1978

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 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.

The

following

are

trademarks of Digital Equipment Corporation:

DIGITAL

DECsystem~10

DEC

DECtape

OMNIBUS

PDP
DECUS

DIBOL
EDUSYSTEM

0s/8
PHA

UNIBUS

FLIP

RSTS

COMPUTER LABS
COMTEX
DDT

FOCAL
INDAC
LAB-8

TYPESET-8

DECCOMM

DECSYSTEM=~-20

TMS-11

ASSIST-11

DECSYSTEM-2020

ITPS-10

CHIP

MASSBUS

RSX
TYPESET-11

CONTENTS

CHAPTER

INTRODUCTION
PREPARING

FOR

INSTALLATION

OVERVIEW OF

INSTALLATION

THE

TOPS-20

THE

TOPS-20 MONITOR AND
The Batch System

CHAPTER

SOFTWARE

TOOLS

CREATING THE

TOPS-20

THE

FILE

TOPS-20AN

MONITOR

SYSTEM

CHECKING

THE TOPS-20 SOFTWARE PACKAGE
DECSYSTEM-20
PREPARING THE DECSYSTEM-20 FOR INSTALLATION

FOR THE

Loading
on

and Starting

the TOPS-20

Monitor

DECSYSTEM-20

CHECKING

FOR THE

THE

TOPS-20

SOFTWARE

PACKAGE

DECSYSTEM-2020

Preparing the DECSYSTEM-2020
for Installation
Loading and Starting the TOPS-20
on a DECSYSTEM-2020
INITIALIZING

THE

TOPS-20

FILE

Monitor

SYSTEM

STARTING THE MONITOR
CREATING A SPECIAL SYSTEM DIRECTORY
RUNNING DUMPER FROM TAPE
TOPS-20

TAILORING

THE

Ut b

WW
B
B

FROM

TAPE

SYSTEM

DECSYSTEM-20

CHANGING
CHANGING

THE

AND

GROUP

USER

ONLY)

PTYCON.ATO
OPERATOR'S

CREATING

PS:<REMARKS>

CREATING

THE

HALTING

THE

RESTARTING

PASSWORD

DIRECTORY

LPFORM.INI

CREATING THE
wWN
=

SOFTWARE

3A-CONFIG.CMD
Setting Terminal Speeds
Defining Dialup (REMOTE) Lines
Defining System Logical Names
Defining Magnetic Tape Logical Unit Numbers
Defining Line Printer Parameters
Specifying the VFU File
Specifying the RAM File
Defining the Local Timezone
Directory Parameter Settings
Account Validation
Full Latency Optimization
(FOR

CHAPTER

BUNDLED

SELECTING A TOPS-20 MONITOR
CHANGING THE SYSTEM NAME
CREATING SYSTEM DEFAULTS IN

WO
WN -

@
e
s
s
o
e
v
o
&
e
o
&
e
s

WWwWwwwwwwwwwwww

WWWWwWwWwwwwwwwwioe

CHAPTER

RESTORING

FRONT-END
TOPS-20

THE

FILE

MONITOR

FRONT-END

COPYING

FILES

TO RP04

OR RPO6

FROM

iii

SYSTEM

FLOPPY

MONITOR
DISK

CONTENTS

(CONT.)

Page

CHAPTER

CREATING

CHAPTER

RESTARTING

THE

CHAPTER

INSTALLING

UNBUNDLED

CHAPTER

RUNNING THE

TOPS-20

8.1

TESTING

UPDATING

SOFTWARE

DECSYSTEM-20

THE

RELEASE

3A SOFTWARE
Release 3 Monitor
File <NEW-SYSTEM>3A-CONFIG.CMD

RELEASE

PRIMARY

MAKING

THE

MONITOR

MONITOR
RELEASE

INSTALLING

THE

Renaming
Creating
Changing
Changing

RELEASE

TOPS-20

SOFTWARE

the Release 3 Monitor
the File <NEW-SYSTEM>3A-CONFIG.CMD
System Parameters
the Operator's Password

PERMANENT

POCKET

POCKET
FOR THE

MONITOR

INSTALLATION

GUIDE

DECSYSTEM-20

INSTALLATION

GUIDE

DECSYSTEM-2020
YOUR

TAILORING

E.1l
E.1l.1

DEFINING THE HOST NUMBER
Entering the Host Number,
and Other

SYSTEM

Pertinent

REVERTING TO RELEASE 3
MAKING THE RELEASE 3A MONITOR
[w

FYRYNY

MONITOR

TwEwwwww

PERMANENT

UPDATING THE DECSYSTEM-2020
RELEASE 3A SOFTWARE

TOPS-20

SOFTWARE

FOR ARPANET

Name,

Information

C
VN
S

e
e

= b

.
.

o
.«

W R

REVERTING
MAKING

-3

PACKAGE

System Parameters
the Operator's Password

FOR THE

APPENDIX

UETP

Changing
Changing

THE

APPENDIX

SOFTWARE

the
the

THE

APPENDIX

SYSTEM

Renaming
Creating

THE

APPENDIX

THE

FILE

SYSTEM

UNBUNDLED

INSTALLING THE

RELEASE

MICROPROCESSOR

w
!

APPENDIX

THE

CONTENTS

(CONT.)

Page
FIGURES

FIGURE

2-1

2=-2

DECSYSTEM-20

and

Front-End

Control

DECSYSTEM-2020 Control Panels

Panels

2-8

2-9

Terminal

3-3
3-4

DECSYSTEM-20

6-1
7-1

System

Line

Numbers

Line

DECSYSTEM=-2020

Reload

Unbundled

DECSYSTEM-2020

Printers

Line

Printers

Abbreviations

Software

Products

[

3-2

Logical Memory Configurations
Terminal Line Numbers DECSYSTEM-20

2-1
3-1

TABLE

\xa(»truauaw

TABLES

Reader

This manual
1.

for

the

Installing

person who

the

TOPS-20

This

has

Manual

the

software

responsibility
on

new

of:

DECSYSTEM-20

DECSYSTEM~20

DECSYSTEM=-2020

Updating the TOPS-20
DECSYSTEM-2020

software

existing

To use this
manual
effectively,
first
read
Getting
Started
With
DECSYSTEM-20
and
then
become
familiar
with the information 1in the
DECSYSTEM-20 Operator's Guide or the DECSYSTEM-2020
Operators
Guide,
depending
on
the
type
of
system
you are installing.
Also become
familiar with the information in the DECSYSTEM-20 User's Guide.
You do not
experience
helpful.

have to know assembly language programming or have previous
1installing
a
TOPS-20
software system, although both are

Contents

Of This

Manual

Chapters 1 through 8 contain
step-by-step
instructions,
with
error
recovery procedures, describing how to install the Release 3A software
on a new DECSYSTEM-20 and/or DECSYSTEM-2020.
Even though most of
the
installation
procedures
within
this manual pertain to both systems,
there are certain steps and error
recovery
procedures
that
pertain
only
to the DECSYSTEM-2020.
These procedures will be shaded in gray,
e.g., Chapters 2, 5, and 6.

The error recovery procedures that pertain to
have the word error printed
as Error.

the

DECSYSTEM-20

will

The error recovery procedures that pertain to the DECSYSTEM-2020
have the word error printed as ERROR and will be shaded.

will

NOTE

you

see:

Error:

ERROR:
together

for

error

procedure,
it means this
procedure is the same for

recovery

error recovery
both systems.

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

Appendix B contains step-by-step instructions and pointers to
various
chapters
within
the
manual,
describing
how
to update a Release 3
TOPS-20 software system to a Release 3A TOPS-20 software system on the
DECSYSTEM-2020.

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

recovery

steps within
TOPS-20

a pocket

installation

guide

on
a
DECSYSTEM-2020.
This
procedures.
The steps in this

the

software

Appendix

body of
on

contains

this manual

for

installing

appendix
appendix

that

does
are

describes

the

TOPS-20

not have error
keyed
to
the

how

install

the

for

the

ARPA

DECSYSTEM-2020.

the

steps

for

tailoring

your

system

network.
The

DECSYSTEM~20

contain

helpful

DECSYSTEM-2020

and

the

hints

timesharing

DECSYSYEM-2020

how

systems.

manual
which
pertains
to
generally available to users.

his

How To

Use

System

manage

Manager's

the DECSYSTEM-20

Guides

and

the

A system manager should read that
system
before
making
timesharing

This

Manual

To install the TOPS-20 software on a DECSYSTEM-20
and
DECSYSTEM-2020
follow
the
directions
in
Chapters
1,
2, 3, 4, 6, 7, and 8, doing
exactly as instructed.
Steps that pertain only
to
a
DECSYSTEM-2020
are
shaded in gray.
If you are experienced in installing the TOPS-20
software, you may follow the example in Appendix C or D
depending
on
the type of system you are installing.
To
wupdate
the
DECSYSTEM-2020:

TOPS-20

software

both

the

DECSYSTEM-20

and

Carefully perform the instructions in either Appendix A or B depending
on
whether
you are installing the TOPS-20 software on a DECSYSTEM-20
or
you

DECSYSTEM-2020.
type

The

accurately,

function and
output.

verify

Remember

commands
all

that

you

the

that

you

must

have

terminal

the

type

are
is

output

systems

differ

printed

perform

resembles
in

the

memory

RED.

indicated

the

sample

size

and

peripherals, so steps that describe configuring
memory,
initializing
line
printers
and
disk packs, and assigning logical unit numbers to
tape drives require you to type the values that are correct
for
your
system

and

not

the

sample

parameters.

If your terminal output does
read
ALL
the
instructions
recovery

procedure

that

not resemble
the
sample
after
the word "Error",

corrects

your

problem.

NOTE

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

vii

output,
first
then choose the

Time estimates are included
takes.
Times are estimated
step

takes

somewhat

longer

so
to
or

that you know ABOUT
how
1long
a
the nearest minute, so don't worry
shorter

than

the

estimate.

If a step pertains only

to a certain

type of system,

beside the step heading

it will

(For DECSYSTEM-20 Only).

_such.

For

example

step
if a

it will

noted

1if a step pertains only to the DECSYSTEM-=-20,
say

step pertains only to a DECSYSTEM-2020, it will be shaded iIn gray.

Checking off each

step as you complete

is a good way to

the

keep

your

1is

done

place.

Symbols
(D)

Indicates

where

Used

you

by
holding down
backslash key is

In This

type

Manual

control

backslash,

this

the CTRL key while typing a backslash.
The
located near the key
1labeled
LINEFEED
or

LF.

(esc )

Indicates where you
PREFIX,

RET

ALT,

press

the

key

labeled

ESC,

ESCAPE,

ALTMODE.

Indicates where you press

Reference

the RETURN

key.

Documentation

The following lists all DECSYSTEM-20 and
DECSYSTEM-2020
manuals
order
numbers
of the latest versions available.
1In this manual
of the following manuals are referenced by title only.
Refer
to
list below for the order numbers of referenced manuals.

Manual
Getting

Started With

Title

Order

DECSYSTEM-20

and
some
the

No.

AA-4187C-TM

DECSYSTEM-20

System Manager's Guide

AA-4169E-TM

DECSYSTEM-20
Update

User's Guide

AA~4179B-TM
AD-4179B-T1
AD-4179B-T2

DECSYSTEM-20

Monitor

Calls

DECSYSTEM-20 Operator's
Update
DECSYSTEM-20

User's

Guide

AA-4176C~TM
AD-4176C-T1

Batch Operator's

Guide

DEC-20-0BOGA~-A-D

Update

DECSYSTEM=-20

DN1,

Monitor

Calls

Reference

Update

Manual

DN2,

DN3

AA-4166C-TM
AA-4166C-T1

DECSYSTEM-20
Update

Batch

DECSYSTEM-20

Link

DECSYSTEM-20

EDIT User's

Getting

DEC=~20-OMUGA-A-D

Reference

Started With

Manual

Guide

DEC-20-OBRMA-A-D
DN1, DN2, DN3
AA-4183B-TM

DEC-20-UEUBA-A-D

Runoff

DEC-20-URGSA-A-D

viii

Manual

Title

Order

No.

DECSYSTEM-20

SORT/MERGE

DECSYSTEM-20

Macro

Assembler

Reference

Manual

AA-4159C-TM

DECSYSTEM-20

MAKLIB

Program

Functional

Spec.

DEC-20-UMKLA-A-D

DECSYSTEM-20

USAGE

DECSYSTEM-2020

File

User's

Guide

AA-4186C-TM

Specification

Operator's

AA-4181A-TM

Guide

AA~C765A-TM

Update

AD-C765A-T1

DECSYSTEM-2020

System Manager's

Guide

AA-C895A-TM
AD-C895A~-T1

Update

User

Environment

Test

Package

DECNET-20 Programmer's
Operator's Manual

TOPS-20

Software

TOPS-10

and

Hardware

Guide

Reference
and

Installation

TOPS-20

Reference

Manual

AA-5091A-TM

Guide

AA~-4195F-TM

SYSERR Manual*

Manual

Vol.

DECSYSTEM-20

FORTRAN

Reference

DECSYSTEM-~-20

APLSF

Reference

DECSYSTEM-20

BASIC

User's

DECSYSTEM-20

COBOL

Utilities

DECSYSTEM-20

COBOL

Programmer's

AA-D533A-TK

EK-10/20-HR-001

Manual

AA-4158B-TM

Manual

DEC-20-LASFA-A-D

Guide

DEC-20-LBMAA-A-D

Manual

DEC-20-LCUMA-A-D

Reference

Update

TOPS-20AN

Monitor

Calls

User's

Manual

Guide

IBM

DEC-20-LCRMA-A-D
DN1
AA-4963A-TM

Update
TOPS-20AN

AA-D606A-TM

AD-4963A-T1

User's

Guide

AA-5221A-TM

Emulation-Termination
Update

DECSYSTEM-10/20

ALGOL

DECSYSTEM-20/PDP-11

2780/3780

DN64:

Programmer's

BASIC-PLUS~2

DECSYSTEM-20

BASIC-PLUS-2

User'‘'s

DECSYSTEM-20

DBMS

Administrator's

DECSYSTEM-20

DBMS

Programmer's

AA-5095A-TM
AD-5095A-T1

Guide

Language

AA-0196C-TK

Manual

Guide

AA-0152A-TM

Procedures

AA-0153A-TK

Manual

Batch

AA-4146B-TM
AA-4149B-TM

Getting

Started With

TRAFFIC

User's

Manual

DEC~-20-ATUMA-A-D

EDIT

Reference

Manual

AA-5415A-TM

*This

manual

supersedes

the

Reference Manual - Order No.

AA-C781B-TM

Error

Detection,

EK-SEDRR-RF-002.
ix

Recovery,

and

Reporting

CHAPTER

INTRODUCTION

Installing
the
TOPS-20
software
on
either
the
DECSYSTEM-20
or
DECSYSTEM-2020
is
not
a
hard
task
if
you
follow the procedures
outlined in the following chapters.
This chapter explains some of the
procedures to follow.
It also describes the tools you need to install
the software.
Before starting
the
installation,
read
the
listing
labeled TOPS20.BWR which accompanies your software.

1.1

PREPARING FOR

INSTALLATION

A Digital Field Service representative will install your
DECSYSTEM-20
or
your
DECSYSTEM-2020
hardware and inform you when the system runs
diagnostics
correctly.
Before
he
1leaves
obtain
the
following
information.

The serial number of the machine.
This information is needed
if
you
are installing the software on a DECSYSTEM-2020.
It
will be used in Chapter 5.
SERIAL

NUMBER

The channel and unit number of each disk drive and if
it
is
dual-ported
(the DECSYSTEM-2020 does not support dual-ported
disk drives).
The unit number is on the display panel on the
drive.
The
DECSYSTEM-20
dual-ported
disk
drives
are
connected to both the C.P.U.
and
the
front-end
processor.

number

an error

are

if two dual-ported drives with the same unit

connected

the

front-end

procedures
in
this
manual
assume
installing the front-end software on
DISK

TYPE

CHANNEL#

processor.

that
the
is Unit 0.

DRIVES

UNIT#

DUAL-PORTED

The

unit you are

INTRODUCTION

The

UBA%#

to which

information
software

the

disk

needed

drives

DECSYSTEM-2020.

attached

installing

to.

This

the TOPS-20

line speeds.
Use these numbers in
set
the
default terminal speeds.
out which lines are remote so that you can
define
lines as described in Section 3.3.2.

Also,

the

are

U.B.A

A list of line
Section
3.3.1

you

find
remote

numbers and
when
you

LINES

Auto

Line

Auto

Speed

Remote?

Line

Speed

Remote?

NOTE

The

word

Auto

over

the

word

Speed

declares

line
has
been
specified
as
an
autobaud
Section 3.3.2.
Autobaud detection pertains
the DECSYSTEM-20.

that

1line
only

the

in
to

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

Tapes

SERIAL

TYPE

SERIAL

NOTE

The serial numbers on a TU70 and/or TU71
tape
drives
are
made
up
of
three
factors.
These factors consist
of
the
RH20
and

channel
number,
the DX20 number,
a
two
digit
tape
unit
number.
Assuming that the RH20 channel number is
2, the serial number
for
tape
unit
3
would be as follows:

2003
In
is

the above example, the
RH20
channel
the first digit (2), the DX20 number

is the second digit (0),
and
the
last
two
digits
are
the
tape
unit number
(03).
The serial number for a TU72 tape
drive
can
be
found on the back of the
tape drive.

TYPE

INTRODUCTION

The unit number and type of
information in Section 3.3.5
Line

each
1line
printer.
to initialize the line

Use
this
printer.

Printers
Programmable

Unit

Model

Lowercase

The
base
address
of
the
RH11
information
1is
needed
if
you
software on a DECSYSTEM~2020.
RHBASE

Creating

The

TOPS-20

File

System

VFU

disk
controller.
are
installing the

This
TOPS-20

(Chapter

This chapter describes powering
up
both
the
DECSYSTEM-20
and
the
DECSYSTEM-2020,
obtaining the DECSYSTEM-20 front-end monitor from the
floppy
disk,
obtaining
the
DECSYSTEM-2020
preboot
monitor
from
magnetic
tape.
This
chapter
also
describes
1loading
the TOPS-20
bundled software from magnetic tape.

Tailoring The System

(Chapter

Each installation is unique.
Chapter 5 describes how
to
select
the
proper
monitor,
declare
the
system
name,
and
change
the system
defaults for terminals, line printers, magnetic tapes, accounting, and
time

zone.

Creating The

Front-End File System

Create the front-end
floppy
disk.
Upon
complete.

Creating

The

(Chapter

file system and
completion
of

Microprocessor

File

(DECSYSTEM-20 ONLY)

copy
files
this chapter,

System

(Chapter

into
it
from
the
the installation is

(DECSYSTEM-2020

ONLY)

This

chapter

describes

the

steps

microprocessor
file
system.
After
chapter the installation is complete.

Restarting The System

(Chapter

This chapter
disk.

the

Installing
The

steps

software

describes

Unbundled
in

this

chapter

you

have

purchased.

building

the

steps

the
this

steps

Software

involved
completing

involved

(Chapter

describe

boot

both

systems

from

7)
how

install

any

unbundled

INTRODUCTION

Running The U.E.T.P.

Program

(Chapter

This
chapter
describes
the
steps
involved
in
running
the
User
Environment
Test
Package.
This program performs a cursory check of
the

software.

Updating

The steps
updating

the DECSYSTEM-20 To Release

this

Appendix

(Appendix A)

describe

the DECSYSTEM-20 to Release

the

3A.

Updating the DECSYSTEM-2020 to Release 3A
The steps in
updating

this

appendix

described

the DECSYSTEM~2020 to Release

appendix

TOPS-20 Release

1list

step~by-step

involved

(Appendix B).
the

3A.

Pocket Installation Guide For The DECSYSTEM-20

This

procedures

(Appendix C)

instructions

3A software on a DECSYSTEM-20.

for

installing

Pocket Installation Guide For The DECSYSTEM-2020

(Appendix D)

This

for

appendix

TOPS-20 Release

list

step-by-step

instructions

3A software on a DECSYSTEM-2020.

Tailoring Your System For ARPANET

(Appendix E)

This appendix contains the steps involved
the ARPA network.

1.2

AN OVERVIEW OF THE TOPS-20 SOFTWARE

1.3

INSTALLATION TOOLS

You need

the

DECSYSTEM-20:

following tools to

install

the

installing

the

(DECSYSTEM-20 ONLY)

in tailoring your system for

the

TOPS-20

software

The RSX-20F Disk-Boot System, System Floppy A.
The files
on
this
floppy
are
used to boot the central processor from an
RP04 or RP06 disk pack.
These files are:
PARSER.TSK;1
T20ACP.TSK;1
BOO.TSK;1
COP.TSK;1
DMO.TSK;1

95.
8.
19.
8.
5.

C
C
C
C
C

27-JUN-78
07-JUN-78
07-JUN-78
07-JUN-78
07-JUN-78

11:40
09:26
09:26
09:26
09:26

PIP.TSK;1
RED.TSK;1
SAV.TSK;1

56.
6.
13.

C
C
C

07-JUN-78
07-JUN-78
07-JUN-78

09:26
09:26
09:26

01-MAY-77

00:02

INI.TSK;1l

UFD.TSK;1l
ZAP.TSK;1l

RSX20F.SYS;1

23.

9.
38.
56.

C
C

07-JUN-78 09:26

07-JUN-78 09:26
07-JUN-78 09:27

INTRODUCTION

The

RSX~20F Auxiliary
this
floppy
are

Diskette,

System Floppy B.
The
files
used
to boot for various functions in
installing and maintaining the software
on
a
DECSYSTEM-20.
These files are:
on

The

F1l1ACP.TSK;1

77.

KLDISC.TSK;1

07-JUN-78 09:20

07-JUN-78

KLRING.TSK;1

07-JUN-78

KLXFER.TSK;1