TOPS-20 KL Model B
Installation Guide
| Electronic Distribution
| April 1990
This manual describes the procedures for
installing TOPS-20 Version 7.0 on a new
system and updating TOPS-20 software on
an existing KL10 Model B system.
Change bars in the margins indicate
material that has been added or changed
since the previous release of this
manual.
This manual supersedes the manual of the
| same name and order number, AA-M229C-TM.
Please read it in its entirety.
OPERATING SYSTEM: TOPS-20 Version 7.0
SOFTWARE: RSX-20F Version 16-00
KLINIT Version 16-00
Microcode Version 442
digital equipment corporation
maynard, massachusetts
First Printing, April 1982
Updated, December 1982
Revised, September 1985
Revised, June 1988
| Software Update Tape 2, April 1990
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 Equipment Corporation or its
affiliated companies.
| Copyright C 1982, 1985, 1988, 1990, Digital Equipment Corporation.
All Rights Reserved.
Printed in U.S.A.
The Reader's Comments form on the last page of this document requests
the user's critical evaluation to assist in preparing future
documentation.
The following are trademarks of Digital Equipment Corporation:
CI DECtape LA50 SITGO-10
DDCMP DECUS LN01 TOPS-10
DEC DECwriter LN03 TOPS-20
DECmail DELNI MASSBUS TOPS-20AN
DECnet DELUA PDP UNIBUS
DECnet-VAX HSC PDP-11/24 UETP
DECserver HSC-50 PrintServer VAX
DECserver 100 KA10 PrintServer 40 VAX/VMS
DECserver 200 KI Q-bus VT50
DECsystem-10 KL10 ReGIS
DECSYSTEM-20 KS10 RSX d i g i t a l
CONTENTS
PREFACE
CHAPTER 1 INTRODUCTION
1.1 COLLECTING INFORMATION . . . . . . . . . . . . . . 1-1
1.1.1 Disk Drives . . . . . . . . . . . . . . . . . . 1-2
1.1.2 Terminal Lines . . . . . . . . . . . . . . . . . 1-2
1.1.3 Magnetic Tape Drives . . . . . . . . . . . . . . 1-3
1.1.4 Line Printers . . . . . . . . . . . . . . . . . 1-4
1.2 INSTALLATION TOOLS . . . . . . . . . . . . . . . . 1-4
1.2.1 Floppy Disks . . . . . . . . . . . . . . . . . . 1-5
1.2.2 Tapes . . . . . . . . . . . . . . . . . . . . . 1-5
1.3 THE TOPS-20 MONITORS . . . . . . . . . . . . . . . 1-6
1.4 THE BATCH AND SPOOLING SYSTEM . . . . . . . . . . 1-6
CHAPTER 2 CREATING THE TOPS-20 FILE SYSTEM
2.1 CHECKING THE TOPS-20 SOFTWARE PACKAGE . . . . . . 2-1
2.2 PREPARING THE DECSYSTEM-20 FOR INSTALLATION . . . 2-2
2.3 LOADING AND STARTING THE TOPS-20 MONITOR . . . . . 2-7
2.4 INITIALIZING THE TOPS-20 FILE SYSTEM . . . . . . 2-14
2.5 RESTARTING THE MONITOR . . . . . . . . . . . . . 2-21
2.6 CREATING SYSTEM DIRECTORIES . . . . . . . . . . 2-24
2.7 RUNNING DUMPER FROM TAPE . . . . . . . . . . . . 2-26
2.8 RESTORING TOPS-20 BUNDLED SOFTWARE FROM TAPE . . 2-27
2.9 CREATING THE DUMP.EXE FILE . . . . . . . . . . . 2-34
CHAPTER 3 TAILORING THE SYSTEM
3.1 SELECTING A TOPS-20 MONITOR . . . . . . . . . . . 3-2
3.2 CHANGING THE SYSTEM NAME . . . . . . . . . . . . . 3-5
3.3 CREATING SYSTEM DEFAULTS IN THE CONFIGURATION
COMMAND FILE . . . . . . . . . . . . . . . . . . . 3-6
3.3.1 Setting Terminal Speeds . . . . . . . . . . . . 3-7
3.3.2 Defining Dial-Up (Remote) Lines . . . . . . . . 3-9
3.3.3 Defining System Logical Names . . . . . . . . 3-10
3.3.3.1 Selecting an Editor . . . . . . . . . . . . 3-11
3.3.4 Defining Magnetic Tape Logical Unit Numbers . 3-11
3.3.5 Defining Line Printer Parameters . . . . . . . 3-12
3.3.5.1 Specifying the VFU File . . . . . . . . . . 3-13
3.3.5.2 Specifying the RAM File . . . . . . . . . . 3-14
3.3.6 Defining the Local Time Zone . . . . . . . . . 3-15
3.3.7 Directory Parameter Setting . . . . . . . . . 3-15
3.3.8 Account Validation . . . . . . . . . . . . . . 3-16
3.3.9 Performance Improvements . . . . . . . . . . . 3-16
iii
3.3.9.1 Full Latency Optimization . . . . . . . . . 3-16
3.3.9.2 Working Set Swapping . . . . . . . . . . . . 3-17
3.3.10 Scheduler Controls . . . . . . . . . . . . . . 3-18
3.3.10.1 Bias Controls . . . . . . . . . . . . . . . 3-18
3.3.10.2 Class Scheduling . . . . . . . . . . . . . . 3-18
3.3.11 File Archiving and Migration Parameters . . . 3-20
3.3.11.1 Archive Tape Recycle Period . . . . . . . . 3-20
3.3.11.2 Migration Tape Recycle Period . . . . . . . 3-20
3.3.12 Tape Drive Allocation . . . . . . . . . . . . 3-21
3.3.12.1 Enabling Tape Drive Allocation . . . . . . . 3-21
3.3.12.2 Treatment of Unrecognized Tapes . . . . . . 3-21
3.3.13 Accounting Shift Changes . . . . . . . . . . . 3-22
3.3.14 Assigning MSCP-served Disk Drives . . . . . . 3-23
3.3.15 Specifying Daylight Savings Time . . . . . . . 3-23
3.3.16 Specifying Remote Line Conditions . . . . . . 3-24
3.3.17 Controlling System Message Levels . . . . . . 3-24
3.3.18 Network Information . . . . . . . . . . . . . 3-25
3.3.19 Designating Off-line Structures . . . . . . . 3-26
3.3.20 Designating Login Structure . . . . . . . . . 3-26
3.3.21 Preventing Fast logins . . . . . . . . . . . . 3-27
3.3.22 Cluster Data Gathering . . . . . . . . . . . . 3-28
3.3.22.1 Cluster Information . . . . . . . . . . . . 3-28
3.3.22.2 Cluster Sendalls . . . . . . . . . . . . . . 3-28
3.3.23 Password Management . . . . . . . . . . . . . 3-29
3.3.23.1 Designating Minimum Password Length . . . . 3-29
3.3.23.2 Changing Passwords Regularly . . . . . . . . 3-29
3.3.23.3 Disallowing Certain Passwords . . . . . . . 3-30
3.3.24 Dumping on Non-fatal System Errors . . . . . . 3-30
3.3.25 Disabling the Console Terminal for Operator
Output . . . . . . . . . . . . . . . . . . . . 3-31
3.3.26 Enabling the Access Control Program . . . . . 3-31
3.3.27 Hangup on DETACH . . . . . . . . . . . . . . . 3-32
3.3.28 Scheduling Low Priority to Batch Jobs . . . . 3-32
3.4 SAVING THE CONFIGURATION COMMAND FILE . . . . . 3-33
3.5 CHANGING THE OPERATOR'S PASSWORD AND USER GROUP 3-36
3.6 CREATING THE DIRECTORY PS:<REMARKS> . . . . . . 3-37
3.7 CREATING THE LPFORM.INI FILE . . . . . . . . . . 3-38
3.8 BUILDING A FRONT-END FILE STRUCTURE . . . . . . 3-40
CHAPTER 4 CREATING THE FRONT-END FILE SYSTEM
4.1 HALTING THE TOPS-20 MONITOR . . . . . . . . . . . 4-1
4.2 RESTARTING THE FRONT-END MONITOR . . . . . . . . . 4-3
4.3 COPYING FILES FROM FLOPPY DISK TO RP04 OR RP06 . . 4-4
4.4 RENAMING THE DX20 MICROCODE FILES . . . . . . . 4-14
CHAPTER 5 STARTING THE SYSTEM
iv
CHAPTER 6 INSTALLING THE TOPS-20 DISTRIBUTION TAPES
CHAPTER 7 RUNNING THE TOPS-20 UETP PACKAGE
7.1 RUNNING THE STANDARD TESTS . . . . . . . . . . . . 7-1
7.2 RUNNING OPTIONAL TESTS . . . . . . . . . . . . . . 7-5
7.3 DELETING TEMPORARY DIRECTORIES . . . . . . . . . . 7-8
APPENDIX A UPDATING THE DECSYSTEM-20 SOFTWARE
A.1 INSTALLATION TOOLS . . . . . . . . . . . . . . . . A-2
A.2 INSTALLING THE VERSION 7.0 SOFTWARE . . . . . . . A-2
A.2.1 Preparing for Installation . . . . . . . . . . . A-2
A.2.2 Creating System Directories . . . . . . . . . . A-7
A.2.3 Restoring TOPS-20 Bundled Software from Tape . . A-8
A.2.4 Renaming the Version 6.1 Monitor . . . . . . . A-12
A.2.5 Creating the Configuration Command File . . . A-14
A.2.6 Setting Parameters for <OPERATOR> . . . . . . A-16
A.2.7 Shutting Down the DECSYSTEM-20 . . . . . . . . A-17
A.2.8 Starting the New Software . . . . . . . . . . A-18
A.3 REVERTING TO VERSION 6.1 . . . . . . . . . . . . A-24
A.4 MAKING THE VERSION 7.0 MONITOR THE PRIMARY
MONITOR . . . . . . . . . . . . . . . . . . . . A-27
A.5 MAKING THE VERSION 7.0 MONITOR THE PERMANENT
MONITOR . . . . . . . . . . . . . . . . . . . . A-29
APPENDIX B POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20
APPENDIX C INSTALLING TCP/IP-20
C.1 TCP/IP INSTALLATION TOOLS . . . . . . . . . . . . C-1
C.2 RESTORING THE TOPS-20 BUNDLED SOFTWARE FROM TAPE . C-2
C.3 RESTORING THE TCP/IP DISTRIBUTION TAPE . . . . . . C-2
C.4 CUSTOMIZING A DATA FILE . . . . . . . . . . . . . C-6
C.5 CHOOSING A MONITOR . . . . . . . . . . . . . . . . C-8
C.6 CHANGING THE SYSTEM NAME . . . . . . . . . . . . C-10
C.7 COMPLETING YOUR TCP/IP INSTALLATION . . . . . . C-11
C.8 ACCESSING THE LIMITED DOMAIN RESOLVER . . . . . C-14
APPENDIX D GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
D.1 RESTORING THE GALAXY SOURCE FILES . . . . . . . . D-2
D.2 RUNNING THE GALGEN PROGRAM . . . . . . . . . . . . D-9
D.3 ASSEMBLING THE NEW GALAXY SYSTEM . . . . . . . . D-17
D.4 SHUTTING DOWN THE OLD GALAXY SYSTEM . . . . . . D-18
D.5 STARTING UP THE NEW GALAXY SYSTEM . . . . . . . D-22
D.6 MAKING YOUR NEW GALAXY SYSTEM PERMANENT . . . . D-25
v
INDEX
FIGURES
2-1 Directories on the Public Structure . . . . . . 2-34
3-1 The 7-CONFIG.CMD File . . . . . . . . . . . . . 3-35
4-1 Directory Listing of Front-End Files . . . . . . 4-13
5-1 Sample Console Terminal Output at System Startup . 5-6
TABLES
3-1 Maximum Structure Size . . . . . . . . . . . . . . 3-4
3-2 DECSYSTEM-20 Terminal Line Numbers . . . . . . . . 3-8
3-3 DECSYSTEM-20 Line Printers . . . . . . . . . . . 3-13
5-1 System Reload Abbreviations . . . . . . . . . . . 5-4
7-1 UETP Commands for Optional Software Product Tests 7-6
vii
PREFACE
The TOPS-20 KL Model B Installation Guide describes the procedures for
installing TOPS-20 software on a new DECSYSTEM-20. This guide also
provides information on updating TOPS-20 software on an existing KL10
Model B system, installing TCP/IP-20 (Transmission Control
Protocol/Internet Protocol), and generating tailored GALAXY software.
AUDIENCE
This guide addresses TOPS-20 operators, system managers, and others
who have the responsibility to:
o Install the TOPS-20 software on a new DECSYSTEM-20.
o Update the TOPS-20 software on an existing DECSYSTEM-20.
o Install TCP/IP-20 software.
o Generate a tailored batch and spooling (GALAXY) system.
ORGANIZATION
Chapter 1 INTRODUCTION, describes what you need to do to prepare
for installation. It also describes the tools you need
to install the software.
Chapter 2 CREATING THE TOPS-20 FILE SYSTEM, 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 TAILORING THE SYSTEM, describes how to select the
viii
proper monitor, declare the system name, and change the
system defaults for terminals, system devices,
accounting, performance improvements, scheduler
controls, file archiving and migration, and other
system functions.
Chapter 4 CREATING THE FRONT-END FILE SYSTEM, describes how to
create the front-end file system for the DECSYSTEM-20
and copy files into it from the floppy disks. (When
you finish this chapter, the installation is complete.)
Chapter 5 STARTING THE SYSTEM, describes how to boot the system
from disk.
Chapter 6 INSTALLING THE TOPS-20 DISTRIBUTION TAPE, describes how
to install TOPS-20 Distribution, Update, and Tools
tapes.
Chapter 7 RUNNING THE TOPS-20 UETP PACKAGE, describes how to run
the User Environment Test Package (UETP program). This
program performs a cursory check of the system.
Appendix A UPDATING THE DECSYSTEM-20 SOFTWARE, contains
step-by-step instructions, with pointers to various
chapters within this guide, describing how to update a
TOPS-20 software system on the DECSYSTEM-20.
Appendix B POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20, is 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 guide that describe how
to install the TOPS-20 software on a new DECSYSTEM-20.
Appendix C INSTALLING TCP/IP-20, contains the steps for installing
TCP/IP-20, with pointers to various chapters within
this guide.
Appendix D GENERATING A TAILORED BATCH AND SPOOLING SYSTEM,
contains the steps for generating a batch and spooling
(GALAXY) system tailored for your particular site.
RELATED DOCUMENTS
The following manuals are valuable as references while using this
guide. All of these manuals are included in the TOPS-20 Software
Notebook Set.
ix
TOPS-20 Commands Reference Manual
TOPS-20 EDIT Reference Manual
TOPS-20 Monitor Calls Reference Manual
TOPS-20 Operator's Guide
TOPS-20 Operator's Command Language Reference Manual
TOPS-20 System Manager's Guide
TOPS-20 User's Guide
TOPS-20 User Utilities Guide
USING RECOGNITION INPUT
TOPS-20 offers a helpful feature to prompt you when you type a
command. Simply type the first few characters, and then press the
ESCape key. This tells TOPS-20 to examine the characters you typed
and to complete the command for you. If TOPS-20 recognizes the
characters you typed, it completes as much of the command as it can.
When it cannot print any more or does not recognize the characters you
typed as part of a valid command, TOPS-20 rings the terminal bell
(your terminal bell may be a buzzer) and waits for you to type
additional characters. If you type part of a command that means more
than one thing to TOPS-20, it rings the terminal bell to indicate that
it needs more information. Using the ESCape key in these ways is how
you use the TOPS-20 feature called recognition input.
When you use recognition input, TOPS-20 also prints some words in
parentheses. These words, called quidewords, make the command more
readable and also tell you what kind of argument TOPS-20 expects you
to type.
In this guide, commands are shown as complete words followed by the
appropriate arguments. For example:
$BUILD PS:<OPERATOR> <RET>
If you use recognition input for this command, it looks like this:
<ESC>
|
$BUILD (DIRECTORY NAME) PS:<OPERATOR> <RET>
Using recognition input provides the guidewords (DIRECTORY NAME).
Here is another example:
x
$COPY PS:<SYSTEM>FILE.CMD PS:<OPERATOR>FILE.CMD <RET>
Using recognition input, the command looks like this:
<ESC> <ESC>
| |
$COPY (FROM) PS:<SYSTEM>FILE.CMD (TO) PS:<OPERATOR>FILE.CMD <RET>
If you type accurately, the command lines shown in this guide will be
accepted and interpreted correctly by TOPS-20. If you choose, you can
use recognition input. In most cases, if you press the ESCape key
after you type a command or an argument, TOPS-20 will provide
guidewords or instruct you to press the RETURN key.
Recognition input offers several advantages. First, you can
double-check your typing, because the completed command as printed by
TOPS-20 verifies that your typing has been interpreted correctly.
Second, you can minimize typing, because you need only type enough
characters to make a unique match with a command or argument. And
third, TOPS-20 prompts your next response, because it prints
guidewords in parentheses.
HOW TO USE THIS GUIDE
Before using this guide, be familiar with the information in the
TOPS-20 User's Guide, the TOPS-20 System Manager's Guide, and the
TOPS-20 Operator's Guide.
If you are installing a new system, read Chapters 1 through 7. If you
are updating an existing TOPS-20 system, read Appendix A. If you are
installing a system with TCP/IP capability, read Appendix C. If you
are generating a tailored GALAXY, read Appendix D.
The following conventions are used in this guide:
Symbol Indicates
<RET> The RETURN key.
<ESC> The ESCape (ESC, ALT, ALTMODE, or PREFIX)
key.
$ The ENABLEd prompt or the echo of the ESCape
key.
$$ The subcommand prompt.
<CTRL/\> Pressing the CTRL (CONTROL) key and the
backslash key simultaneously. The backslash
key is located near the key labeled LINEFEED
xi
or LF on your console terminal (CTY).
<CTRL/x> Pressing the CTRL (CONTROL) key and another
key simultaneously.
^x The echo of <CTRL/x>. For example, pressing
<CTRL/Z> echoes as ^Z. Note that pressing
<CTRL/x> does not always echo with ^x on your
terminal. For example, <CTRL/\> has no echo.
@ The TOPS-20 prompt.
UPPERCASE Actual input required in a command string.
You must type an uppercase element in full or
with an abbreviation acceptable to the
system.
lowercase An input variable in a command string (for
example, name or number). These are
variables that you must determine.
Spaces Separate elements of a command. Spaces must
be input where shown.
{ } A list of alternatives within a command. You
must specify one of the alternatives in your
command string. Do not type braces in the
actual command string.
. That some of the lines in the example or
figure are not shown.
.
.
Underlined text What you type at your terminal in command
examples (in either uppercase or lowercase
characters).
Regular Print What the system prints or displays at your
terminal (in either uppercase or lowercase
characters).
The commands you type are underlined. If you type accurately, all you
have to do is perform the indicated function and verify that your
actual terminal output resembles the sample output. Be sure to
include the spaces shown in the command lines. Remember that systems
differ in memory 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 not resemble the sample output, first
xii
read ALL of the instructions after the word "Error," then choose the
recovery procedure that corrects your problem.
NOTE
The version and edit numbers in this guide could
differ from those printed on your console terminal.
The numbers printed on your console must be equal to
or greater than the numbers in this guide.
Time estimates are included so that you know about how long a step
takes. Times are estimated to the nearest minute, so don't worry if a
step takes somewhat longer or shorter than this.
xiii
CHAPTER 1
INTRODUCTION
This introductory chapter describes collecting information before you
start an installation, what tools you will need, the monitors
available to you, and information on GALAXY.
When installing the TOPS-20 software on a DECSYSTEM-20 model number
2060 or on a DECSYSTEM-20 model number 2040S, you should be using
software package QT023, which contains the Installation tape and the
Distribution tapes. (The installation of a DECSYSTEM-20 Model 2065 is
identical to that of a DECSYSTEM-20 Model 2060. Throughout this
guide, Model 2060 will be used to designate both Model 2060 and 2065.)
NOTE
Before starting the installation, read the listing
labeled TOPS20.BWR, which accompanies your software.
The TOPS20.BWR file describes changes in the software
and installation procedures made too late for
inclusion in this guide.
1.1 COLLECTING INFORMATION
A DIGITAL Field Service Representative will install your DECSYSTEM-20
hardware and inform you when the system runs diagnostics correctly.
Before he leaves, you need to obtain the following information:
o The channel, unit, and controller number of each disk drive
o A list of terminal line numbers and line speeds
o The serial number of each magnetic tape drive
o The unit number and type of each line printer
1-1
INTRODUCTION
1.1.1 Disk Drives
You need to know the channel, unit, and controller number of each disk
drive, and whether it is dual-ported. The controller number for an
RP04, RP06, and RP07 is -1. The controller number for both an RA60
and RA81 is 7. RP20 disk drives have a different controller number.
The unit number is located on the display panel on the drive.
The DECSYSTEM-20 dual-ported disk drives are connected to both the CPU
and the front-end processor. In a common file system (CFS)
environment, dual-ported disks may be connected to another
DECSYSTEM-20. When doing an installation, these disks should be
ported to one system or the other. It is an error if two dual-ported
drives with the same unit number are connected to the front-end
processor. Remember that it is possible for RP04, RP06, and RP07
disks to be dual-ported to two different channels on the same system.
The procedures in this guide assume that the unit on which you are
installing the front-end software is Unit 0. Use the following chart
to record the necessary information.
Disk Drives
Type Channel # Unit # Controller # Dual-Ported ?
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
---- --------- ------ ------------ -------------
1.1.2 Terminal Lines
You need a list of terminal 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
1-2
INTRODUCTION
remote lines as described in Section 3.3.2. Use the following chart
to record this information.
Lines
Auto Auto
Line # Speed Remote? Line # Speed Remote?
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
NOTE
The word Auto over the word Speed declares that the
line is an autobaud line (see Section 3.3.2).
1.1.3 Magnetic Tape Drives
You need to know 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 logical unit number of the drive. Use the following
chart to record this information.
Magnetic Tapes
Serial # Type Serial # Type Serial # Type
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
1-3
INTRODUCTION
-------- ---- -------- ---- -------- ----
NOTE
The serial numbers on TU70 and/or TU71 tape drives are
made up of three factors. These factors consist of
the RH20 channel number, the DX20 number, and a
two-digit tape unit number. Assuming that the RH20
channel number is 2, the serial number for tape unit 3
would be 2003. In this example, the RH20 channel is
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.
1.1.4 Line Printers
You need the unit number and type of each line printer. Use this
information in Section 3.3.5 to initialize the line printers. Use the
following chart to record this information.
Line Printers
Programmable
Unit # Model # Lowercase ? VFU ?
------ ------- ----------- ------------
------ ------- ----------- ------------
------ ------- ----------- ------------
1.2 INSTALLATION TOOLS
You need the following tools to install the TOPS-20 software on a
DECSYSTEM-20:
o The TOPS-20 RSX-20F Version 16-00 System Floppy A
o The TOPS-20 RSX-20F Version 16-00 System Floppy B
o The TOPS-20 RSX-20F Version 16-00 System Floppy C
o The TOPS-20 Version 7.0 Installation Tape
o The TOPS-20 Version 7.0 Distribution Tape 1
1-4
INTRODUCTION
o The TOPS-20 Version 7.0 Distribution Tape 2
o A separate tape for each optional software product you have
purchased
o Formatted disk packs (If your disk packs are not formatted,
ask your DIGITAL Field Service Representative to format them
for you)
RP20 Disks
If you are installing the TOPS-20 software on a
DECSYSTEM-20, Model 2040s or 2060, that contains an
RP20 disk subsystem, be sure you have Floppy C, as
this floppy disk contains the microcode necessary to
boot the RP20.
1.2.1 Floppy Disks
System Floppy A contains the files to boot the central processor from
an RP04 or RP06 disk pack.
System Floppy B contains the files for various functions used to
install and maintain the software on a DECSYSTEM-20.
System Floppy C contains the RSX-20F Version 16-00 map file and the
RP20/DX20 microcode files.
1.2.2 Tapes
The TOPS-20 Installation tape, for DECSYSTEM-20s Models 2040S and
2060, contains the TOPS-20 monitor and related programs. The files
are:
o The TOPS-20 monitor (SAVE format)
o The TOPS-20 command processor (SAVE format)
o The DLUSER program (SAVE format)
o DLUSER data (ASCII file)
o The DUMPER program (SAVE format)
o Four DUMPER savesets recorded at 1600 bpi in DUMPER format
for the following directories:
1-5
INTRODUCTION
- PS:<SYSTEM> for the monitor and related programs.
- PS:<SUBSYS> for the system program files and the GALAXY
files.
- PS:<UETP.LIB> for the UETP files.
The TOPS-20 Distribution tapes for all DECSYSTEM-20s contain the
TOPS-20 bundled software. TOPS-20 Distribution tape 1 contains one
DUMPER saveset recorded at 1600 bpi in DUMPER format. This saveset
contains source files needed to build the software in the directory
<SUBSYS>, except for the monitor and the TOPS-20 command processor.
TOPS-20 Distribution tape 2 contains three DUMPER savesets recorded at
1600 bpi in DUMPER format.
o Saveset 1 contains documents about the software.
o Saveset 2 contains language source files.
o Saveset 3 contains GALAXY source files.
NOTE
The term "bundled software" refers to the contents of
the Installation and Distribution tapes considered
together, or to the contents of the Distribution tapes
alone. The term "unbundled software" refers to the
contents of the tapes for optional software products.
1.3 THE TOPS-20 MONITORS
Two monitors are distributed with the TOPS-20 software for the
DECSYSTEM-20, Models 2040S and 2060. They are:
2060-MONBIG.EXE
2060-MONMAX.EXE
Read Chapter 3 for descriptions of these monitors. The installation
will proceed more smoothly if you take time now to choose the monitor
you want to use.
1.4 THE BATCH AND SPOOLING SYSTEM
Your TOPS-20 software system initialization includes a standard GALAXY
batch and spooling system. If you need a special batch and spooling
system, first install the standard system; then see Appendix D of this
1-6
INTRODUCTION
manual for instructions on how to build your own specialized batch and
spooling system.
1-7
CHAPTER 2
CREATING THE TOPS-20 FILE SYSTEM
This chapter describes how to create a new TOPS-20 file system on the
DECSYSTEM-20. To create a new file system, you must load and start
the TOPS-20 monitor, initialize the file system, restart the monitor,
and restore the bundled software from tape.
STOP: These Procedures Install a New System
Follow the procedures in this chapter if you are
installing TOPS-20 software on a new system, or if you
are creating a new file system on a set of disk packs.
Use Appendix A to update TOPS-20 software on an
existing system.
2.1 CHECKING THE TOPS-20 SOFTWARE PACKAGE
The TOPS-20 software package contains the following items:
1. The TOPS-20 RSX20F Version 16-00 System Floppy A
2. The TOPS-20 RSX20F Version 16-00 System Floppy B
3. The TOPS-20 RSX20F Version 16-00 System Floppy C
4. The TOPS-20 Installation Tape Version 7.0
5. The TOPS-20 Distribution Tape 1 Version 7.0
6. The TOPS-20 Distribution Tape 2 Version 7.0
7. A separate tape for each optional software product purchased
Be sure that you have all of these items. See Chapter 1, Sections
1.2.1 and 1.2.2 for the contents of the floppy disks and magnetic
tapes.
2-1
CREATING THE TOPS-20 FILE SYSTEM
2.2 PREPARING THE DECSYSTEM-20 FOR INSTALLATION
You prepare the system for installation by powering it up, checking
for formatted disks, and labeling the disk packs. You then mount the
disk packs and turn on the disk drives; mount the floppy disks; and
mount the Installation tape.
Perform Steps 1 through 9 to prepare for installation.
Step 1: Read the listing labeled TOPS20.BWR.
Read the listing labeled TOPS20.BWR to learn about any last minute
changes made to the installation procedure or to the TOPS-20 software.
Step 2: Ask your DIGITAL Field Service Representative if the disk
packs are formatted.
Ask your DIGITAL Field Service Representative if the disk packs are
formatted for use with the DECSYSTEM-20. If they are not, ask him to
format them. The packs must be formatted before you proceed further.
Note that you cannot use an RP20 for the system structure.
Step 3: Power up the system.
Turn on the power by pressing the POWER switch if the light under the
word POWER on the operator's panel is off. (Do not touch the
emergency power switch unless you see smoke or sparks coming from the
system.) The system is ready after a few seconds, and the power light
comes on.
Be sure that the system is completely powered on:
1. Check the disk drives.
2. Check the magnetic tape drives. If power is off, press the
rocker switch (the white switch containing the ON/OFF light)
on the front panel. If you have trouble with the disk drives
or magnetic tape drives, call your DIGITAL Field Service
Representative for assistance.
3. Check the line printers. If power is off for an LP20A or
LP20B printer (which has four buttons on the right of the top
panel), reset the knee-level breaker on the lower panel. The
TAPE light may be on; disregard it. If you have an LP20F or
LP20H printer (which has four rocker switches on the left of
the top panel), lift the cover just above the lights and
reset the breaker. Be sure that the printer has paper.
2-2
CREATING THE TOPS-20 FILE SYSTEM
4. Turn on the console terminal (CTY). Be sure that it is on
line and has paper.
Step 4: Label the disk packs.
This guide contains the procedures for creating the system structure
for your system. The system structure name can be up to six
characters and contains the files needed to run the system. The
system structure cannot include RP20, RA81, or RA60 disk drives. If
the system structure is on an RP07 disk drive, the front-end file
system must reside on a RP04 or RP06 dual-ported disk drive.
Decide how many packs you will have, and assign them consecutive
"logical unit numbers," starting with 0. These are the logical pack
numbers referred to in Step 25. Identify each pack by writing these
numbers with a felt-tip pen on the pack cover with a gummed label. A
sample of the format of the label is:
TOPS-20 Disk Pack
Structure ID: structure name
Logical Unit: n
CAUTION
Do not use a gummed label on the surface of the pack
itself, because it can spin off and cause severe
damage to the drive.
Step 5: Mount the 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
can dismount the disk packs to clean and maintain the drives.
However, during system operation, the pack that contains the front-end
files must be on dual-ported drive 0 as it was during installation.
NOTE
RP07 and RP20 disk packs are non-removable. To mount
an RA60 disk pack see the HSC-50 User's Guide.
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:
2-3
CREATING THE TOPS-20 FILE SYSTEM
1. If another RP04 or RP06 disk is already mounted on the drive
and spinning, do the following:
a. Press the START/STOP button and wait until the drive
stops.
b. Push the door back. Slide the pack cover down over the
pack.
c. Turn the cover handle counterclockwise a few turns until
it turns freely. Gently lift the pack vertically. If
there is any resistance, turn the handle a few more turns
counterclockwise and lift again.
d. Lift the pack out of the drive and place it on the
protective bottom cover. Be sure that the cover clicks
closed.
2. Pick up the pack to be mounted and remove the protective
bottom cover by squeezing the handle of the bottom cover.
CAUTION
If you insert a pack without removing the
bottom cover, you will be unable to use or
remove the pack.
3. Gently lower the pack vertically into the drive, being
careful not to hit the sides of the drive. Keep the pack
centered in the drive while lowering it.
4. 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.
5. Lift off the cover vertically.
6. Close the door to the drive.
7. 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 is mounted
properly.)
8. Be sure that the drive is not write protected. The switch
labeled WRITE PROTECT must be off.
CAUTION
Do not leave a disk pack or magnetic tape on
top of a disk drive. The vibration from the
2-4
CREATING THE TOPS-20 FILE SYSTEM
drive can cause these items to fall to the
floor, causing expensive and irreparable
damage.
Step 6: Check the CONTROLLER SELECT switches on the disk drive.
Be sure that the CONTROLLER SELECT switch on dual-ported drive 0 is
set to A/B and that every other drive has the CONTROLLER SELECT switch
set to A. To change the CONTROLLER SELECT switch, set the switch to
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 the READY light to come on.
Step 7: Mount System Floppy A in drive 0.
Place the floppy disk labeled System Floppy A in the left floppy drive
(drive 0). To mount a floppy disk, hold the floppy disk with your
thumb on the label. Then with your thumb and the label facing upward,
slide the floppy disk into the floppy drive until it contacts the back
of the drive and stops. Press down the bar until it clicks.
CAUTION
Make sure that the paper directory that is sometimes
included with the floppy disk is not sticking to the
back of the floppy disk. Failure to do so will damage
the floppy disk and the floppy disk drive.
Step 8: Mount System Floppy B in drive 1.
In the right floppy drive (drive 1), place the floppy disk labeled
System Floppy B.
HINT
Be sure that you have mounted the floppy disks in the
correct drives, or problems will develop in Step 12.
Step 9: Mount the Installation tape on MTA0:.
Mount the correct version of the Installation tape for your system.
(See Chapter 1 for the correct Installation tape for your system.)
Remove the write ring (if present) from the magnetic tape labeled
TOPS-20 Installation Tape and mount the tape on drive 0. Drive 0 is
the lowest unit on the lowest channel on the lowest TM03, TM02
controller or DX20 controller. (Your DIGITAL Field Service
Representative gives you this information.) If you cannot determine
which drive is drive 0, make sure that all drives are off line except
2-5
CREATING THE TOPS-20 FILE SYSTEM
the one you want to use.
CAUTION
The logical unit number for a magnetic tape drive is
not determined by the numbered thumbwheel on the left
side of TU45 drives. The numbered thumbwheel is the
slave number of the drive. Never change the setting
of this thumbwheel.
To mount a reel of tape on a TU45 tape drive:
1. Place the reel on the top hub with the labeled side of the
tape facing you.
2. Lock the reel on the hub by pressing the rocker in the center
of the hub.
3. Thread the tape through the slot in front of the tape heads
by following the arrows. Move the head shields back for
easier access to the tape slot.
4. Wind the tape one turn clockwise onto the take-up reel.
5. Press the LOAD button. The tape slowly advances onto the
take-up reel and moves to the logical beginning of the tape.
If the drive overshoots the beginning of the tape, it
repositions itself.
6. Make sure the ON LINE button is lit; if it is not, press the
ON LINE button.
To mount a reel of tape on a TU77 or TU78/TU79 tape drive:
1. Place the reel of tape on the top hub with the labeled side
of the tape facing you.
2. Lock the reel on the hub by pressing the rocker in the center
of the hub.
3. Press, in order, the RESET and LOAD buttons. The tape is
wound counterclockwise a few turns. Then the tape leader is
threaded automatically through the slot near the upper
right-hand corner of the drive, and the tape is positioned at
the logical beginning of tape.
4. Press the ON LINE button.
On 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 light is on, the system cannot write on the tape. If
the FILE PROTECT light is not on, remove the write ring from the back
2-6
CREATING THE TOPS-20 FILE SYSTEM
of the tape.
To mount a reel of tape on a TU72 tape drive:
1. Place the reel of tape on the rightmost hub with the labeled
side of the tape facing you.
2. Thread the tape leader down the slot until it is
approximately three inches in front of the read/write head.
3. Press, in order, the RESET, LOAD, and START buttons. The
tape leader is threaded automatically on the take-up reel and
the tape is positioned at the logical beginning of tape.
2.3 LOADING AND STARTING THE TOPS-20 MONITOR
To create the TOPS-20 file system, you must:
1. Load the front-end monitor from the floppy disks. Use the
front end to initialize the central processor and memory.
2. Use the front-end monitor to load the TOPS-20 Magnetic Tape
Bootstrap (MTBOOT) program from System Floppy A into the
central processor.
3. Use MTBOOT to load the TOPS-20 monitor from magnetic tape
into memory.
4. Use MTBOOT to start the TOPS-20 monitor at the file system
initialization routine.
Perform steps 10 through 21 to load and start the TOPS-20 monitor.
Step 10: Place the front-end HALT switch in the ENABLE position.
Open the second door from the left side of the DECSYSTEM-20, directly
under the DECSYSTEM-20 control panel, to access the front-end
switches.
Be sure that the front-end HALT switch is in the ENABLE position. If
the switch is in the HALT position, move it up to the ENABLE position.
When the HALT switch is in the HALT position, the front end will not
operate.
Step 11: Set the switch register to 000007 (octal).
The front-end control panel has 16 switch register switches. Set them
to 000007 (octal) by setting switches 2, 1, and 0 up, and leaving the
2-7
CREATING THE TOPS-20 FILE SYSTEM
rest down. (See the TOPS-20 Operator's Guide for a detailed
description of all switches.)
Booting the front end from a floppy disk with the switch register set
to 000007 causes the front-end monitor to run the central processor
initialization dialog. This loads the central processor microcode and
configures central processor memory.
Step 12: Hold ENABLE and press the SWITCH REGISTER button.
Hold ENABLE and press the SWITCH REGISTER button on the control panel
(Figure 2-1). This loads the front-end monitor and starts the
initialization dialog. The system prints:
RSX-20F VB16-00 12:00 3-Mar-88
[SY0: redirected to DX0:]
[DX0: mounted]
[DX1: mounted]
KLI -- VERSION VB16-00 RUNNING
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>
where:
Item Identifies
RSX-20F The name of the front-end monitor.
VB16-00 The version of the front-end monitor.
12:00 3-Mar-88 The time and date that the front-end monitor
was built.
SY0: The area from which the front end obtains its
files. If SY0: is redirected to DX0:, the
front end obtains the files from floppy drive
0. If SY0: is redirected to DB0:, the front
end obtains the files from disk drive 0.
KLI VB16-00 The name and version of the central processor
initialization dialog.
KLI> The prompt for the central processor
initialization dialog.
Error: If the system does not print the above heading, be sure that
the floppy disks are mounted in the proper drives and the
HALT switch is in the ENABLE position. Then retry Step 12.
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.
2-8
CREATING THE TOPS-20 FILE SYSTEM
Step 13: Type YES and press the RETURN key.
To enter the central processor initialization dialog, type YES and
press the RETURN key. Following this, if you answer either NO or 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 list 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 <RET>
KL1 -- KL10 S/N: 2102., MODEL B, 60 HERTZ
KL1 -- KL10 HARDWARE ENVIRONMENT:
MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>
Error: If the system does not print the above heading, be sure that
the floppy disks are mounted in the proper drives, then
return to Step 12.
NOTE
For a DECSYSTEM-20 Model 2065, the system prints:
KLI -- SELECT PAGE TABLE [FILE,BOTH,0,1]?
KLI>
A Model 2065 has two page tables, whereas there is one
page table in a Model 2060. Answer BOTH to utilize
this additional page table.
KLI>BOTH <RET>
KLI -- PAGE TABLE SELECTED: BOTH
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>
DELETE KEY
If you make a typing error, press the DELETE key to
erase a single character at a time. Type <CTRL/U> to
delete the entire line.
2-9
CREATING THE TOPS-20 FILE SYSTEM
Step 14: Type YES KLX and press the RETURN key.
To load the central processor microcode, type YES KLX and press the
RETURN key. After 30 seconds, during which the floppy drives click,
the microcode is loaded and the system prints KLI -- MICROCODE VERSION
2.1[442] LOADED followed by KLI -- RECONFIGURE CACHE
[FILE,ALL,YES,NO]?.
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>YES KLX <RET>
KLI -- MICROCODE VERSION 2.1[442] LOADED
Step 15: STOP.
Go to Step 16 if the system prints:
KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
Go to Step 17 if the system prints:
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,FORCE,YES,NO]?
KLI>
Step 16: Type ALL and press the RETURN key.
To reconfigure the central processor cache, type ALL and press the
RETURN key. Upon receiving this reply, the system configures all
available cache. After the configuration is complete, the system
prints KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,FORCE,YES,NO]?.
KLI>ALL <RET>
KLI -- ALL CACHES ENABLED
KLI -- CONFIGURE 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 return to Step 12.
Step 17: 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 vary, depending on the type of hardware you have. Check
the two sample outputs below to see which one pertains to your system.
(See the TOPS-20 Operator's Guide for details on memory
configuration.) After the configuration is complete, the system
prints KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?.
2-10
CREATING THE TOPS-20 FILE SYSTEM
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,FORCE,YES,NO]?
KLI>ALL <RET>
Depending on the size of your system, your output will resemble one of
the following:
LOGICAL MEMORY CONFIGURATION
ADDRESS SIZE INT TYPE CONTROLLER
00000000 768K 4 MF20 10
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
or
LOGICAL MEMORY CONFIGURATION
ADDRESS SIZE INT TYPE CONTROLLER
00000000 128K 4 MB20 0 & 1
00400000 512K 4 MF20 10
02400000 256K 4 MF20 14
03400000 3200K NON-EXISTENT
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
Error: If the system does not print a heading similar to one of
those above, be sure that the correct floppy disks are
mounted in the proper drives, then return to Step 12.
NOTE
The MOS memory configurator is capable of configuring
4096K of memory. The message concerning the
NON-EXISTENT memory can be ignored. This message is
specifying the difference between the actual physical
memory and 4096K.
Step 18: Type MTBOOT and press the RETURN key.
After the prompt KLI>, type MTBOOT and press the RETURN key.
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
KLI>MTBOOT <RET>
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>
The system now asks whether it should write the front-end
configuration 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
2-11
CREATING THE TOPS-20 FILE SYSTEM
recommended that you answer NO to this question for the present.
Later, when you have a front-end configuration that should be recorded
(Step 148 in Chapter 4), the configuration file will be written for
you.
Step 19: Type NO and press the RETURN key.
After the prompt KLI>, type NO and press the RETURN key.
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>NO <RET>
KLI -- BOOTSTRAP LOADED AND STARTED
BOOT V11.0(315)
MTBOOT>
The front end loads the central processor memory with the bootstrap
program from the floppy mounted on drive 0, and then starts the
bootstrap program. When at bootstrap command level (about 45
seconds), the system prints MTBOOT>.
Error: If the 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 (\)
is 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. Go back to Step 12.
If the system prints the following message exactly:
KLI -- ?BOOT FILE NOT FOUND
KLI -- ?BOOTSTRAP LOAD FAILED
KLI -- ENTER DIALOG [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.
Step 20: Type /L and press the RETURN key.
To load the TOPS-20 monitor from magnetic tape into memory, type /L
2-12
CREATING THE TOPS-20 FILE SYSTEM
and press the RETURN key. The system rewinds the tape on drive 0,
loads the resident monitor, skips a line, and prints MTBOOT>.
MTBOOT>/L <RET>
[BOOT: LOADING] [OK]
MTBOOT>
DX20 Microcode
You will receive a message concerning the DX20
microcode ONLY if you are installing the TOPS-20
software on a DECSYSTEM-20 with an RP20 tape or disk
controller.
Error: If you made a typing error and pressed the RETURN key, the
system prints MTBOOT> again. Reissue the correct command.
If you did not put the magnetic tape on line, the system
prints:
?NO RDY DRIVE
MTBOOT>
Place the tape on line and give the /L command again.
If the system prints one of these messages:
?BAD FIL FMT
?BAD EXE DIR
do the following:
1. Make sure that you have mounted the correct TOPS-20
Installation tape on drive 0 and that all other tape
drives are off line.
2. Rewind the tape and try giving the /L command again.
If the error recurs, call DIGITAL Software Support.
Error: If the system does not print MTBOOT>, you probably mistyped
the name MTBOOT. The system then prints:
KLI -- ?BOOT FILE NOT FOUND
KLI -- ?BOOT LOAD FAILED
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>
If the floppy disks are mounted properly and you typed
MTBOOT properly, go back to Step 12. If the error recurs,
contact DIGITAL Software Support.
2-13
CREATING THE TOPS-20 FILE SYSTEM
The system will use the magnetic tape that is on line.
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. If you are trying to bring up a
monitor that has already been installed on a set of
TOPS-20 disk packs, see Chapter 5 of this guide or to
the TOPS-20 Operator's Guide for the correct
procedure.
Step 21: Type /G143 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>/G143 <RET>
[FOR ADDITIONAL INFORMATION TYPE "?" TO ANY OF THE FOLLOWING
QUESTIONS.]
DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM
STRUCTURE?
Error: If you make an error and the system reprints MTBOOT>,
reissue the correct command.
If the system does not print MTBOOT>, check your typescript.
Go back to Step 12.
If the system prints:
?BAD EXE DIR
you probably typed the wrong command. Try giving the /G143
command again. If you still get an error, go back to
Step 12.
2.4 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 is
part of the system structure.
The steps in this section initialize the TOPS-20 file system by
2-14
CREATING THE TOPS-20 FILE SYSTEM
creating:
1. New home blocks (which contain pointers to the beginning of
the file system).
2. The directory <ROOT-DIRECTORY> (which contains pointers to
all the directories in the system).
3. The directories <SYSTEM>, <SUBSYS>, <NEW-SYSTEM>,
<NEW-SUBSYS>, <UETP>, <UETP.LIB>, <UETP.RUN>, <ACCOUNTS>,
<SYSTEM-ERROR>, <OPERATOR>, and <SPOOL>.
4. Space for the front-end file system.
5. The system swapping space (the area allocated for the
movement, by the monitor, of pages between memory and disk).
NOTE
See the TOPS-20 System Manager's Guide for a detailed
explanation of all the above.
Perform Steps 22 through 36 to initialize the TOPS-20 file system.
Step 22: Type YES and press the RETURN key.
To create the system structure, type YES and press the RETURN key.
[FOR ADDITIONAL INFORMATION TYPE "?" TO ANY OF THE FOLLOWING
QUESTIONS.]
DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM
STRUCTURE? YES <RET>
DO YOU WANT TO DEFINE THE SYSTEM STRUCTURE?
Step 23: Type YES and press the RETURN key.
To write the home blocks for each unit in the system structure, type
YES and press the RETURN key.
DO YOU WANT TO DEFINE THE SYSTEM STRUCTURE? YES <RET>
HOW MANY PACKS ARE IN THIS STRUCTURE:
Step 24: Type the number of packs and press the RETURN key.
Count the number of disk packs you plan to have in your system
structure. Type the answer and press the RETURN key. The example
2-15
CREATING THE TOPS-20 FILE SYSTEM
uses 1.
HOW MANY PACKS ARE IN THIS STRUCTURE: 1 <RET>
ON WHICH "CHANNEL,CONTROLLER,UNIT" IS LOGICAL PACK # 0 MOUNTED:
Error: If you type the wrong number of disk packs, type <CTRL/\>.
After the system prints PAR> (10 seconds), type ABORT and
press the RETURN key. The system prints PAR%, indicating
that the central processor has stopped. Go back to
Step 12 and start again.
Step 25: Type ? (do not press the RETURN key).
You must inform the system of the location of each disk pack that is
to be in the public file system. If you are not sure of the channel,
controller, and unit numbers of each disk pack, type ?. This causes
the system to print the channel and unit number of each disk drive.
NOTE
The example shows channel and unit numbers for a
specific configuration. The numbers for your system
will probably be different, as they are generated by
your own system configuration.
ON WHICH "CHANNEL,CONTROLLER,UNIT" IS LOGICAL PACK # 0 MOUNTED: ?
[ENTER A TRIPLE OF NUMBERS SEPARATED BY COMMAS THAT SPECIFY THE
CHANNEL, CONTROLLER, AND UNIT UPON WHICH THE APPROPRIATE PACK IS
MOUNTED. THE FOLLOWING IS A LIST OF VALID CHANNEL, CONTROLLER,
AND UNIT NUMBERS:
1,-1,0 ;TYPE=RP06,DUAL PORT
1,-1,1 ;TYPE=RP06,OFFLINE,DUAL PORT
1,-1,2 ;TYPE=RP04,OFFLINE,DUAL PORT
1,-1,3 ;TYPE=RP07,OFFLINE
]
ON WHICH "CHANNEL,CONTROLLER,UNIT" IS LOGICAL PACK # 0 MOUNTED:
NOTE
The controller number is always -1 for all system
structures.
Error: If you followed the procedure in Step 6 exactly, drive 0
will be listed as dual-ported. Of the remaining drives,
those that contain the packs that are to be your system
structure will be listed as on line. All other drives will
be listed as off line.
If a drive that you want to use is not listed, the drive's
controller select switch is probably set to B. Follow the
2-16
CREATING THE TOPS-20 FILE SYSTEM
procedure in Step 6 for changing it to A. Then type
<CTRL/\>. After 10 seconds, the system prints PAR>. Type
ABORT and press the RETURN key to halt the central
processor. Return to Step 12 and start again.
If a drive you want to use is listed as off line, turn it on
line and wait for the READY light to come on. Go back to
Step 12.
Step 26: Type the channel number, controller number, and unit number
and press the RETURN key.
Type the channel number, the controller number, and the unit number of
the dual-ported drive, and press the RETURN key. You must answer this
question once for each disk pack. If there is any problem, ask your
DIGITAL Field Service representative to give you the channel and unit
number of each drive. The controller number of all drives (except the
RP20) is -1. (The RP20 controller number cannot be -1 as it cannot be
used in the system structure.)
ON WHICH "CHANNEL,CONTROLLER,UNIT" IS LOGICAL PACK # 0 MOUNTED:
1,-1,0 <RET>
DO YOU WANT THE DEFAULT SWAPPING SPACE?
Error: If your answer is invalid, the system prints one of several
messages and repeats the question. You can simply repeat
the current step.
If your answer is valid but is not the one you wanted, type
<CTRL/\>. After 10 seconds, the system prints PAR>. Type
ABORT and press the RETURN key to halt the central
processor. Go back to Step 12 and start again.
Step 27: Type ? (do not press the RETURN key).
To determine the default size of the swapping space for your system,
type ?. The system prints the default swapping space, which is 10070
for a 2060.
If you are planning on using a monitor other than MONBIG for the 2060,
see Chapter 3 Section 3.1 for the correct swapping space for the
monitor you choose.
DO YOU WANT THE DEFAULT SWAPPING SPACE? ?
[THE DEFAULT IS 10070 PAGES]
DO YOU WANT THE DEFAULT SWAPPING SPACE?
Step 28: Type YES or NO and press the RETURN key.
2-17
CREATING THE TOPS-20 FILE SYSTEM
If you want to accept the default swapping space size, type YES, press
the RETURN key, and proceed to Step 30.
DO YOU WANT THE DEFAULT SWAPPING SPACE? YES <RET>
DO YOU WANT THE DEFAULT SIZE FRONT END 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.) After you determine the size of the swapping space
you need, proceed to Step 29.
DO YOU WANT THE DEFAULT SWAPPING SPACE? NO <RET>
HOW MANY PAGES FOR SWAPPING?
Error: If you type the wrong answer, type <CTRL/\>. After 10
seconds, the system prints PAR>. Type ABORT and press the
RETURN key to halt the central processor. Return to
Step 12 and start again.
Step 29: Type the decimal number of pages and press the RETURN key.
Type the decimal number of disk pages you want to assign for swapping
and press the RETURN key. This option is provided so you can increase
the amount of swapping space in the future. The default size is the
maximum amount that your present monitor will use for swapping. If
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 and specify the larger number. The system will round the
number of pages specified up to an integral number of cylinders on the
disk.
To check the number of swapping pages for the monitor you have
selected, see Chapter 3, Section 3.1.
For TCP/IP installations, see Appendix C, Section C.5, for the correct
number of swapping pages for TCP/IP monitors.
HOW MANY PAGES FOR SWAPPING? n <RET>
DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM?
Error: If you type an invalid number, the system prints:
? INVALID NUMBER OF SWAPPING PAGES FOR THIS TYPE OF DISK
and returns to the question in Step 28. If you type an answer
that is valid but is not the one you wanted, type <CTRL/\>.
After 10 seconds, the system prints PAR>. Type ABORT and
2-18
CREATING THE TOPS-20 FILE SYSTEM
press the RETURN key to halt the central processor. Go back
to Step 12 and start again.
Step 30: Type ? (do not press the RETURN key).
To determine the default size of the front-end file system, type ?.
If you already know what the default is, you can omit this step.
DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? ?
[THE DEFAULT IS 950 PAGES]
DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM?
NOTE
If you are using an RP07 disk drive as the system
structure, do not reserve any pages for the front-end
file system.
Step 31: Type YES and press the RETURN key.
Type YES, press the RETURN key, and proceed to Step 32.
DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? YES <RET>
DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA?
Step 32: Type ? (do not press the RETURN key).
To find out how many pages are assigned as the default boot file
space, type ?. The system responds with the number of pages allocated
for the boot file space.
DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? ?
[THE DEFAULT IS 64 PAGES]
DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA?
Step 33: Type YES and press the RETURN key.
It is recommended that you take the default bootstrap space. Type YES
and press the RETURN key.
DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? YES <RET>
DO YOU WANT TO ENABLE PASSWORD ENCRYPTION FOR THE SYSTEM
STRUCTURE?
2-19
CREATING THE TOPS-20 FILE SYSTEM
Step 34: Type YES and press the RETURN key.
If you want user passwords to be encrypted on the disk, type YES and
press the RETURN key.
DO YOU WANT TO ENABLE PASSWORD ENCRYPTION FOR THE SYSTEM
STRUCTURE? YES<RET>
WHAT IS THE NAME OF THIS STRUCTURE?
NOTE
Before proceeding with Step 35, see the TOPS-20 System
Manager's Guide for information on naming structures.
Step 35: Type the name of the structure and press the RETURN key.
TOPS-20 recognizes any six-character name as a valid structure name.
Type the name of the structure and press the RETURN key. The system
prints a message to indicate that the structure is successfully
defined and mounted. The following examples use PS: as the structure
name.
WHAT IS THE NAME OF THIS STRUCTURE? PS: <RET>
[STRUCTURE "PS" SUCCESSFULLY DEFINED]
[PS MOUNTED]
%%NO SETSPD.
%%NO SETSPD means that the system cannot run the SETSPD program. This
is expected because you have not yet loaded the SETSPD program into
the file system. This message can be printed at any time before the
system requests the date and time.
Error: If certain error conditions occur while the monitor is
mounting the structure (a drive is write protected, for
example), the system prints an error message followed by:
?HAVE THE PROBLEMS MENTIONED ABOVE BEEN CORRECTED YET:
When the problem has been corrected, type Y and press the
RETURN key. Go back to Step 12.
Step 36 STOP.
If the system prints a message similar to:
?PS UNIT 0 HAS NO BAT BLOCKS
DO YOU WANT TO WRITE A SET OF PROTOTYPE BAT BLOCKS?
2-20
CREATING THE TOPS-20 FILE SYSTEM
type yes and press the RETURN key. Continue with the next step.
2.5 RESTARTING THE MONITOR
Now that the file system is initialized, you can start the system by
performing Steps 37 to 43.
Step 37: Type the date and time and press the RETURN key.
The system prints:
System restarting, wait...
ENTER CURRENT DATE AND TIME:
Type the date and time in the format dd-mmm-yy hhmm. Then press the
RETURN key. Be sure to enter the time in 24-hour format. For
example, 4:30 PM on the twelfth day of March can be entered as
12-MAR-88 1630.
ENTER CURRENT DATE AND TIME: 12-MAR-88 1630 <RET>
The system responds by retyping the date and time.
YOU HAVE ENTERED SATURDAY, 12-MARCH-1988 4:30PM,
IS THIS CORRECT (Y,N)
Step 38: 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. If
the date and time are incorrect, type N and press the RETURN key. The
system again asks for the date and time.
YOU HAVE ENTERED SATURDAY, 12-JUNE-1988 4:30PM,
IS THIS CORRECT (Y,N) Y <RET>
WHY RELOAD?
CI20
If your system configuration does not include CI20,
ignore the following message when you start the
monitor:
BUGCHK "NOLODF" AT dd-mmm-yy hh:mm
COULD NOT FIND CI-20 MICROCODE LOAD PROGRAM
If you are installing CI20, you can also ignore this
message, as the necessary files are not yet on disk.
2-21
CREATING THE TOPS-20 FILE SYSTEM
Step 39: Type NEW and press the RETURN key.
Type NEW and press the RETURN key. The 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 prints PROBLEM WITH <SYSTEM>ACCOUNTS-TABLE.BIN CANNOT FIND
ERROR MESSAGE FILE - ACCOUNT VALIDATION IS DISABLED and RUNNING DDMP.
NOTE
If you do not respond to the WHY RELOAD question
within 60 seconds, the system assumes OTHER and
continues the startup procedure.
WHY RELOAD? NEW <RET>
PROBLEM WITH <SYSTEM>ACCOUNTS-TABLE.BIN
CANNOT FIND ERROR MESSAGE FILE - ACCOUNT VALIDATION IS
DISABLED
RUNNING DDMP
NO SYSJOB
The system prints the message ACCOUNT VALIDATION IS DISABLED because
the ACTGEN program did not run. (See the TOPS-20 System Manager's
Guide for more information.) The system runs DDMP and then prints NO
SYSJOB because the SYSJOB program is not stored on disk. Ignore this
message as SYSJOB is not needed yet.
Error: If you type an incorrect string to the WHY RELOAD?
question, the system prints the valid abbreviations and then
prompts you again for the answer.
Ethernet
If your system configuration does not include an
Ethernet, ignore the following message when you start
the monitor:
BUGCHK "KNICFF" AT dd-mmm-yy hh:mm:ss
PHYKNI - CANNOT RELOAD THE KLNI
If you are installing an Ethernet, you can also ignore
this message, as the necessary files are not yet on
disk.
Step 40: Type <CTRL/C>.
2-22
CREATING THE TOPS-20 FILE SYSTEM
After the system prints NO SYSJOB, type <CTRL/C> to start a job.
NO SYSJOB
<CTRL/C>
NO EXEC
MX>
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.
Step 41: Type G, then MTA0:. Press the RETURN key.
The system is now at the miniexec command level, and you can type any
miniexec command. Use this command language to load the TOPS-20
command processor from tape. (Type <CTRL/U> if you want to erase a
line while at miniexec command level.)
Type G. The system prints ET FILE. Type MTA0: and press the RETURN
key. The system skips over the end of the monitor save file and
prints the miniexec prompt MX>.
NO EXEC
MX>GET FILE MTA0: <RET>
MX>
NOTE
If you are using a tape drive other than tape drive 0,
reply accordingly in the following steps and/or error
recovery procedures, for example, MTA1:, MTA2:.
Error: If you get a question mark (?) after issuing the command,
you can ignore this message and continue with the next step.
Step 42: Again type G, then MTA0:. Press the RETURN key.
To load the TOPS-20 command processor from magnetic tape into memory,
type G. The system prints ET FILE. Type MTA0: and press the RETURN
key. The system reads the program from MTA0: into memory and prints
the miniexec prompt when it is finished.
MX>GET FILE MTA0: <RET>
MX>
Error: If you get an error in the form "INTERRUPT AT location," the
tape 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.
2-23
CREATING THE TOPS-20 FILE SYSTEM
If you make a typing mistake and press the RETURN key, the
system prints MX>. Try again.
Step 43: Type S and press the RETURN key.
To start the TOPS-20 command processor that you just loaded into
memory, type S. The system prints TART. Press the RETURN key. The
system prints the name and version of the TOPS-20 command processor
and the TOPS-20 prompt (@).
MX>START <RET>
TOPS-20 Command processor 7(4123)
@
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 error message INTERRUPT AT 601772, follow
these error recovery procedures:
1. Rewind the tape manually and give the following
commands:
MX>GET FILE MTA0: <RET>
MX>RESET <RET>
MX>GET FILE MTA0: <RET>
MX>START <RET>
2. Proceed to Step 44.
If you make a typing error and press the RETURN key, the
system prints MX>. Try again.
Error: If many error messages are repeatedly printed, the tape
could be bad. Press the front-end HALT switch and wait one
minute. Go back to Step 12. If the errors persist, ask for
another tape.
2.6 CREATING SYSTEM DIRECTORIES
With the system running, you must create directories to store system
files and files for testing the system. You create these directories
by running the DLUSER program from tape (Steps 44 through 47).
Step 44: Type ENABLE and press the RETURN key.
2-24
CREATING THE TOPS-20 FILE SYSTEM
To load files into privileged areas and to create directories, give
the ENABLE command to obtain the required capabilities.
@ENABLE <RET>
$
Step 45: Type RUN MTA0: and press the RETURN key.
To run the DLUSER program from the magnetic tape, type RUN MTA0:.
After you issue this command, the system prints the prompt DLUSER>.
$RUN MTA0: <RET>
DLUSER>
Error: If you receive an error message, rewind the tape, skip two
files, and reissue this command. The following example
shows how to do this for MTA0:.
$REWIND MTA0: <RET>
$SKIP MTA0: 2 FILES <RET>
$RUN MTA0: <RET>
DLUSER>
Step 46: Type LOAD MTA0: and press the RETURN key.
To load the directory structure from the tape into the file system,
type LOAD MTA0:. After a few seconds, the system prints DONE. and the
DLUSER prompt.
DLUSER>LOAD MTA0: <RET>
DONE.
DLUSER>
Error: If you mistype the command and have not pressed the RETURN
key, delete the entire line by typing <CTRL/U>, and then
reissue the command.
If you mistyped the command and pressed the RETURN key,
follow the error recovery procedure in Step 45.
If you get a group of JSYS error messages, you probably did
not give the ENABLE command in Step 44. Type <CTRL/C>
twice, type ENABLE, press the RETURN key, and give the
following commands:
$REWIND MTA0: <RET>
?Device MTA0: open on JFN 3
%Close JFN? YES <RET>
2-25
CREATING THE TOPS-20 FILE SYSTEM
3 MTA0: [OK]
$SKIP MTA0: 2 FILES <RET>
$RUN MTA0: <RET>
DLUSER>LOAD MTA0: <RET>
DONE.
DLUSER>
Step 47: Type EXIT and press the RETURN key.
Type EXIT to end the DLUSER program. The system prints the ENABLEd
prompt ($).
DLUSER>EXIT <RET>
$
2.7 RUNNING DUMPER FROM TAPE
The DUMPER program places files from the magnetic tape into the
TOPS-20 file system. The DUMPER program is the fifth file on the
Installation Tape.
For the output from the DUMPER command FILES to print the width (132
columns) of the CTY paper, rather than wrap after 80 columns, enter
the following command before starting DUMPER:
$TERMINAL WIDTH 132 <RET>
To run DUMPER, perform Steps 48 and 49.
Step 48: Type RUN MTA0: and press the RETURN key.
The DUMPER program is on the tape mounted on drive 0. Since the tape
is already positioned at the DUMPER program, type RUN MTA0:. After
the DUMPER program starts, the system prints the DUMPER prompt.
$RUN MTA0: <RET>
DUMPER>
Error: If you get errors, the magnetic tape was either not recorded
properly or not positioned properly. Rewind the tape, skip
four files, and try again. The following lines show how to
do this for MTA0:. If the errors persist, contact DIGITAL
Software Support.
$REWIND MTA0: <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
2-26
CREATING THE TOPS-20 FILE SYSTEM
DUMPER>
Step 49: Type TAPE MTA0: and press the RETURN key.
Tell DUMPER which tape drive to use by typing TAPE MTA0:. The system
then prints the DUMPER prompt.
DUMPER>TAPE MTA0: <RET>
DUMPER>
Error: If you make a typing error, reissue the command.
2.8 RESTORING TOPS-20 BUNDLED SOFTWARE FROM TAPE
Restore the files for the directories PS:<SYSTEM>, PS:<SUBSYS>, and
PS:<UETP.LIB> from the tape.
Give the DUMPER command FILES just before the RESTORE command if you
want the system to print the file specification of each file it
restores. (The installation takes longer if you print this
information.) To stop printing each file specification, give the NO
FILES command after the current RESTORE command finishes. (See the
TOPS-20 User Utilities Guide for an explanation of any messages that
DUMPER may print on your terminal.)
NOTE
This procedure restores the files on the Installation
tape to a structure called PS:. If in Step 35 of this
guide you gave a structure name other than PS:, type
the structure name you specified in place of PS: in
the following steps. For example:
RESTORE PS:<*>*.*.* FOO:<SYSTEM> <RET>
Note that the files are being restored to a structure
called FOO:.
Perform Steps 50 through 57 to restore the bundled software.
Step 50: Type RESTORE PS:<*>*.*.* PS:<SYSTEM>*.*.* and press the
RETURN key.
To copy the TOPS-20 monitor and its related programs from magnetic
tape to disk, type the RESTORE command. This command restores all the
files in the first saveset to the directory PS:<SYSTEM>. When all the
files are restored, you return to the DUMPER prompt.
2-27
CREATING THE TOPS-20 FILE SYSTEM
DUMPER>RESTORE PS:<*>*.*.* PS:<SYSTEM>*.*.* <RET>
Saveset "SYSTEM Files for TOPS-20 V7.0" 17-Mar-88 1441
Loading files into PS:<SYSTEM>
End of Saveset.
Total files restored: 26
Total pages restored: 1765
DUMPER>
Error: If you do not type the correct input structure, PS:, or if
the tape is not positioned correctly, no files are restored
from tape. In this case you will not see the message
"Loading files into PS:<SYSTEM>." To correct this error,
type <CTRL/E>, give the following commands, and begin again
at Step 49.
<CTRL/E>
Interrupting...
DUMPER>>ABORT <RET>
Aborting RESTORE command...
DUMPER>REWIND <RET>
DUMPER>EXIT <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
DUMPER>
Error: If you do not type the correct structure and directory name,
PS:<SYSTEM>, the files are restored to the wrong directory.
To correct this error, type <CTRL/E>, and give the following
commands. Then reissue the RESTORE command in this step.
Be sure to delete and expunge the files in the incorrect
directory.
<CTRL/E>
Interrupting...
DUMPER>>ABORT <RET>
Aborting RESTORE command...
DUMPER>REWIND <RET>
DUMPER>EXIT <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
DUMPER>TAPE MTA0: <RET>
DUMPER>
Step 51: Type RESTORE PS:<*>*.*.* PS:<SUBSYS>*.*.* and press the
RETURN key.
Restore the system program files to the directory PS:<SUBSYS> with the
RESTORE command. When all the files are restored, you return to the
DUMPER prompt.
2-28
CREATING THE TOPS-20 FILE SYSTEM
DUMPER>RESTORE PS:<*>*.*.* PS:<SUBSYS>*.*.* <RET>
Saveset "SUBSYS Files for TOPS-20 V7.0" 17-Mar-88 1442
Loading files into PS:<SUBSYS>
End of Saveset.
Total files restored: 177
Total pages restored: 4534
DUMPER>
Error: If you do not type the correct input structure, PS:, or if
the tape is not positioned correctly, no files are restored
from tape. In this case you will not see the message
"Loading files into PS:<SUBSYS>." To correct this error,
type <CTRL/E>, give the following commands, and begin again
at Step 49.
<CTRL/E>
Interrupting...
DUMPER>>ABORT <RET>
Aborting RESTORE command...
DUMPER>REWIND <RET>
DUMPER>EXIT <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
DUMPER>
Error: If you forget to type the directory PS:<SUBSYS>, the files
are restored to the wrong directory. Type <CTRL/E> and give
the following commands to correct the error. Then reissue
the RESTORE command in this step. Be sure to delete and
expunge the files in the incorrect directory.
<CTRL/E>
Interrupting...
DUMPER>>ABORT <RET>
Aborting RESTORE command...
DUMPER>REWIND <RET>
DUMPER>EXIT <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
DUMPER>TAPE MTA0: <RET>
DUMPER>SKIP 1 <RET>
DUMPER>
Step 52: Type RESTORE PS:<*>*.*.* PS:<SUBSYS>*.*.* and press the
RETURN key.
To restore the GALAXY files into the directory PS:<SUBSYS>, type the
RESTORE command. When all the files are restored, you return to the
DUMPER prompt.
2-29
CREATING THE TOPS-20 FILE SYSTEM
DUMPER>RESTORE PS:<*>*.*.* PS:<SUBSYS>*.*.* <RET>
Saveset "GALAXY SUBSYS Files for TOPS-20 V7.0" 17-Mar-88 1443
Loading files into PS:<SUBSYS>
End of Saveset.
Total files restored: 24
Total pages restored: 585
DUMPER>
Error: If you forget to type PS:<SUBSYS>, the system restores the
files to the wrong directory. Type <CTRL/E> to stop DUMPER
and enter the commands listed below. Then reissue the
RESTORE command in this step. Be sure to delete and expunge
the files in the incorrect directory.
<CTRL/E>
Interrupting...
DUMPER>>ABORT <RET>
Aborting RESTORE command...
DUMPER>REWIND <RET>
DUMPER>EXIT <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
DUMPER>TAPE MTA0: <RET>
DUMPER>SKIP 2 <RET>
DUMPER>
Step 53: Type RESTORE PS:<*>*.*.* PS:<UETP.LIB>*.*.* and press the
RETURN key.
To restore the files into the directory <UETP.LIB>, type the RESTORE
command. When all the files are restored, you return to the DUMPER
prompt.
DUMPER>RESTORE PS:<*>*.*.* PS:<UETP.LIB>*.*.* <RET>
Saveset "UETP Files for TOPS-20 V7.0" 17-Mar-88 1444
Loading files into PS:<UETP.LIB>
End of Tape.
Total files restored: 55
Total pages restored: 482
DUMPER>
Error: If you do not type the correct input structure, PS:, for
example, or if the tape is not positioned correctly, no
files are restored from tape. In this case you will not see
the message "Loading files into PS:<UETP.LIB>." To correct
this error, type <CTRL/E>, give the following commands, and
begin again at Step 49.
2-30
CREATING THE TOPS-20 FILE SYSTEM
<CTRL/E>
Interrupting...
DUMPER>>ABORT <RET>
Aborting RESTORE command...
DUMPER>REWIND <RET>
DUMPER>EXIT <RET>
$SKIP MTA0: 4 FILES <RET>
$RUN MTA0: <RET>
DUMPER>
Step 54: Type EXIT and press the RETURN key.
Type EXIT to end DUMPER. The system prints the ENABLEd prompt ($).
DUMPER>EXIT <RET>
$
Step 55: Type UNLOAD MTA0: and press the RETURN key.
To remove the TOPS-20 Installation tape from the tape drive, type
UNLOAD MTA0:. The system rewinds the tape onto the source reel.
$UNLOAD MTA0: <RET>
$
You can now remove the tape from the tape drive.
Error: If the system prints:
%Device open in lower fork
%Kill lower fork?
type YES and press the RETURN key. The system unloads your
tape.
Step 56: Type INFORMATION DISK-USAGE PS:<*> and press the RETURN key.
If you give the command INFORMATION DISK-USAGE PS:<*>, the system
prints the size of every directory on the public structure, PS:. The
example in Figure 2-1 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 in the event
you update your system to a newer release of the TOPS-20 operating
system.
Error: If the "Pages assigned" for each directory shown do not
approximately match the value shown in this guide or the
value derived from the directory listing shipped with your
2-31
CREATING THE TOPS-20 FILE SYSTEM
Installation tape, some files may not have been copied
correctly. Mount the tape again on MTA0:, skip four files
and begin again at Step 48.
2-32
CREATING THE TOPS-20 FILE SYSTEM
$INFORMATION DISK-USAGE PS:<*> <RET>
PS:<ROOT-DIRECTORY>
-881 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<ACCOUNTS>
17 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<NEW-SUBSYS>
0 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<NEW-SYSTEM>
0 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<OPERATOR>
0 Pages assigned
250 Working pages, 250 Permanent pages allowed
PS:<SPOOL>
0 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<SUBSYS>
5119 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<SYSTEM>
1765 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<SYSTEM-ERROR>
1 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<UETP>
6 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<UETP.LIB>
482 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<UETP.RUN>
0 Pages assigned
+INF Working pages, +INF Permanent pages allowed
Total of 6509 Pages assigned, in 12 directories.
52134 Pages free on PS:, 23866 Pages used.
2-33
CREATING THE TOPS-20 FILE SYSTEM
Figure 2-1: Directories on the Public Structure
2.9 CREATING THE DUMP.EXE FILE
To record system failures, create the DUMP.EXE file by performing
Steps 57 through 59.
Step 57: Type RUN PS:<SUBSYS>MAKDMP.EXE and press the RETURN key.
To create the DUMP.EXE file, which records any system failures, type
RUN PS:<SUBSYS>MAKDMP.EXE. The system prints the prompt MAKDMP>.
$RUN PS:<SUBSYS>MAKDMP.EXE <RET>
MAKDMP>
NOTE
If you do not know how much memory your system has,
type the HELP command and press the RETURN key after
the system prints MAKDMP>. MAKDMP prints examples of
physical memory size with the corresponding number of
words.
Step 58: Type CREATE PS:<SYSTEM>DUMP.EXE.1 memory-size and press the
RETURN key.
To overwrite the existing DUMP.EXE file with a new DUMP.EXE file, type
CREATE PS:<SYSTEM>DUMP.EXE.1 memory-size. Be sure to enter the total
amount of memory your system has. The following example uses 2048K
words as the memory size.
MAKDMP>CREATE PS:<SYSTEM>DUMP.EXE.1 2048 <RET>
[Dump file: <SYSTEM>DUMP.EXE.1 created]
MAKDMP>
Step 59: Type EXIT and press the RETURN key.
Type EXIT to end the MAKDMP program and return to TOPS-20 command
level.
MAKDMP>EXIT <RET>
$
NOTE
If in the future you add some additional memory to
your system, you should recreate the DUMP.EXE file to
2-34
CREATING THE TOPS-20 FILE SYSTEM
allow it to accommodate the additional memory.
2-35
CHAPTER 3
TAILORING THE SYSTEM
After you have installed the bundled TOPS-20 software from the
Installation Tape, tailor your system for your specific needs.
1. Select a monitor that is correct for your system.
2. Change the system name.
3. Create system defaults for the following:
o terminal speeds
o dial-up lines
o system logical names
o magnetic tape drive numbers
o line printer parameters
o local time zone
o directory parameter setting
o account validation
o performance improvements
o scheduler controls
o file archiving parameters
o migration parameters
o tape drive allocation
o accounting shift changes
3-1
TAILORING THE SYSTEM
o assigning MSCP-served disk drives
o daylight savings time
o remote line conditions
o controlling system message levels
o network information
o cluster data gathering
o off-line structures time out interval
o login structures
o minimum password length
|
| o password expiration
|
| o password dictionary
o dumping memory on non-fatal errors
|
| o Security parameters
These defaults are set in the configuration command file.
4. Change the operator's password and user group.
5. Create the directory PS:<REMARKS>.
6. Create the PS:<SYSTEM>LPFORM.INI file.
3.1 SELECTING A TOPS-20 MONITOR
At this time you are running the TOPS-20 monitor 2060-MONBIG.EXE. You
should now select the monitor that most closely meets your system's
requirements. Choose a monitor that supports at least:
1. As much memory as your system contains. A monitor that
supports less memory than your system contains will not use
all available memory.
2. The number of terminal lines you need. Do not count the
operator's console in this number. Just count the local
terminal lines and remote lines.
3. The number of user jobs that you plan to run, plus two (one
operator job and job 0). For example, if you expect to run
3-2
TAILORING THE SYSTEM
20 user jobs, the monitor you select should support at least
22 jobs.
4. The number of pseudo-terminals that you need. The system
needs at least two pseudo-terminals, one for the PTYCON
program to run the operator program OPR and one for unplanned
situations that may arise.
For example, if you want to run five pseudo-terminals in your
batch system, you need a monitor that supports at least seven
pseudo-terminals.
5. The number of peripheral devices on your system.
6. The number of LAT (Local Area Transport) lines on your
system.
All monitors are stored in the directory <SYSTEM>. They all run
timesharing and batch concurrently. Do not select a monitor that has
fewer resources than you need, or a monitor that is unnecessarily
large. The TOPS-20 monitors and their characteristics are listed
below. See Table 3-1 for the maximum structure size.
2060-MONBIG.EXE A big timesharing monitor. This monitor supports:
100 jobs
96 lines
64 LAT lines
30 pseudo-terminals
4MEG of memory
8 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six RP04,
three RP06, one RP07, three RP20 spindles,
two RA60, or one RA81) per structure
10000 pages for swapping space
2060-MONMAX.EXE The largest timesharing monitor. This monitor
supports:
128 jobs
128 lines
128 LAT lines
50 pseudo-terminals
4MEG of memory
16 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six RP04,
three RP06, one RP07, three RP20 spindles,
two RA60, or one RA81) per structure
3-3
TAILORING THE SYSTEM
15000 pages for swapping space
Table 3-1: Maximum Structure Size
-------------------------------------------------------
| Type of | Max. No. Packs | No. Pages |
| Disk Drive | Per Structure | Per Pack * |
-------------------------------------------------------
| | | |
| RP04 | 6 | 38,000 |
| RP06 | 3 | 76,000 |
| RP07 | 1 | 216,376 |
| RP20 | 5 | 201,420 |
| RA60 | 6 | 90,516 |
| RA81 | 5 | 200,928 |
-------------------------------------------------------
* a page = 512 36-bit words
In Steps 60 and 61, you choose the monitor most appropriate for your
needs and copy it to the file MONITR.EXE.
Step 60: Type CONNECT PS:<SYSTEM> and press the RETURN key.
Connect to the directory PS:<SYSTEM> by typing the CONNECT command.
$CONNECT PS:<SYSTEM> <RET>
$
TCP/IP Installations
If you are performing a TCP/IP installation, you must
choose a TOPS-20 monitor at this time. After you
restore the TCP/IP Distribution tape, you will be able
to choose a TCP/IP monitor.
Step 61: Type COPY montyp.EXE.* MONITR.EXE.* and press the RETURN
key.
Use the COPY command to copy the monitor that you have selected to the
file MONITR.EXE. "Montyp" designates the type of monitor you have
selected for your system. When the copy is successfully completed,
the system prints an OK message. The different monitors are
2060-MONBIG.EXE and 2060-MONMAX.EXE.
$COPY montyp.EXE.* MONITR.EXE.* <RET>
montyp.EXE.n => MONITR.EXE.n [OK]
3-4
TAILORING THE SYSTEM
$
Error: If you type the wrong name, reissue the command.
3.2 CHANGING THE SYSTEM NAME
Whenever a user types <CTRL/C> before logging in or gives the
INFORMATION VERSION command, the system prints a message similar to:
TOPS-20 BIG SYSTEM, TOPS-20 Monitor n.n(nnnn)
where n.n(nnnn) is the version and edit number of the operating
system. You can change the system name "TOPS-20 BIG SYSTEM" by
entering the name you want into the file PS:<SYSTEM>MONNAM.TXT. If
the name contains lowercase letters, give the command TERMINAL NO
RAISE before entering the name.
The text of the system name can contain up to 105 characters. For
practical purposes, it should not exceed 32 characters to fit on a
single 72-character line of terminal output. Steps 62 through 64 show
how to change the system name to "Installation-test System" and how to
change the new system name to the abbreviated name "Instal-tst."
Step 62: Type TERMINAL NO RAISE and press the RETURN key (optional).
If you want lowercase letters in the system name, type the TERMINAL
command. Make sure that the CAPS LOCKED button on the terminal is up.
$TERMINAL NO RAISE <RET>
$
Step 63: Type COPY TTY: MONNAM.TXT and press the RETURN key. Then
enter the system name and type <CTRL/Z>.
Change the system name by entering the name you want into the file
PS:<SYSTEM>MONNAM.TXT. The system name should not exceed 32
characters.
Use the COPY command to give the system a new system name. After you
enter the command, the system waits for you to type the new name of
your system. After you enter the new system name, type <CTRL/Z>. In
the example, the new system name is Installation-test System.
$COPY TTY: MONNAM.TXT <RET>
TTY: = MONNAM.TXT.1
Installation-test System ^Z
$
3-5
TAILORING THE SYSTEM
You can change this file at any time, but the system reads the system
name only when the monitor is started (whenever you boot the system).
Step 64: Type COPY TTY: TAPNAM.TXT and press the RETURN key. Enter
the abbreviated system name and type <CTRL/Z>.
You should also change the system name that will be written on the
volume header label of any tape initialized by users of the system.
Do this by entering the name you want into the file
PS:<SYSTEM>TAPNAM.TXT. This system name must contain ten or fewer
characters, so you will probably have to abbreviate the name given in
the previous step. The example shows how to change the system name
(that appears on tape labels written by the system) to "Instal-tst."
Give the system an abbreviated name with the COPY command. After you
enter the command, the system waits for you to type the abbreviated
system name. After you enter the abbreviated system name, type
<CTRL/Z>. In the example, the abbreviated system name is Instal-tst.
$COPY TTY: TAPNAM.TXT <RET>
TTY: = TAPNAM.TXT.1
Instal-tst ^Z
$
3.3 CREATING SYSTEM DEFAULTS IN THE CONFIGURATION COMMAND FILE
You must create a configuration command file to define:
Terminal line speeds Logical names
Magnetic tape drives Line printers
Local time zone Directory parameter setting
Account validation Performance improvements
Scheduler controls File archiving and migration
Tape drive allocation Accounting shift changes
MSCP-served disk drives Daylight savings time
Remote line conditions System level messages
Network information Off-line structures
| Login structures Password management
Memory dumps Cluster data gathering
| Security controls
The next time the system starts, the SETSPD (SET System Parameter
Defaults) program uses the definitions entered into this file. This
program runs automatically at system startup.
The formats of the commands are described in Sections 3.3.1 through
3.3.23 (Steps 65 through 99). You can include comment lines if they
are preceded by exclamation points.
3-6
TAILORING THE SYSTEM
NOTE
The following sections describe how to create the
configuration command file. These steps illustrate
the use of the EDIT editor program. You can use any
editor of your choice, as long as you accomplish the
goal of each step.
Step 65: Type CREATE 7-CONFIG.CMD and press the RETURN key.
Use EDIT to CREATE the 7-CONFIG.CMD file. (See the TOPS-20 EDIT
Reference Manual for more information on how to use EDIT.) The system
prints the file name and the line number.
$CREATE 7-CONFIG.CMD <RET>
Input: PS:<SYSTEM>7-CONFIG.CMD.1
00100
Do not confuse the CREATE command, which creates a file, with the
privileged ^ECREATE command, which creates a directory.
3.3.1 Setting Terminal Speeds
Whenever the system starts, the SETSPD program reads the TERMINAL
commands from the configuration command file and sets the terminal
lines to the specified speeds.
Users can change the speeds of their terminals by giving the TERMINAL
SPEED command. When one user logs out and another user logs in on the
same terminal, the system does not change the line speed back to the
default listed in the configuration command file. However, if the
line is defined as REMOTE, the speed is changed back after the line is
disconnected. Note that the operator can change the speed of the line
by giving the privileged ^ESET command.
To set the default speed for a particular line, enter a command in the
following format into the configuration command file:
TERMINAL line SPEED input output
where:
line is an octal line number, or a range of lines in the
form line-line. Your DIGITAL Field Service
Representative will provide you with a list of line
numbers and the corresponding locations. (See Section
1.2.)
input is the input speed (to the system) of the terminal(s).
3-7
TAILORING THE SYSTEM
output is the output speed of the terminal(s). If you do not
specify both output and input, the system assumes that
the output speed is the same as the input speed.
Valid terminal speeds are:
0 (to shut off the line) 300
50 600
75 1200
110 1800
134 (actually 134.5) 2400
150 4800
200 9600
NOTE
If you do not specify a speed for a line, the system
uses 300 for both input and output. If you have lines
in the terminal cont