Trailing-Edge
-
PDP-10 Archives
-
BB-H138A-BM
-
3a-documentation/tops20.bwr
There are 34 other files named tops20.bwr in the archive. Click here to see a list.
TOPS-20 Beware File
11-September-1978
VERSION 3A(1)
Release 3A
COPYRIGHT (C) 1976,1977,1978 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
TOPS-20 Beware File Page 2
1.0 INTRODUCTION
1.1 Function
This document is a collection of helpful hints which supplement the
manuals by pointing out problems and pitfalls. This document also
includes potential problems discovered at the last minute.
2.0 HARDWARE DEPENDENCIES
2.1 Use of the FULL-LATENCY-OPTIMIZATION Feature
TOPS-20 Release 3A supports the use of the "Backup Register" in the
RH20 Disk Controller to obtain optimum performance from the disk
hardware. This feature may be used only if the system is at the
following System Revision Levels:
RH20 M8555 Board Revision Level D
RH20 M8557 Board Revision Level D
KL10-C CPU Revision level 10B
KL10-E CPU Revision level 2A
**CAUTION** USE OF THIS FEATURE WITHOUT THE REQUIRED HARDWARE
REVISIONS WILL CAUSE FILE-SYSTEM DAMAGE.
Both the RH20 revisions and the appropriate CPU revision for your
system are required. The feature may be enabled by adding the command
"ENABLE FULL-LATENCY-OPTIMIZATION to the file SYSTEM:3A-CONFIG.CMD.
If this command is not present the feature is disabled.
2.2 Hardware and Software Requirements for DECSYSTEM-20's with
Greater than 256K of Memory
The monitor MONBIG, which is included in Release 3A as one of the
standard monitors is set up to run on DECSYSTEM-20's with up to 512K
of memory.
However, Release 3A of TOPS-20 requires that the DECSYSTEM-20 hardware
has KL10 System Revision 10 installed. Without this revision, the
monitor will not run more than a few minutes. If more than 256K of
memory is present before KL10 System Revision 10 is installed, then
the customer should run MONMED until this revision is installed.
MONMED will only use the first 256K of memory and will not be affected
by the problem addressed in Revision 10.
TOPS-20 Beware File Page 3
2.3 "Problem on Device..." messages
When a user dials in to an Auto-baud line it is normal to see a
message of the form "Problem on device: RP04, S.N.=s, ACCESS PATH:
CHN=c, UNI=u". This message results from the normal invokation of a
task in the Console Front End to set the line speed; no hardware
malfunction is indicated.
3.0 HINTS FOR THE OPERATOR
3.1 Operator Console
The Operator's Console cannot be switched to another terminal.
3.2 7-Track Tape Drives
1. DUMPER can not use 7-track tape drives.
2. In order to use 7-track tape drives you must use SIXBIT or
the recording format. In order to use 7-track tapes with the
EXEC you must execute the "SET TAPE FORMAT (TO) SIXBIT"
command.
4.0 HINTS FOR USERS OF THE FRONT-END COMMAND PARSER
* * * * WARNING * * * *
In general, all documented procedures
required to install and normally operate
the system have been thouroughly tested
and are known to work. Also, several
design decisions have been made to
tailor the front end to its job which
may cause behavior that is considerably
different from that expected of an RSX
system.
Therefore, any use of implied
capabilities not specifically for use in
a documented procedure can have serious
system integrity implications and should
not be attempted. Only standard
documented installation and operation
procedures are supported.
TOPS-20 Beware File Page 4
5.0 USING MAKVFU
Information concerning the Vertical Format Unit (VFU) and the
Translation RAM can be found in the files MAKVFU.DOC, MAKVFU.HLP,
MAKRAM.DOC, and MAKRAM.HLP. Note that the VFU and the RAM are closely
coupled. You should not make a new RAM or VFU file without
considering both. You must read both the VFU and RAM .DOC and .HLP
files. Note also that the minimum VFU file must define channel 1 (top
of form) and channel 12 (bottom of form).
One cannot "undo" a valid command to MAKVFU. If an incorrect but
acceptable command has been given to MAKVFU, the only valid way to
undo the effect of the command is to EXIT from MAKVFU and start over.
The very last command to MAKVFU must be "OUTPUT".
6.0 HINTS FOR BUILDING PROGRAMS FROM SOURCES
The following iles are now located in <3A-DOCUMENTATION> rather than
<3A-SOURCES>.
1. STOPCD.TXT
2. USAG20.TXT
6.1 Building a TOPS-20 Monitor
NOTE: The TOPS-20 monitor may only be built using the
special assembler MONITOR-MACRO.EXE and the special loader
MONITOR-LINK.EXE. The standard MACRO and LINK may not be
used for this purpose. Prior to building a TOPS20 monitor
the following operations should be performed:
$RENAME PS:<SUBSYS>MACRO.EXE (TO BE) PS:<SUBSYS>RELEASED-MACRO.EXE
$RENAME PS:<SUBSYS>LINK.EXE (TO BE) PS:<SUBSYS>RELEASED-LINK.EXE
$RENAME PS:<SUBSYS>MONITOR-MACRO.EXE (TO BE) PS:<SUBSYS>MACRO.EXE
$RENAME PS:<SUBSYS>MONITOR-LINK.EXE (TO BE) PS:<SUBSYS>LINK.EXE
Users should not be permitted to employ these special versions of
MACRO and LINK for their own work. Note also that the Release 3A
version of the compatibility package (PA1050.EXE), must be used when
building a Release 3A monitor.
The Release 3A Distribution Tape contains all the files necessary to
build a Release 3A monitor tailored to each installations's needs.
The building procedure is described in a file called BUILD.MEM which
is distributed on the Documentation area of the Distribution Tape
(AP-4172-BM).
After building the TOPS20 monitor, the standard MACRO and LINK should
be restored as follows:
TOPS-20 Beware File Page 5
$RENAME PS:<SUBSYS>MACRO.EXE (TO BE) PS:<SUBSYS>MONITOR-MACRO.EXE
$RENAME PS:<SUBSYS>LINK.EXE (TO BE) PS:<SUBSYS>MONITOR-LINK.EXE
$RENAME PS:<SUBSYS>RELEASED-MACRO.EXE (TO BE) PS:<SUBSYS>MACRO.EXE
$RENAME PS:<SUBSYS>RELEASED-LINK.EXE (TO BE) PS:<SUBSYS>LINK.EXE
When building an ARPA monitor, the description of the "Address Space
at Link Time" will specify a negative amount of free space following
the BUGPOINTERS. This is normal and does not indicate any problems.
6.2 RUNOFF
When RUNOFF is built, it generates a SCNMAC.UNV which is not the
correct version for building other software. To avoid any problems
build RUNOFF in a separate directory.
7.0 DOCUMENTATION ERRORS
7.1 2060 Logical Memory Map
The 2060 logical memory configuration map shown in the documentation
contains a line that reports nonexistent memory. This line has been
removed from the software and no longer appears in the map.
7.2 KL Memory Boot Program
The information describing the KL memory boot program was supplied too
late to be included in the documentation. This information will be
included in future releases of the documentation.
If the memory boot program outputs the message:
STARTING MF20 DBE SCAN WAIT 25 SEC/256K
the scan really does take 25 seconds for each 256K of memory. For
that length of time, the system will appear unresponsive.
7.3 SET TAPE DENSITY Command
There is a new density parameter (6250 BPI) to the SET TAPE DENSITY
command. This parameter is not documented for Release 3A, but will be
for Release 4.
8.0 MAKDMP
The DUMP.EXE file distributed with Release 3A will support up to 1024K
of memory. Installations wishing to change DUMP.EXE