Trailing-Edge
-
PDP-10 Archives
-
SRI_NIC_PERM_SRC_1_19910112
-
6-manuals/20binst.mem
There are no other files named 20binst.mem in the archive.
1
TOPS-20 KL Model B
Installation Guide
| VERSION 6.0 INTERIM RELEASE DRAFT
|
|
|
| December 1984
This manual describes the procedures for
| installing TOPS-20 Version 6 on a new
| system and updating TOPS-20 software on
an existing KL10 Model B system.
| This update supersedes the information
| contained in the manual numbered
| AA-M229B-TM and all updates. Please
| read it in its entirety.
| OPERATING SYSTEM: TOPS-20 Version 6.0
|
| SOFTWARE: RSX-20F Version 15-20
| KLINIT Version 15-12
| Microcode Version 352
DIGITAL Equipment Corporation, Maynard, Massachusetts
2
First Printing, April 1982
| Updated, December 1982
| Revised, December 1984
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.
Copyright C 1982 Digital Equipment Corporation.
All Rights Reserved.
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:
DEC DECnet IAS
DECUS DECsystem-10 MASSBUS
Digital Logo DECSYSTEM-20 PDT
PDP DECwriter RSTS
UNIBUS DIBOL RSX
VAX EduSystem VMS
VT
3
CONTENTS
CHAPTER 1 INTRODUCTION
1.1 SUMMARY OF CONTENTS . . . . . . . . . . . . . . . 1-1
1.2 PREPARING FOR INSTALLATION . . . . . . . . . . . . 1-2
1.3 INSTALLATION TOOLS . . . . . . . . . . . . . . . . 1-5
1.4 THE TOPS-20 MONITORS . . . . . . . . . . . . . . . 1-6
1.5 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.1.1 Preparing the DECSYSTEM-20 for Installation . . 2-2
2.1.2 Loading and Starting the TOPS-20 Monitor . . . . 2-6
2.2 INITIALIZING THE TOPS-20 FILE SYSTEM . . . . . . 2-13
2.3 STARTING THE MONITOR . . . . . . . . . . . . . . 2-19
2.4 CREATING SYSTEM DIRECTORIES . . . . . . . . . . 2-21
2.5 RUNNING DUMPER FROM TAPE . . . . . . . . . . . . 2-23
2.6 RESTORING TOPS-20 BUNDLED SOFTWARE FROM TAPE . . 2-24
CHAPTER 3 TAILORING THE SYSTEM
3.1 SELECTING A TOPS-20 MONITOR . . . . . . . . . . . 3-1
3.2 CHANGING THE SYSTEM NAME . . . . . . . . . . . . . 3-4
3.3 CREATING SYSTEM DEFAULTS IN 6-CONFIG.CMD . . . . . 3-6
3.3.1 Setting Terminal Speeds . . . . . . . . . . . . 3-6
3.3.2 Defining Dial-Up (Remote) Lines . . . . . . . . 3-8
3.3.3 Defining System Logical Names . . . . . . . . . 3-9
3.3.4 Defining Magnetic Tape Logical Unit Numbers . 3-10
3.3.5 Defining Line Printer Parameters . . . . . . . 3-11
3.3.5.1 Specifying the VFU File . . . . . . . . . . 3-12
3.3.5.2 Specifying the RAM File . . . . . . . . . . 3-12
3.3.6 Defining the Local Time Zone . . . . . . . . . 3-13
3.3.7 Directory Parameter Setting . . . . . . . . . 3-14
3.3.8 Account Validation . . . . . . . . . . . . . . 3-14
3.3.9 Performance Improvements . . . . . . . . . . . 3-14
3.3.9.1 Full Latency Optimization . . . . . . . . . 3-15
3.3.9.2 Working Set Swapping . . . . . . . . . . . . 3-15
3.3.10 Scheduler Controls . . . . . . . . . . . . . . 3-16
3.3.10.1 Bias Controls . . . . . . . . . . . . . . . 3-16
3.3.10.2 Class Scheduling . . . . . . . . . . . . . . 3-16
3.3.11 File Archiving and Migration Parameters . . . 3-18
3.3.11.1 Archive Tape Recycle Period . . . . . . . . 3-18
3.3.11.2 Migration Tape Recycle Period . . . . . . . 3-18
3.3.12 Tape Drive Allocation . . . . . . . . . . . . 3-18
3.3.12.1 Enabling Tape Drive Allocation . . . . . . . 3-19
3.3.12.2 Treatment of Unrecognized Tapes . . . . . . 3-19
3.3.13 Accounting Shift Changes . . . . . . . . . . . 3-19
3.3.14 Assigning MSCP Served Disk Drive . . . . . . . 3-20
3.3.15 Specifying Daylight Savings Time . . . . . . . 3-20
3.3.16 Specifying Remote Line Conditions . . . . . . 3-21
3.3.17 Controlling System Message Levels . . . . . . 3-21
3.4 CHANGING THE OPERATOR'S PASSWORD AND USER GROUP 3-23
3.5 CREATING PS:<REMARKS> DIRECTORY . . . . . . . . 3-24
3.6 CREATING THE LPFORM.INI FILE . . . . . . . . . . 3-25
3.7 BUILDING A FRONT-END FILE STRUCTURE . . . . . . 3-27
4
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-2
4.3 COPYING FILES FROM FLOPPY DISK TO RP04 OR RP06 . . 4-3
CHAPTER 5 RESTARTING THE SYSTEM
CHAPTER 6 INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
CHAPTER 7 RUNNING THE TOPS-20 UETP PACKAGE
7.1 TESTING SOFTWARE . . . . . . . . . . . . . . . . . 7-5
APPENDIX A UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
A.1 INSTALLING THE VERSION 6.0 SOFTWARE . . . . . . . A-1
A.1.1 Renaming the Version 5.1 Monitor . . . . . . . A-12
A.1.2 Creating the File <NEW-SYSTEM>6-CONFIG.CMD . . A-13
A.1.3 Changing System Parameters . . . . . . . . . . A-15
A.1.4 Setting a User Group for the Operator . . . . A-15
A.2 REVERTING TO VERSION 5.1 . . . . . . . . . . . . A-21
A.3 MAKING THE VERSION 6.0 MONITOR THE PRIMARY
MONITOR . . . . . . . . . . . . . . . . . . . . A-24
A.4 MAKING THE VERSION 6.0 MONITOR THE PERMANENT
MONITOR . . . . . . . . . . . . . . . . . . . . A-25
APPENDIX B TAILORING YOUR SYSTEM FOR ARPANET
APPENDIX C GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
C.1 INTRODUCTION . . . . . . . . . . . . . . . . . . . C-1
C.2 RESTORING THE GALAXY FILES . . . . . . . . . . . . C-2
C.3 RUNNING THE GALGEN PROGRAM . . . . . . . . . . . . C-8
C.4 ASSEMBLING THE NEW GALAXY SYSTEM . . . . . . . . C-12
C.5 SHUTTING DOWN THE OLD GALAXY SYSTEM . . . . . . C-13
C.6 STARTING UP THE NEW GALAXY SYSTEM . . . . . . . C-17
C.7 MAKING YOUR NEW GALAXY SYSTEM THE PERMANENT
SYSTEM . . . . . . . . . . . . . . . . . . . . . C-19
FIGURES
2-1 DECSYSTEM-20 and Front-End Control Panels . . . . 2-8
TABLES
3-1 Maximum Structure Size . . . . . . . . . . . . . . 3-3
3-2 Terminal Line Numbers DECSYSTEM-20 . . . . . . . . 3-8
3-3 DECSYSTEM-20 Line Printers . . . . . . . . . . . 3-11
5-1 System Reload Abbreviations . . . . . . . . . . . 5-3
5
PREFACE
This manual is for the person who has the responsibility to:
1. Install the TOPS-20 software on a new DECSYSTEM-20.
2. Update the TOPS-20 software system on an existing
DECSYSTEM-20.
To use this manual effectively, first read Getting Started With
TOPS-20. You should also become familiar with the information in the
TOPS-20 User's Guide and the TOPS-20 Operator's Guide.
You do not have to know assembly language programming or have previous
experience installing a TOPS-20 software system, although both are
helpful.
Contents of This Manual
Chapters 1 through 7 contain step-by-step instructions, with error
| recovery procedures, describing how to install a new TOPS-20 Version
| 6.0 software system.
Appendix A contains step-by-step instructions describing how to update
| a TOPS-20 Version 5 software system to Version 6.0.
After you complete either the set of steps in Chapters 1 through 7 or
the steps in Appendix A, your system is ready for timesharing.
Appendix B is a pocket installation guide for the experienced
installer. This appendix contains the text and output from a sample
installation, but does not cover error recovery procedures. The steps
in this appendix are keyed to the body of this manual so that you can
easily refer to a complete description of any step.
Appendix C describes the procedures for tailoring your system for the
ARPA network.
Appendix D contains the procedures for generating a tailored batch and
spooling system (GALAXY).
The commands you must type are printed in RED. 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.
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.
6
If your terminal output does not resemble the sample output, first
read ALL the instructions after the word "Error", then choose the
recovery procedure that corrects your problem.
NOTE
The version and edit numbers in this manual could
differ from the numbers printed on your console
terminal. The numbers printed on your console must be
equal to or greater than the numbers in this manual.
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.
Checking off each step as you complete it is a good way to keep your
place.
Symbols Used in This Manual
CTRL/\ Indicates where you type a control backslash. This is done
by holding down the CTRL key while typing a backslash. The
backslash key is located near the key labeled LINEFEED or
LF.
<ESC> Indicates where you press the key labeled ESC, ESCAPE,
PREFIX, ALT, or ALTMODE.
<RET> Indicates where you press the RETURN key.
Reference Documentation
The following manuals are valuable as references for users of this
manual. These manuals are included in the TOPS-20 Software Notebook
Set.
Manual Title
TOPS-20 Commands Reference Manual
TOPS-20 EDIT Reference Manual
TOPS-20 Monitor Calls Reference Manual
TOPS-20 Operator's Guide
TOPS-20 OPR Command Language Reference Manual
TOPS-20 System Manager's Guide
TOPS-20 User Utilities Guide
TOPS-20 User's Guide
7
1-1
CHAPTER 1
INTRODUCTION
Installing the TOPS-20 software on the DECSYSTEM-20 is not a hard task
if you follow the procedures outlined in the following chapters.
1.1 SUMMARY OF CONTENTS
Chapter 1 explains some of the procedures to follow. It also
describes the tools you need to install the software.
Chapter 2 describes powering up the DECSYSTEM-20 and obtaining the
DECSYSTEM-20 front-end monitor from floppy disk. This chapter also
describes loading the TOPS-20 bundled software from magnetic tape.
Chapter 3 describes how to select the proper monitor, declare the
system name, and change the system defaults for terminals, system
devices, accounting, performance improvements, scheduler controls, and
file archiving and migration.
Chapter 4 describes how to create the front-end file system for the
DECSYSTEM-20 and copy files into it from the floppy disk. Upon your
completion of this chapter, the installation is complete.
Chapter 5 describes how to boot the system from disk.
Chapter 6 describes how to install the TOPS-20 distribution and update
tapes.
Chapter 7 describes how to run the User Environment Test Package (UETP
program). This program performs a cursory check of the system.
Appendix A contains step-by-step instructions and pointers to various
| chapters within the manual, describing how to update a TOPS-20 Version
| 5.1 software system to a TOPS-20 Version 6.0 software system on the
DECSYSTEM-20.
Appendix B 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 manual that describe how to install the
TOPS-20 software on a DECSYSTEM-20.
Appendix C contains the steps for tailoring your system for the ARPA
network.
Appendix D contains the steps for generating a batch and spooling
(Galaxy) system tailored for your particular site.
1-1
INTRODUCTION
The TOPS-20 System Manager's Guide contains helpful hints on how to
manage a TOPS-20 timesharing system. A system manager should read
this manual before making timesharing generally available to users.
NOTE
Before starting the installation, read the listing
labeled TOPS20.BWR, which accompanies your software.
The TOPS20.BWR file describes changes in the software
made too late for inclusion in this manual.
1.2 PREPARING FOR INSTALLATION
A DIGITAL Field Service Representative will install your DECSYSTEM-20
hardware and inform you when the system runs diagnostics correctly.
Before he leaves, obtain the following information:
1. The channel, unit, and controller number of each disk drive,
and whether it is dual-ported. The controller number for
RP04, RP06, and RP07 is -1. The controller number for 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.
It is an error if two dual-ported drives with the same unit
number are connected to the front-end processor. The
procedures in this manual assume that the unit on which you
are installing the front-end software is Unit 0.
Disk Drives
Type Channel # Unit # Controller # Dual-Ported ?
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
---- -------- ----- ------------ -------------
1-2
INTRODUCTION
2. A list of line numbers and line speeds. Use these numbers in
Section 3.3.1 when you set the default terminal speeds.
Also, find out which lines are remote so that you can define
the remote lines as described in Section 3.3.2.
Lines
Auto Auto
Line # Speed Remote? Line # Speed Remote?
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
------ ----- ------- ------ ----- -------
NOTE
The word Auto over the word Speed declares
that the line is specified as an autobaud
line in Section 3.3.2.
1-3
INTRODUCTION
3. 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.
Magnetic Tapes
Serial # Type Serial # Type Serial # Type
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
-------- ---- -------- ---- -------- ----
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 as follows:
2003
In the above 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.
4. The unit number and type of each line printer. Use this
information in Section 3.3.5 to initialize the line printers.
Line Printers
Programmable
Unit # Model # Lowercase ? VFU ?
------ ------- ----------- -----
------ ------- ----------- -----
1-4
INTRODUCTION
1.3 INSTALLATION TOOLS
You need the following tools to install the TOPS-20 software on a
DECSYSTEM-20:
1. The RSX-20F System Floppy A. The files on this floppy are
used to boot the central processor from an RP04 or RP06 disk
pack.
2. The RSX-20F System Floppy B. The files on this floppy are
used for various functions in installing and maintaining the
software on a DECSYSTEM-20.
3. The RSX-20F System Floppy C. This floppy contains the
| RSX-20F map file, which should be used for new installations
| only. If you are updating your software from a previous
| version DO NOT USE Floppy C.
|
| 4. The TOPS-20 V6.0 Installation Tape and the TOPS-20
Distribution tape. 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 labeled TOPS-20 2060
| INSTL.MT V6.0 and the Distribution Tape labeled TOPS-20 2060
| DIST.MT V6.0.
| The TOPS-20 V6.0 Installation Tape for 2040S, 2060, and
ARPANET systems contains the TOPS-20 monitor and related
programs. The files on this tape are:
The TOPS-20 monitor (SAVE format)
The TOPS-20 command processor (SAVE format)
The DLUSER program (SAVE format)
DLUSER data (ASCII file)
The DUMPER program (SAVE format)
Four DUMPER savesets recorded at 1600 bpi in DUMPER
format for the following directories:
PS:<SYSTEM>
PS:<SUBSYS>
PS:<GALAXY-SUBSYS>
PS:<UETP.LIB>
The TOPS-20 Distribution Tape for all DECSYSTEM-20s contains
the TOPS-20 bundled software. There are four DUMPER save
sets recorded at 1600 bpi in DUMPER format. The contents of
the savesets are:
Saveset 1 contains documents about the software.
| Savesets 2 through 3 contain source files needed to
build the software in the directories <SYSTEM> and
<SUBSYS>, except for the monitor and the TOPS-20 command
processor.
5. If you are installing the TOPS-20 software on a
DECSYSTEM-2040S or DECSYSTEM-2060 that contains an RP20 Disk
Subsystem, you should receive a DX20 microcode tape
containing the microcode necessary to boot the DX20.
1-5
INTRODUCTION
6. A separate tape for each optional software product you have
purchased.
NOTE
The term "bundled software" refers to the
contents of the Installation and Distribution
tapes considered together, or to the contents
of the Distribution tape alone. The term
"unbundled software" refers to the contents
of the various tapes described in Chapter 6.
7. Formatted disk packs. If your disk packs are not formatted,
ask your DIGITAL Field Service Representative to format them
for you.
1.4 THE TOPS-20 MONITORS
| Six monitors are distributed with the TOPS-20 V6.0 software for the
DECSYSTEM-20 Models 2040S, 2060, and ARPANET systems. They are:
2060-MONBIG.EXE
2060-MONMAX.EXE
AN-MONMAX.EXE
AN-MONCFS.EXE
AN-MONBIG.EXE
AN-MONLGE.EXE
All the monitors mentioned above are described in Chapter 3. The
installation will proceed more smoothly if you take time now to decide
the monitor you want to use.
1.5 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 refer to Appendix D of
this manual for instructions on how to build your own specialized
batch and spooling system.
1-6
CHAPTER 2
CREATING THE TOPS-20 FILE SYSTEM
This chapter describes how to create a new TOPS-20 file system on the
DECSYSTEM-20.
STOP: These Procedures Install a New System
| Follow the procedures in this chapter if you are
| installing TOPS-20 Version 6.0 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 from
| TOPS-20 Version 5.1 to Version 6.0 software on an
existing system.
2.1 CHECKING THE TOPS-20 SOFTWARE PACKAGE
The TOPS-20 software package contains the following items. Check to
be sure that you have all of them.
1. RSX20F System Floppy A
2. RSX20F System Floppy B
3. RSX20F System Floppy C, which should be used for new
installations only. If you are updating your software from a
previous version, DO NOT USE Floppy C.
4. TOPS-20 Installation Tape V6.0
Throughout the rest of this text, this tape is referred to as
the Installation tape.
|
| 5. TOPS-20 Distribution Tape V6.0
6. The DX20 Microcode Tape (RP20 Customer only)
7. A separate tape for each optional software product purchased.
| Chapter 6 lists the optional software products. Refer to the
| installation guide that accompanies each optional software
| product for specific installation procedures.
Refer to Chapter 1, Section 1.3 for the contents of the floppy disks
and magnetic tapes.
2-1
CREATING THE TOPS-20 FILE SYSTEM
2.1.1 Preparing the DECSYSTEM-20 for Installation
Prepare the system for installation by powering it up and mounting the
disk packs.
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. You cannot use the RP20 for the system structure. The
packs must be formatted before you proceed further.
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, i.e., 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.
4. Turn on the console terminal. Be sure that it is on line and
has paper.
Step 4: Label the Disk Packs.
This manual 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 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.
2-2
CREATING THE TOPS-20 FILE SYSTEM
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: Mounting an RP04 or RP06 Disk Pack.
Mount the disk packs on the proper drives. RP04 and RP06 disk packs
are similar in appearance but can be distinguished by the name RP04 or
RP06 written on the upper surface of the pack. Make sure you place
one pack on the drive that is unit 0, dual ported, and connected to
the front-end. The installation procedure stores the files used by
the front-end on this pack. After the installation is complete, you
may dismount the disk packs so that the drives can be cleaned and
maintained. However, during system operation, the pack that contains
the front-end files must be on dual-ported drive 0 as it was during
installation.
Be careful when mounting a disk pack because the drive shaft can be
damaged if the pack is jammed off center into the drive. Follow these
instructions when mounting a pack:
NOTE
RP07 and RP20 disk packs are non-removable. To mount
an RA60 disk pack refer to the HSC-50 User's Guide.
1. If another RP04 or RP06 disk is already mounted on the drive
and spinning, press the START/STOP button and wait until the
drive stops.
2. Push the door back; slide the pack cover down over the pack.
3. 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.
4. Lift the pack out of the drive and place it on the protective
bottom cover. Be sure that the cover clicks closed.
5. 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.
2-3
CREATING THE TOPS-20 FILE SYSTEM
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.
6. 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.
7. Lift off the cover vertically.
8. Close the door to the drive.
9. 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.)
10. 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 drive can cause
these items to fall to the floor, causing expensive
and irreparable damage.
Step 6: Check the CONTROLLER SELECT Switches.
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.
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 drive.
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.
2-4
CREATING THE TOPS-20 FILE SYSTEM
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:.
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 the one you want to use.
NOTE
Be sure to mount the correct version of the
Installation tape. Refer to Chapter 1, Section 1.3
for the correct Installation tape for your system.
CAUTION
The logical 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.
2-5
CREATING THE TOPS-20 FILE SYSTEM
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 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
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.1.2 Loading and Starting the TOPS-20 Monitor
To create the TOPS-20 file system, you need to load the TOPS-20
monitor into the system and start the file system initialization
routine. Perform steps 10 through 19 to load and start the TOPS-20
monitor.
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.
2-6
CREATING THE TOPS-20 FILE SYSTEM
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
(Figure 2-1). 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 (Figure
2-1). Set them to 000007 (octal) by setting switches 2, 1, and 0 up,
and leaving the rest down. (Refer to Part 4, Chapter 1 of 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 VB15-20 6:11 5-MAR-84
[SY0: REDIRECTED TO DX0:]
[DX0: MOUNTED]
[DX1: MOUNTED]
| KLI -- VERSION VB15-12 RUNNING
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>
Item Identifies
RSX-20F The name of the front-end monitor.
| VB15-20 The version of the front-end monitor.
6:11 5-MAR-84 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 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.
2-7
CREATING THE TOPS-20 FILE SYSTEM
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.
Figure 2-1: DECSYSTEM-20 and Front-End Control Panels
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.
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.
| Step 14: Type YES KLX.MCB and Press the RETURN Key.
| To load the central processor microcode, type YES KLX.MCB 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 352 LOADED followed by KLI -- RECONFIGURE CACHE
[FILE,ALL,YES,NO]?
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
| KLI>YES KLX.MCB
| KLI -- MICROCODE VERSION 352 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>
2-9
CREATING THE TOPS-20 FILE SYSTEM
Step 16: Type ALL and Press the RETURN Key. -20 FILE SYSTEM
Step 18: Type MTBOOT and Press the RETURN Key.
After the prompt KLI>, type MTBOOT and press the RETURN key:
KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?
KLI>MTBOOT<RET>
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>
The system asks whether it should write the front-end file KL.CFG,
which describes your current configuration and the method you used to
bring up the system (disk, floppy disks, or magnetic tape). If this
file is written, the front end will attempt to use the same method and
the same configuration when you next install or reload the system.
The default answer to the question, WRITE CONFIGURATION FILE
[YES,NO]?, is YES. Therefore, it is recommended that you answer NO to
this question for the present. Later, when you have a front-end
configuration that should be recorded (Step 136, in Chapter 5), the
configuration 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 V10.0 (201)
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.
2-11
CREATING THE TOPS-20 FILE SYSTEM
Step 20: Type /L and Press the RETURN Key.
To load the TOPS-20 monitor from magnetic tape into memory, type /L
and press the RETURN key. The system rewinds the tape on drive 0,
loads the resident monitor, skips a line, and prints the MTBOOT>
prompt:
MTBOOT>/L<RET>
[BOOT: STARTING CHN:1 DX20X:0 MICROCODE V10(0)] [OK]
[BOOT: LOADING] [OK]
MTBOOT>
NOTE
The message concerning the DX20 microcode is printed
only if you are installing the TOPS-20 software on a
DECSYSTEM-20 with a DX20 tape or disk controller.
Error: If you have made a typing error and pressed the RETURN key,
the system prints the MTBOOT> prompt 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 the message:
?BAD FIL FMT, or
?BAD EXE DIR
Make sure that you have mounted the correct TOPS-20
Installation tape on drive 0 and that all other tape drives
are off line. Then 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 the MTBOOT> prompt, you
probably mistyped the name MTBOOT. The system prints the
message:
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-12
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, refer to Step 136 in Chapter 4
of this manual 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 the MTBOOT>
prompt, reissue the correct command.
If the system does not print the MTBOOT> prompt, 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.2 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
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>.
2-13
CREATING THE TOPS-20 FILE SYSTEM
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
Refer to the TOPS-20 System Manager's Guide for a
detailed explanation of all the above.
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 following
example 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.
2-14
CREATING THE TOPS-20 FILE SYSTEM
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:
ON WHICH "CHANNEL, CONTROLLER, UNIT" IS LOGICAL PACK # 0 MOUNTED: ?
[ENTER A TRIPLE OF NUMBERS SEPARATED BY A COMMA THAT SPECIFY THE
CHANNEL, CONTROLLER, AND UNIT UPON WHICH THE APPROPRIATE PACK IS
MOUNTED. THE FOLLOWING IS A LIST OF VALID CHANNEL, CONTROLLER,
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
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 No., Controller No., Unit No., 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.
ON WHICH "CHANNEL,CONTROLLER,UNIT" IS LOGICAL PACK # 0 MOUNTED:
1,-1,0<RET>
DO YOU WANT THE DEFAULT SWAPPING SPACE?
2-15
CREATING THE TOPS-20 FILE SYSTEM
Error: If your answer is invalid, the system prints one of several
messages and repeats the question. You can simply repeat
the current step.
Error: 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,
refer to 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.
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,
| Chapter 4.
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.
2-16
CREATING THE TOPS-20 FILE SYSTEM
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.
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 prnts:
? 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
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 may 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?
2-17
CREATING THE TOPS-20 FILE SYSTEM
Step 32: Type ? (Do Not Press the RETURN Key).
To find out how many pages are assigned as the default boot file
space, type a question mark. 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>
WHAT IS THE NAME OF THIS STRUCTURE?
Step 34: 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
following examples uses PS: as the structure name.
WHAT IS THE NAME OF THIS STRUCTURE? PS:<RET>
[STRUCTURE "PS" SUCCESSFULLY DEFINED]
Step 35: STOP.
The system now recognizes the structure you just defined and prints
[STRUCTURE "PS" SUCCESSFULLY DEFINED]
[PS MOUNTED]
%%NO SETSPD
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?
Type YES and press the RETURN key. Continue with the next step.
%%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 may be printed at any time before the
system requests the date and time.
2-18
CREATING THE TOPS-20 FILE SYSTEM
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.
2.3 STARTING THE MONITOR
Now that the file system is initialized, you can start the system by
performing the following steps.
Step 36: 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 following format:
day-month-year hhmm
Press the RETURN key. Type the time in AM/PM format or 24-hour
format. For example, 4:30 PM on the second day of March may be
entered as 2-MAR-81 4:30 PM:
ENTER CURRENT DATE AND TIME: 5-MAR-84 1630
The system responds by retyping the date and time.
YOU HAVE ENTERED SUNDAY, 5-MARCH-1984 4:30PM,
IS THIS CORRECT (Y,N)
Step 37: 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 SUNDAY, 5-MARCH-1984 4:30PM,
IS THIS CORRECT (Y,N) Y<RET>
WHY RELOAD?
Step 38: 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 <SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT
VALIDATION IS DISABLED and RUNNING DDMP.
WHY RELOAD? NEW<RET>
<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED
RUNNING DDMP
NO SYSJOB
2-19
CREATING THE TOPS-20 FILE SYSTEM
The system prints the message <SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND -
ACCOUNT VALIDATION IS DISABLED because the ACTGEN program has not been
run. (Refer to Chapter 6 of the TOPS-20 System Manager's Guide for
more information.) The system prints NO SYSJOB because the SYSJOB
program is not stored on disk. This program is not needed yet, so
ignore this message.
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 abbreviation.
Step 39: Type CTRL/C to Tell the System that You Want to Start a Job.
<SYSTEM>ACCOUNTS.TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED
RUNNING DDMP
NO SYSJOB
<CTRL/C>
!
NO EXEC
MX>
Step 40: Type G, Then MTA0: and 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.
The system prints NO EXEC because the file PS:<SYSTEM>EXEC.EXE
(containing the TOPS-20 command processor) does not exist. The
command processor is not needed at this point, so ignore this message.
To skip over the end of the monitor save file, 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, e.g., MTA1:, MTA2:.
| Error: If you get a ? (Question mark) after issuing the command,
you can ignore this message and continue with the next step.
2-20
CREATING THE TOPS-20 FILE SYSTEM
Step 41: Again Type G, Then MTA0:, and Press the RETURN Key.
To load the TOPS-20 command processor from magnetic tape into memory,
type G. The system prints ET FILE. Type 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 another 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.
If you make a typing mistake and press the RETURN key, the
system prints the MX> prompt. Try again.
Step 42: 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 6(1640)
@
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
the error recovery procedures listed below.
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>
Proceed to Step 43.
If you make a typing error and press the RETURN key, the
system prints the MX> prompt. 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.4 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.
2-21
CREATING THE TOPS-20 FILE SYSTEM
Step 43: Give the Command: ENABLE (CAPABILITIES).
To be able to load files into privileged areas and create user names
and directories, give the ENABLE command to obtain the required
capabilities. Type ENABLE and press the ESC key. The system prints
(CAPABILITIES). Press the RETURN key. The system prints a $ prompt
instead of @:
ESC
!
@ENABLE (CAPABILITIES)<RET>
$
Step 44: Give the Command: RUN (PROGRAM) MTA0:.
To run the DLUSER program from the magnetic tape, type RUN and press
the ESC key. The system prints (PROGRAM). Type MTA0: and press the
RETURN key. After you issue this command, the system prints the
prompt DLUSER>:
ESC
!
$RUN (PROGRAM) 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:
ESC
!
$REWIND (DEVICE) MTA0:<RET>
ESC
!
$SKIP (DEVICE) MTA0: 2 FILES<RET>
ESC
!
$RUN (PROGRAM) MTA0:<RET>
DLUSER>
Step 45: Give the DLUSER Command: LOAD (FROM FILE) MTA0:.
To load the directory structure from the tape into the file system,
type LOAD and press the ESC key. The system prints (FROM FILE). Type
MTA0: and press the RETURN key. After a few seconds, the system
prints DONE. and the DLUSER prompt:
ESC
!
DLUSER>LOAD (FROM FILE) MTA0:<RET>
DONE.
DLUSER>
Error: If you mistype the command and have not pressed the RETURN
key, delete the entire line by typing a CTRL/U, and reissue
the command.
If you mistyped the command and pressed the RETURN key,
follow the error recovery procedure in Step 44.
2-22
CREATING THE TOPS-20 FILE SYSTEM
If you get a group of JSYS error messages, you probably did
not give the ENABLE command in Step 43. Type two CTRL/Cs,
type ENABLE, give the commands in the following example, and
reissue the command in this step:
ESC
!
$REWIND (DEVICE) MTA0:<RET>
?DEVICE MTA0: OPEN ON JFN 3
%CLOSE JFN? YES<RET>
3 MTA0: [OK]
ESC
!
$SKIP (DEVICE) MTA0: 2 FILES<RET>
ESC
!
$RUN (PROGRAM) MTA0:<RET>
DLUSER>
Step 46: Type EXIT and Press the RETURN Key.
Type EXIT and press the RETURN key to end the DLUSER program. The
system prints $:
DLUSER>EXIT<RET>
$
2.5 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.
Step 47: Give the Command: RUN (PROGRAM) MTA0:.
The DUMPER program is on the tape mounted on drive 0. Type RUN and
press the ESC key. The system prints (PROGRAM). Since the tape is
already positioned at the DUMPER program, type MTA0: and press the
RETURN key. After the DUMPER program starts, the system prints the
DUMPER prompt:
ESC
!
$RUN (PROGRAM) MTA0:<RET>
DUMPER>
2-23
CREATING THE TOPS-20 FILE SYSTEM
Error: If you get errors, the magnetic tape was either not recorded
properly or not positioned properly. Rewind the tape, skip
five files, and try again. The following lines show how to
do this for MTA0:. If the errors persist, contact DIGITAL
Software Support.
ESC
!
$REWIND (DEVICE) MTA0:<RET>
ESC
!
$SKIP (DEVICE) MTA0: 4 FILES<RET>
ESC
!
$RUN (PROGRAM) MTA0:<RET>
DUMPER>
Step 48: Give the DUMPER Command: TAPE (DEVICE) MTA0:.
Tell DUMPER which tape drive to use by giving the DUMPER command TAPE.
Type TAPE and press the ESC key. The system prints (DEVICE). Type
MTA0: and press the RETURN key. The system prints the DUMPER prompt:
ESC
!
DUMPER>TAPE (DEVICE) MTA0:<RET>
DUMPER>
Error: If you make a typing error, reissue the command.
2.6 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.
(Refer to Chapter 7 of the TOPS-20 User Utilities Guide for an
explanation of any messages that DUMPER may print on your terminal.)
2-24
CREATING THE TOPS-20 FILE SYSTEM
NOTE
The following steps assume you are restoring the files
on the Installation tape to a structure called PS:.
If in Step 34 of this manual you gave a structure name
other than PS:, type the structure name you specified
in place of PS: in the following steps. For example:
ESC ESC
! !
RESTORE (FROM) PS:<*>*.*.* (TO) FOO: <SYSTEM><RET>
Notice the files are being restored to a structure
called FOO: and the directory <SYSTEM>.
| Step 49: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.
| (TO) PS:<SYSTEM>*.*.*.
|
| To copy the TOPS-20 monitor and its related programs from magnetic
| tape to disk, give the DUMPER RESTORE command. Type RESTORE and press
| the <ESC> key. The system prints (TAPE FILES). Type PS: and press
| the <ESC> key. The system prints <*>*.*.* (TO). Type PS:<SYSTEM> and
| press the <ESC> key. The system prints *.*.*. PRess the RETURN key.
|
| This DUMPER command restores all the files in the first saveset to the
| directory PS:<SYSTEM>. When all the files are restored, the system
| prints END OF SAVESET and the DUMPER prompt:
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SYSTEM>*.*.*<RET>
|
| Saveset "SYSTEM FILES FOR TOPS-20 V6.0"
| LOADING FILES(S) INTO PS:<SYSTEM>
|
| END OF SAVESET
| DUMPER>
|
| The system prints a header containing the date and time that the tape
| was written.
|
| 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(S) 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>
|
| 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>, give the following
| command, and reissue the RESTORE command in this step. Be
| sure to delete and expunge the files in the incorrect
| directory.
|
| <CTRL/E>
2-25
CREATING THE TOPS-20 FILE SYSTEM
| !
| INTERRUPTING...
| DUMPER>>ABORT<RET>
| Aborting RESTORE command...
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SYSTEM>:*.*.*<RET>
|
|
| Step 50: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<SUBSYS>*.*.*.
|
| Restore the system program files to the directory PS:<SUBSYS>. Type
| RESTORE and press the <ESC> key. The system prints (TAPE FILES).
| Type PS: and press the <ESC> key. The system prints <*>*.*.* (TO).
| Type PS:<SUB> and press the <ESC> key. The system prints SYS>*.*.*.
| Press the RETURN key. When all the files are restored, the system
| prints END OF SAVESET and the DUMPER prompt:
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES)PS:<*>*.*.* (TO) PS:<SUBSYS> *.*.*<RET>
|
| Saveset "SUBSYS FILES FOR TOPS-20 V6.0"
| LOADING FILE(S) INTO PS:<SUBSYS>
|
| END OF SAVESET
| 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 FILE(S) INTO PS:<SUBSYS>. To correct this error,
| type <CTRL/E>, give the following command, and begin again
| at Step 48.
|
| <CTRL/E>
| INTERRUPTING...
| DUMPER>>ABORT<RET>
| Aborting RESTORE command...
| DUMPER>
|
| Error: If you forget to type the directory PS:<SUBSYS>, the files
| are restored to the wrong directory. Type <CTRL/E>, give
| the following command to correct the error, and 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>
|
|
| Step 51: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<SUBSYS>*.*.*
|
| To restore the GALAXY files into the directory PS:<SUBSYS>, type
| RESTORE and press the <ESC> key. The system prints (TAPE FILES).
| Type PS: and press the <ESC> key. The system prints <*>*** (TO).
| Type PS:<SUB and press the <ESC> key. The system prints SYS>*.*.*.
| Press the RETURN key. When all the files are restored, the system
2-26
CREATING THE TOPS-20 FILE SYSTEM
| prints END OF SAVESET and the DUMPER prompt.
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SUBSYS>*.*.*<RET>
|
| Saveset "GALAXY SUBSYS FILES FOR TOPS-20 V6.0"
| LOADING FILES(S) INTO PS:<SUBSYS>
|
| END OF SAVESET
|
| Error: If you forget to type PS:<SUBSYS>, the system restores the
| files to the wrong directory. Type <CTRL/E> to stop DUMPER,
| give the commands listed below, and reissue the RESTORE
| command. Be sure to delete and expunge the files in the
| incorrect directory.
|
| <CTRL/E>
| INTERRUPTING...
| DUMPER>>ABORT<RET>
| Aborting RESTORE command...
| DUMPER>SKIP 0<RET>
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) <SUBSYS>*.*.*<RET>
|
| NOTE
|
| If you have an RP20 disk subsystem, perform Steps 53
| through 55. Otherwise, continue the installation
| procedures at Step 56.
|
|
|
| Step 52: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<UETP.LIB>*.*.*.
|
| To restore the files into the directory <UETP.LIB>, type RESTORE and
| press the <ESC> key. The system prints (TAPE FILES). Type PS: and
| press the <ESC> key. The system prints <*>*.*.* (TO). Type
| PS:<UETP.L and press the <ESC> key. The system prints IB>*.*.*.
| Press the RETURN key. When all the files are restored, the system
| prints END OF SAVESET and the DUMPER prompt:
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<UETP.LIB>*.*.*<RET>
|
| Saveset "UETP FILES FOR TOPS-20 V.6.0"
| LOADING FILE(S) INTO PS:<UETP.LIB>
|
| END OF SAVESET
| 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 FILE(S) INTO PS:<UETP.LIB>. To correct
| this error, type <CTRL/E>, give the following commands, and
| begin again at Step 48.
|
| <CTRL/E>
| INTERRUPTING...
2-27
CREATING THE TOPS-20 FILE SYSTEM
| DUMPER>>ABORT<RET>
| Aborting RESTORE command...
| DUMPER>
|
|
| Step 53: Give the DUMPER Command: DUMPER>UNLOAD
|
| To remove the TOPS-20 Installation tape from the tape drive, type
| UNLOAD and press the RETURN key. The system rewinds the tape onto the
| source reel.
|
| DUMPER>UNLOAD<RET>
| DUMPER>
|
|
| Step 54: Remove the TOPS-20 Installation Tape and Physically Mount
| the RP20 Microcode Tape on the Tape Drive.
|
|
| Step 55: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<SUBSYS>*.*.* <RET>
|
| To copy the RP20 Microcode from magnetic tape to disk, give the DUMPER
| RESTORE command. Type RESTORE and press the <ESC> key. The system
| prints (TAPE FILES). Type PS: and press the <ESC> key. The system
| prints <*>*.*.* (TO). Type PS:<SUB and press the <ESC> key. The
| system prints SYS>*.*.*. Press the RETURN key.
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SUBSYS>*.*.* <RET>
|
| Saveset "RP20 DX20 MICROCODE FOR TOPS-20 V5.1",
| LOADING FILES(S) INTO PS:<SUBSYS>
|
| END OF SAVESET
| DUMPER>
|
| Error: If you do not type the correct structure and directory name,
| PS:<SUBSYS>, the files are restored to the wrong directory.
| To correct this error, type <CTRL/E>, ABORT and reissue the
| RESTORE command in Step 55. Be sure to delete and expunge
| the files in the incorrect directory.
|
| <CTRL/E>
|
| INTERRUPTING...
| DUMPER>ABORT<RET>
| Aborting RESTORE command..
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SUBSYS>*.*.*<RET>
|
|
| Step 56: Type EXIT and Press the RETURN Key.
|
| Type EXIT and press the RETURN key to end DUMPER. The system prints
| the TOPS-20 enabled prompt:
|
| DUMPER>EXIT<RET>
| $
2-28
CREATING THE TOPS-20 FILE SYSTEM
| Step 57: Give the Command: UNLOAD (DEVICE) MTA0:.
|
| To remove the TOPS-20 Installation Tape or RP20 Microcode Tape from
| the tape drive, type UNLOAD and press the <ESC> key. The system
| prints (DEVICE). Type MTA0: and press the RETURN key. The system
| rewinds the tape onto the source reel.
|
| <ESC>
| !
| $UNLOAD (DEVICE) MTA0:<RET>
| $
|
| You can now remove the TOPS-20 Installation Tape from the tape drive.
2-29
CREATING THE TOPS-20 FILE SYSTEM
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 58: Give the Command: INFORMATION (ABOUT) DISK-USAGE (OF
DIRECTORY) PS:<*> and Press the RETURN Key.
If you give the command INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY)
PS:<*>, the system will print the size of every directory on the
public structure, PS:. The example below was obtained using a
DECSYSTEM-20, model 2060. You will notice that there are two
directories called <NEW-SYSTEM> and <NEW-SUBSYS>. These directories
should have no files associated with them. They were created by the
monitor and will be used in the event you update your system to a
newer release of the TOPS-20 operating system.
ESC ESC
! !
$INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY) PS:<*><RET>
PS:<ROOT-DIRECTORY>
| 872 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<ACCOUNTS>
14 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>
2319 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<SYSTEM>
5493 Pages assigned
+INF Working pages, +INF Permanent pages allowed
PS:<SYSTEM-ERROR>
1 Pages assigned
+INF Working pages, +INF Permanent pages allowed
2-30
CREATING THE TOPS-20 FILE SYSTEM
PS:<UETP>
0 Pages assigned
100000 Working pages, 100000 Permanent pages allowed
PS:<UETP.LIB>
1740 Pages assigned
4000 Working pages, 4000 Permanent pages allowed
PS:<UETP.RUN>
0 Pages assigned
500 Working pages, 500 Permanent pages allowed
Total of 9675 Pages assigned, in 12 directories.
57943 Pages free on PS:, 18057 pages used.
Error: If the "Pages assigned" for each directory shown do not
approximately match the value shown in this manual or the
value derived from the directory listing shipped with your
Installation tape, some files may not have been copied
correctly. Mount the tape again on MTA0:, skip four files
and begin again at Step 47.
Step 59: Give the Command: RUN (PROGRAM) PS:<SUBSYS>MAKDMP.EXE and
Press the RETURN Key.
To create the DUMP.EXE file, which records any system failures, type
RUN and press the ESCAPE key. The system prints (PROGRAM). Type
PS:<SUBSYS>MAKDMP.EXE and press the RETURN key. The system prints the
prompt MAKDMP>.
ESC
!
$RUN (PROGRAM) 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 60: Give the MAKDMP Command: CREATE (DUMP FILE)
PS:<SYSTEM>DUMP.EXE (FOR MEMORY SIZE) Memory Size and Press
the RETURN Key.
To overwrite the existing DUMP.EXE file with a new DUMP.EXE file, type
CREATE and press the ESCAPE key. The system prints (DUMP FILE). Type
PS:<SYSTEM>DUMP.EXE and press the ESCAPE key. The system prints (FOR
MEMORY SIZE). Type the total amount of memory your system has and
press the RETURN key. In the following example 2048K words was the
memory size.
ESC ESC
! !
| MAKDMP>CREATE (DUMP FILE)PS:<SYSTEM>DUMP.EXE (FOR MEMORY SIZE) 2048<RET>
2-31
CREATING THE TOPS-20 FILE SYSTEM
Step 61: Give the MAKDMP Command: EXIT and Press the RETURN Key.
To exit the MAKDMP program and return to TOPS-20 command level, type
EXIT and press the RETURN key.
MAKDMP>EXIT<RET>
$
NOTE
If in the future you add some additional memory to
your system, you should reconfigure the DUMP.EXE file
to allow it to accommodate the additional memory.
2-32
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. You
must:
1. Select a monitor that is correct for your system.
2. Change the system name.
3. Set terminal speeds; define remote lines, system logical
names, magnetic tape drive parameters, line printer
parameters, time zone, file archiving and migration recycle
periods, and accounting shift parameters; and enable or
disable directory parameter setting, account validation,
class scheduling, working set swapping, latency optimization,
and tape drive allocation. All these parameters are located
| in the system parameter file PS:<SYSTEM>6-CONFIG.CMD.
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
20 user jobs, the monitor you select should support at least
22 jobs.
3-1
TAILORING THE SYSTEM
4. The number of pseudo-terminals that you need. The system
needs at least two pseudo-terminals, one to run the PTYCON
program, which in turn usually runs 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.
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. Refer to Table 3-1 for the maximum structure size.
2060-MONBIG.EXE A large timesharing monitor. This monitor
supports up to:
100 jobs
128 lines
30 pseudo-terminals
| 3MEG of memory
8 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six RP04,
three RP06, three RP20 spindles, or one
RP07) per structure
10000 pages for swapping space
2060-MONMAX.EXE The largest timesharing monitor. This monitor
supports up to:
128 jobs
128 lines
50 pseudo-terminals
| 3MEG of memory
16 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six RP04
three RP06, three RP20 spindles, or one
RP07) per structure
15000 pages for swapping space
AN-MONBIG.EXE A large ARPANET timesharing monitor. This monitor
supports up to:
100 jobs
128 lines
30 pseudo-terminals
40 NVT's
| 3MEG of memory
8 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six RP04,
three RP06, three RP20 spindles, or one
RP07) per structure
10000 pages for swapping space
3-2
TAILORING THE SYSTEM
AN-MONCFS.EXE A large ARPANET timesharing monitor. This monitor
supports up to:
80 jobs
128 lines
50 pseudo-terminals
40 NVTS
3M6 of memory
8 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six
RP04,three RP06, three RP20 spindles, on
RP07,).
15000 pages for swapping space
AN-MONMAX.EXE The largest ARPANET timesharing monitor. This
monitor supports up to:
128 jobs
128 lines
50 pseudo-terminals
40 NVT's
3M6 of memory
8 magnetic tape drives
2 line printers
1 card reader
120 million words of disk storage (six RP04,
three RP06, three RP20 spindles, or one
RP07) per structure
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 3 201,420
* a page = 512 x 36 bit words
3-3
TAILORING THE SYSTEM
Step 62: Give the Command: CONNECT (TO DIRECTORY) PS:<SYSTEM>.
Connect to the PS:<SYSTEM> directory by typing CONNECT and pressing
the ESC key. The system prints (TO DIRECTORY). Type PS:<SYSTEM> and
press the RETURN key:
ESC
!
$CONNECT (TO DIRECTORY) PS:<SYSTEM><RET>
$
Step 63: Give the Command: COPY (FROM) montyp.EXE (TO) MONITR.EXE.
Copy the monitor that you have selected to the file MONITR.EXE. Type
COPY and press the ESC key. The system prints (FROM). Type the name
of the monitor that you have selected and press the ESC key. The
system prints the generation number and (TO). Type MONITR.EXE and
press the RETURN key.
ESC ESC
! !
$COPY (FROM) montyp.EXE.1 (TO) MONITR.EXE<RET>
montyp.EXE.1 => MONITR.EXE.1 [OK]
The different monitors are:
TOPS-20 TOPS-20
2060/2040S ARPANET
2060-MONBIG.EXE AN-MONBIG.EXE
2060-MONMAX.EXE AN-MONMAX.EXE
AN-MONCFS.EXE
E
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 (ABOUT) VERSION command, the system prints a message
similar to:
| TOPS-20 SMALL SYSTEM, TOPS-20 MONITOR 6.(5050)
You can change the system name "TOPS-20 SMALL SYSTEM" by entering the
name you want into the file PS:<SYSTEM>MONNAM.TXT. If the name
contains lowercase letters, give the command TERMINAL (MODE IS) 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. The following two steps
show how to change the system name to "Installation-test System."
3-4
TAILORING THE SYSTEM
Step 64: Give the Command: TERMINAL (MODE IS) NO RAISE.
If you want lowercase letters in the system name, type TERMINAL and
press the ESC key. The system prints (MODE IS). Type NO RAISE and
press the RETURN key. Make sure the CAPS LOCKED button on the
terminal is not depressed. The system prints $.
ESC
!
| $TERMINAL (FEATURE OR TYPE) NO RAISE<RET>
$
Step 65: Give the Command: COPY (FROM) TTY: (TO) MONNAM.TXT<RET>
type-system-name-here ^Z.
Type COPY and press the ESC key. The system prints (FROM). Type TTY:
and press the ESC key. The system prints (TO). Type MONNAM.TXT and
press the RETURN key. The system is now waiting for you to type the
new name of your system. After you enter the new system name, press
the RETURN key; then type a CTRL/Z. The system prints ^Z, followed by
the $ prompt. In the example below, we use Installation-test System
as the new system name.
ESC ESC
! !
$COPY (FROM) TTY: (TO) MONNAM.TXT<RET>
TTY: => MONNAM.TXT.1
Installation-test System <RET>
CTRL/Z
!
^Z
$
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 66: Give the Command: COPY (FROM) TTY: (TO) TAPNAM.TXT<RET>
type-short-system-name-here ^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 following step shows how to change the system
name appearing on tape labels written by the system to "Instal-tst".
ESC ESC
! !
$COPY (FROM) TTY: (TO) TAPNAM.TXT<RET>
TTY:=> TAPNAM.TXT.1
Instal-tst<RET>
CTRL/Z
!
^Z
$
3-5
TAILORING THE SYSTEM
| 3.3 CREATING SYSTEM DEFAULTS IN 6-CONFIG.CMD
|
| You must create the file PS:<SYSTEM>6-CONFIG.CMD to define system
| parameters for:
o Terminal line speeds
o Logical names
o Magnetic tape drives
o Line printers
o Local time zone
o Directory parameter setting
o Account validation
o Performance improvements
o Scheduler controls
o File archiving and migration
o Tape drive allocation
o Accounting shift changes
The next time the system starts, the SETSPD (SET System Parameter
Defaults) program uses the parameters 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.13. You may include comment lines if they are preceded by
exclamation points.
Step 67: Give the Command: CREATE (FILE) 6-CONFIG.CMD.
| Use EDIT to create the 6-CONFIG.CMD file. (Refer to the TOPS-20 EDIT
| Reference Manual for more information on how to use EDIT.) To create
| the file 6-CONFIG.CMD, type CREATE and press the ESC key. The system
| prints (FILE). Type 6-CONFIG.CMD and press the RETURN key. The
| system prints Input: 6-CONFIG.CMD.1 and line number 00100:
ESC
!
| $CREATE (FILE) 6-CONFIG.CMD<RET>
Input: 6-CONFIG.CMD.1
00100
Do not confuse the CREATE command, which creates a file, with the
CTRL/E CREATE command, which creates a directory.
3.3.1 Setting Terminal Speeds
Whenever the system starts, the SETSPD program reads the TERMINAL
| commands from PS:<SYSTEM>6-CONFIG.CMD and sets the terminal lines to
the specified speeds.
3-6
TAILORING THE SYSTEM
Users can change the speeds of their terminals by giving the TERMINAL
(MODE IS) 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 6-CONFIG.CMD.
However, if the line is defined as REMOTE, the speed is changed back
after the line is disconnected.
The operator can change the speed of the line by giving the CTRL/E SET
command.
To set the default speed for a particular line, enter a command in the
| following format into 6-CONFIG.CMD:
TERMINAL line SPEED input output
Item Identifies
line 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. (Refer to Section 1.2.)
input The input (to the system) speed of the terminal(s).
output The output speed of the terminal(s). If you do not
specify an output speed along with an input speed, 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 controller (the DH11) that are not
installed, you should define those lines with a speed
of 0. Otherwise, the lines run open, causing
degradation in system performance.
3-7
TAILORING THE SYSTEM
Line numbers are always octal, and the console terminal line number is
always one greater than the highest line number. Refer to Table 3-2,
below, for line numbers for the DECSYSTEM-20.
Table 3-2: Terminal Line Numbers DECSYSTEM-20
Number of Lines Timesharing Line Console Line
(Decimal) Numbers (Octal) Number (Octal)
8 1 to 10 11
16 1 to 20 21
32 1 to 40 41
64 1 to 100 101
96 1 to 140 141
Step 68: Type the TERMINAL SPEED Commands.
Type your required TERMINAL SPEED commands. You can include comment
lines by preceding each of them with an exclamation point. The file
entered below is an example. Determine the most useful definitions
for the system according to the terminals that you have.
00100 ! Terminal Speeds<RET>
00200 ! Line 1 has input=9600 and output=9600<RET>
00300 TERMINAL 1 SPEED 9600<RET>
00400 ! Lines 2 to 20 have input and output=2400<RET>
00500 TERMINAL 2-20 SPEED 2400<RET>
00600 ! Lines 23 to 40 do not exist<RET>
00700 TERMINAL 23-40 SPEED 0<RET>
00800
3.3.2 Defining Dial-Up (Remote) Lines
For each dial-up line, you have the option of declaring that line to
have a specified speed or you may declare a line to be autobaud. If a
dial-up line is declared an autobaud line, at system startup the line
can be automatically set to 9600 baud.
To declare a line autobaud, replace the word SPEED with the word AUTO
in the TERMINAL command and do not specify any input and output
speeds.
3-8
TAILORING THE SYSTEM
Include a TERMINAL command for each dial-up line. Use the same form
as described above, but insert the word REMOTE after the line number.
If you do not use the AUTO argument and omit the output speed, the
system assumes that the output speed is the same as the input speed.
The command format is:
TERMINAL line REMOTE SPEED input output
or
TERMINAL line REMOTE AUTO
Whenever a user starts a job on a dial-up line, and AUTO has not been
specified, the system sets the speed of that line to the speed
| specified in 6-CONFIG.CMD.
Step 69: Define REMOTE Lines.
If you have remote lines, obtain the line numbers from your DIGITAL
Field Service Representative and enter the proper commands in
| 6-CONFIG.CMD. The lines entered below are only an example. You must
determine the correct commands for your own system.
00800 ! Lines 21 and 22 are dialup lines<RET>
00900 TERMINAL 21 REMOTE SPEED 9600<RET>
01000 TERMINAL 22 REMOTE AUTO<RET>
3.3.3 Defining System Logical Names
Insert a command in the following format to define any special system
logical names that you require. These logical names are defined when
the system starts. The command format is:
DEFINE name definition-list
The logical name SYS: defaults to PS:<SUBSYS> if you do not define it
| in 6-CONFIG.CMD. The TOPS-20 System Manager's Guide describes logical
| names.
Step 70: Type System Logical Name Definitions.
| Enter any system logical name definitions into 6-CONFIG.CMD. The
lines entered below are examples. You must determine the correct
definitions for your own system.
01100 DEFINE NEW: PS:<NEW>,SYS:<RET>
01200 DEFINE OLD: PS:<OLD>,SYS:<RET>
01300 DEFINE HLP: SYS:<RET>
01400 DEFINE SERR: PS:<SYSTEM-ERROR><RET>
01500 DEFINE DMP: PS:<directory>
| 01600 DEFINE POBOX: PS:<directory>
3.3.3.1 Selecting an Editor - You have the option of selecting the
default editing program (editor) with which your users create and edit
files using the CREATE and EDIT commands. If you want them to use TV,
| enter the command, DEFINE EDITOR: SYS:TV.EXE into the 6-CONFIG.CMD
| file. If you do not put this command into the 6-CONFIG.CMD file, the
default editor used for the CREATE and EDIT commands will be the EDIT
program.
3-9
TAILORING THE SYSTEM
By defining logical name EDITOR: for their own jobs, users can
override your choice of default editor, as long as the editor they
specify is available at your installation. The following step is an
example of making TV the default editor for your installation.
Step 71: Type DEFINE EDITOR: SYS:TV.EXE and Press the RETURN Key.
If you are using the TV editor as your system's default editor, type
DEFINE EDITOR: SYS:TV.EXE and press the RETURN key.
| 01700 DEFINE EDITOR: SYS:TV.EXE<RET>
| 01800
NOTE
If you want your system's default editor to be the
EDIT program, do not put any DEFINE EDITOR: command
| into the 6-CONFIG.CMD file.
3.3.4 Defining Magnetic Tape Logical Unit Numbers
The system assigns logical unit numbers to magnetic tape drives. It
starts with the lowest numbered unit on the lowest numbered controller
on the lowest numbered channel, and proceeds upward. If the cabling
connecting the tape drives to the system changes, the logical unit
numbers referencing the tape drives can also change, unless you enter
| the appropriate commands in 6-CONFIG.CMD. The commands in
| 6-CONFIG.CMD guarantee that the physical drives always have the same
logical unit numbers.
Request the tape drive serial numbers from your DIGITAL Field Service
Representative, or open the back door of the magnetic tape drives and
look on the sticker containing the number. Use the last four digits
of the number. Enter a MAGTAPE command in the following format into
| the 6-CONFIG.CMD file:
MAGTAPE unit serial slave
Item Identifies
unit The logical unit number that you wish to assign to the
drive. The unit number can be 0, 1, 2, 3, 4, 5, 6, or
7.
serial The last four digits of the serial number.
(Leading 0s may be omitted.)
| slave The type of tape drive, e.g., TU72, TU45, TU77, TU78.
NOTE
If no slave number is entered, the system assumes that
the slave number is TU45.
3-10
TAILORING THE SYSTEM
Step 72: Define Magnetic Tape Drive Logical Unit Numbers.
Enter the definitions of the magnetic tape drive logical unit numbers
| into 6-CONFIG.CMD. The commands entered below are only examples. You
must determine the correct definitions for your system.
| 01900 MAGTAPE 0 24 TU45<RET>
| 02000 MAGTAPE 1 2001 TU77<RET>
| 02100 MAGTAPE 2 2002 TU71<RET>
| 02200 MAGTAPE 3 2003 TU70<RET>
| 02300 MAGTAPE 4 1500 TU72<RET>
| 02400
3.3.5 Defining Line Printer Parameters
The characteristics of the six possible line printers that can be
ordered with your DECSYSTEM-20 are listed in Table 3-3, below. Ask
your DIGITAL Field Service Representative which type of line printer
you have.
Table 3-3: DECSYSTEM-20 Line Printers
Model VFU Lowercase Identification
LP20A PROGRAMMABLE NO Four buttons on the
LP20B PROGRAMMABLE YES right top panel, with the
top button being POWER ON
ALARM/CLEAR
LP20C PROGRAMMABLE NO Four buttons on the
LP20D PROGRAMMABLE YES right top panel, with the
top button being POWER ON
ALARM/CLEAR
LP20F TAPE NO Four rocker switches on
LP20H TAPE YES the left of the top panel
Sections 3.3.5.1 and 3.3.5.2 describe how to install the line printer.
3-11
TAILORING THE SYSTEM
3.3.5.1 Specifying the VFU File - The VFU (vertical formatting unit)
is used to control paper advance through the line printer. For a line
| printer with a programmable VFU, place a command in 6-CONFIG.CMD that
specifies the file to program the VFU. For installation purposes, use
SYS:NORMAL.VFU. The command format is:
PRINTER n LOWERCASE VFU dev:<dir>name.typ
Item Identifies
n The unit number of the printer.
LOWERCASE The printer has the 96-character set.
If your printer has the 64-character
set, do not include the word LOWERCASE
in the command.
VFU The type of file specified by the
command.
dev:<dir>name.typ The location of the VFU file.
You do not need VFU commands for LP20F and LP20H line printers.
| Examples of typical VFU commands in the 6-CONFIG.CMD file are:
For an LP20A and LP20C
PRINTER 0 VFU SYS:NORMAL.VFU
For an LP20B and LP20D
PRINTER 0 LOWERCASE VFU SYS:NORMAL.VFU
Step 73: Type the VFU Command.
If you have one or more line printers with programmable VFUs, enter
| the appropriate PRINTER commands in 6-CONFIG.CMD:
| 02500 PRINTER 0 LOWERCASE VFU SYS:NORMAL.VFU<RET>
| 02600 PRINTER 1 VFU SYS:NORMAL.VFU<RET>
| 02700
3.3.5.2 Specifying the RAM File - You must identify a file that will
load the translation RAM (random-access memory). This RAM controls
the way in which each character is treated by the line printer. Use
SYS:LP96.RAM for line printers that have lowercase letters. Use
SYS:LP64.RAM for printers that do not have lowercase letters. The
command format is:
PRINTER n LOWERCASE RAM dev:<dir>name.typ
3-12
TAILORING THE SYSTEM
Item Identifies
n The line printer unit number.
LOWERCASE The printer has the 96-character set.
If your printer has the 64-character
set, do not include the word LOWERCASE
in the command.
RAM The type of file specified by the
command.
dev:<dir>name.typ The file that contains the translation
RAM.
| Examples of typical RAM commands in the 6-CONFIG.CMD file are:
For an LP20A, LP20F or LP20C
PRINTER 0 RAM SYS:LP64.RAM
For an LP20B, LP20H or LP20D
PRINTER 0 LOWERCASE RAM SYS:LP96.RAM
Step 74: Type the RAM Command.
| Enter the RAM command into 6-CONFIG.CMD:
| 02800 PRINTER 0 LOWERCASE RAM SYS:LP96.RAM<RET>
| 02900 PRINTER 1 RAM SYS:LP64.RAM<RET>
| 03000
3.3.6 Defining the Local Time Zone
The time zone in which your installation is located can be represented
as the number of hours west or east of Greenwich. For example,
Eastern Standard Time is zone 5; Central Standard Time is zone 6;
Mountain Standard Time is zone 7; and Pacific Standard Time is zone 8.
| To set your local time zone, you can enter the following command in
| 6-CONFIG.CMD:
TIMEZONE n
where n is a decimal number between -12 and 12 inclusive. Zones -12
and 12 represent the same clock time but on opposite sides of the
international date line. If you do not specify a time zone in
| 5-1-CONFIG.CMD, the time zone will default to zone 0, signifying
Greenwich mean time.
Step 75: Type the TIMEZONE Command.
| Enter the TIMEZONE command into 6-CONFIG.CMD:
| 03100 TIMEZONE 5<RET>
| 03200
3-13
TAILORING THE SYSTEM
3.3.7 Directory Parameter Setting
You have the option of allowing users to change their directory
parameters. If you decide to allow users to do this, no command is
| entered into the 6-CONFIG.CMD file, because the system default is:
ENABLE DIRECTORY-PARAMETER-SETTING. However, if you decide not to
allow users to change their directory parameters, you should enter the
| command: DISABLE DIRECTORY-PARAMETER-SETTING into the 6-CONFIG.CMD
file. When this command is given, it prevents the user from changing
any of his directory parameters unless he has WHEEL or OPERATOR
capabilities. The following step is an example of disallowing users
from changing their directory parameters.
Step 76: Type DISABLE DIRECTORY-PARAMETER-SETTING and Press the
RETURN key.
To prevent users from changing their directory parameters, type
DISABLE DIRECTORY-PARAMETER-SETTING and press the RETURN key.
| 03300 DISABLE DIRECTORY-PARAMETER-SETTING<RET>
| 03400
NOTE
If the default is taken, users are allowed to change
some of their directory parameters with the SET
DIRECTORY commands.
3.3.8 Account Validation
You have the option of requiring all users to enter a valid account
name when they are logging in to the system. If you decide to require
valid accounts, you do not have to enter any command into the
| 6-CONFIG.CMD file, because the system default is: ENABLE
ACCOUNT-VALIDATION. However, if you decide not to validate accounts,
you must enter the command DISABLE ACCOUNT-VALIDATION into the
| 6-CONFIG.CMD file. The following step is an example of not using the
account validation facility.
Step 77: Type DISABLE ACCOUNT-VALIDATION and Press the RETURN Key.
If you are not validating accounts, type DISABLE ACCOUNT-VALIDATION
and press the RETURN key.
| 03500 DISABLE ACCOUNT-VALIDATION<RET>
| 03600
3.3.9 Performance Improvements
Sections 3.3.9.1 and 3.3.9.2 discuss full latency optimization and
working set swapping, respectively.
3-14
TAILORING THE SYSTEM
| 3.3.9.1 Full Latency Optimization - When the command, ENABLE
| FULL-LATENCY-OPTIMIZATION is entered into the 6-CONFIG.CMD file, the
number of revolutions needed to read pages off the disk is minimized.
NOTE
Before you can use this performance feature, you must
obtain from your DIGITAL Field Service Representative
the following information about your hardware.
1. If you have a KL10-E processor, it must be at
revision level 3.
2. If you have board M7772, it must be at version
level E and CS revision level F; or you may have
board M7786.
If your hardware does not meet the above requirements,
take the system default, which is DISABLE
FULL-LATENCY- OPTIMIZATION.
Step 78: Type ENABLE FULL-LATENCY-OPTIMIZATION and Press the RETURN
Key.
If your hardware meets the above requirements, type ENABLE
FULL-LATENCY-OPTIMIZATION and press the RETURN key.
| 03700 ENABLE FULL-LATENCY-OPTIMIZATION<RET>
| 03800
3.3.9.2 Working Set Swapping - If the command, ENABLE
| WORKING-SET-PRELOADING, is entered in the 6-CONFIG.CMD fle, the entire
| working set of a process is brought into memory at once when it is the
process's turn to run. Otherwise, this action occurs on a
page-by-page basis.
NOTE
You should enable working set swapping only if your
system runs large compute-bound jobs. However, if
your system runs many interactive jobs or if you are
unsure which description better fits your system, take
the system default, which is:
DISABLE WORKING-SET-PRELOADING
Step 79: Type ENABLE WORKING-SET-PRELOADING and Press the RETURN Key.
| 03900 ENABLE WORKING-SET-PRELOADING<RET>
| 04000
3-15
TAILORING THE SYSTEM
3.3.10 Scheduler Controls
Sections 3.3.10.1 and 3.3.10.2 describe bias controls and class
scheduling, respectively.
3.3.10.1 Bias Controls - You have the option of deciding how your
system's CPU time is to be divided between interactive and batch jobs.
| You do this by entering the command, BIAS n, into the 6-CONFIG.CMD
file, where n is any integer between 1 and 20. The smaller the value
of n, the larger the percentage of CPU time that is given to
interactive jobs. If you do not give this command, a default value of
11 will be taken, calling for equal division of time between
interactive and batch jobs.
Step 80: Type the BIAS n Command.
The example below shows how to enter a BIAS n command with a value of
6, which favors interactive jobs. You must determine the correct
value of n for your own system.
| 04100 BIAS 6<RET>
| 04200
3.3.10.2 Class Scheduling - You can use class scheduling to divide
your system's CPU time among different classes of jobs. Class
scheduling assigns percentages of CPU time to jobs according to their
account number or according to a policy program written especially for
your site.
NOTE
If you do not want to use class scheduling, you do not
| have to enter any command into the 6-CONFIG.CMD file,
because the system default is: DISABLE
CLASS-SCHEDULING.
If you use either kind of class scheduling you can allocate any unused
CPU time (windfall) among active jobs, or withhold it from all jobs.
The command for enabling class scheduling using a policy program and
allocating windfall is: ENABLE CLASS-SCHEDULING POLICY-PROGRAM
ALLOCATED. The command for enabling class scheduling using a policy
program and withholding windfall is: ENABLE CLASS-SCHEDULING
POLICY-PROGRAM WITHHELD. If you enable class scheduling using a
policy program, you cannot also enable class scheduling using
accounts, and should skip to Section 3.3.11 after giving one of these
two commands.
If you do not have a policy program to use with class scheduling at
your site, you can still enable class scheduling by assigning jobs to
classes according to the account under which each job is running.
(Refer to Chapter 6 of the TOPS-20 System Manager's Guide for
information about associating accounts with particular classes.) To
| do this you must first enter commands into the 6-CONFIG.CMD file,
specifying the percentage of CPU time that is to be given to jobs in
each class.
3-16
TAILORING THE SYSTEM
The command, CREATE 1 .20, specifies that jobs running under accounts
in class 1 are to be given a total of 20% of your system's CPU time.
You must enter a CREATE command for each class that your system will
use, with a different percentage for each class. The sum of the
percentages you specify must not add up to more than 100%, although
they may add up to less than 100%. If they add up to less than 100%,
the percentage of CPU time that is not assigned becomes part of the
system's windfall. The following commands are an example of dividing
up 75% of the system's CPU time among three classes of jobs. You must
supply the correct class numbers and percentages for your own system.
Step 81: Enter CREATE Commands for Scheduler Classes.
| Enter CREATE commands for your system's classes into 6-CONFIG.CMD.
| 04300 CREATE 1 .20<RET>
| 04400 CREATE 2 .40<RET>
| 04500 CREATE 3 .15<RET>
| 04600
Batch jobs can be put into a special class of their own by including
the BATCH-CLASS n command, where n is the number of the class you
choose for batch jobs. If you do not enter a BATCH-CLASS command,
batch jobs are given CPU time according to the class associated with
the account of the job's owner at the time of submission. The
following commands are an example of creating a class for batch jobs
and assigning 25% of CPU time to this class.
Step 82: Enter the BATCH-CLASS n Command and Assign a Percentage to
This Class.
| 04700 BATCH-CLASS 4<RET>
| 04800 CREATE 4 .25<RET>
| 04900
Now you must enter the command that enables class scheduling using
accounts. You must also decide whether to allocate any windfall CPU
time to the jobs that are running or to withhold this windfall. The
default for this command is ALLOCATED. It is recommended that you
take this default.
Step 83: Type ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED and Press
the RETURN Key.
Now you actually enable class scheduling by giving the following
command.
| 05000 ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED<RET>
| 05100
CAUTION
| Do not enter the above command into the 6-CONFIG.CMD
| file until you have entered the commands shown in this
section that create scheduler classes. If you enable
class scheduling before creating classes, class
scheduling will not function properly.
3-17
TAILORING THE SYSTEM
3.3.11 File Archiving and Migration Parameters
Sections 3.3.11.1 and 3.3.11.2 describe tape recycle periods for use
with the file archiving and migration features.
3.3.11.1 Archive Tape Recycle Period - TOPS-20 provides a feature
that allows off-line storage of selected files on magnetic tape for
long periods of time. You can specify for how long these files are
| saved by inserting a command into the 6-CONFIG.CMD file stating, in
days, the recycle period of the tapes. For example, to save archival
files on tape for five years, you would enter the command,
ARCHIVE-TAPE-RECYCLE-PERIOD 1825 (because 5 years x 365 days/year =
1825 days). If you do not insert an ARCHIVE-TAPE-RECYCLE-PERIOD
| command in the 6-CONFIG.CMD file, a default value of 3650 (ten years)
will be taken.
Step 84: Type the ARCHIVE-TAPE-RECYCLE-PERIOD n Command.
The example below shows how to enter an ARCHIVE-TAPE-RECYCLE-PERIOD n
command with a value of 1825 (five years). You must determine a
suitable value of n for your own system.
| 05200 ARCHIVE-TAPE-RECYCLE-PERIOD 1825<RET>
| 05300
3.3.11.2 Migration Tape Recycle Period - TOPS-20 provides a feature
that allows automatic off-line storage of old or little-used files on
magnetic tape for short periods of time. You can specify for how long
| these files are saved by inserting a command into the 6-CONFIG.CMD
file stating, in days, the recycle period of the tapes. For example,
to save migrated files on tape for three months, you would enter the
command, TAPE-RECYCLE-PERIOD 90 (because 3 months x 30 days/month =
90 days). If you do not insert a TAPE-RECYCLE-PERIOD command in the
| 6-CONFIG.CMD file, a default value of 180 (six months) will be taken.
Step 85: Type the TAPE-RECYCLE-PERIOD n Command.
The example below shows how to enter a TAPE-RECYCLE-PERIOD n command
with a value of 90 (three months). You must determine a suitable
value of n for your own system.
| 05400 TAPE-RECYCLE-PERIOD 90<RET>
| 05500
3.3.12 Tape Drive Allocation
Sections 3.3.12.1 and 3.3.12.2 describe putting tape drive allocation
into effect, and specifying a response to certain error conditions.
3-18
TAILORING THE SYSTEM
3.3.12.1 Enabling Tape Drive Allocation - TOPS-20 provides for the
automatic assignment of tape drives to users who wish to read or write
magnetic tapes. In order to use this feature, which also allows your
system to read and write the labels of standard labeled tapes, you
must insert the command, ENABLE TAPE-DRIVE-ALLOCATION into the
| 6-CONFIG.CMD file. If you do not give this command, your users must
assign tape drives with the TOPS-20 ASSIGN command and their labeled
tapes will be treated as unlabeled tapes.
Step 86: Type the ENABLE TAPE-DRIVE-ALLOCATION Command.
To allow labeled tape processing and the automatic assignment of tape
drives, type ENABLE TAPE-DRIVE-ALLOCATION and press the RETURN key.
| 05600 ENABLE TAPE-DRIVE-ALLOCATION<RET>
| 05700
3.3.12.2 Treatment of Unrecognized Tapes - If you enabled tape drive
allocation in the previous step, you must decide what action the
system should take if a labeled tape is mounted improperly, for
example, the user specifies the wrong label type or density. If you
want the system to unload the tape so that it cannot be accidentally
erased, you must insert the command, TAPE-RECOGNITION-ERRORS UNLOAD,
| into the 6-CONFIG.CMD file. If you do not give this command, the
system will treat improperly mounted labeled tapes as unlabeled tapes
and will continue processing them. That is, the system default is
TAPE-RECOGNITION-ERRORS REGARD-AS-UNLABELED.
Step 87: Type the TAPE-RECOGNITION-ERRORS UNLOAD Command.
To force the automatic unloading of any tapes that are improperly
mounted, type TAPE-RECOGNITION-ERRORS UNLOAD and press the RETURN key.
| 05800 TAPE-RECOGNITION-ERRORS UNLOAD<RET>
| 05900
3.3.13 Accounting Shift Changes
The accounting facility allows you to provide varied billing rates for
system use at different times. You do this by entering commands into
| the 6-CONFIG.CMD file specifying the time of day for each rate change.
You should give one command for each time the rate changes. Use days
of the week or keywords WEEKDAYS, WEEKENDS, and ALL, and times in
either 24-hour or AM/PM format. (Refer to Chapter 6 of the TOPS-20
System Manager's Guide for detailed information about accounting shift
changes.) The example below allows special rates for evenings and
weekends. You must provide the correct days and times for your own
system.
3-19
TAILORING THE SYSTEM
Step 88: Enter CHANGE Commands for Accounting Shift Changes.
| 06000 CHANGE 9:00 WEEKDAYS
| 06100 CHANGE 17:00 WEEKDAYS
| 06200 CHANGE 0:00 SATURDAY
| 06300
NOTE
| You do not have to enter CHANGE commands into the
| 6-CONFIG.CMD file. If you do not enter any CHANGE
commands, the accounting shift change feature of
system accounting is not used.
|
|
|
| 3.3.14 Assigning MSCP Served Disk Drive
|
| MSCP (Mass Storage Communication Protocol) is responsible for granting
| access to MASSBUS disks across the CI (Computer Interconnect). You
| can limit the number of disks served by MSCP with the RESTRICT and
| ALLOW commands. Enter the command in the following format
|
| ALLOW
| drive-type Low-order-Serial-number
| RESTRICT
|
| where:
|
| drive-type = RP04,RP06,RP07,or RP20
|
| serial-number = serial number of the disk drive
|
|
| Step 88A: Defining MSCP Served Disk Drives.
|
| Enter the ALLOW command for each disk drive that is to be served by
| MSCP. Enter a RESTRICT command for the disk drives that are not to be
| served by the MSCP server. The commands entered below are only
| examples. You must determine the correct definitions for your system.
|
| 06400 ALLOW RP06 1243
| 06500 ALLOW RP20 3327
|
|
|
| 3.3.15 Specifying Daylight Savings Time
|
| You can specify one of three daylight savings time options in the
| 6-CONFIG. CMD file. The three options are: AUTOMATIC (change at
| prescribed time), OFF (never do DST conversions), and ON (always do
| DST conversions).
|
| Step 88B: Enter the DAYLIGHT Argument Command for Your Site.
|
| To specify the DST option for your system, type DAYLIGHT argument.
| The following is only an example. You must enter the correct
| definition for your system.
|
| 04700 DAYLIGHT-SAVINGS-TIME ON
3-20
TAILORING THE SYSTEM
| 3.3.16 Specifying Remote Line Conditions
|
| You can specify whether or not a remote line will hung up after the
| logout command is issued on logged-out or logged-in terminal jobs.
| Setting these parameters can be especially useful for dial-up lines or
| for resource contention devices such as terminal concentrators. To
| specify whether a remote line will be hung-up, you must enter either a
| ENABLE or DISABLE in the 6-CINFIG.CMD file.
|
| Step 88C: Type the ENABLE HANGUP-IF-LOGGED-IN and ENABLE
| HANGUP-IF-LOGGED-OUT commands.
|
| To enable the remote line to be disconnected after a logout command is
| issued on logged-out or logged-in terminal jobs, type the following
| two commands into the 6-CONFIG.CMD file.
|
| 06600 ENABLE HANGUP-IF-LOGGED-IN
| 06700 ENABLE HANGUP-IF-LOGGED-OUT
|
|
|
| 3.3.17 Controlling System Message Levels
|
| You have the option of notifying users of certain events, such as
| resource problems. The following two commands allow you to control
| what class of messages the user will receive.
|
| ENABLE
| SYSTEM-MESSAGE-LEVEL-0
| DISABLE
|
| will inform (or not inform) users about resource problems.
|
| ENABLE
| SYSTEM-MESSAGE-LEVEL-1
| DISABLE
|
| will inform (or not inform) users of operational type messages.
|
|
| Step 88D: ENABLE SYSTEM-MESSAGE-LEVEL n
|
| To enable users to receive both types of system messages, type ENABLE
| SYSTEM-MESSAGE-LEVEL-0 and ENABLE SYSTEM-MESSAGE-LEVEL-1 and press the
| RETURN key.
|
| 06800 ENABLE SYSTEM-MESSAGE-LEVEL-0
| 06900 ENABLE SYSTEM-MESSAGE-LEVEL-1
Step 89: Press the ESC Key, Type EU and Press the RETURN Key.
| When you have finished creating the 6-CONFIG.CMD file, press the ESC
key to end insert mode. Type EU and press the RETURN key to save the
file. The system prints the filename and $:
ESC
!
05200 $
*EU<RET>
| [6-CONFIG.CMD.1]
$
3-21
TAILORING THE SYSTEM
| Step 90: Give the Command: TYPE (FILE) <SYSTEM>6-CONFIG.CMD.
To be sure that the file is in the proper directory, type TYPE and
press the ESC key. The system prints (FILE). Type
| PS:<SYSTEM>6-CONFIG.CMD and press the RETURN key. The system prints
the contents of the file on your terminal.
ESC
!
| $TYPE (FILE) PS:<SYSTEM>6-CONFIG.CMD<RET>
! Terminal Speeds
! Line 1 has input=9600 and output=9600
TERMINAL 1 SPEED 9600 ! Burke's line
! Lines 2 to 20 have input and output=2400
TERMINAL 2-20 SPEED 2400
! Lines 23 to 40 are shut off
TERMINAL 23-40 SPEED 0
! Line 21 and 22 are dialup lines
TERMINAL 21 REMOTE SPEED 300
TERMINAL 22 REMOTE AUTO
DEFINE NEW: PS:<NEW>,SYS:
DEFINE OLD: PS:<OLD>,SYS:
DEFINE HLP: SYS:
DEFINE SERR: PS:<SYSTEM-ERROR>
| DEFINE DMP: PS:<directory>
| DEFINE POBOX: PS:<directory>
| DEFINE EDITOR: SYS:TV.EXE
MAGTAPE 0 24 TU45
MAGTAPE 1 2001 TU77
MAGTAPE 2 2002 TU71
MAGTAPE 3 2003 TU70
MAGTAPE 4 150000 TU72
3-22
TAILORING THE SYSTEM
PRINTER 0 VFU SYS:NORMAL.VFU
PRINTER 1 VFU SYS:NORMAL.VFU
PRINTER 0 LOWERCASE RAM SYS:LP96.RAM
PRINTER 1 RAM SYS:LP64.RAM
TIMEZONE 5
ENABLE FULL-LATENCY-OPTIMIZATION
ENABLE WORKING-SET-PRELOADING
BIAS 6
CREATE 1 .20
CREATE 2 .40
CREATE 3 .15
BATCH-CLASS 4
CREATE 4 .25
ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED
ARCHIVE-TAPE-RECYCLE-PERIOD 1825
TAPE-RECYCLE-PERIOD 90
ENABLE TAPE-DRIVE-ALLOCATION
TAPE-RECOGNITION-ERRORS UNLOAD
CHANGE 9:00 WEEKDAYS
CHANGE 17:00 WEEKDAYS
CHANGE 0:00 SATURDAY
$
Remember, the file shown above is just an example.
Error: If the system cannot find the file or prints the wrong file,
give the following COPY command to place the file in
<SYSTEM>:
ESC ESC
! !
| $COPY (FROM) 6-CONFIG.CMD (TO) PS:<SYSTEM>6-CONFIG.CMD<RET>
(Refer to the TOPS-20 EDIT Reference Manual if you want to
change the file.)
3.4 CHANGING THE OPERATOR'S PASSWORD AND USER GROUP
You may wish to change the operator's password from the widely
publicized DEC-20 to a 39-alphanumeric-character phrase of your
choosing. The password can include a hyphen. Be sure to remember the
password or you will have to reinstall the system if you cannot think
of the particular password that you typed.
Also, in order for the operator to run the User Environmental Test
Package, he must belong to the correct user group. This section
describes how to change the operator's password and user group.
Step 91: Give the Command: ^ECREATE (DIRECTORY NAME) PS:<OPERATOR>
and Press the RETURN Key.
Type CTRL/E CREATE, and press the ESC key. The system prints
(DIRECTORY NAME). Type PS:<OPERATOR> and press the RETURN key. The
system prints [OLD], and then the subcommand prompt $$.
CTRL/E ESC
! !
$^ECREATE (DIRECTORY NAME) PS:<OPERATOR><RET>
[OLD]
$$
3-23
TAILORING THE SYSTEM
Step 92: Give the Command: PASSWORD Your Password and Press the
RETURN Key.
To insert the operator's new password, type PASS and press the ESC
key. The system prints WORD. Type the new password and press the
RETURN key. The system prints the subcommand prompt.
ESC
!
$$PASSWORD your password<RET>
$$
Step 93: Give the Subcommand: USER-GROUP (NUMBER) 100 and Press the
RETURN Key.
The operator must be a member of user group 100 in order for him to
run the User Environmental Test Package. Type USER-GROUP and press
the ESC key. The system prints (NUMBER). Type 100 and press the
RETURN key.
ESC
!
$$USER-GROUP (NUMBER) 100<RET>
$$
Error: If you see a message similar to: %Group already exists, you
can ignore this message. The operator is already a member
of the correct user group. Go to Step 95.
Step 94: Give the Subcommand: IPCF (CAPABILITY) and Press the RETURN
Key.
The operator must have IPCF capabilities in order to run the User
Environmental Test Package. Type IPCF and press the ESCAPE key. The
system prints (CAPABILITY). Press the RETURN key.
ESC
!
$$IPCF (CAPABILITY)<RET>
$$
Step 95: Press the RETURN Key.
To return to the TOPS-20 command level, press the RETURN key.
$$<RET>
$
3.5 CREATING PS:<REMARKS> DIRECTORY
The directory PS:<REMARKS> is used to receive messages sent by users
to the operator. Creating this directory avoids constant interruption
to the operator from users issuing PLEASE requests. With this
directory the operator can read the messages at a specified time each
day.
3-24
TAILORING THE SYSTEM
Step 96: Give the Command ^ECREATE (DIRECTORY NAME) PS:<REMARKS> and
Press the RETURN Key.
Type CTRL/E CREATE, and press the ESC key. The system prints
(DIRECTORY NAME). Type PS:<REMARKS> and press the RETURN key.
CTRL/E ESC
! !
$^ECREATE (DIRECTORY NAME) PS:<REMARKS><RET>
[NEW]
$$
Step 97: Press the RETURN Key.
Upon completion of the above step, the system prints [NEW] and $$.
Press the RETURN key and proceed to the next step.
$$<RET>
$
3.6 CREATING THE LPFORM.INI FILE
If the LPFORM.INI file is created, each time LPTSPL receives a request
for the line printer, the system does the following:
1. Prints the name of the user who requested the line printer.
(BANNER)
2. Prints the name of the file that is being printed. (HEADER)
3. After all the information in that file is printed, it prints
the user's name again. (TRAILER)
If this file is omitted, each time a request for the line printer is
received, LPTSPL will use the system default.
Step 98: Give the Command: CONNECT (TO DIRECTORY) PS:<SUBSYS> and
Press the RETURN Key.
The LPFORM.INI file must reside in the directory PS:<SUBSYS>. Type
CONNECT and press the ESC key. The system prints (TO DIRECTORY).
Type PS:<SUBSYS> and press the RETURN key.
ESC
!
$CONNECT (TO DIRECTORY) PS:<SUBSYS><RET>
$
3-25
TAILORING THE SYSTEM
Step 99: Give the Command: CREATE (FILE) LPFORM.INI and Press the
RETURN Key.
Use your system's text editing program to create the LPFORM.INI file.
(The example below uses the editing program, EDIT.) Type CREATE and
press the ESC key. The system prints (FILE). Type LPFORM.INI and
press the RETURN key. The system proceeds into edit mode and prints
00100. The parameters in the example below are used only for
explanatory purposes. You must decide the parameters to be used on
your system.
ESC
!
$CREATE (FILE) LPFORM.INI<RET>
INPUT: LPFORM.INI.1
00100 NORMAL/BANNER:2/HEADER:2/TRAILER:2<RET>
00200 NARROW/BANNER:2/HEADER:2/TRAILER:2/WIDTH:72<RET>
00300
The above example causes the user's name and the filename to be
printed twice on both normal and narrow forms before the actual data
is printed. Also, after all the data is printed, the system prints
the user's name twice again on both normal and narrow forms. The
parameter WIDTH:72 informs the system that a maximum of 72 characters
can be printed horizontally on narrow forms. (Refer to the TOPS-20
Operator's Guide for a complete description of all the LPFORM.INI
parameters.)
Step 100: Press the ESC Key. Type EU and Press the RETURN Key.
To leave edit mode and save the file without line numbers, press the
ESC key. The system prints the edit prompt. Type EU and press the
RETURN key. The system prints the filename and the generation number,
then the TOPS-20 command prompt.
00300 <ESC>
*EU<RET>
[LPFORM.INI.1]
$
NOTE
If your system is going to be part of the ARPA
network, you should perform the steps in Appendix C
before going on to Chapter 4.
NOTE
Perform Step 101 through Step 111 only if you are
using an RP07 disk drive for your system structure.
3-26
TAILORING THE SYSTEM
3.7 BUILDING A FRONT-END FILE STRUCTURE
Steps 101 through 111 describe how to build an RP04 or RP06 structure
for the front-end file system when you are using an RP07 disk pack for
the TOPS-20 file system.
Step 101: Give the Command: RUN (PROGRAM) CHECKD and Press the
RETURN Key.
To run CHECKD to create a structure for your front-end file system,
type RUN and press the ESC key. The system prints (PROGRAM). Type
CHECKD and press the RETURN key. The system prints the prompt
CHECKD>.
ESC
!
$RUN (PROGRAM) CHECKD <RET>
CHECKD>
Step 102: Give the CHECKD Command: CREATE (NEW FILE SYSTEM FOR)
FE-SYS
To inform the system that you are creating a structure, type CREATE
and press the ESC key. The system prints (NEW FILE SYSTEM FOR). Type
the name of the structure. The structure name can consist of 1 to 6
alphanumeric characters. The example uses FE-SYS. Press the RETURN
key. The system prints ENTER ALIAS:.
<ESC>
!
CHECKD>CREATE (NEW FILE SYSTEM FOR) FE-SYS <RET>
ENTER ALIAS:
Step 103: Give the Command: FE-SYS and Press the RETURN Key.
To inform the system of the alias name of the structure, type FE-SYS
and press the RETURN key. The system prints HOW MANY UNITS IN THIS
STRUCTURE:
ENTER ALIAS: FE-SYS <RET>
HOW MANY UNITS IN THIS STRUCTURE:
Step 104: Give the Command: 1 and Press the RETURN Key.
The front-end file system can only reside on a single structure. Type
1 and press the RETURN key. The system prints CHANNEL, CONTROLLER,
AND UNIT NUMBER FOR LOGICAL UNIT 0:.
HOW MANY UNITS IN THIS STRUCTURE: 1 <RET>
CHANNEL, CONTROLLER, AND UNIT NUMBER FOR LOGICAL UNIT 0:
3-27
TAILORING THE SYSTEM
Step 105: Give the Command: 1, -1, 0 and Press the RETURN Key.
The front-end file system must reside on either an RP04 or RP06 disk
drive that is connected to both the KL10 and PDP11 front-end. If you
are not sure, type a ? and press the RETURN key. The system prints
the information needed to make the decision. The example uses channel
1, controller -1 (which is the default), and unit 0. After you type
this information, the system prints NUMBER OF PAGES TO ALLOCATE FOR
SWAPPING?
CHANNEL, CONTROLLER, AND UNIT NUMBERS FOR LOGICAL UNIT 0: 1, -1, 0 <RET>
NUMBER OF PAGES TO ALLOCATE FOR SWAPPING?
Step 106: Type the Number of Pages to Allocate for Swapping and Press
the RETURN Key.
If you plan to use this structure as a secondary system structure,
type a decimal number between 2000 and 40,000 and press the RETURN
key. Otherwise, type 0 and press the RETURN key. The example assumes
you will be using this structure as a secondary structure.
NUMBER OF PAGES TO ALLOCATE FOR SWAPPING? 7035 <RET>
NUMBER OF PAGES TO ALLOCATE FOR THE FRONT-END FILE SYSTEM?
Step 107: Type the Number of Pages to Allocate for the Front-End File
System and Press the RETURN Key.
To allocate the number of pages to reserve for the front-end file
system, type 950 and press the RETURN key. The system prints OWNER
NAME?
NUMBER OF PAGES TO ALLOCATE FOR THE FRONT-END FILE SYSTEM? 950 <RET>
OWNER NAME?
Step 108: Type the Owner's Name and Press the RETURN Key.
Type the owner's name of the structure and press the RETURN key. The
owner's name can be from 1 to 12 alphanumeric characters. The example
uses the name OPERATOR. The system prints IS THIS A SYSTEM STRUCTURE
FOR STARTUP?
OWNER NAME? OPERATOR <RET>
IS THIS A SYSTEM STRUCTURE FOR STARTUP?
| Step 109: Type NO And Press the RETURN Key.
|
| To inform the system that this structure will not be used at system
| startup, type NO and press the RETURN key. The system prints the
| CHECKD prompt.
|
| IS THIS A SYSTEM STRUCTURE FOR STARTUP? NO <RET>
| CHECKD>
3-28
TAILORING THE SYSTEM
| Step 110: Give the CHECKD Command: EXIT and Press the RETURN Key.
To exit the CHECKD program, type EXIT and press the RETURN key. The
system prints the TOPS-20 command prompt $.
CHECKD>EXIT <RET>
$
NOTE
When performing the steps in Chapter 4, be sure you
install the front-end file system on the structure you
have just created.
3-29
4-1
CHAPTER 4
CREATING THE FRONT-END FILE SYSTEM
The steps in this chapter restore the front-end file system when you
reinitialize it or change the front-end hardware. They also restore
the front-end software if the front-end file system on disk is
destroyed.
These steps copy the front-end software from the floppy disks to the
front-end file space on the public structure. They involve the
following front-end programs:
MOU Adds a device to the list of front-end devices.
UFD Creates a directory in the front-end file space on the
public structure.
PIP Copies files from the floppy disk to the public structure.
RED Changes the definition of the front-end logical name SY0:
from the floppy disk to the public structure.
SAV Saves the front-end monitor.
INI Initializes the front-end file system on the public
structure.
| DMO Logically dismounts the floppy disks from the disk drives.
4.1 HALTING THE TOPS-20 MONITOR
| Step 111: Make Sure that the Correct Floppy Disks Are Mounted.
Be sure that System Floppy A is mounted in the left drive (drive 0)
and that System Floppy B is mounted in the right drive (drive 1).
(Refer to Step 7 in Chapter 2 if you have trouble.)
| Step 112: Type CTRL/\.
At the console terminal, type CTRL/\ to return to the front-end
Command Parser. When you are at Command Parser command level, the
system prints the prompt PAR>:
CTRL/\
PAR>
4-1
CREATING THE FRONT-END FILE SYSTEM
Step 113: Type SHUTDOWN and Press the RETURN Key.
To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key.
The system prints a list of messages.
PAR>SHUTDOWN<RET>
**HALTED**
%DECSYSTEM-20 NOT RUNNING
Error: If you mistype SHUTDOWN an error message is printed, after
which you can reissue the command.
The system must print %DECSYSTEM-20 NOT RUNNING. If it does
not, type CTRL/\ and give the ABORT command. Go back to
Step 113.
4.2 RESTARTING THE FRONT-END MONITOR
This entire procedure is invalid if you did not stop the TOPS-20
monitor as described in Section 4.1.
| Step 114: Set the Switch Register to 000003 (Octal).
Set the front-end switch register to 000003 (switches 1 and 0 up, the
rest down).
| Step 115: Hold ENABLE and Press the SWITCH REGISTER Button.
Hold ENABLE and press the SWITCH REGISTER button to start the
front-end monitor from drive 0. The system will print a few lines of
information. After the system prints [DX1: MOUNTED] proceed to
Section 4.3.
| RSX-20F VB15-20 6:11 5-MAR-84
[SY0: REDIRECTED TO DX0:]
[DX0: MOUNTED]
[DX1: MOUNTED]
Error: If you left the switch register set to 000007, the system
starts the KL Initialization routine. In this case, the
printout looks like this:
| RSX-20F VB15-20 6:11 5-MAR-84
[SY0: REDIRECTED TO DX0:]
[DX0: MOUNTED]
[DX1: MOUNTED]
| KLI -- VERSION VB15-12 RUNNING
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>
Set the switch register to 000003 and press the ENABLE and
SWITCH REGISTER buttons again.
4-2
CREATING THE FRONT-END FILE SYSTEM
If you set the switch register to 000003, the system may
print:
11-HALT
T04
or
**This VOLUME DOES NOT CONTAIN A HARDWARE-BOOTABLE SYSTEM**
Set the switch register correctly and press the ENABLE and
SWITCH REGISTER buttons again.
4.3 COPYING FILES FROM FLOPPY DISK TO RP04 OR RP06
Use the following procedures to copy the files. Remember that you are
typing commands to the front end and that you must wait for a prompt
before typing the answer. There is no type-ahead feature except when
you want to type a CTRL/\. You can type a CTRL/U to erase an entire
line or press the DELETE key to erase a single character per
keystroke.
Many of the steps in this chapter and in Chapter 5 assume that the
disk pack is mounted on drive 0. To use a dual-port drive other than
drive 0, make the following changes:
1. Where a step calls for DB0: to be typed, type the number of
the actual drive used. For example: DB1:, DB2:, etc.
Messages printed by the system will reflect this change.
2. If the disk is mounted on a drive other than drive 0,
pressing ENABLE and DISK in Step 151 will not work. Instead,
set the front-end switch register switches 7 and 0 in the up
position. Set switches 10, 9, and 8 to the binary number of
the drive used. For example, for drive 1, set switch 8 up;
for drive 2, set switch 9 up; for drive 3, set switches 9 and
8 up. After this has been completed, press the ENABLE and
SWITCH REGISTER buttons.
| Step 116: Type CTRL/\.
To start the front-end Command Parser, type CTRL/\. The system takes
about 10 seconds to load the Command Parser from the floppy disks.
You are at Command Parser command level when the system prints the
prompt PAR%. The % after PAR indicates that the central processor is
not running:
[DX1: MOUNTED]
CTRL/\
PAR%
| Step 117: STOP.
The central processor (as opposed to the front-end processor) must be
halted before you proceed to the next step. If the central processor
is not halted, the front-end monitor will not be saved in the
front-end file system in a usable state. When the central processor
is stopped, the system prints a percent sign, %, following the Command
Parser prompt. If it prints an angle bracket, >, give the SHUTDOWN
4-3
CREATING THE FRONT-END FILE SYSTEM
command and type CTRL/\ before continuing.
4-4
CREATING THE FRONT-END FILE SYSTEM
| Step 118: Type MCR INI and Press the RETURN Key.
To start the INITIALIZE program, type MCR INI and press the RETURN
key. When the INITIALIZE program is ready for you to type commands
(after a few seconds), it prints the prompt INI>:
PAR%MCR INI<RET>
INI>
| Step 119: Type DB0:, and Press the RETURN Key. Wait 5 Seconds and
Perform the Next Step.
To initialize the front-end file system on the public structure, type
DB0: and press the RETURN key. In about 5 seconds, the INI program
finishes. It does not reprint the prompt. Proceed directly to the
next step.
INI>DB0:<RET>
Error: If you type the wrong device name or get an error message,
start again at Step 117. If you still get an error message,
press the front-end HALT switch and wait one minute. Go
back to Step 116.
| Step 120: Type CTRL/\.
To start the front-end Command Parser, type CTRL/\. When the Command
Parser is ready for you to type commands (about 10 seconds), it prints
the prompt PAR%:
CTRL/\
PAR%
NOTE
Nothing happens until you type CTRL/\.
| Step 121: Type MCR MOU and Press the RETURN Key.
To start the MOUNT program again, type MCR MOU and press the RETURN
key. When you are at MOUNT command level, the system prints MOU>:
PAR%MCR MOU<RET>
MOU>
Error: If you make a typing error, reissue the command.
Step 122: Type DB0: and Press the RETURN Key.
To allow the front end to use its reserved area on the dual-port disk
(the one with the channel selector set to A/B), type DB0: and press
the RETURN key. When the mount operation is complete, the system
prints a message and the prompt, MOU>:
MOU>DB0:<RET>
MOU -- MOUNT COMPLETE
MOU>
4-5
CREATING THE FRONT-END FILE SYSTEM
Error: If you mistype DB0:, the mount operation may fail. If this
happens and the system reprints the prompt MOU>, reissue the
command. Otherwise, go back to Step 121.
| Step 123: Type CTRL/Z and CTRL/\.
To terminate the MOUNT program and start the front-end Command Parser,
type CTRL/Z, followed by CTRL/\. After about 10 seconds, when the
system is at Command Parser command level, it prints the prompt PAR%:
CTRL/Z
!
MOU>^Z
CTRL/\
PAR%
| Step 124: Type MCR UFD and Press the RETURN Key.
To run the UFD program, type MCR UFD and press the RETURN key. The
system loads the program from the floppy disk and starts it. After a
few seconds, UFD is ready for you to type commands and prints the
prompt UFD>:
PAR%MCR UFD<RET>
UFD>
Error: If you make a typing error, reissue the command.
| Step 125: Type DB0:[5,5], Press RETURN Key, Wait 10 Seconds and
Perform the Next Step.
To create the directory (in the front-end reserved space on the public
structure) that contains the front-end file system, type DB0:[5,5] and
press the RETURN key. When the UFD program finishes, it does not
reprint the prompt. Wait 10 seconds and then proceed directly to the
next step:
UFD>DB0:[5,5]<RET>
Error: If the system prints:
UFD -- FAILED TO CREATE DIRECTORY
you probably did not give the correct command the last time
you ran the MOU program. Go back to Step 118.
Error: If the system prints:
UFD -- DIRECTORY ALREADY EXISTS
and you have run the INI program on the disk, then the
front-end file system has been corrupted and the entire disk
pack will have to be reformatted and rebuilt from the
beginning of the installation.
4-6
CREATING THE FRONT-END FILE SYSTEM
| Step 126: Type CTRL/\.
To load the front-end Command Parser from the floppy disk, type
CTRL/\. After 10 seconds, the Command Parser is at command level and
the system prints the prompt PAR%:
CTRL/\
PAR%
NOTE
Nothing happens until you type CTRL/\.
| Step 127: Type MCR PIP and Press the RETURN Key.
To load the PIP program from the floppy disk and start it, type MCR
PIP and press the RETURN key. After 10 seconds, PIP is ready for you
to type commands. The system prints the prompt PIP>:
PAR%MCR PIP<RET>
PIP>
Error: If you make a typing error, reissue the command.
| Step 128: Type DB0:/NV=DX0:*.*,DX1:*.* and Press the RETURN Key.
To copy the newest version of all the files from the floppy disks
(both drive 0 and drive 1) to the front-end file system on the public
structure, type DB0:/NV=DX0:*.*,DX1:*.* and press the RETURN key.
(You can use CTRL/U and the DELETE key to help type this line and
others in this chapter.) You will hear clicking as the system accesses
the floppy disks. After about 10 minutes, the transfer is complete
and the system prints the prompt PIP>:
PIP>DB0:/NV=DX0:*.*,DX1:*.*<RET>
PIP>
Error: If you make a typing error, reissue the command.
| Step 129: Type CTRL/Z and CTRL/\.
To end PIP and start the front-end Command Parser, type CTRL/Z
followed by CTRL/\. After 10 seconds, the system is ready to accept
commands and prints the prompt PAR%:
CTRL/Z
!
PIP>^Z
CTRL/\
PAR%
Error: If you make a typing error, reissue the command.
4-7
CREATING THE FRONT-END FILE SYSTEM
| Step 130: Type MCR RED and Press the RETURN Key.
To load and start the REDIRECT program from floppy disk, type MCR RED
and press the RETURN key. After the REDIRECT program is ready to
accept commands (about five seconds), the system prints the REDIRECT
prompt RED>:
PAR%MCR RED<RET>
RED>
Error: If you make a typing error, reissue the command.
| Step 131: Type DB0:=SY0: and Press the RETURN Key. Wait 5 Seconds
and Perform the Next Step.
To redirect the primary front-end file structure from the floppy disks
to the front-end file system on the public structure, type DB0:=SY0:
and press the RETURN key. After 5 seconds, the REDIRECT program is
finished and does not reprint the prompt. Proceed directly to the
next step.
RED>DB0:=SY0:<RET>
Error: If this operation fails or if you make a mistake and the
system has printed the prompt RED>, reissue the command. If
it still fails, perform Steps 115 through 117 and Steps 122
through 124, then continue at Step 131. (Even this may not
work. You may have to perform all the steps again,
beginning with Step 115.)
| Step 132: Type CTRL/\.
To start the front-end Command Parser, type CTRL/\. After one second,
the system loads and starts the Command Parser and prints the prompt
PAR%:
CTRL/\
PAR%
| Step 133: Type MCR SAV and Press the RETURN Key.
To start the SAVE program, type MCR SAV and press the RETURN key.
After one second, the SAVE program is ready to accept commands and the
system prints the prompt SAV>:
PAR%MCR SAV<RET>
SAV>
Error: If you make a typing error, reissue the command.
| Step 134: Set the Switch Register to Zero.
Before proceeding, set the switch register to zero (all switches
down).
4-8
CREATING THE FRONT-END FILE SYSTEM
| Step 135: Type SY0:/WB and Press the RETURN Key.
To save the system bootstrap and the front-end monitor in the
front-end file system on the public structure, type SY0:/WB and press
the RETURN key (WB stands for write bootstrap). After the bootstrap
and the monitor are saved, the system prints a message and the front
end restarts itself at the save entry point:
SAV>SY0:/WB<RET>
[DB0: DISMOUNTED]
[DX0: DISMOUNTED]
[DX1: DISMOUNTED]
| RSX-20F VB15-20 6:28 5-MAR-84
[SY0: REDIRECTED TO DB0:]
[DB0: MOUNTED]
The last two messages inform you that the front end is using the
files on the TOPS-20 file system instead of on the floppy disks.
Error: If you make a typing error, reissue the command.
| Step 136: Store the Floppy Disks A and B.
Remove the floppy disks, insert them in their covers, and store them
in a safe place.
NOTE
If you have some spare floppies available, it is a
good idea to copy System Floppies A and B to the spare
floppies for backup purposes. Refer to the TOPS-20
System Manager's Guide for this procedure.
| Step 137: Mount System Floppy C on Drive 0
Mount System Floppy C in the left drive (drive 0). (Refer to Step 7
in Chapter 2 if you have trouble.)
| Step 138: Type CTRL/\
To start the front-end Command Parser again, type CTRL/\. After one
second, the system loads and starts the Command Parser and prints the
prompt PAR%:
CTRL/\
PAR%
4-9
CREATING THE FRONT-END FILE SYSTEM
| Step 139: Type MCR MOU and Press the RETURN Key.
To start the MOUNT program, type MCR MOU and press the RETURN key.
When the system is at MOUNT command level, the system prints the
prompt MOU>:
PAR%MCR MOU<RET>
MOU>
Error: If you make a typing error, reissue the command.
| Step 140: Type DX0: and Press the RETURN Key.
The MOUNT program mounts floppy drive 0, then prints the message MOUNT
COMPLETE:
MOU>DX0:<RET>
MOU -- MOUNT COMPLETE
| Step 141: Type CTRL/Z and CTRL/\.
To terminate the MOUNT program and start the front-end Command Parser,
type CTRL/Z, followed by CTRL/\. After about one second, when the
system is at Command Parser command level, it prints the prompt PAR%:
CTRL/Z
!
MOU>^Z
CTRL/\
PAR%
| Step 142: Type MCR PIP and Press the RETURN Key.
To run the PIP program, type MCR PIP and press the RETURN key. When
PIP is at command level, it prints the prompt PIP>:
PAR%MCR PIP<RET>
PIP>
Error: If you make a typing error, retype the command.
| Step 143: Type DB0:/NV=DX0:*.* and Press the RETURN Key.
Copy the contents of System Floppy C to the disk by typing
DB0:/NV=DX0:*.*. This copies RSX20F.MAP to the disk. When the file
is copied, PIP prints the prompt PIP>:
PIP>DB0:/NV=DX0:*.*<RET>
PIP>
| Step 144: Type DB0:/LI and Press the RETURN Key.
To get a list of the files on the front-end file system, type DB0:/LI
and press the RETURN key. The system prints the list of the files
copied from floppies A, B, and C. Check it against the directory
listing shown in the TOPS20.BWR file to be sure that you have all the
files shown there. The TOPS20.BWR file is located on the TOPS-20
4-10
CREATING THE FRONT-END FILE SYSTEM
Installation tape.
4-11
CREATING THE FRONT-END FILE SYSTEM
The directory listing shown here is only a sample. Do not worry about
the order of the files, generation numbers, or dates and times when
comparing the files. The file sizes (indicated in the second column
in 256-word blocks) should be the same. When the listing is finished,
the system prints the prompt PIP>:
PIP>DB0:/LI<RET>
DIRECTORY DB0:[5,5]
5-MAR-84 16:36
PIP>
| Step 145: Type CTRL/Z and CTRL/\
To exit from the PIP program, type a CRTL/Z. To restart the front-end
command parser, type a CTRL/\. When at command level, the front-end
command parser prints the prompt PAR%:
CTRL/Z
!
PIP>^Z
CTRL/\
PAR%
4-12
CREATING THE FRONT-END FILE SYSTEM
| Step 146: Type MCR DMO and Press the RETURN Key.
To start the DMO program, type MCR DMO and press the RETURN key. When
at command level, the DMO program prints the prompt DMO>:
PAR%MCR DMO<RET>
DMO>
| Step 147: Type DX0: and Press the RETURN Key.
To dismount the floppy drive, type DX0: and press the RETURN key.
After a few seconds, when the drive is dismounted, DMO prints a
message and the prompt DMO>:
DMO>DX0:<RET>
DMO -- DISMOUNT COMPLETE
DMO>
| Step 148: Type a CTRL/Z and CTRL/\
To exit from the DMO program, type a CTRL/Z followed by a CTRL/\.
When you return to command level, the front-end command parser prints
the prompt PAR%:
CTRL/Z
!
DMO>^Z
CTRL/\
PAR%
NOTE
If you have a spare floppy available, it is a good
idea to copy System Floppy C to the spare floppy for
backup purposes. Refer to the TOPS-20 System
Manager's Guide for this procedure.
4-13
5-1
CHAPTER 5
RESTARTING THE SYSTEM
At this point you have:
1. Initialized the TOPS-20 file system.
2. Loaded the TOPS-20 monitor and related programs into
directories PS:<SYSTEM> and PS:<SUBSYS>.
3. Loaded the files for the TOPS-20 User Environmental Test
Package into directory PS:<UETP.LIB>.
4. Created the system initialization files.
5. Loaded the front-end software into the TOPS-20 file system.
| The only thing left to be done is to restart the system. Once this is
done, the TOPS-20 file system is intact and the standard TOPS-20
bundled software is completely installed on your system. This means
you can stop the system and reboot it from the file system on disk.
Whenever you have to restart the system, be sure that the central
processor is stopped; otherwise you can damage the file system you
just created.
| Step 149: Be Sure that the Central Processor Is Stopped
Check your output to be sure that the last time the system printed the
prompt PAR (in Step 149) it was followed by a % to indicate that the
central processor has stopped. If the prompt is followed by a >, type
SHUTDOWN and press the RETURN key.
| Step 150: Hold ENABLE and Press the DISK Button.
To restart the system, hold ENABLE and press the DISK button. The
system restarts after a few seconds and obtains all the software from
the TOPS-20 file system.
If the TOPS-20 file system is on a drive other than drive 0, holding
the ENABLE button and pressing the DISK button does not work. You
must set the switch register to the appropriate disk drive. For
example, if the TOPS-20 file system is on drive 1, set switches 8, 7,
and 0 up; for drive 2, set switches 9, 7 and 0 up. (Refer to Part 4,
Chapter 1, of the TOPS-20 Operator's Guide for more information on
setting the switch register.)
5-1
RESTARTING THE SYSTEM
Once you have set the switches to the appropriate disk drive, hold
ENABLE and press the SWITCH REGISTER button rather than the DISK
button. When you follow this procedure, the system prints the
question, KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]? and waits for a
reply. Reply by pressing the RETURN key.
| RSX-20F VB15-20 6:11 5-MAR-84
[SY0: REDIRECTED TO DB0:]
[DB0: MOUNTED]
| KLI -- VERSION YB15-12 RUNNING
KLI -- KL10 S/N: 2102., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE ENVIRONMENT:
MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
| KLI -- MICROCODE VERSION 352 LOADED
| KLI -- ALL CACHES ENABLED
|
| LOGICAL MEMORY CONFIGURATION
| ADDRESS SIZE INT TYPE CONTROLLER
| 00000000 1024K 4 MF20 4
|
| KLI -- CONFIGURATION FILE WRITTEN
| KLI -- BOOTSTRAP LOADED AND STARTED
|
|
| BOOT V10.0 (201)
| [BOOT: LOADING] [OK]
|
|
| [PS MOUNTED]
|
| System restarting wait...
| ENTER CURRENT DATE AND TIME:
The line "System restarting, wait..." is printed on all the terminals
currently connected to the system to inform users that the system will
soon be ready to use.
Error: If the system prints:
*** THIS VOLUME DOES NOT CONTAIN A HARDWARE BOOTABLE SYSTEM ***
the disk pack on the dual-port drive does not contain the
front-end software. Perhaps the wrong disk pack has been
mounted. But if everything appears to be in order, try the
steps in Chapters 2 through 4 again. If the error
continues, contact DIGITAL Software Support.
If the system does nothing when you press the switches, you
may have pressed ENABLE and SWITCH REGISTER by mistake. Try
pressing ENABLE and DISK.
If the system prints JSYS error messages between the lines
[PS MOUNTED] and System restarting, wait..., you probably
have mistyped some information in the
| PS:<SYSTEM>6-CONFIG.CMD file. Use EDIT to check the file
and correct any errors.
5-2
RESTARTING THE SYSTEM
| Step 151: Type the Date and Time and Press the RETURN Key.
After the prompt, type the date and time in the form:
day-month-year hhmm
Then press the RETURN key:
ENTER CURRENT DATE AND TIME: 5-MAR-84 1112<RET>
YOU HAVE ENTERED WEDNESDAY, 5-MAR-84 11:12AM,
IS THIS CORRECT (Y,N)
| Step 152: Type Y or N and Press the RETURN Key.
After the system prints the date and time, check to be sure that it is
correct. If it is, type Y and press the RETURN key. If the date or
time is incorrect, type N, press the RETURN key, and go back to the
| Step 151:
YOU HAVE ENTERED WEDNESDAY, 5-MAR-82 11:12AM,
IS THIS CORRECT (Y,N) Y<RET>
WHY RELOAD?
| Step 153: Type SC and Press the RETURN Key.
If you plan to install optional software, type SC and press the RETURN
key. When you bring up the system for any other reason, type one of
the abbreviations listed in Table 5-1, below:
WHY RELOAD? SC<RET>
<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED
RUN CHECKD?
Table 5-1: System Reload Abbreviations
Abbreviation Meaning
OP OPR
PA Parity
PO Power Failure
ST Static
HAR Hardware
HA Halt
HU Hung
PM Preventive Maintenance
CM Corrective Maintenance
SA Stand-alone
NE New Monitor
SC Scheduled
OT Other
5-3
RESTARTING THE SYSTEM
| Step 154: Type N and Press the RETURN Key.
The CHECKD program examines the entire disk file system, reports any
errors, and tries to correct them. You do not have to run this
program unless the system crashes unexpectedly, or if, for some
other reason, you suspect that there may be disk errors. If you
halt the system by giving a CTRL/E CEASE command or by using some
other controlled means, you do not have to run CHECKD before
restarting.
Type N and press the RETURN key. The system prints RUNNING DDMP and
runs the SYSJOB.RUN file.
If you do run CHECKD, be prepared for a long wait until the system
prints something on your console terminal. For each inconsistency,
CHECKD prints a message and the directory in which the error
occurred. (Refer to the TOPS-20 Operator's Guide for a list of
CHECKD error messages.)
RUN CHECKD? N<RET>
RUNNING DDMP
| SYSJOB 6(23) STARTED AT 5-MAR-84 1112
RUN SYS:ORION
RUN SYS:QUASAR
*****
| 5-MAR-84 11:12:09 - TGHA 4(0) IS RUNNING FOR THE FIRST TIME.
*****
RUN SYS:MOUNTR
RUN SYS:INFO
RUN SYS:MAILER
RUN SYS:MAPPER
RUN SYS:LPTSPL
RUN SYS:CDRIVE
RUN SYS:SPRINT
JOB 0 /LOG OPERATOR XX OPERATOR
ENA
^ESET LOGIN PSEUDO
^ESET LOGIN CONSOLE
^ESET OPERATOR
PTYCON
| GET SYSTEM:6-PTYCON.ATO
/
JOB 1 /LOG OPERATOR XX OPERATOR
ENA
RUN SYS:BATCON
/
SJ 0:
| SJ 0: 10/5-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 6(nnnn)
SJ 1:
| SJ 1: 10/5-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 6(nnnn)
5-4
RESTARTING THE SYSTEM
SJ 0: @LOG OPERATOR OPERATOR
SJ 1: @LOG OPERATOR OPERATOR
SJ 0: JOB 1 ON TTY206 5-MAR-84 11:12:22
SJ 0: @ENA
SJ 0: $^ESET LOGIN PSEUDO
SJ 0: $^ESET LOGIN CONSOLE
SJ 0: $^ESET OPERATOR
SJ 0: $PTYCON
SJ 1: JOB 2 ON TTY207 5-MAR-84 11:12:23
SJ 1: @ENA
| SJ 0: PTYCON> GET SYSTEM:6-PTYCON.ATO
SJ 0: PTYCON> SILENCE
SJ 1: $RUN SYS:BATCON
[From OPERATOR on line 210: SYSTEM IN OPERATION]
SJ 0: PTYCON.LOG.1
SJ 0: PTYCON> W ALL
SJ 0: OPR(0) 3 OPERATOR OPR TI 0:0:1
SJ 0: PTYCON> CONN OPR
SJ 0: [CONNECTED TO SUBJOB OPR(0)]
5-5
6-1
CHAPTER 6
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
The steps in this section describe how to install the TOPS-20
distribution tape or any TOPS-20 update tapes.
To install any option software products, follow the steps specified in
the installation guide that accompanies each optional software
product.
The TOPS-20 distribution tape contains four savesets. These savesets
are: documentation regarding specific programs; sources that allow
you to rebuild certain programs, if required; language sources that
allow you to rebuild certain language modules, such as MACRO, LINK;
GALAXY sources that allow you to rebuild a GALAXY system, if required.
If you are installing the TOPS-20 DECnet-20 software on a 2060, follow
the steps in the TOPS-20 DECnet-20 Manual.
If you are installing the IBM communications software, follow the
steps in the IBM Emulation/Termination Manual.
6-1
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
| Step 155: Type CTRL/C.
Type CTRL/C to start a job at your terminal:
CTRL/C
| Installation-test System, TOPS-20 Monitor 6(nnnn)
@
| Step 156: Type SYSTAT OPERATOR and Press the RETURN Key.
To look at the operator jobs on the system, type SYSTAT OPERATOR and
press the RETURN key. The system prints a list of the current
operator jobs. Determine which operator job is running PTYCON. Use
that job number in the next step.
@SYSTAT OPERATOR<RET>
0 DET SYSJOB OPERATOR
1 206 PTYCON OPERATOR
2 207 BATCON OPERATOR
3 210 OPR OPERATOR
@
| Step 157: Give the Command: ATTACH (USER) OPERATOR (JOB#) n.
Attach to the operator's job running PTYCON. Type ATTACH and press
the ESC key. The system prints (USER). Type OPERATOR and press the
ESC key. The system prints (JOB #). Type the number of the job
running PTYCON and press the RETURN key. The system prints a message
similar to [PSEUDO-TERMINAL, CONFIRM]. Press the RETURN key.
ESC ESC
! !
@ATTACH (USER) OPERATOR (JOB #) 1<RET>
[PSEUDO-TERMINAL, CONFIRM] <RET>
PASSWORD:
| Step 158: Type Your Password and Press the RETURN Key Twice.
Type the operator's password and press the RETURN Key twice. The
system prints the prompt for the OPR program.
PASSWORD: your password <RET>
<RET>
OPR>
6-2
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
| Step 159: Give the Command: SHOW STATUS TAPE-DRIVE /ALL, and Press
the RETURN Key.
To find a tape drive that you can use for mounting the software tape,
give the OPR program command SHOW STATUS TAPE-DRIVE /ALL, and press
the RETURN key. The system responds with a list of tape drives and
their status.
OPR>SHOW STATUS TAPE-DRIVE /ALL <RET>
OPR>
9:35:49 --Tape Drive Status--
DRIVE STATE VOLID REQ# JOB# USER
----- ----- ------ ---- ---- ----
MTA0: Unloaded
AVR: Yes
MTA1: In Use DEK 31 45 LARRUP
AVR: Yes, Write: Yes, Unlabeled
MTA2: Loaded
AVR: Yes, Write: Yes, Unlabeled
MTA3: Unloaded
AVR: Yes
MTA4: Unloaded
AVR: No
MTA5: Unloaded
AVR: Yes
OPR>
| Step 160: Give the Command: SET TAPE-DRIVE MTAn: UNAVAILABLE.
To mount the software tape, you should first make a free drive
unavailable to timesharing users. The OPR program command SET
TAPE-DRIVE MTAn: UNAVAILABLE accomplishes this. The example uses
drive number 0, but you can specify any drive that is not in use at
the moment.
OPR>SET TAPE-DRIVE MTA0: UNAVAILABLE<RET>
Enter text and terminate with ^Z
| Step 161: Enter INSTALLING OPTIONAL SOFTWARE and Type CTRL/Z.
Enter text and terminate with ^Z
CTRL/Z
!
INSTALLING OPTIONAL SOFTWARE ^Z
OPR>
6-3
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
| Step 162: Give the PUSH Command and Press the RETURN Key.
To restore the contents of the tape, you should be at TOPS-20 command
level. Giving the PUSH command to the OPR program puts you at TOPS-20
command level.
OPR>PUSH<RET>
| TOPS-20 Command processor 6(nnnn)
@
NOTE
If you are using the console terminal, as recommended
above, your PUSH command to OPR puts you at TOPS-20
command level. You then see the TOPS-20 prompt (@).
| Step 163: Give the Command: ASSIGN (DEVICE) MTAn:.
Give the ASSIGN command to assign a magnetic tape drive to your job.
The example uses drive number 0, but you can use any free drive of
your choice. Type ASSIGN and press the ESC key. The system prints
(DEVICE). Type MTA0: and press the RETURN key. The system prints
the system prompt when the drive is assigned:
ESC
!
@ASSIGN (DEVICE) MTA0:<RET>
@
Error: If the device is assigned to another job, the system prints
the message:
?ALREADY ASSIGNED TO JOB n
Use the command INFORMATION (ABOUT) AVAILABLE DEVICES to
find an available tape drive. Reissue the ASSIGN command.
| Step 164: Give the Command: ENABLE (CAPABILITIES).
Because you will be restoring files to restricted areas, you must
enable your capabilities. Type ENABLE and press the ESC key. The
system prints (CAPABILITIES). Press the RETURN key. The system
prints a $ prompt:
ESC
!
@ENABLE (CAPABILITIES)<RET>
$
6-4
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
| Step 165: Type DUMPER and Press the RETURN Key.
To start DUMPER, type DUMPER and press the RETURN key. The system
prints the DUMPER prompt:
$DUMPER<RET>
DUMPER>
DUMPER ERRORS
If you get errors when using DUMPER, refer to the
description of DUMPER in the TOPS-20 User Utilities
Guide.
| Step 166: Give the Command: TAPE (DEVICE) MTAn:.
Tell DUMPER which tape drive to use. The example uses MTA0:; but, if
you have assigned another drive in Step 164, use that drive number.
Type TAPE and press the ESC key. The system prints (DEVICE). Type
MTA0: and press the RETURN key. The system prints the DUMPER prompt:
ESC
!
DUMPER>TAPE (DEVICE) MTA0:<RET>
DUMPER>
| Step 167: Mount the Distribution Tape or the Update Tape.
Mount the distribution tape or the update tape on the drive that is
assigned to your job. Remember to press the ON LINE button after
mounting the tape on a TU45 tape drive.
| Step 168: Type REWIND and Press the RETURN Key.
To start the tape at the beginning, type REWIND and press the RETURN
key. The system moves the tape to the beginning and prints the DUMPER
prompt:
DUMPER>REWIND<RET>
DUMPER>
6-5
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
| Step 169: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO)
| PS:<OPERATOR>.
|
| To restore the documents to directory PS:<OPERATOR>, type RESTORE and
| press the <ESC> key. The system prints (TAPE FILES). Type PS:.
| Press the <ESC> key. The system prints <*>*.*.* (TO). Type
| PS:<OPERATOR> and press the RETURN key. The system prints a header
| containing the date and time that the tape was made, followed by the
| DUMPER prompt. If you want a list of the files, give the FILES
| command before the RESTORE command. You can restore the files to any
| directory. PS:<OPERATOR> is not required.
|
| <ESC> <ESC>
| ! !
|
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<OPERATOR><RET>
|
| DUMPER TAPE # 1, "DOCUMENTATION FILES FOR TOPS-20 V6"
| LOADING FILE(S) INTO PS:<OPERATOR>
|
| END OF SAVESET
| DUMPER>
|
| Error: If you do not see the message LOADING FILE(S) INTO
| PS:<OPERATOR>, no files are being restored from tape.
| Rewind the tape and try again. Be sure you have the correct
| tape mounted and the tape drive is on line. If problems
| persist, contact your DIGITAL Field Service Representative.
|
| You can list any of the files on the line printer by typing CTRL/C and
| giving the PRINT command. The files with file types .MEM, .BWR, .BD,
| .SD, .DOC, .TCO, and .PCO are the most useful to print. Return to
| DUMPER by giving the CONTINUE command and pressing the RETURN key
| twice. In the example, the user prints the file SOURCE.DIR:
|
| <CTRL/C>
| !
| DUMPER>^C
| $PRINT (FILES) SOURCE.DIR<RET>
| $CONTINUE<RET>
| <RET>
| DUMPER>
|
|
| Step 170: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO)
| PS:<SUBSYS>.
|
| To restore the binary files to PS:<SUBSYS>, type RESTORE and press the
| <ESC> key. The system prints (TAPE FILES). Type PS:. Press the
| <ESC> key. The system prints <*>*.*.* (TO). Type PS:<SUBSYS> and
| press the RETURN key. The system prints the header, followed by the
| DUMPER prompt:
|
| <ESC> <ESC>
| ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SUBSYS><RET>
|
| DUMPER TAPE # 1, <BINARY>, WEDNESDAY, 5-MAR-84 1743
| LOADING FILE(S) INTO PS:<SUBSYS>
|
| END OF SAVESET
| DUMPER>
6-6
INSTALLING TOPS-20 DISTRIBUTION AND UPDATE TAPES
| Step 171: Sources.
If you want to restore the source files for either the language or
GALAXY sources, give the same RESTORE command as in the last step; but
replace <SUBSYS> with the name of the directory where you want the
sources stored. Normally, the directories in the definition of the
system logical name SYS: do not contain source files, so you should
use the CTRL/E CREATE command to create appropriate directories for
the source files.
| Step 172: Dismount the Tape and Store It.
Remove the tape from the drive and store it in a safe place.
| Step 173: Go to Step 167 to Restore Other Software Products.
| Go back to Step 167 if you want to install other software products.
| Step 174: Give the DUMPER Command: EXIT.
Type EXIT and press the RETURN key to end DUMPER. Return to TOPS-20
command level:
DUMPER>EXIT<RET>
$
| Step 175: Give the Command: DEASSIGN (DEVICE) MTAn:.
Give the DEASSIGN command to release the magnetic tape for use by
other users. Type DEASSIGN and press the ESC key. The system prints
(DEVICE). Type MTAn: (or the number of the magnetic tape drive that
you are using) and press the RETURN key. The system prints the
TOPS-20 prompt:
ESC
!
$DEASSIGN (DEVICE) MTA0:<RET>
$
| Step 176: Proceed to Step 177 in Chapter 7.
6-7
7-1
CHAPTER 7
RUNNING THE TOPS-20 UETP PACKAGE
This chapter describes how to run the User Environment Test Package.
This program performs a cursory check of the system.
This program starts a number of tests that can run either once or
repeatedly. The source files are kept in the directory <UETP.LIB>,
while the temporary data files and results of the test are stored in
the directory <UETP.RUN>. For more information on UETP, refer to the
User Environment Test Package Reference Manual.
NOTE
If you performed the steps in Chapter 6 of this
| manual, you may skip Steps 177 through 179 and start
| at Step 180. You should perform all the steps in this
chapter on the operator's console terminal (CTY).
Otherwise, you must return to the CTY after completing
the steps in this chapter to resume control of the
system.
| Step 177: Type CTRL/C.
Type a CTRL/C to start a job.
| CTRL/C
|
| Installation-test System, TOPS-20 Monitor 6(nnnn)
| @
| Step 178: Give the Command: LOGIN (USER) OPERATOR (PASSWORD) Your
Password (ACCOUNT) OPERATOR and Press the RETURN Key.
From this terminal, log into the system as OPERATOR, using your
password and the account OPERATOR. Type LOGIN and press the ESC key.
The system prints (USER). Type OPERATOR and press the ESC key. The
system prints (PASSWORD). Type your password and press the ESC key.
The system prints (ACCOUNT). Type OPERATOR and press the RETURN key.
ESC ESC ESC
! ! !
@LOGIN (USER) OPERATOR (PASSWORD) your password (ACCOUNT) OPERATOR<RET>
JOB 6 ON TTY1 8-MAR-84 13:51
@
7-1
RUNNING THE TOPS-20 UETP PACKAGE
| Step 179: Give the Command: ENABLE (CAPABILITIES) and Press the
RETURN Key.
To enable your capabilities, type ENABLE and press the ESC key. The
system prints (CAPABILITIES). Press the RETURN key.
ESC
!
@ENABLE (CAPABILITIES)<RET>
$
| Step 180: Give the Command: TAKE (COMMANDS FROM) PS:<UETP.LIB>
| SET-UP.CMD and Press the RETURN Key.
To set up various subdirectories, type TAKE and press the ESC key.
The system prints (COMMANDS FROM). Type PS:<UETP.LIB>SET-UP.CMD and
press the RETURN key. This command file contains all the commands
necessary to create the subdirectories.
ESC
!
$TAKE (COMMANDS FROM) PS:<UETP.LIB>SET-UP.CMD<RET>
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
[NEW]
END OF <UETP.LIB>SET-UP.CMD.3
| Step 181: Give the Command: CONNECT (TO DIRECTORY) PS:<UETP.RUN> and
Press the RETURN Key.
To connect to the directory that has the standard tests, type CONNECT
and press the ESC key. The system prints (TO DIRECTORY). Type
PS:<UETP.RUN> and press the RETURN key.
ESC
!
$CONNECT (TO DIRECTORY) PS:<UETP.RUN><RET>
$
| Step 182: Give the Command: RUN (PROGRAM) UETP.EXE and Press the
RETURN Key.
To start the UETP program, type RUN and press the ESC key. The system
prints (PROGRAM). Type UETP.EXE and press the RETURN key. The system
prints the prompt UETP>.
ESC
!
$RUN (PROGRAM) UETP.EXE<RET>
[ 1-Nov-84 9:41:45 USER ENVIRONMENT TEST PACKAGE ]
UETP>
7-2
RUNNING THE TOPS-20 UETP PACKAGE
| Step 183: Load the Standard Verification Tests.
Type:
TAKE (COMMANDS FROM) VERIFY.CMD<RET>
This command causes the standard tests to be loaded and the first test
(VERIFY) to begin. The following messages are typed out:
UETP>ENABLE VERIFY/CYCLE:1 ! Verify that the correct software
[hh:mm:ss ENABLE COMPLETED]
UETP>BEGIN ! is installed
[hh:mm:ss BEGIN COMPLETED]
UETP>DEFAULT/CYCLE:00:15
[hh:mm:ss DEFAULT COMPLETED]
UETP>ENABLE RANCBL
[hh:mm:ss ENABLE COMPLETED]
UETP>ENABLE RANFOR
[hh:mm:ss ENABLE COMPLETED]
UETP>ENABLE MTA0
[hh:mm:ss ENABLE COMPLETED]
The field hh:mm:ss contains the time the message was generated.
Following these messages, the system prints the following status
information:
| [ 5-MAR-84 9:42:47]
Test Depth Status Cycle Times Error Error Start
name run count limit time
==== ===== ====== ===== ===== ===== ===== =====
VERIFY VER Queued 1 0 0 0 dd-mmm-yy hh:mm:ss
RANCBL VER Enabled 0:15 0 0 0
RANFOR VER Enabled 0:15 0 0 0
MTA0 VER Enabled 0:15 0 0 0
The next two messages you see are
START VERIFY 9:43:33
END VERIFY 10:14:53
The messages signify the beginning and ending of the test.
NOTE
If any messages appear between the start message and
the end message, there are errors in the files you
received. Do not proceed any further.
7-3
RUNNING THE TOPS-20 UETP PACKAGE
If the first test (VERIFY) finishes without error, go on to Step 185.
NOTE
In the following steps you should use a tape drive
that is not presently available to timesharing users.
If you have just completed the steps in Chapter 6 of
this manual, you can give the TOPS-20 ASSIGN command
| to assign the drive that you deassigned in Step 175.
| Otherwise, perform Steps 159 through 163 in Chapter 6
| before continuing with Step 184 below.
| Step 184: Mount a Magnetic Tape on the Drive You Want to Test.
Test MTA0 requires that a blank magnetic tape be mounted on drive 0.
Be sure that a write ring has been inserted in the tape and that the
drive is on line before you issue the BEGIN command.
NOTE
The standard tests include a random I/O COBOL test, a
random I/O FORTRAN test, and a magtape test for MTA0:.
If you want to test a tape drive other than drive 0,
you must enable the test for the selected drive. Type
ENABLE and press the ESC key. The system prints
(TEST). Type MTAn (n = the number of the drive, e.g.,
MTA1, MTA2) and press the RETURN key.
ESC
!
UETP>ENABLE (TEST) MTAn<RET>
| Step 185: Begin the Remaining Tests.
Type:
BEGIN<RET>
The system prints the following messages:
START RANCBL hh:mm:ss
START RANFOR hh:mm:ss
START MTA0 hh:mm:ss
END RANCBL hh:mm:ss
END RANFOR hh:mm:ss
END MTA0 hh:mm:ss
7-4
RUNNING THE TOPS-20 UETP PACKAGE
If messages other than those shown above appear, the tests generating
the messages have failed.
When all tests are completed, the following status information
appears:
[All tests complete on processor # 2102]
| [ 1-Nov-84 10:26:01]
Test Depth Status Cycle Times Error Error Start
name run count limit time
====== ===== ======= ===== ===== ===== ===== =====
VERIFY VER Ended 1 1 0 0 5-MAR-84 9:42:33
RANCBL VER Ended 0:15 1 0 0 5-MAR-84 10:15:46
RANFOR VER Ended 0:15 1 0 0 5-MAR-84 10:15:46
MTA0 VER Ended 0:15 1 0 0 5-MAR-84 10:15:46
NOTE
At this point you can either type an EXIT command to
terminate UETP, or begin the tests for the optional
| software. The following step (Step 186) shows how to
terminate UETP. If you want to test the optional
| software, you should skip Step 186 and proceed to Step
| 187.
| Step 186: Type EXIT<RET>.
UETP>EXIT<RET>
7.1 TESTING SOFTWARE
The steps in this section describe how to enable tests for optional
software products. Be sure to enable tests only for the optional
software products you have installed.
| Step 187: If You Have Installed BASIC-PLUS-2, Give the Command:
ENABLE (TEST) BASIC and Press the RETURN Key.
If you have installed BASIC-PLUS-2, type ENABLE and press the ESC key.
The system prints (TEST). Type BASIC and press the RETURN key.
ESC
!
UETP>ENABLE (TEST) BASIC<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
7-5
RUNNING THE TOPS-20 UETP PACKAGE
| Step 188: If You Have Installed ALGOL, Give the Command: ENABLE
(TEST) ALGOL and Press the RETURN Key.
If you have installed ALGOL-20, type ENABLE and press the ESC key.
The system prints (TEST). Type ALGOL and press the RETURN key.
ESC
!
UETP>ENABLE (TEST) ALGOL<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
| Step 189: If You Have Installed DBMS-20, Give the Command: ENABLE
(TEST) DBMS and Press the RETURN Key.
If you have installed DBMS-20, type ENABLE and press the ESC key. The
system prints (TEST). Type DBMS and press the RETURN key.
ESC
!
UETP>ENABLE (TEST) DBMS<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
| Step 190: If You Have Installed APL-20, Give the Command: ENABLE
(TEST) APL and Press the RETURN Key.
If you have installed APL-20, type ENABLE and press the ESC key. The
system prints (TEST). Type APL and press the RETURN key.
ESC
!
| UETP>ENABLE (TEST) APL<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
| Step 190A: If you have installed FORTRAN, Give the Command: ENABLE
(TEST) FORTRA and press the RETURN key.
If you have installed FORTRAN, type ENABLE and press the ESC key. The
system prints (TEST). Type FORTRA and press the RETURN key.
ESC
!
| UTEP>ENABLE (TEST) FORTRA<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
| Step 190B: If you have installed COBOL-68, Give the Command: ENABLE
| (TEST) COBOL and press the RETURN key.
If you have installed COBOL-68, type ENABLE and press the ESC key.
The system prints (TEST). Type COBOL and press the RETURN key.
ESC
!
UETP>ENABLE (TEST)COBOL<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
7-6
RUNNING THE TOPS-20 UETP PACKAGE
| Step 190C: If you have installed COBOL-74, Give the Command ENABLE
| (TEST) CBL74 and press the RETURN key.
If you have installed COBOL-74, type ENABLE and press the ESC key.
The system prints (TEST). Type CBL74 and press the RETURN key.
ESC
!
| UETP>ENABLE (TEST) CBL74<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
| Step 190D: If you have installed SORT-20, Give the Command ENABLE
(TEST) SORT and press the RETURN key.
If you have installed SORT-20, type ENABLE and press the ESC key. The
system prints (TEST). Type SORT and press the RETURN key.
| UETP>ENABLE (TEST) SORT<RET>
10:43:07 [ENABLE COMPLETED]
UETP>
| Step 191: Give the Command: BEGIN and Press the RETURN Key.
To begin the standard tests and all the optional software tests you
enabled, type BEGIN and press the RETURN key. The system starts all
the tests immediately.
UETP>BEGIN <RET>
10:45:17 [BEGIN COMPLETED]
UETP>
NOTE
Periodically give a STATUS command to find out which
tests are running and how many times they have been
run. The following is an example of the STATUS
command:
7-7
RUNNING THE TOPS-20 UETP PACKAGE
UETP>STATUS<RET>
| [1-Nov-84 11:02:05]
Test Depth Status Cycle Times Error Error Start
name run count limit time
====== ===== ======= ===== ===== ===== ===== =====
VERIFY VER Ended 1 1 0 0 5-MAR-84 10:42:20
RANCBL VER Running 0:15 0 0 0 5-MAR-84 10:59:27
RANFOR VER Queued 0:15 0 0 0 5-MAR-84 10:59:27
MTA0 VER Queued 0:15 0 0 0 5-MAR-84 10:59:27
UETP>
From the above example you can see that the RANCBL.SUP test is
running, the RANFOR.SUP and MTA0.SUP tests are in a wait state, and
the VERIFY.SUP test has ended.
If under the heading ERROR COUNT there is a number other than 0, be
sure to print the ERRORS.LOG file, when the tests are completed, to
find out what caused the error.
The UETP program does not notify you when all the tests are completed.
To find out when all the tests are completed, give a STATUS command.
When all the tests are completed, your output from the STATUS command
resembles the following:
STATUS<RET>
| [ 1-Nov-84 11:40:45]
Test Depth Status Cycle Times Error Error Start
name run count limit time
====== ===== ======= ===== ===== ===== ===== =====
VERIFY VER Ended 1 1 0 0 5-MAR-84 10:42:20
RANCBL VER Ended 0:15 1 0 0 5-MAR-84 10:59:27
RANFOR VER Ended 0:15 1 0 0 5-MAR-84 10:59:27
MTA0 VER Ended 0:15 1 0 0 5-MAR-84 10:59:27
| Step 192: Give the Command: EXIT and Press the RETURN Key.
To exit from the UETP program, type EXIT and press the RETURN key.
The system prints the TOPS-20 enabled prompt.
UETP>EXIT<RET>
$
Error: If you try to exit while there are tests still running, the
system prints the message %YOU STILL HAVE TESTS RUNNING.
"ABORT ALL" BEFORE EXITING. Wait until all the tests are
completed and then reissue the EXIT command.
7-8
RUNNING THE TOPS-20 UETP PACKAGE
| Step 193: Give the Command: TAKE (COMMANDS FROM) <UETP.LIB>
CLEAN-UP.CMD and Press the RETURN Key.
To delete the temporary directories, type TAKE and press the ESC key.
The system prints (COMMANDS FROM). Type <UETP.LIB>CLEAN-UP.CMD and
press the RETURN key. The system prints the word [OLD] for each
directory it has deleted.
<ESC>
!
$TAKE (COMMANDS FROM) <UETP.LIB>CLEAN-UP.CMD<RET>
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
[OLD]
End of <UETP.LIB>CLEAN-UP.CMD.3
NOTE
If you did not perform the steps in Chapter 6 before
proceeding to the steps in this chapter, you cannot
| return to the OPR program (Step 194). Instead,
| perform Steps 156 through 158 in Chapter 6 at this
| time. Then you can skip Step 194 and continue with
| Step 195, below.
| Step 194: Type POP.
To return the CTY to the OPR program, type POP. The system prints the
OPR prompt.
$POP<RET>
OPR>
| Step 195: Give the command: SET TAPE-DRIVE MTA0: AVAILABLE and
Press the RETURN key.
To return the tape drive you were using to the pool of available
resource, type SET TAPE-DRIVE MTA0: AVAILABLE and press the RETURN
key.
OPR>SET TAPE-DRIVE MTA0: AVAILABLE<RET>
OPR>
| Step 196: Start Timesharing.
7-9
A-1
APPENDIX A
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
| This appendix describes how to install Version 6.0 software on a
| DECSYSTEM-20 now running TOPS-20 Version 5.1 software.
As you update the system, enter the commands printed in red. The
system's replies are printed in black.
The updating procedures are divided into four sections. They are:
|
| o INSTALLING THE VERSION 6.0 SOFTWARE (Section A.1)
|
| o REVERTING TO VERSION 5.1 (Section A.2)
|
| o MAKING THE VERSION 6.0 MONITOR THE PRIMARY MONITOR (Section
| A.3)
|
| o MAKING THE VERSION 6.0 MONITOR THE PERMANENT MONITOR (Section
| A.4)
The steps in this Appendix assume you are using the CTY.
|
|
|
| A.1 INSTALLING THE VERSION 6.0 SOFTWARE
|
| To install the TOPS-20 Version 6.0 software, you need:
o System Floppy A
o System Floppy B
|
| o System Floppy C, which should be used for new installations
| only. If you are updating your software from a previous
| version, DO NOT USE Floppy C.
|
| o TOPS-20 Installation Tape V6.0
o RP20 Microcode Tape (RP20 only)
o A separate tape for each optional software product you have
purchased.
A-1
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 1: Log in to the System with OPERATOR or WHEEL Capabilities.
ESC ESC ESC
! ! !
@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account<RET>
NOTE
If you are using the OPR program at the CTY, you can
give the PUSH command to OPR instead of logging in
another job. The PUSH command to OPR puts you at
TOPS-20 command level. Below is an example of giving
the PUSH command to OPR at the CTY and performing Step
2:
OPR>PUSH<RET>
TOPS-20 Command processor 5.1(1640)
<ESC>
!
@INFORMATION (ABOUT) DISK-USAGE<RET>
n pages assigned
n Working pages, n Permanent pages allowed
n Pages free on PS:
@
Step 2: Give the Command: INFORMATION (ABOUT) DISK-USAGE and Press
the RETURN Key.
You must have enough disk space on your public structure (PS:) before
you can proceed. To find out how many free pages there are on PS:,
type INFORMATION and press the ESCAPE key. The system prints (ABOUT);
type DISK-USAGE and press the RETURN key. The system prints the
number of pages assigned to you and the number of free pages on PS:.
ESC
!
@INFORMATION (ABOUT) DISK-USAGE<RET>
The system prints
n pages assigned
n Working pages, n Permanent pages allowed
n Pages free on PS:
@
Where n = the number of pages
NOTE
The number of free pages on PS: must be at least 5000.
If you do not have at least this number of pages free,
you must dump some files to tape or delete and expunge
some files.
A-2
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 3: Give the Command: ENABLE (CAPABILITIES).
ESC
!
@ENABLE (CAPABILITIES)<RET>
Step 4: Give the Command: TAKE PS:<UETP.LIB>CLEAN-UP.CMD and Press
the RETURN Key.
To delete various directories created by the UETP program, type TAKE
PS:<UETP.LIB>CLEAN-UP.CMD and press the RETURN key.
$TAKE PS:<UETP.LIB>CLEAN-UP.CMD<RET>
$
Step 5: Give the Command: ^ECREATE (DIRECTORY NAME) PS:<UETP.LIB>
and Press the RETURN Key.
| Before you can load the Version 6.0 UETP program onto PS:, you must
| delete the Version 5.1 PS:<UETP.LIB> directory. Type CTRL/E CREATE
| and press the ESC key. The system prints (DIRECTORY NAME). Type
PS:<UETP.LIB> and press the ESC key. The system prints (PASSWORD).
Press the RETURN key.
CTRL/E ESC ESC
! ! !
$^ECREATE (DIRECTORY NAME) PS:<UETP.LIB> (PASSWORD)<RET>
[OLD]
$$
Step 6: Give the Command: KILL and Press the RETURN Key.
| To delete the Version 5.1 PS:<UETP.LIB> directory, type KILL and press
| the RETURN key. The system prints [CONFIRM].
$$KILL<RET>
[CONFIRM]
Step 7: Press the RETURN Key Twice.
To confirm you are deleting the directory PS:<UETP.LIB>, press the
RETURN key twice.
[CONFIRM]<RET>
$$<RET>
$
A-3
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 8: Kill Directories PS:<UETP.RUN> and PS:<UETP> in the Same
Manner.
<CTRL/E>
!
$^ECREATE PS:<UETP.RUN><RET>
[OLD]
$$KILL<RET>
[CONFIRM]<RET>
$$<RET>
<CTRL/E>
!
$^ECREATE PS:<UETP><RET>
[OLD]
$$KILL<RET>
[CONFIRM]<RET>
$$<RET>
$
Step 9: Give the Command: DELETE PS:<SPOOL>PRIMARY-MASTER-QUEUE-FILE
.QUASAR and Press the RETURN Key.
After allowing any pending jobs to complete or after sending messages
to their owners asking them to re-submit them later, you must delete
the master spooling file in preparation for the batch and spooling
(GALAXY) system. Type DELETE PS:<SPOOL>PRIMARY- and press the ESCAPE
key. The system prints MASTER-QUEUE-FILE.QUASAR.1 and gives a message
verifying the deletion.
<ESC>
!
$DELETE PS:<SPOOL>PRIMARY-MASTER-QUEUE-FILE.QUASAR<RET>
PS:<SPOOL>PRIMARY-MASTER-QUEUE-FILE.QUASAR.1 [OK]
$
NOTE
If you gave a PUSH command to OPR, at the CTY give a
POP command to return to OPR command level, and
perform Steps 11 through 14. Otherwise, perform Steps
10 through 14.
If you have tape drive allocation enabled, perform
Steps 10 through 13. Otherwise, continue at Step 15.
Step 10: Give the Command: OPR and Press the RETURN Key
To place yourself at OPR command level, type OPR and press the RETURN
key. The system prints the prompt OPR>.
$OPR<RET>
OPR>
A-4
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 11: Give the OPR Command: SHOW STATUS TAPE-DRIVES /ALL and
Press the RETURN Key
To find out what drives on the system are available to mount the
Installation Tape, give the OPR command SHOW STATUS TAPE-DRIVES /ALL.
The system prints the status of all tape drives on the system and then
prints the prompt OPR> again.
Any tape drive that has the status of "UNLOADED" can be used for
mounting the Installation tape.
<ESC> <ESC>
! !
OPR>SHOW STATUS TAPE-DRIVES /ALL<RET>
OPR>
10:13:09 --Tape Drive Status--
DRIVE STATE VOLID REQ# JOB# USER
----- ----- ----- ---- ---- ----
MTA0: Available
MTA1: Unloaded
AVR: Yes
MTA2: Unloaded
AVR: Yes
MTA3: Unloaded
AVR: Yes
MTA5: Unloaded
AVR: Yes
MTA6: Unavailable
MTA7: Unavailable
Step 12: Give the OPR Command: SET TAPE-DRIVE MTAn UNAVAILABLE and
Press the RETURN Key.
To mount the TOPS-20 Installation Tape, you should first make an
available tape drive unavailable to timesharing users. To do this,
give the OPR command SET TAPE-DRIVE MTAn UNAVAILABLE, and press the
RETURN key. The system prints Enter text and terminate with ^Z. Type
| Installing Version 6.0 Software and type a CTRL/Z. The system prints
the prompt OPR>.
The example uses MTA0: as the tape drive, but you can specify any
tape drive that is not in use at the moment.
<ESC> <ESC>
! !
OPR>SET TAPE-DRIVE MTA0: UNAVAILABLE<RET>
Enter text and terminate with ^Z
| Installing Version 6.0 Software <CTRL/Z>
OPR>
A-5
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 13: Give the OPR Command: PUSH and Press the RETURN Key.
To install the Version 6.0 software, you should be at TOPS-20 command
level. To place yourself at TOPS-20 Command level, type PUSH to OPR
and press the RETURN key. The system prints TOPS-20 command Processor
| 5.1(1640) and then the prompt @.
OPR>PUSH<RET>
| TOPS-20 Command Processor 5.1(1640)
@
Step 14: Give the Command: ENABLE (CAPABILITIES) and Press the
RETURN Command.
To enable your capabilities, type ENABLE and press the ESCAPE key.
The system prints (CAPABILITIES). Press the RETURN key. The system
prints the $ prompt.
<ESC>
!
@ENABLE (CAPABILITIES)<RET>
$
Step 15: Give the Command: ASSIGN (DEVICE) MTA0: and Press the
RETURN Key.
To assign tape drive 0 to your job, type ASSIGN and press the ESCAPE
key. The system prints (DEVICE). Type MTA0: and press the RETURN
key. The system prints the $ prompt.
<ESC>
!
$ASSIGN (DEVICE) MTA0:<RET>
$
Step 16: Mount the Installation Tape on MTA0: and Give the Following
Commands:
ESC
!
$REWIND (DEVICE) MTA0:<RET>
ESC
!
$SKIP (DEVICE) MTA0: 2 FILES<RET>
Step 17: Give the Command: RUN (PROGRAM) MTA0: and Press the RETURN
Key.
To run the DLUSER program from magnetic tape, type RUN and press the
ESCAPE key. The system prints (PROGRAM). Type MTA0: and press the
RETURN key. After the DLUSER program starts, the system prints the
DLUSER prompt.
ESC
!
$RUN (PROGRAM) MTA0:<RET>
DLUSER>
A-6
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Error: If you make a typing mistake, rewind the tape, skip two
files, and reissue the command above. The following example
shows how to do this when the Installation tape is on MTA0:.
ESC
!
$REWIND (DEVICE) MTA0:<RET>
ESC
!
$SKIP (DEVICE) MTA0: 2 FILES<RET>
ESC
!
$RUN (PROGRAM) MTA0:<RET>
DLUSER>
Step 18: Give the DLUSER Command: LOAD (FROM FILE) MTA0: and Press
the RETURN Key.
To load the parameters for the directories <UETP> and <SYSTEM-ERROR>
into the file system from the TOPS-20 Installation tape, type LOAD and
press the ESCAPE key. The system prints (FROM FILE). Type MTA0: and
press the RETURN key. After a few seconds, the system prints
DONE. and gives the DLUSER prompt.
ESC
!
DLUSER>LOAD (FROM FILE) MTA0:<RET>
The system prints
DONE.
DLUSER>
Step 19: Type EXIT and Press the RETURN Key.
Type EXIT and press the RETURN key to leave the DLUSER program. The
system prints the TOPS-20 enabled prompt.
DLUSER>EXIT<RET>
$
Step 20: Give the Command: RUN (PROGRAM) MTA0: and Press the RETURN
Key.
To run the DUMPER program, type RUN and press the ESCAPE key. The
system prints (PROGRAM). Type MTA0: and press the RETURN key. After
the DUMPER program starts, the system prints the DUMPER prompt.
ESC
!
$RUN (PROGRAM) MTA0:<RET>
The system prints
DUMPER>
A-7
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Error: If you receive any errors, rewind the tape, skip four files
and reissue the command above. The following example shows
how to do this for MTA0:. If errors still persist, contact
DIGITAL Software Support.
ESC
!
$REWIND (DEVICE) MTA0:<RET>
ESC
!
$SKIP (DEVICE) MTA0: 4 FILES<RET>
ESC
!
$RUN (PROGRAM) MTA0:<RET>
The system prints
DUMPER>
Step 21: Give the DUMPER Command: TAPE (DEVICE) MTA0: and Press the
RETURN Key.
To tell the DUMPER program which tape drive you are using, type TAPE
and press the ESC key. The system prints (DEVICE). Type MTA0: and
press the RETURN key. The system prints the DUMPER prompt.
ESC
!
DUMPER>TAPE (DEVICE) MTA0:<RET>
The system prints
DUMPER>
Step 22: Give the DUMPER Command: FILES and Press the RETURN Key.
To have the files being restored into the individual directories typed
on your terminal, type FILES and press the RETURN key. The system
prints the DUMPER prompt.
DUMPER>FILES<RET>
DUMPER>
Step 23: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO)
PS:<NEW-SYSTEM> and Press the RETURN Key.
To copy the TOPS-20 monitor and its related programs from the
Installation tape to your public structure, type RESTORE and press the
ESC key. The system prints (TAPE FILES). Type PS: and press the ESC
key. The system prints <*>*.*.* (TO). Type PS:<NEW-SYSTEM> and press
the RETURN key.
A-8
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
| This DUMPER command restores all the files in the first saveset to the
| directory PS:<NEW-SYSTEM>. When all the files are restored, the
| system prints the message END OF SAVESET and the DUMPER prompt.
|
| <ESC> <ESC>
| ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<NEW-SYSTEM><RET>
|
| Saveset "NEW-SYSTEM FOR Version V6.0"
| LOADING FILE(S) INTO PS:<NEW-SYSTEM>
|
| END OF SAVESET
| DUMPER>
|
|
| Step 24: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO)
| PS:<NEW-SUBSYS> and Press the RETURN Key.
|
| Restore the system program files to the directory PS:<NEW-SUBSYS>.
| Type RESTORE and press the <ESC> key. The system prints (TAPE FILES).
| Type PS: and press the <ESC> key. The system prints <*>*.*.* (TO).
| Type PS:<NEW-SUBSYS> and press the RETURN key. When all the files are
| restored, the system prints the message END OF SAVESET and the DUMPER
| prompt.
|
| <ESC> <ESC>
| ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<NEW-SUBSYS><RET>
|
| Saveset "SUBSYS FILES FOR TOPS-20 V6.0"
| LOADING FILE(S) INTO PS:<NEW-SUBSYS>
|
| END OF SAVESET
| DUMPER>
|
|
| Step 25: Give the DUMPER Command:RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<NEW-SUBSYS>*.*.*
|
| To restore the GALAXY files into the directory PS:<NEW-SUBSYS>, type
| RESTORE and press the <ESC> key. The system prints (TAPE FILES).
| Type PS: and press the <ESC> key. The system prints <*>*.*.* (TO).
| Type PS:<NEW-SUB and press the <ESC> key. The system prints
| SYS>*.*.*. Press the RETURN key. When all the files are restored,
| the system prints END OF SAVESET and the DUMPER prompt.
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<NEW-SUBSYS>*.*.*<RET>
| Saveset "GALAXY NEW-SUBSYS FILES FOR TOPS-20 V6.0"
| Loading file(s) into PS:<NEW-SUBSYS>
|
| End of SAVESET
| DUMPER>
A-9
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
| Step 26: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<UETP.LIB>*.*.* and Press the RETURN Key.
|
| To restore the files for the User Environment Test Package, type
| RESTORE and press the <ESC> key. The system prints (TAPE FILES).
| Type PS: and press the <ESC> key. The system prints <*>*.*.* (TO).
| Type PS:<UETP.LIB> and press the <ESC> key. The system prints *.*.*.
| Press the RETURN key. When all the files are restored, the system
| prints END OF SAVESET and the DUMPER prompt.
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<UETP.LIB>*.*.*<RET>
|
| Saveset "UETP FILES FOR TOPS-20 V6.0"
| LOADING FILE(S) INTO PS:<UETP.LIB>
|
| END OF SAVESET
| DUMPER>
|
| NOTE
|
| If you have an RP20 disk system, perform the
| procedures in Steps 27 to 29. Otherwise, continue the
| installation process at Step 30.
|
|
| Step 27: Give the DUMPER Command: UNLOAD and Press the RETURN Key.
|
| To unload the Version 6 Installation Tape from the tape drive, give
| the DUMPER command UNLOAD and press the ESCAPE key. The system prints
| (DEVICE). Type MTA0: and press the RETURN key. The system rewinds
| and unloads the tape from the drive.
|
| DUMPER>UNLOAD<RET>
|
| DUMPER>
|
|
| Step 28: Dismount the Installation Tape and Mount the RP20 Microcode
| Tape.
|
|
| Step 29: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.*
| (TO) PS:<NEW-SUBSYS> and Press the RETURN Key.
|
| After you have mounted the RP20 Microcode Tape on MTA0, give the
| DUMPER command. RESTORE and press the <ESC> key. The system prints
| (TAPE FILES). Type PS: and press the <ESC> key. The system prints
| <*>*.*.*. (TO). Type PS:<NEW-SUBSYS> and press the <ESC> key. The
| system prints *.*.*. Press the RETURN key. After all the file(s) are
| restored, the system prints END OF SAVESET and then the DUMPER prompt.
|
| <ESC> <ESC> <ESC>
| ! ! !
| DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<NEW-SUBSYS>*.*.*<RET>
|
| Saveset "RP20 MICROCODE FOR Version V6.0"
| LOADING FILE(S) INTO PS:<NEW-SUBSYS>
|
| END OF SAVESET
| DUMPER>
A-10
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 30: Give the DUMPER Command: EXIT and Press the RETURN Key.
To terminate the DUMPER program and return to the TOPS-20 command
level, type EXIT and press the RETURN key.
DUMPER>EXIT<RET>
$
Step 31: Give the Command: UNLOAD (DEVICE) MTA0: and Press the
RETURN Key.
To rewind and unload the tape on MTA0:, type UNLOAD and press the ESC
key. The system prints (DEVICE). Type MTA0: and press the RETURN
key.
ESC
!
$UNLOAD (DEVICE) MTA0:<RET>
$
Step 32: Give the Command: DEASSIGN (DEVICE) MTA0: and Press the
RETURN Key.
To remove the device MTA0: from your job, type DEASSIGN and press the
ESC key. The system prints (DEVICE). Type MTA0: and press the
RETURN key. The system prints the $ prompt.
<ESC>
!
$DEASSIGN (DEVICE) MTA0:<RET>
$
NOTE
If you performed Step 12, which removed a tape drive
from system's usage, perform Steps 33 through 36.
Otherwise, continue at Step 37.
Step 33: Give the Command: POP and Press the RETURN Key.
To return to OPR command level, type POP and press the RETURN key.
The system prints the prompt OPR>
$POP<RET>
OPR>
Step 34: Give the OPR Command: SET TAPE-DRIVE MTAn: AVAILABLE and
Press the RETURN Key.
To return the tape drive you removed from system usage in Step 12,
give the OPR command SET TAPE-DRIVE MTAn: AVAILABLE and press the
RETURN key. MTA0: is used in the example:
OPR>SET TAPE-DRIVE MTA0: AVAILABLE<RET>
A-11
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 35: Give the OPR Command: PUSH and Press the RETURN Key.
To return to TOPS-20 command level and continue the installation
procedures, type PUSH and press the RETURN Key. The system prints the
Command Processor's Version number and the @ prompt.
OPR>PUSH<RET>
| TOPS-20 Command Processor 5.1(1640)
@
Step 36: Give the Command: ENABLE (CAPABILITIES) and Press the
Return Key.
To enable your capabilities, type ENABLE and press the ESC key. The
system prints (CAPABILITIES). Press the RETURN key. The system
prints the $ prompt.
<ESC>
!
@ENABLE (CAPABILITIES)<RET>
$
|
|
|
| A.1.1 Renaming the Version 5.1 Monitor
|
| In case you ever need to revert to the Version 5.1 monitor, you must
| rename it before copying the Version 6.0 monitor into
<SYSTEM>MONITR.EXE.
Step 37: Give the Command: RENAME (EXISTING FILE)
| PS:<SYSTEM>MONITR.EXE (TO) PS:<SYSTEM>5.1-MONITR.EXE and
| Press the RETURN Key.
| To rename and save the Version 5.1 monitor, type RENAME and press the
ESC key. The system prints (EXISTING FILE). Type
PS:<SYSTEM>MONITR.EXE and press the ESC key. The system prints (TO
| BE). Type PS:<SYSTEM>5-1-MONITR.EXE and press the RETURN key. When
| the rename is successfully completed, the system prints a message
specifying that the file was renamed correctly.
ESC ESC
! !
$RENAME (EXISTING FILE) PS:<SYSTEM>MONITR.EXE (TO BE)
| PS:<SYSTEM>5-1-MONITR.EXE<RET>
| <SYSTEM>MONITR.EXE.1 => <SYSTEM>5-1-MONITR.EXE.1 [OK]
$
A-12
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 38: Give the Command: COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE
(TO) PS:<SYSTEM>MONITR.EXE and Press the RETURN Key.
| To copy the Version 6.0 monitor into PS:<SYSTEM>, type COPY and press
the ESC key. The system prints (FROM). Type
PS:<NEW-SYSTEM>montyp.EXE and press the ESC key. (Montyp designates
the type of monitor you have selected for your system, for example
2060-MONBIG; refer to Chapter 2, Section 2.3 of this manual for
information about choosing a monitor for your system.) The system
prints (TO). Type PS:<SYSTEM>MONITR.EXE and press the RETURN key.
When the copy is successfully completed, the system prints a message
specifying that the file was copied correctly.
ESC ESC
! !
$COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE (TO) PS:<SYSTEM>MONITR.EXE<RET>
<NEW-SYSTEM>montyp.EXE. => <SYSTEM>MONITR.EXE.1 [OK]
$
|
|
| Step 38A: Give the Command: COPY (FROM) PS:<NEW-SYSTEM> IPALOD.EXE
| (TO) PS:<SYSTEM>IPALOD.EXE and Press the RETURN Key.
|
| The file IPALOD.EXE must be in the directory <SYSTEM> in order for the
| CI-20 microcode to be loaded properly in Step 55 of this Appendix. To
| do this, type COPY and press the <ESC> key. The system prints (FROM).
| Type PS:<NEW-SYSTEM>IPALOD.EXE and press the <ESC> key. The system
| prints (TO). Type PS:<SYSTEM>IPALOD.EXE and press the RETURN key.
| When the copy is successfully completed, the system prints a message
| specifying that the file was copied correctly.
|
| <ESC> <ESC>
| ! !
| $COPY (FROM) PS:<NEW-SYSTEM>IPALOD.EXE (TO) PS:<SYSTEM>IPALOD.EXE<RET>
|
| <NEW-SYSTEM>IPALOD.EXE.n => <SYSTEM>IPALOD.EXE.n [OK]
|
|
|
| A.1.2 Creating the File <NEW-SYSTEM>6-CONFIG.CMD
|
| You must create the file <NEW-SYSTEM>6-CONFIG.CMD to declare system
| parameters. Before performiing the next step, be sure you are
| connected to system.
| Step 39: Give the Command: EDIT (FILE) PS:<SYSTEM>5-1-CONFIG.CMD.1
| (OUTPUT AS) PS:<NEW-SYSTEM>6-CONFIG.CMD.
| To edit PS:<SYSTEM>5-1-CONFIG.CMD and have the changes placed in
| PS:<NEW-SYSTEM>6-CONFIG.CMD, type EDIT and press the ESC key. The
| system prints (FILE). Type PS:<SYSTEM>5-1-CONFIG.CMD and press the
| ESC key. The system prints the generation number of that file and
| (OUTPUT AS). Type PS:<NEW-SYSTEM>6-CONFIG.CMD and press the RETURN
| key. The system prints: EDIT: <SYSTEM>5-1-CONFIG.CMD and the EDIT
| prompt.
ESC ESC
! !
$EDIT (FILE) PS:<SYSTEM>5-1-CONFIG.CMD.1 (OUTPUT AS)
| PS:<NEW-SYSTEM>6-CONFIG.CMD<RET>
A-13
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
The system prints
| EDIT: <SYSTEM>5-1-CONFIG.CMD.1
|
| *
Step 40: Give the Edit Command: P^:* and Press the RETURN Key.
To print the contents of PS:<SYSTEM>5-1-CONFIG.CMD, type P^:* and
| press the RETURN key. The system prints the entire 5-1-CONFIG.CMD
| file and then the EDIT prompt.
| EDIT: <SYSTEM>5-1CONFIG.CMD.1
*P^:*<RET>
A-14
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
A.1.3 Changing System Parameters
Read Chapter 3 of this manual (Tailoring the System), and make any
changes to the system parameters that are necessary. Three parameters
that must be added are the definitions for the logical names SYS:,
| SYSTEM:, and SERR:. Add the following commands to the 6-CONFIG.CMD
file.
DEFINE SYS: PS:<NEW-SUBSYS>,PS:<SUBSYS><RET>
DEFINE SYSTEM: PS:<NEW-SYSTEM>, PS:<SYSTEM><RET>
NOTE
| When you are making a change to existing lines of the
| 5-1-CONFIG.CMD file, use the EDIT command R line
number. Any changes made to the system parameters are
| made only in <NEW-SYSTEM>6-CONFIG.CMD. The file
| <SYSTEM>5-1-CONFIG.CMD remains the same.
Step 41: Press the ESC Key, Type EU and Press the RETURN Key.
After you make all the necessary changes to the system parameters,
press the ESC key, type EU, and press the RETURN key. This command
ends the EDIT program and saves the file. The system prints the name
of the output file.
*EU<RET>
| [<NEW-SYSTEM>6-CONFIG.CMD.1]
NOTE
| Before bringing up the system under Version 6, you
| should check the Version 6 PTYCON.ATO file against the
| Version 5.1 PTYCON.ATO file. You do not have to
| compare these files if you have not changed the
| Version 5.1 file. However, if you have made your own
changes to the Version 5.1 PTYCON.ATO file and you
| wish those changes to exist under Version 6.0, you
| must add the changes to the Version 6.0 PTYCON.ATO.
A.1.4 Setting a User Group for the Operator
You must be certain that the operator is a member of user group 100.
Do so by giving the following command.
A-15
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 42: Give the Command: ^ECREATE (DIRECTORY NAME) PS:<OPERATOR>
and Press the RETURN Key.
Type CTRL/E CREATE and press the ESC key. The system prints
(DIRECTORY NAME). Type PS:<OPERATOR> and press the RETURN key. The
system prints [Old], then the subcommand prompt.
CTRL/E ESC
! !
$^ECREATE (DIRECTORY NAME) PS:<OPERATOR><RET>
[Old]
$$
Step 43: Type USER 100 and Press the Return Key.
At the subcommand prompt type USER, press the space bar, then type
100. Press the RETURN key.
$$USER 100<RET>
$$
| Step 43A: Give the subcommand: IPCF and Press the RETURN key.
|
| $$IPCF<RET>
| $$
Step 44: Press the RETURN Key.
To exit from the subcommand level, press the RETURN key.
$$<RET>
$
Step 45: Give the Command: ^ECEASE (TIMESHARING AT) +1 (RESUMING AT)
Date and Time and Press the RETURN Key.
To bring the system down, type CTRL/E CEASE and press the ESC key.
The system prints (TIMESHARING AT). Type +1 and press the ESC key.
The system prints (RESUMING AT). Type the date and time and press the
RETURN key.
CTRL/E ESC ESC
! ! !
$^ECEASE (TIMESHARING AT) +1 (RESUMING AT) date and time<RET>
System shutdown scheduled for 2-MAR-84 13:47:00,
System going down in one minute!!
System down, up again at 2-MAR-84 13:48:00
Shutdown complete
NOTE
Wait for the system to print Shutdown complete.
A-16
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 46: Type CTRL/\.
At the console terminal, type CTRL/\ to return to the front-end
Command Parser. When you are at Command Parser command level, the
system prints the prompt PAR>.
Shutdown complete
CTRL/\
PAR>
Step 47: Type SHUTDOWN and Press the RETURN Key.
To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key.
The system prints a list of messages.
PAR>SHUTDOWN<RET>
** HALTED **
%DECSYSTEM-20 NOT RUNNING
Step 48: Type CTRL/\.
Type CTRL/\ to return to the front-end Command Parser. Because the
system is not running now, you will see the prompt PAR%. If you see
the prompt PAR> instead, go back to Step 46.
CTRL/\
PAR%
Step 49: Type MCR PIP and Press the RETURN Key.
To load the PIP program and start it, type MCR PIP and press the
RETURN key. After 1 second, PIP is ready for you to type commands.
The system prints the prompt PIP>:
PAR%MCR PIP<RET>
PIP>
Step 50: Type KL.CFG;*/DE and Press the RETURN Key.
You must delete any existing front-end configuration file from your
| front-end file system before bringing up the Version 5.1 front-end
monitor.
PIP>KL.CFG;*/DE<RET>
PIP>
NOTE
If the system prints PIP -- NO SUCH FILE(S), then you
did not have a front-end configuration file in your
front-end file system. Proceed with Step 51.
A-17
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 51: Type CTRL/Z and CTRL/\.
To end PIP and return to the front-end Command Parser, type CTRL/Z
followed by CTRL/\.
CTRL/Z
!
PIP>^Z
CTRL/\
PAR%
| Step 52: Mount Version 6.0 System Floppy A in Floppy Drive 0 and
| Version 6.0 System Floppy B in Floppy Drive 1.
Step 53: Set the Switch Register to 000007 (Switches 0, 1, and 2 Up),
and Press the ENABLE and SWITCH-REGISTER Buttons
Simultaneously.
| To bring up the Version 6 front-end file system, press the ENABLE and
SWITCH-REGISTER buttons simultaneously. The system prints:
| RSX-20F VB15-20 6:11 5-MAR-84
[SY0: REDIRECTED TO DX0:]
[DX0: MOUNTED]
[DX1: MOUNTED]
| KLI -- Version VB15-12 RUNNING
KLI -- KL10 S/N:2102., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE ENVIRONMENT:
MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KL1 -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>
Step 54: Type NO and Press the RETURN Key.
To tell the front-end monitor that you want it to take default answers
to dialog questions, type NO and press the RETURN key. The front end
prints messages as the system is reloaded, and the bootstrap program
gives the BOOT> prompt.
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>NO<RET>
| KLI -- MICROCODE Version 352 LOADED
KLI -- % NO FILE - ALL MEMORY BEING CONFIGURED
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00400000 768K 4 MF20 11
KLI -- % NO FILE - LOADING BOOTSTRAP
KLI -- CONFIGURATION FILE ALTERED
KLI -- BOOTSTRAP LOADED AND STARTED
BOOT V10.0(167)
[BOOT:LOADING] [OK]
BOOT>
A-18
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 55: Press the RETURN Key.
To tell the bootstrap program to restart the system, press the RETURN
key. The system prints [PS MOUNTED] and System restarting,
wait... before prompting for the date and time.
BOOT><RET>
[PS MOUNTED]
System restarting, wait...
ENTER CURRENT DATE AND TIME:
Step 56: Type the Date and Time, Then Press the RETURN Key.
After the prompt, type the date and time in the format day-month-year
hhmm. Then press the RETURN key.
ENTER CURRENT DATE AND TIME: 5-MAR-84 1112<RET>
The system prints
YOU HAVE ENTERED WEDNESDAY, 5-MARCH-84 11:12AM, IS THIS CORRECT
(Y,N)
Step 57: Type Y or N and Press the RETURN Key.
If you have entered the correct date and time, type Y and press the
RETURN key. Otherwise, type N and press the RETURN key. The system
will ask for the date and time again.
IS THIS CORRECT (Y,N) Y<RET>
The system prints
WHY RELOAD?
| Step 58: Type NEW and Press the RETURN Key.
|
| WHY RELOAD? NEW<RET>
The system prints
<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED
RUN CHECKD?
NOTE
The system prints the message SYSTEM ACCOUNTS
TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED
because the ACTGEN program has not been run. (Refer
to Chapter 6 of the TOPS-20 System Manager's Guide for
more information.)
A-19
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 59: Type N and Press the RETURN Key.
The CHECKD program examines the entire disk file system, reports any
errors, and tries to correct the errors. You do not have to run the
program unless the system crashes unexpectedly or you suspect that
there may be disk errors. Type N and press the RETURN key. The
system runs the DDMP program. The DDMP program is a background task
that moves pages from the disk swapping area to the disk file system.
RUN CHECKD? N<RET>
RUNNING DDMP
SYSJOB 6(10) STARTED AT 5-MAR-84 1112
RUN SYS:ORION
RUN SYS:QUASAR
*****
5-MAR-84 11:12:09 - TGHA V2(6) IS RUNNING FOR THE FIRST TIME.
*****
RUN SYS:MOUNTR
RUN SYS:INFO
RUN SYS:MAILER
RUN SYS:MAPPER
RUN SYS:LPTSPL
RUN SYS:CDRIVE
RUN SYS:SPRINT
JOB O /LOG OPERATOR XX OPERATOR
ENA
^ESET LOGIN PSEUDO
^ESET LOGIN CONSOLE
^ESET OPERATOR
PTYCON
GET SYSTEM:PTYCON.ATO
/
JOB 1 /LOG OPERATOR XX OPERATOR
ENA
RUN SYS:BATCON
/
SJ 0:
| SJ 0: 3/5-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 6(5050)
SJ 1:
| SJ 1: 3/5-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 6(5050)
SJ 0: @LOG OPERATOR OPERATOR
SJ 1: @LOG OPERATOR OPERATOR
SJ 0: JOB 1 ON TTY206 5-MAR-84 11:12:22
SJ 0: @ENA
SJ 0: $^ESET LOGIN PSEUDO
SJ 0: $^ESET LOGIN CONSOLE
SJ 0: $^ESET OPERATOR
SJ 0: $PTYCON
SJ 1: JOB 2 ON TTY207 5-MAR-84 11:12:23
SJ 1: @ENA
SJ 0: PTYCON> GET SYSTEM:PTYCON.ATO
SJ 0: PTYCON> SILENCE
SJ 1: $RUN SYS:BATCON
[From OPERATOR on line 210: SYSTEM IN OPERATION]
SJ 0: PTYCON.LOG.1
SJ 0: PTYCON> W ALL
SJ 0: OPR(0) 3 OPERATOR OPR TI 0:0:1
SJ 0: PTYCON> CONN OPR
SJ 0: [CONNECTED TO SUBJOB OPR(0)]
A-20
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
| A.2 REVERTING TO VERSION 5.1
|
| If you must revert to running the TOPS-20 Version 5.1 software, follow
the steps in this section. If you want the UETP files when you revert
to Version 5.1, you must restore the UETP files from either the
| Version 5.1 Installation Tape or the latest backup tape.
Step 1: Log In to the System with OPERATOR or WHEEL Capabilities.
ESC ESC ESC
! ! !
@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account<RET>
@
Step 2: Give the Command: ENABLE (CAPABILITIES) and Press the RETURN
Key.
To perform the next step you must enable your capabilities. Type
ENABLE and press the ESC key. The system prints (CAPABILITIES).
Press the RETURN key.
ESC
!
@ENABLE (CAPABILITIES)<RET>
$
A-21
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 3: Give the Command: RENAME (EXISTING FILES)
| PS:<SYSTEM>5-1-MONITR.EXE (TO BE) PS:<SYSTEM>MONITR.EXE and
Press the RETURN Key.
| In Section A.1.1, you renamed the Version 5.1 monitor to
| PS:<SYSTEM>5-1-MONITR.EXE. If you are reverting to Version 5.1, you
| must put this monitor back into PS:<SYSTEM>MONITR.EXE. Type RENAME
and press the ESC key. The system prints (EXISTING FILE). Type
| PS:<SYSTEM>5-1-MONITR.EXE and press the ESC key. The system prints
| the generation number and (TO BE). Type PS:<SYSTEM>MONITR.EXE and
press the RETURN key. When the rename has been successfully executed,
the system prints a message specifying that the file has been renamed
correctly.
ESC ESC
! !
| $RENAME (EXISTING FILE) PS:<SYSTEM>5-1-MONITR.EXE (TO BE)
PS:<SYSTEM>MONITR.EXE<RET>
| <SYSTEM>5-1-MONITR.EXE.1=> <SYSTEM>MONITR.EXE [OK]
NOTE
| Before reverting to Version 5-1, examine the
| PS:<SYSTEM>5-1-CONFIG.CMD file. Be sure it contains a
definition of logical name SYSTEM:, and that this
definition does not include the directory,
PS:<NEW-SYSTEM>. If it does include the directory,
| PS:<NEW-SYSTEM>, when you revert to Version 5-1 the
| Version 5-1 monitor attempts to operate programs that
| do not function properly in a Version 5-1 system. If
| the PS:<SYSTEM>5-1-CONFIG.CMD file does not contain a
definition of logical name SYSTEM:, insert the
following command into the file:
DEFINE SYSTEM: PS:<SYSTEM>
| Step 3A: Give the Command: DELETE PS:<SPOOL>
| PRIMARY-MASTER-QUEUE-FILE.QUASAR and Press the RETURN key.
|
| Before reverting to the old GALAXY system, you must delete the master
| spooling file. Type DELETE PS:<SPOOL>PRIMARY- and press the ESCAPE
| key. The system prints MASTER-QUEUE-FILE.QUASAR.1 and gives a message
| verifying the deletion.
|
| <ESC>
| !
| $DELETE PS:<SPOOL>PRIMARY-MASTER-QUEUE-FILE.QUASAR<RET>
| PS:<SPOOL>PRIMARY-MASTER-QUEUE-FILE.QUASAR.1 [OK]
| $
A-22
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 4: Give the Command: ^ECEASE (TIMESHARING AT) Date and Time
(RESUMING AT) Date and Time and Press the RETURN Key.
To bring the system down, type CTRL/E CEASE and press the ESC key.
The system prints (TIMESHARING AT). Type the date and time and press
the ESC key. The system prints (RESUMING AT). Type the date and time
you want timesharing to start again and press the RETURN key. The
system prints a list of messages; the last message is Shutdown
complete.
CTRL/E ESC ESC
! ! !
$^ECEASE (TIMESHARING AT) date and time (RESUMING AT) date and time<RET>
Shutdown complete
Step 5: Type CTRL/\.
At the console terminal, type CTRL/\ to return to the front-end
Command Parser. When you are at Command Parser command level, the
system prints the prompt PAR>.
CTRL/\
PAR>
Step 6: Type SHUTDOWN and Press the RETURN Key.
To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key.
The system prints a list of messages.
PAR>SHUTDOWN<RET>
** HALTED **
%DECSYSTEM-20 NOT RUNNING
| Step 7: Reload the Version 5.1 Monitor Using the Version 5.1 Floppies
| or the Version 5.1 Disk.
|
| To reload the Version 5.1 monitor using the Version 5.1 floppies,
| mount System Floppy A in floppy drive 0, press the ENABLE and FLOPPY
buttons simultaneously, and answer the usual start-up questions.
| To reload the Version 5.1 monitor using the Version 5.1 disk, press
| the ENABLE and DISK buttons simultaneously, and answer the usual
start-up questions.
NOTE
| You can reload the Version 5.1 monitor from disk only
| if the Version 5.1 front-end software is still on the
disk.
A-23
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
| A.3 MAKING THE VERSION 6.0 MONITOR THE PRIMARY MONITOR
|
| In case you are presently using the Version 5-1 monitor, you must
| rename it in Step 4, below, before copying the Version 6.0 monitor
| into <SYSTEM>MONITR.EXE.
Step 1: Log in to the System with OPERATOR or WHEEL Capabilities.
ESC ESC ESC
! ! !
@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account<RET>
@
Step 2: Give the Command: ENABLE (CAPABILITIES) and Press the RETURN
Key.
To perform the next few steps you must enable your capabilities. Type
ENABLE and press the ESC key. The system prints (CAPABILITIES).
Press the RETURN key.
ESC
!
@ENABLE (CAPABILITIES)<RET>
$
Step 3: STOP.
| Proceed with Step 4 if you have reverted to a Version 5.1 system, and
| your present monitor is a Version 5.1 monitor. You must rename this
| monitor in Step 4 in case you ever need to revert to Version 5.1
| again.
|
| Skip to Step 6 if your present monitor is a Version 6.0 monitor. You
do not need to rename your present monitor in Step 4. This action was
already performed in Section A.1.1, Step 37.
Step 4: Give the Command: RENAME (EXISTING FILE)
| PS:<SYSTEM>MONITR.EXE (TO BE) PS:<SYSTEM>5-MONITR.EXE and
Press the RETURN Key.
| To rename and save the Version 5.1 monitor, type RENAME and press the
ESC key. The system prints (EXISTING FILE). Type
PS:<SYSTEM>MONITR.EXE and press the ESC key. The system prints (TO
| BE). Type PS:<SYSTEM>5-1-MONITR.EXE. When the Version 5.1 monitor is
successfully renamed, the system prints a message specifying that the
file has been renamed correctly. Continue with Step 5.1.
ESC ESC
! !
$RENAME (EXISTING FILE) PS:<SYSTEM>MONITR.EXE (TO BE)
| PS:<SYSTEM>5-1-MONITR.EXE<RET>
| <SYSTEM>MONITR.EXE.1 => <SYSTEM>5-1-MONITR.EXE.1 [OK]
$
A-24
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 5: Give the Command: COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE (TO)
PS:<SYSTEM> MONITR.EXE and Press the RETURN Key.
| To copy the Version 6.0 monitor into PS:<SYSTEM>, type COPY and press
the ESC key. The system prints (FROM). Type PS:<NEW-SYSTEM>
montyp.EXE and press the ESC key. (Montyp designates the type of
monitor you have selected for your system.) The system prints (TO).
Type PS:<SYSTEM>MONITR.EXE and press the RETURN key. When the copy is
successfully completed, the system prints a message specifying that
the file was copied correctly.
ESC ESC
! !
$COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE (TO) PS:<SYSTEM>MONITR.EXE<RET>
<NEW-SYSTEM>montyp.EXE. => <SYSTEM>MONITR.EXE.1 [OK]
Step 6: Give the Command: ^ECEASE (TIMESHARING AT) Date and Time
(RESUMING AT) Date and Time and Press the RETURN key.
Shut down the system by typing CTRL/E CEASE and pressing the ESC key.
The system prints (TIMESHARING AT). Type the date and time you want
timesharing to cease and press the ESC key. The system prints
(RESUMING AT). Type the date and time you want timesharing to start
again and press the RETURN key.
CTRL/E ESC ESC
! ! !
$^ECEASE (TIMESHARING AT) date and time (RESUMING AT)
date and time<RET>
| Step 7: Put the Version 6.0 Front-End Software on Disk.
| Start at Step 112 of this manual to put the Version 6.0 front-end
software on disk.
NOTE
| When the Version 6.0 front-end software is put on
| disk, the Version 5.1 front end is destroyed. In
| order to use the Version 5.1 front-end software again,
| you must reinstall it using the Version 5.1 floppies.
|
|
|
| A.4 MAKING THE VERSION 6.0 MONITOR THE PERMANENT MONITOR
|
The steps in this section should be performed when you feel
| comfortable with the Version 6.0 software.
Step 1: Log In to the System with OPERATOR or WHEEL Capabilities.
ESC ESC ESC
! ! !
@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account<RET>
@
A-25
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 2: Give the Command: ENABLE (CAPABILITIES) and Press the RETURN
Key.
To perform the next step you must enable your capabilities. Type
ENABLE and press the ESC key. The system prints (CAPABILITIES).
Press the RETURN key.
ESC
!
@ENABLE (CAPABILITIES)<RET>
Step 3: Give the Command: COPY (FROM) PS:<NEW-SYSTEM>*.* (TO)
PS:<SYSTEM>*.* and Press the RETURN Key.
To copy the directory <NEW-SYSTEM> to <SYSTEM>, type COPY and press
the ESC key. The system prints (FROM). Type PS:<NEW-SYSTEM>*.* and
| press the ESC key. The system prints (TO). Type PS:<SYSTEM> and
| press the ESC key. The system prints *.*. Press the RETURN key. The
system prints a message specifying that each file has been copied
correctly.
| ESC ESC ESC
| ! ! !
| $COPY (FROM) PS:<NEW-SYSTEM>*.* (TO) PS:<SYSTEM>*.*<RET>
Step 4: Give the Command: COPY (FROM) PS:<NEW-SUBSYS>*.* (TO)
PS:<SUBSYS> and Press the RETURN Key.
To copy the directory <NEW-SUBSYS> to <SUBSYS>, type COPY and press
the ESC key. The system prints (FROM). Type PS:<NEW-SUBSYS>*.* and
press the ESC key. The system prints (TO). Type PS:<SUB and press
the ESC key. The system prints SYS>*.*. Press the RETURN key. The
system prints a message specifying that each file has been copied
correctly.
ESC ESC
! !
$COPY (FROM) PS:<NEW-SUBSYS>*.* (TO) PS:<SUBSYS>*.*<RET>
Step 5: Give the Command: CONNECT (TO DIRECTORY) PS:<SYSTEM> and
Press the RETURN Key.
Connect to the directory PS:<SYSTEM> by typing CONNECT and pressing
the ESC key. The system prints (TO DIRECTORY). Type PS:<SYSTEM> and
press the RETURN key.
ESC
!
$CONNECT (TO DIRECTORY) PS:<SYSTEM><RET>
$
A-26
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
| Step 6: Give the Command: EDIT (FILE) PS:<SYSTEM>6-CONFIG.CMD and
Press the RETURN Key.
| To edit the 6-CONFIG.CMD file, type EDIT and press the ESC key. The
| system prints (FILE). Type PS:<SYSTEM>6-CONFIG.CMD and press the
RETURN key.
ESC
!
| $EDIT (FILE) PS:<SYSTEM>6-CONFIG.CMD<RET>
The system prints:
| EDIT: 6-CONFIG.CMD
*
Step 7: Give the EDIT Command: P^:* and Press the RETURN Key.
| To print the entire 6-CONFIG.CMD file, type P^:* and press the RETURN
key.
*P^:*<RET>
Step 8: Give the EDIT Command: R Line Number and Press the RETURN
Key.
The parameters DEFINE SYS: PS:<NEW-SUBSYS>, PS:<SUBSYS> and SYSTEM:
PS:<NEW-SYSTEM>, PS:<SYSTEM> must be replaced by DEFINE
SYS: PS:<SUBSYS> DEFINE SYSTEM: PS:<SYSTEM> respectively. To do
this, type an R and the line number where DEFINE SYS: PS:<NEW-SUBSYS>,
PS:<SUBSYS> is located; then press the RETURN key.Do the same thing
for SYSTEM: The system prints the line number you entered in the R
command. In the example below, the parameter is located at line
00500.
*R500<RET>
The system prints
00500
Step 9: Type DEFINE SYSTEM: PS:<SYSTEM> and Press the RETURN Key.
To define SYSTEM: as PS:<SYSTEM>, type DEFINE SYSTEM: PS:<SYSTEM> and
press the RETURN key. Also, be sure to use the EDIT program's D
command to delete any line giving another definition of SYSTEM:.
00500 DEFINE SYSTEM: PS:<SYSTEM><RET>
The system prints
1 LINES (00500/1) DELETED
*
Step 10: Type EU and Press the RETURN Key.
To end the EDIT program and save the file, type EU and press the
| RETURN key. The system prints <SYSTEM>6-CONFIG.CMD.2 and the TOPS-20
command prompt.
A-27
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
*EU<RET>
| <SYSTEM>6-CONFIG.CMD.2
$
A-28
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 11: Give the Command: CONNECT and Press the RETURN Key.
Connect back to your log-in directory by typing CONNECT and pressing
the RETURN key.
$CONNECT<RET>
$
Step 12: Give the Command: DELETE (FILES) PS:<NEW-SYSTEM>*.*.* and
Press the RETURN Key.
To delete the files in the directory PS:<NEW-SYSTEM>, type DELETE and
press the ESC key. The system prints (FILES). Type
PS:<NEW-SYSTEM>*.*.* and press the RETURN key. The system prints an
[OK] message for each file it deletes.
ESC
!
$DELETE (FILES) PS:<NEW-SYSTEM>*.*.*<RET>
.
.
.
.
.
.
.
.
$
Step 13: Give the Command: DELETE (FILES) PS:<NEW-SUBSYS>*.*.* and
Press the RETURN Key.
To delete the files in the directory PS:<NEW-SUBSYS>, type DELETE and
press the ESC key. The system prints (FILES). Type
PS:<NEW-SUBSYS>*.*.* and press the RETURN key. The system prints an
[OK] message for each file it deletes.
ESC
!
$DELETE (FILES) PS:<NEW-SUBSYS>*.*.* <RET>
.
.
.
.
.
.
.
.
.
.
.
$
A-29
UPDATING THE DECSYSTEM TO TOPS-20 VERSION 6.0 SOFTWARE
Step 14: Give the Command: ^ECEASE (TIMESHARING AT) Date and Time
(RESUMING AT) Date and Time and Press the RETURN Key.
Shut down the system by typing CTRL/E CEASE and press the ESCAPE key.
The system prints (TIMESHARING AT). Type the date and time you want
timesharing to cease and press the ESCAPE key. The system prints
(RESUMING AT). Type the date and time you want timesharing to start
again and press the RETURN key. The system prints a list of messages.
The last message is Shutdown complete.
CTRL/E ESC ESC
! ! !
$^ECEASE (TIMESHARING AT) date and time (RESUMING AT)
date and time<RET>
Shutdown complete
Step 15: Type CTRL/\.
At the console terminal, type CTRL/\ to return to the front-end
Command Parser. When you are at Command Parser command level, the
system prints the prompt PAR>.
Shutdown complete
CTRL/\
PAR>
Step 16: Type SHUTDOWN and Press the RETURN Key.
To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key.
The system prints a list of messages.
PAR>SHUTDOWN<RET>
** HALTED **
%DECSYSTEM-20 NOT RUNNING
Step 17: Press the ENABLE and DISK Buttons Simultaneously.
| To run the Version 6.0 software from disk, press the ENABLE and DISK
| buttons simultaneously. Follow the steps in Chapter 5 of this manual.
NOTES
|
| 1. If you ever need to revert to Version 5.1, you
| must reinstall Version 5.1, using the Version 5.1
| floppies and tapes.
| 2. If you are installing any unbundled software,
| perform the steps specified in the appropriate
| installation guide that accompanies each optional
| software product.
|
|
| Step 18: Start Timesharing.
A-30
APPENDIX B
TAILORING YOUR SYSTEM FOR ARPANET
Perform the steps in this appendix only if you are using the ARPA
network.
At this point you have installed the ARPANET software.
Step 1: Give the Command: CONNECT (TO DIRECTORY) PS:<SYSTEM> and
Press the RETURN Key.
| If you are part of the ARPA network, you must add your Internet
| Address to the SITE-ADDRESS.TXT file. Type CONNECT and press the ESC
| key. The system prints (TO DIRECTORY). Type PS:<SYSTEM> and press
the RETURN key.
ESC
!
$CONNECT (TO DIRECTORY) PS:<SYSTEM><RET>
$
| Step 2: Give the Command: EDIT (FILE) SITE-ADDRESS.TXT.1 and Press
| the RETURN Key.
|
| If you are using the ARPA network you must enter your Internet address
| into the SITE-ADDRESS.TXT file. To do this, type EDIT and press the
| ESCAPE key. The system prints (FILE). Type SITE-ADDRESS.TXT and
| press the RETURN key.
|
| <ESC>
| !
| $EDIT (FILE) SITE-ADDRESS.TXT<RET>
|
|
| Step 3: Give the EDIT Command: I line-number and Press the RETURN
| key.
|
| To insert the Internet address into the SITE-ADDRESS.TXT file type I
| followed by the line number you selected then press the RETURN key.
|
| *I2150<RET>
| 02150
|
|
| Step 4: Type Your Internet Address Number and Press the RETURN Key.
|
| Type your Internet Address and press the RETURN key.
|
| 02150 AN20 0, n n n n, PACKET:1004<RET>
| *
B-1
TAILORING YOUR SYSTEM FOR ARPANET
| where n n n n = the decimal octets number of the Internet
| address.
|
|
| Step 5: Type EU and Press the RETURN Key.
|
| To save the file without the line numbers, type EU and press the
| RETURN key.
|
| *EU<RET>
| [SITE-ADDRESS.TXT.1]
| $
B-2
APPENDIX C
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
C.1 INTRODUCTION
This appendix shows you how to generate a TOPS-20 batch and spooling
(GALAXY) system specifically tailored for your installation. To do
| this you must have already installed a standard Release 5 GALAXY
| system. The standard GALAXY system is satisfactory for most sites.
The procedures shown in Chapters 1 through 7 of this manual, or in
| Appendix A or B, show you how to install Release 6.0 TOPS-20 software,
| including a standard Release 5 GALAXY system. After performing those
procedures, you can use the steps in this appendix if you need to
generate a GALAXY system having different parameters from the standard
one.
NOTE
| While the steps in generating a tailored Release 5
| GALAXY system can be used with timesharing users
| logged in, the critical phase of stopping the standard
| Release 5 system and starting up your tailored one
| (Steps 29-56) should, for safety reasons, be performed
on a stand-alone system. The queues need not be
| empty, however, as long as a Release 5 (as opposed to
| Release 4.2 or earlier) GALAXY system is already
running.
The following paragraphs summarize the procedure for generating and
starting up a new GALAXY system. The actual steps you would perform
are shown in the next section.
1. Run the DUMPER program to transfer the GALAXY source files
from the TOPS-20 bundled system software tape (also called
the TOPS-20 Distribution Tape) to a disk directory. This
directory is referred to as the build area. In addition to
the source code, this directory contains a special batch
control file called GALAXY.CTL.
2. Run the GALGEN program to create a file containing the new
GALAXY system parameters. The name of the parameter file is
GALCNF.MAC.
C-1
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
3. Submit the control file GALAXY.CTL to your currently running
batch system. The batch job that is created by GALAXY.CTL
reads the parameter file created by GALGEN and generates a
new set of GALAXY files of type .EXE in a temporary area.
The batch job creates a log file that should be saved for
reference, at least until the new GALAXY system is correctly
operating.
4. Stop all the components of the currently running GALAXY
system (QUASAR, LPTSPL, etc.).
5. Copy all old GALAXY files from their current area (usually
SYS:) to some other area.
6. Copy all new GALAXY files from the temporary area to SYS:.
7. Start up the components of the new batch system.
8. When you are sure that the new batch system is operating
correctly, you can delete the .EXE files of the old system.
If you want to be cautious, you can save the old .EXE files
on tape. You can also delete the GALAXY source files (and
the unrelated files restored along with them from the
Distribution Tape) from the build area. However, if your
installation can spare the disk space, it is more convenient
to leave the sources on disk. Then, if any code patches must
be made to the batch system, you have the sources readily
available. Otherwise, you have to restore the sources from
the software tape if patching is required.
NOTE
The procedures described below assume that
| you have a Release 5 GALAXY system currently
running. These procedures can be carried out
during normal timesharing.
C.2 RESTORING THE GALAXY FILES
NOTE
These procedures assume that you are using the console
terminal (CTY) and are attached to the system PTYCON
job.
Step 1: Give the Command: WHAT ALL and Press the RETURN Key.
To find out which PTYCON subjob is running the OPR program, give the
PTYCON command WHAT ALL and press the RETURN key. The system responds
with a list of PTYCON subjobs, followed by the PTYCON> prompt.
PTYCON>WHAT ALL<RET>
C-2
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 2: Give the Command: CONNECT (TO SUBJOB) 0 and Press the RETURN
Key.
To connect to the subjob running the OPR program, type CONNECT and
press the ESC key. The system prints (TO SUBJOB). Type OPR and press
the RETURN key. The system prints the OPR prompt.
ESC
!
PTYCON>CONNECT (TO SUBJOB) OPR<RET>
OPR>
Step 3: Give the Command: SHOW STATUS TAPE-DRIVE /ALL and Press the
RETURN Key.
To find out which tape drives are not in use, give the SHOW STATUS
TAPE-DRIVE /ALL command, and press the RETURN key. The system
responds with a list of tape drives and their status.
OPR>SHOW STATUS TAPE-DRIVE /ALL<RET>
Step 4: Give the Command: SET TAPE-DRIVE MTA0: UNAVAILABLE and
Press the RETURN Key.
To allow the use of a tape drive without the intervention of the
MOUNTR program, give the command SET TAPE-DRIVE, and insert the number
of a tape drive that is not presently in use (MTA0: is only an
example). Type UNAVAILABLE and press the RETURN key. The system
prints, Enter Text and Terminate with ^Z.
OPR>SET TAPE-DRIVE MTA0: UNAVAILABLE<RET>
Enter Text and Terminate with ^Z
Error: If you see an error message similar to ?Tape drive
allocation is not enabled, your site does not have tape
drive allocation enabled. Therefore, you do not have to
set any drives unavailable. Skip to Step 6.
Step 5: Type USING GALGEN PROCEDURE ^Z.
To give a reason for setting a tape drive unavailable, enter USING
GALGEN PROCEDURE and type a CTRL/Z. The system prints ^Z and gives
the OPR> prompt.
Enter Text and Terminate with ^Z
<CTRL/Z>
!
USING GALGEN PROCEDURE ^Z
OPR>
C-3
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 6: Type PUSH and Press the RETURN key.
Type PUSH to move to another level and press the RETURN key.
OPR>PUSH<RET>
@
Step 7: Type ASSIGN MTA0: and Press the RETURN Key.
Assign to your job the tape drive that you set unavailable in Step 4.
@ASSIGN MTA0:<RET>
@
NOTE
The examples in this manual show MTA0: as the tape
drive used to restore files from the Distribution
Tape. However, you can assign and use any tape drive.
Be sure to use the name of the tape drive you assign
in this step whenever MTA0: appears in this appendix.
Step 8: Type ENABLE and Press the RETURN Key.
@ENABLE<RET>
$
Step 9: Give the Command: ^ECREATE (DIRECTORY NAME) PS:<BUILD> and
Press the RETURN Key.
Create a directory to hold the GALAXY source files. Although you can
give it any name, a reasonable name for this directory is PS:<BUILD>,
because it is also known as the build area. Type CTRL/E CREATE and
press the ESC key. The system prints (DIRECTORY NAME). Type
PS:<BUILD> and press the RETURN key. The system prints [NEW] and the
subcommand prompt ($$).
CTRL/E ESC
! !
$^ECREATE (DIRECTORY NAME) PS:<BUILD><RET>
[NEW]
$$
Step 10: Give the Subcommands: WORKING 3000 and PERMANENT 3000 and
Press the RETURN Key.
Assign sufficient storage space to the directory to allow copying of
the entire fourth save set (not just the GALAXY sources). Then
complete the command with a final carriage return.
$$WORKING 3000<RET>
$$PERMANENT 3000<RET>
$$<RET>
$
C-4
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 11: Mount the Distribution Tape on MTA0:.
To restore the GALAXY files from tape, mount the Distribution Tape
(the TOPS-20 bundled system software tape) on the tape drive you
assigned in Step 7. If you need help, refer to Chapter 2, Section
2.1.1, Step 9, of this manual.
Step 12: Type DUMPER and Press the RETURN Key.
You need the DUMPER program to restore the GALAXY source files from
tape. Type DUMPER and press the RETURN key. The system prints the
DUMPER> prompt.
$DUMPER<RET>
DUMPER>
Step 13: Give the Command: TAPE (DEVICE) MTA0: and Press the RETURN
Key.
To tell the DUMPER program the tape drive you are using, type TAPE and
press the ESC key. The system prints (DEVICE). Type the name of the
tape drive on which you mounted the Distribution tape in Step 16
(MTA0: is only an example). Press the RETURN key. The system prints
the DUMPER> prompt.
ESC
!
DUMPER>TAPE (DEVICE) MTA0:<RET>
DUMPER>
Step 14: Give the Command: SKIP 3 and Press the RETURN Key.
To skip over the first three save sets on the Distribution Tape, give
the command SKIP 3 and press the RETURN key. The DUMPER program
prints a message identifying each save set it skips, and then gives
the DUMPER> prompt. Be prepared for a 5- to 10-minute wait while
DUMPER positions the tape.
DUMPER>SKIP 3<RET>
DUMPER>
C-5
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 15: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO)
PS:<BUILD>*.*.* and Press the RETURN Key.
To restore all the files from the fourth save set (including the
GALAXY source files), type RESTORE and press the ESC key. The system
prints (TAPE FILES). Type PS: and press ESC. The system prints
<*>*.*.* (TO). Type PS:<BUILD> and press ESC. The system prints
*.*.*. Press the RETURN key. The system prints a message identifying
the tape and then the message, Loading file(s) into PS:<BUILD>. Be
prepared for a wait of approximately 10 minutes between this message
and the next DUMPER> prompt.
ESC ESC ESC
! ! !
DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<BUILD>*.*.*<RET>
Error: If DUMPER does not print a message identifying the save set
as "Language Sources for TOPS-20 V6.0", the tape is not
positioned at the correct save set. Give the REWIND commnd
to DUMPER and begin again at Step 14.
Error: If the message, Loading files into PS:<BUILD>, does not
appear, no files are being restored from tape. Be sure that
the correct tape is mounted on the tape drive you have
assigned to your job. Then begin again at Step 9. If
errors persist, the tape may be bad. Contact your DIGITAL
Field Service Representative for assistance.
Step 16: Give the DUMPER Commands: REWIND and EXIT.
Once the fourth save set has been restored from tape, rewind
the tape and exit from DUMPER. Give the DUMPER command
REWIND, and press the RETURN key. The DUMPER program prints
the DUMPER> prompt. Give the DUMPER command EXIT. The
DUMPER program finishes, and the system prints the TOPS-20
enabled prompt ($).
DUMPER>REWIND<RET>
DUMPER>EXIT<RET>
$
Step 17: Give the Command: INFORMATION (ABOUT) DISK-USAGE (OF
DIRECTORY) PS:<BUILD> and Press the RETURN Key.
To verify that you have restored all the files from the fourth save
set of the TOPS-20 Distribution Tape, type INFO and press the ESCAPE
key; the system prints RMATION (ABOUT). Type DIS and press the ESCAPE
key; the system prints K-USAGE (OF DIRECTORY). Type PS:<BUILD> and
press the RETURN key. The system prints information about the amount
of disk space used by the directory.
<ESC> <ESC>
! !
$INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY) PS:<BUILD><RET>
PS:<BUILD>
2865 Pages assigned
3000 Working, 3000 Permanent pages allowed
7971 Pages free on PS:
$
C-6
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 18: STOP.
If the number of pages assigned does not approximately match the
number shown in this manual, you may not have restored all the files
necessary for creating a GALAXY system. Check to be sure you have the
correct tape mounted, then begin again at Step 12.
Step 19: Give the Commands: UNLOAD (DEVICE) MTA0: and DEASSIGN
(DEVICE) MTA0: and Press the RETURN Key.
Once the GALAXY source files have been restored from the Distribution
Tape, you should unload the tape and return the tape drive to the pool
of available resources. Type UNLOAD and press the ESC key; the system
prints (DEVICE). Type MTA0: (or the name of the tape drive on which
you mounted the Distribution Tape in Step 11) and press the RETURN
key. The system prints the TOPS-20 enabled prompt ($). Type DEASSIGN
and press the ESC key; the system prints (DEVICE). Type MTA0: and
press the RETURN key. The system prints the TOPS-20 enabled prompt.
ESC
!
$UNLOAD (DEVICE) MTA0:<RET>
<ESC>
!
$DEASSIGN (DEVICE) MTA0:<RET>
$
You can now remove the Distribution Tape from the tape drive. If you
need help, refer to Chapter 2, Section 2.5, Step 57 of this manual.
Step 20: STOP.
If in Step 4 you set unavailable the tape drive you used, you should
make it available again to timesharing users: go on to Step 21.
Otherwise, skip to Step 24.
Step 21: Type POP and Press the RETURN Key.
To return the tape drive to the pool of tape drives under control of
the MOUNTR program, you must return to the previous level. Type POP
and press the RETURN key. The system prints the OPR> prompt.
$POP<RET>
OPR>
Step 22: Give the Command: SET TAPE-DRIVE MTA0: AVAILABLE and Press
the RETURN Key.
OPR>SET TAPE-DRIVE MTA0: AVAILABLE<RET>
OPR>
Step 23: Give the Command: PUSH and Press the RETURN Key.
OPR>PUSH<RET>
$
C-7
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
C.3 RUNNING THE GALGEN PROGRAM
Step 24: Type GALGEN and Press the RETURN Key.
You must run the GALGEN program to create the GALAXY configuration
file PS:<BUILD>GALCNF.MAC, which will contain the parameters
describing the tailored GALAXY system you are building. Type GALGEN
and press the RETURN key. The GALGEN program responds by giving its
name and version number, and then printing several paragraphs of
information.
$GALGEN<RET>
| GALGEN Version 5(2031)
[Starting GALAXY Generation Procedure for TOPS-20 System]
[Writing GALAXY Configuration File PS:<BUILD>GALCNF.MAC.3]
In the following dialog, all questions are of the form:
Text of question (List or range of answers) [Default answer]
The line starts with the actual text of the question. Following
the question is a description of the possible answers enclosed in
parentheses. This description might be a range of numbers, a
list of keywords, or a textual description. Following this
description is the default answer, enclosed in square brackets.
The default will be assumed if you only press the RETURN key.
You have the choice of carrying on a LONG dialog in which an
explanation of each question is provided automatically, or a
SHORT dialog in which it is assumed that you are familiar with
the GALAXY generation procedure. In either case, you can always
obtain the help text by typing a question mark (?) in response to
any question.
Answer the following question either LONG (for a long dialog) or
SHORT (for a short one). Simply pressing the RETURN key implies
SHORT.
Dialog Length (SHORT,LONG) [SHORT]
Step 25: STOP.
You have the option of a long dialog, in which GALGEN explains the
choices it offers you, or a short one, in which only the choices
themselves are displayed. If you are an experienced user of GALGEN,
you may want the short dialog, which is faster; in this case, press
the RETURN key and skip to Step 35.
Step 26: Type LONG and Press the RETURN key.
To request the long dialog with GALGEN, type LONG and press the RETURN
key. GALGEN responds with some information and then the first
question about GALGEN parameters.
C-8
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 27: Answer the Questions in the GALGEN Display.
GALGEN presents a series of questions, one at a time, for you to
answer. If you asked for a long dialog in Step 26, an explanation of
each question is included. Otherwise, you see only the questions, the
range of choices, and the default answer. The default answer is the
one that appears in brackets ([]). This value is used if you answer
the question by pressing the RETURN key.
Below is a sample of the dialog you would see if you typed LONG in
Step 26. Press the RETURN key when you want to see the next question
in the GALGEN dialog.
NOTE
You must supply the correct values for your own
system.
Administrative Controls and Parameters
The questions in this section determine absolute GALAXY parameters,
which cannot be overridden by user or operator controls.
The system logs all operator interactions in a disk file in the
spooling area. Your answer to the following question specifies the
name to be used for this file.
Operator log filename(3-20 Characters) [OPERATOR-SYSTEM]
Users can specify a priority for their batch and spooling requests
with the /PRIORITY switch. The allowable values on this parameter
range between 1 (representing lowest priority) and 63 (representing
the highest). The following two questions relate to this switch. The
first question requests the maximum priority that may be specified by
a non-privileged user.
Maximum priority non-privileged users may specify(10-63) [20]
You can specify the value to be used if the user does not specify a
/PRIORITY switch. This value must be between 1 and the maximum that
you specified in the previous question.
Default for /PRIORITY on batch and spooling requests(1-63) [10]
| This value is to control the number of objects (printers, batch
| streams, etc.) that can be controlled by a single command in OPR.
| This value should be at least the maximum number of objects of a
| single type you may have. The value must be at least 1.
|
| Maximum number of objects that can be contolled with one command
| (1-100) [6]
|
| Specify the highest number that a batch stream can be on the system.
| The value must be greater than zero and less than or equal to 10000.
|
| Highest number a batch stream can be on the system (1-10000) [100]
C-9
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Applications
The following section establishes parameters for applications
supported by GALAXY (for example, NCP). These applications will be
accessible through OPR, the operator interface.
You can enable applications through your answers to the following
questions.
Will you be running applications?(YES,NO) [YES]
Each application must be associated with an application table name
(for example, NCPTAB).
Application name or carriage return to exit(1-20 characters)
Batch Job Defaults
The questions in this section are used to define default values for
the various options that a user can specify when submitting a batch
job.
The batch user can specify a maximum runtime for his batch job using
the /TIME switch. If he does not specify this switch, the following
default will be used:
Default batch job runtime limit (5-9999 Seconds) [300]<RET>
Every batch job has maximum limits for each type of spooled output.
These limits can be set by the batch user with appropriate switches to
the SUBMIT command. If the user doesn't specify these switches, the
following defaults will be used:
Line printer output limit(0-9999 pages) [200]
Card punch output limit(0-9999 cards) [1000]
Paper tape punch output limit(0-5000 feet) [200]
Plotter output limit(0-5000 minutes) [30]
The user can specify whether or not the batch log file should be
printed after the job terminates by using the /OUTPUT switch to the
SUBMIT command. The action is specified by: LOG to always print the
log file, NOLOG to never print the log file, and ERROR to print the
log file only if the job ended with an unhandled error. If the user
doesn't specify this switch, the following value will be used:
Default for batch SUBMIT/OUTPUT (LOG,NOLOG,ERROR) [LOG]
C-10
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Line Printer Defaults and Parameters
The questions in this section are used to set default values for the
line printer spoolers.
Job banner pages printed at the beginning of each print request. The
user's name and any /NOTE value is printed on them.
Number of job banner pages (0-5) [2]
Job trailer pages are printed at the end of each print request. The
user's name and any spooler checkpoint information is printed on them.
Number of job trailer pages(0-5) [2]
File header pages are printed before each file or copy in each print
request. The file name is printed in BOLD letters on each header
page.
Number of file header pages(0-5) [2]
The user can specify a special form for a print request with the
/FORMS switch. If this switch is not specified, the following default
will be used:
Name for standard output forms (of 4-6 characters) [NORMAL]
The number of characters that uniquely identifies a form is compared
with the current form name to determine if a forms change is required
for a specific user request.
Number of characters that uniquely identifies form(2-6) [4]
Tape Label Action
The system administrator can allow non-privileged users to bypass
label processing.
Allow bypassing for non-privileged users?(YES,NO) [NO]
Miscellaneous Defaults and Parameters
The questions in this section refer to general GALAXY parameters.
The following section establishes default bias and
disk-page-to-spooler unit conversion factors.
Do you want the standard limit computation(YES,NO) [YES]
The default action to be taken when output exceeds the specified limit
for an output spooler may be to ABORT the job and ignore all remaining
output, ASK the operator what to do, or PROCEED to finish processing
the job.
Default output-limit-exceeded action(ABORT,ASK,PROCEED) [ASK]
ABORT<RET>
[End of Galgen Dialog]
$
C-11
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
C.4 ASSEMBLING THE NEW GALAXY SYSTEM
Step 28: Give the Command: SUBMIT (BATCH JOB) GALAXY.CTL
/TIME:0:30:00/RESTARTABLE.
In the last step you completed the GALGEN program, which produced the
GALAXY parameter file, GALCNF.MAC. This file contains your choice of
options for a tailored batch and spooling system. To create this
batch and spooling system you must submit the GALAXY control file,
GALAXY.CTL, to your present batch system. GALAXY.CTL reads GALCNF.MAC
and generates the files and programs for a tailored GALAXY system.
Type SUBMIT and press the ESC key; the system prints (BATCH JOB).
Type GALAXY and press the ESC key; the system prints .CTL.1. Type
/TIME:0:30:00/RESTARTABLE and press the RETURN key. The system prints
a message giving the job name, the request I.D., and the time limit of
the batch job.
<ESC> <ESC>
! !
$SUBMIT (BATCH JOB) GALAXY.CTL.1 /TIME:0:30:00/RESTARTABLE<RET>
[Job GALAXY Queued, Request-ID 170, Limit 0:30:00]
$
NOTE
If assembly is unsuccessful, examine the appropriate
.LOG file to see if you can find the problem. If you
can, correct it (which might involve editing the
control file), delete the .LOG file, and resubmit the
specified .CTL file. If you are unable to determine
what caused the failure, consult your systems
programmer or software specialist.
When the GALAXY system assembly succeeds, you see a series of messages
similar to the following printed on your terminal:
LPTSPL ASSEMBLY SUCCESSFUL
CDRIVE ASSEMBLY SUCCESSFUL
.
.
.
A message is printed for each control file generated.
The new batch system can now be run. However, before you proceed to
the next step, it is advisable to check the .LOG files to be sure that
no problems arose during batch system generation. It is conceivable
that a %-type (warning) error occurred. Such an error might not cause
processing of GALAXY.CTL to be unsuccessful, but could create problems
later when you attempt to use the new batch system. Therefore, it is
important that you correct any problems now, before you stop running
the current batch system.
C-12
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
C.5 SHUTTING DOWN THE OLD GALAXY SYSTEM
Once you have checked the .LOG files to be sure that no errors
occurred during the build procedure, you are ready to stop all old
GALAXY programs and start the new ones.
NOTE
During the following steps, Steps 29-56, it is
important not to have timesharing users logged in to
the system, as their jobs could initiate batch or
spooling requests during the critical period of
changeover. However, it is acceptable for requests to
be present in the queues at the time of Step 29 as
long as the old GALAXY system is a Release 5 system.
Step 29: Type POP and Press the RETURN Key.
To return to the OPR program so you can stop the old GALAXY objects
type POP and press the RETURN key. The system prints the OPR> prompt.
$POP <RET>
OPR>
Step 30: Give the Command: SHOW STATUS and Press the RETURN key.
To determine which GALAXY objects are in use, give the SHOW STATUS
command, and press the RETURN key. The system responds with a list of
GALAXY objects.
OPR>SHOW STATUS
OPR>
13:42:58 -- System Device Status --
Printer Status:
Unit Status
---- ---------------
0 Idle
Batch-Stream Status:
Strm Status
---- ---------------
0 Idle
1 Idle
2 Idle
C-13
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 31: Give SHUTDOWN Commands for Each Component of the GALAXY
System.
To be sure that each GALAXY object has been shut down, you must give a
SHUTDOWN command for each GALAXY object shown in Step 30.
<ESC> <ESC>
! !
OPR>SHUTDOWN (SCHEDULING FOR) PRINTER (unit number) 0<RET>
<ESC> <ESC>
! !
OPR>SHUTDOWN (SCHEDULING FOR) BATCH-STREAM (stream number) 0:2<RET>
.
.
.
Error: If you see a message similar to:--THERE ARE NO DEVICES
STARTED--, you can ignore this message and go on to the
next SHUTDOWN command. The message means only that
your site was not using the specified device.
Step 32: Give the Command: SHOW STATUS and Press the RETURN key.
To verify that all parts of the GALAXY system have been shut down,
give the SHOW STATUS command, and press the RETURN key.
OPR>SHOW STATUS<RET>
OPR>
13:44:55 -- There are no devices started --
OPR>
Step 33: Give the Command: EXIT and Press the RETURN Key.
To return to TOPS-20 command level so you can kill the GALAXY
components, type PUSH and press the RETURN key. The system prints the
enabled prompt.
OPR>EXIT<RET>
$
Step 34: Give the Command: ^ESPEAK and Press the RETURN Key.
To kill the GALAXY components you must give the ^ESPEAK command. Type
CTRL/E SPEAK and press the RETURN key. The system prints, [PLEASE
TYPE SYSJOB COMMANDS - END WITH ^Z].
<CTRL/E>
!
$^ESPEAK<RET>
[PLEASE TYPE SYSJOB COMMANDS - END WITH ^Z]
C-14
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 35: Give the KILL Command for each GALAXY Component.
You should KILL all the components referenced in SYSJOB.RUN. You
should also KILL BATCON, which normally runs as a separate job under
SYSJOB.
[PLEASE TYPE SYSJOB COMMANDS - END WITH ^Z]
KILL QUASAR<RET>
KILL ORION<RET>
KILL MOUNTR<RET>
.
.
.
.
Step 36: Type CCJOB 1, and Press the RETURN key.
CCJOB 1<RET>
Step 37: Type STATUS and Press the RETURN Key.
STATUS<RET>
Step 38: Type ^Z and Press the RETURN Key.
To return to TOPS-20 command level, type CTRL/Z. The system prints
the TOPS-20 enabled prompt.
<CTRL/Z>
!
^Z
$
Step 39: Give the Command: ^ECREATE (DIRECTORY) PS:<OLD-GALAXY> and
Press the RETURN Key.
You should create a directory to store your old GALAXY system before
copying your new one into SYS:. Type CTRL/E CREATE and press the
ESCAPE key. The system prints (DIRECTORY). Type PS:<OLD-GALAXY> and
press the RETURN key. The system prints [NEW] and the enabled
subcommand prompt.
<CTRL/E> <ESC>
! !
$^ECREATE (DIRECTORY NAME) PS:<OLD-GALAXY><RET>
[NEW]
$$
Step 40: Press the RETURN Key.
To create a directory with default characteristics, press the RETURN
key.
[NEW]
$$<RET>
$
C-15
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 41: Give the Command: COPY (FROM) SYS:QUASAR.EXE (TO)
PS:<OLD-GALAXY> and Press the RETURN Key.
To copy your old QUASAR program into the back-up directory that you
just created, type COPY and press the ESCAPE key. The system prints
(FROM). Type SYS:QUASAR.EXE and press the ESCAPE key. The system
prints (TO). Type PS:<OLD-GALAXY> and press the RETURN key. The
system prints a message verifying that it has copied the file.
<ESC> <ESC>
! !
$COPY (FROM) SYS:QUASAR.EXE (TO) PS:<OLD-GALAXY> <RET>
PS:<SUBSYS>QUASAR.EXE.1 => PS:<OLD-GALAXY>QUASAR.EXE.1 [OK]
$
Step 42: Copy the other files of Your GALAXY System into
PS:<OLD-GALAXY>.
Repeat Step 41 as many times as necessary to copy all the files of
your present GALAXY system into PS:<OLD-GALAXY>. You must copy all of
the following files, if they exist.
QUASAR.EXE
BATCON.EXE
CDRIVE.EXE
GLXLIB.EXE
SPRINT.EXE
LPTSPL.EXE
OPR.EXE
ORION.EXE
PLEASE.EXE
QMANGR.EXE
SPROUT.EXE
MOUNTR.EXE
C-16
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
C.6 STARTING UP THE NEW GALAXY SYSTEM
Now you are ready to replace the old GALAXY system on SYS: with your
new tailored system.
Step 43: Give the Command: COPY (FROM) PS:<BUILD>QUASAR.EXE (TO)
PS:<SUBSYS>QUASAR.EXE and Press the RETURN Key.
To copy the QUASAR.EXE component of the new GALAXY system into the
system area, type COPY and press the ESCAPE key. The system prints
(FROM). Type PS:<BUILD>QUASAR.EXE and press the ESCAPE key. The
system prints (TO). Type PS:<SUBSYS>QUASAR.EXE and press the RETURN
key. The system prints a message verifying the file it has copied
correctly.
<ESC> <ESC>
! !
$COPY (FROM) PS:<BUILD>QUASAR.EXE (TO) PS:<SUBSYS>QUASAR.EXE<RET>
PS:<GALAXY>QUASAR.EXE.1 => PS:<SUBSYS>QUASAR.EXE.1 [OK]
$
Step 44: Copy the other components of the GALAXY system into the
system area.
Repeat Step 43 as many times as it is necessary to copy all the files
of your new GALAXY system into PS:<SUBSYS>. You must copy all the
files listed in Step 42.
Step 45: Give the Command: ^ESPEAK and Press the RETURN Key.
To start the new GALAXY system you must give the ^ESPEAK command.
Type CTRL/E SPEAK and press the RETURN key. The system prints,
[PLEASE TYPE SYSJOB COMMANDS - END WITH ^Z]
<CTRL/E>
!
$^ESPEAK<RET>
[PLEASE TYPE SYSJOB COMMANDS - END WITH ^Z]
Step 46: Give the RUN Command for each component in the new GALAXY
system.
To be sure that all components of the GALAXY system are started, you
must give the RUN command for each component shown in Step 35.
[PLEASE TYPE SYSJOB COMMANDS - END WITH ^Z]
RUN SYS:QUASAR<RET>
RUN SYS:ORION<RET>
RUN SYS:BATCON<RET>
.
.
.
.
C-17
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 47: Type JOB 1 / and Press the RETURN Key.
RUN SYS:QUASAR
RUN SYS:ORION
RUN SYS:BATCON
.
.
.
.
JOB 1 /<RET>
Step 48: Give the Command: RUN SYS:BATCON and Press the RETURN Key
JOB 1 /
RUN SYS:BATCON<RET>
Step 49: Type / and Press the RETURN Key.
JOB 1 /
RUN SYS:BATCON
/<RET>
Step 50: Give the Command: STATUS and Type ^Z and Press the RETURN
Key.
RUN SYS:BATCON
/
<CTRL/Z>
!
STATUS ^Z<RET>
$
Step 51: Type OPR and Press the RETURN Key.
You must return to OPR command level to start the components of your
new GALAXY system. At TOPS-20 command level, type OPR and press the
RETURN key. The system prints the OPR prompt.
$OPR<RET>
OPR>
Step 52: Type TAKE SYSTEM:SYSTEM.CMD and Press the RETURN key.
To start all the components of the new GALAXY system, type TAKE
SYSTEM:SYSTEM.CMD and press the RETURN key.
OPR>TAKE SYSTEM:SYSTEM.CMD<RET>
OPR>
C-18
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM
Step 53: Give the Command: SHOW STATUS and Press the RETURN key.
To verify that each component of your GALAXY system is running
properly, you should now give a SHOW STATUS command and press the
RETURN key.
OPR>SHOW STATUS<RET>
Step 54: Type PUSH and Press the RETURN key.
To move to another level, type PUSH and press the RETURN key.
OPR>PUSH<RET>
@
Step 55: Type ENABLE and Press the RETURN key.
@ENABLE<RET>
$
C.7 MAKING YOUR NEW GALAXY SYSTEM THE PERMANENT SYSTEM
Once your new system is successfully running, you may want to delete
all the files from PS:<BUILD>, PS:<GALAXY>, and PS:<OLD-GALAXY> to
make more disk space available.
Step 56: Give the Command: DELETE PS:<BUILD>*.*, PS:<OLD-GALAXY>*.*
and Press the RETURN Key.
<ESC>
!
$DELETE (FILES) PS:<BUILD>*.*, PS:<OLD-GALAXY>*.*<RET>
Step 57: Type POP and Press the RETURN key.
To return to OPR level to supervise your new GALAXY system, type POP
and press the RETURN key.
$POP<RET>
OPR>
C-19