Trailing-Edge
-
PDP-10 Archives
-
k20v7b
-
manuals/klad20-users-guide.doc
There are no other files named klad20-users-guide.doc in the archive.
PART NUMBER: AC-F502M-DD
PRODUCT NAME: KLAD20 USERS GUIDE
This document applies to KLAD20-AC-7.0-A on KL Model B processors
only. It does not apply to earlier versions of KLAD20. It is
advisable that you refer to KLAD20 specific revisions in order to
perform any required updates.
COPYRIGHT 1988 DIGITAL EQUIPMENT CORPORATION, MARLBOROUGH, MASS.
The contents of this and all KLAD10 or KLAD20 media are
confidential and are the sole property of Digital Equipment
Corporation. Their use is intended for Digital personnel only!
Digital Equipment Corporation does not make available any of the
software, documentation, or any other files from these media to
persons not considered authorized employees of Digital Equipment
Corporation.
Individuals who violate or otherwise disregard this warning
without previous written consent from LCG CSSE may be subject to
disciplinary action.
It is recommended that you carefully read this document before
attempting to perform any of the indicated procedures.
EDITED 12 December 1988
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 2
KLAD20 VERSION 7.0
Support for TOPS-20 7.0
Edited 12 December 1988
Supports KLAD20 Version KLAD20-AC-7.0-A
CONTENTS
A KLAD20 INTRODUCTION (READ ME FIRST) . . . . . . . . 3
A.1 CONTENTS OF THE KLAD20 PACK: . . . . . . . . . . 3
A.2 WHAT'S NEW/DIFFERENT ON KLAD20 V7.0 . . . . . . . 4
A.3 DESCRIPTIONS OF DIRECTORIES ON KLAD20 . . . . . . 4
B CONVENTIONS USED IN THIS DOCUMENT . . . . . . . . . 6
C CREATING A KLAD20 FROM DUMPER TAPES . . . . . . . . 7
C.1 REQUIREMENTS . . . . . . . . . . . . . . . . . . . 7
C.2 SETUP TO BUILD A KLAD20 PACK FROM TAPES . . . . . 8
C.3 HOW TO PUT YOUR SYSTEM'S SERIAL NUMBER ON THE
KLAD20 . . . . . . . . . . . . . . . . . . . . . 17
D MIC FILE TO RESTORE YOUR PACK FROM TAPE
(RESTOR.MIC) . . . . . . . . . . . . . . . . . . . 19
E USING KLAD20 . . . . . . . . . . . . . . . . . . . 21
E.1 STAND-ALONE DIAGNOSTIC USAGE WITH KLDCP. . . . . 21
E.2 USING KLAD20 WITH TOPS-20 IN TIMESHARING MODE . 24
F UETP . . . . . . . . . . . . . . . . . . . . . . . 25
G TAILORING TOPS-20 FOR YOUR SYSTEM . . . . . . . . 26
H MAKBUG . . . . . . . . . . . . . . . . . . . . . . 26
I COPYING YOUR PACK . . . . . . . . . . . . . . . . 28
I.1 REQUIREMENTS . . . . . . . . . . . . . . . . . . 28
I.2 OVERVIEW . . . . . . . . . . . . . . . . . . . . 28
I.3 COPYING PROCEDURE . . . . . . . . . . . . . . . 28
J BACKING UP YOUR KLAD20 . . . . . . . . . . . . . . 31
J.1 REQUIREMENTS . . . . . . . . . . . . . . . . . . 31
J.2 BACKUP PROCEDURE . . . . . . . . . . . . . . . . 31
J.3 NOTES . . . . . . . . . . . . . . . . . . . . . 32
K MIC FILE TO SAVE YOUR PACK ON TAPE (SAVE.MIC) . . 33
L UPDATING KLAD20 WITH NEW DIAGNOSTICS . . . . . . . 37
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 3
A KLAD20 INTRODUCTION (READ ME FIRST)
-----------------------------------
KLAD20 (KL Advanced Diagnosis for TOPS-20) consists of software
to run and diagnose a TOPS-20 system. It is contained on a
single disk pack. This informational guide describes basic
features of KLAD20 and gives you helpful hints for using the
tool. It also contains instructions on how to build a KLAD20
disk pack and back up the contents to disk and tape.
Further information about KLAD20 can be gained from your LCG
experienced co-workers or through the normal LCG support
structure. Additional information on the contents of this
package and how it was put together can be obtained through the
LCG Support Hot Line at DTN: 297-5000 (508-467-5000) or Enet:
SUPPORT@GIDNEY (GIDNEY::SUPPORT).
A.1 CONTENTS OF THE KLAD20 PACK:
----------------------------
1. A complete version of the operating system (runnable MONMAX
monitor in <SYSTEM>MONITR.EXE). This monitor will work for
all DECSYSTEM-20 based hardware versions.
This monitor is the Version 7.0 TOPS-20 monitor submitted to
SDC to be distributed to the customer plus Autopatch 19 and
one patch necessary to run on a TOPS-20 system without an
NI20. It was necessary to use Autopatch 19 because UETP
needs AP19's GALAXY to run properly.
2. The contents of the current diagnostic tapes and the
diagnostics to down-line load and test secondary PDP-11s are
located in the front-end area [6,11] and in
<2-DIAGNOSTICS> on the DECSYSTEM-20 side.
Two diagnostics (DFPTA and DFKCC) have been updated to
reflect fixes made by TOPS engineering.
3. The contents of the current diagnostic tapes in the front-end
file system UIC [6,11].
4. A Field Service work area (<F-S>; password FS). This area
contains a full list of diagnostics in files DDXLA and DFXLK.
It is recommended to log in and work under <F-S> to get
automatic read access to the diagnostics and the batch files
for <UETP.LIB>.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 4
KLAD20 INTRODUCTION (READ ME FIRST)
5. A full directory of the DECSYSTEM-20 side in
<UTILITIES>KLAD20.DIR and a directory of the PDP-11 side in
<UTILITIES>FE11.DIR.
6. Current manuals in <MANUALS>. Beware, these manuals are only
for internal use, not for customers.
With the exception of <OPERATOR>, <F-S>, and <MFG>, which have
"WHEEL" capabilities, all other areas are "files only" and can be
modified from only one of the above areas.
A.2 WHAT'S NEW/DIFFERENT ON KLAD20 V7.0
-----------------------------------
1. Resolutions for problems with diagnostics DFPTA and DFKCC.
2. The monitor on KLAD20 is the one distributed to the customer
plus TOPS-20 Autopatch 19 and a patch to correct problems
when running 7.0 on a system without an NI20. AP19's GALAXY
is needed so that UETP will run.
3. The KLAD20 User's Guide was updated.
4. MAKBUG is an unsupported tool created by the TOPS-20
engineering group to give a brief description of bugchecks
and bughalts. More on this tool later in this guide.
A.3 DESCRIPTIONS OF DIRECTORIES ON KLAD20
-------------------------------------
[1-DIAGNOSTICS]
Special support programs D20MON, SUBKL
[2-DIAGNOSTICS]
KL10 and KL10 peripheral user mode diagnostics
[3-DIAGNOSTICS]
Diagnostics used on DN20
[4-DIAGNOSTICS]
Work area used to PIP diagnostics to PDP-11 side of KLAD
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 5
KLAD20 INTRODUCTION (READ ME FIRST)
[ACCOUNTS]
[DECNET]
[DECNET-SOURCES]
[DECNET-TOOLS]
[DN20]
[F-S]
Field Service area. Contains directories of the diagnostic tapes.
[FIELD-IMAGE]
Field Image Layered Products
[HELP]
Help files
[MANUALS]
Manuals useful for KLAD
[MFG]
Manufacturing area
[MFG.CMDS]
Manufacturing command files
[MFG.SRC]
Manufacturing source files
[MFG.UPD]
Manufacturing update files
[OPERATOR]
[SPOOL]
[SUBSYS]
[SYSTEM]
[TOOLS]
[UETP]
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 6
KLAD20 INTRODUCTION (READ ME FIRST)
User Environment Test Package area
[UETP.LIB]
UETP files
[UETP.RUN]
[UNSUPPORTED]
Unsupported files useful to KLAD
[UTILITIES]
Files used to build and maintain the KLAD pack
B CONVENTIONS USED IN THIS DOCUMENT
---------------------------------
Underlining:
Indicates input that the user is to type at the terminal.
Prompt:
Indicates that the system is waiting for terminal input from
the operator (user).
<CR>
Indicates that the user is to type a carriage return. In
most cases, it is assumed that the user will terminate all
keyboard entries with a <CR>, unless directed to do
otherwise.
$ (dollar sign)
Indicates that the ESC or ALT-MODE key has been used. When
this character appears within text or a command sequence,
the user is directed to type the ESC or ALT-MODE key,
whichever is available on the keyboard.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 7
CREATING A KLAD20 FROM DUMPER TAPES
C CREATING A KLAD20 FROM DUMPER TAPES
-----------------------------------
*** WARNING ***
Before beginning any portion of this operation,
remove all customer disk packs, magnetic tapes,
and system floppy media, and place them in a
secure area away from the system.
C.1 REQUIREMENTS
------------
1. A DECSYSTEM-20 with one magtape, one dual-ported disk drive,
and a console terminal.
2. A formatted and verified disk pack.
BEWARE: When the pack is formatted- DO NOT MAPOUT SOFT
ERRORS!!
3. A verified system on which the "B" string has been run.
4. The KLAD-20 backup tapes (four tapes) and system floppies.
5. This document.
6. Approximately 90 minutes to carry out the procedure.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 8
CREATING A KLAD20 FROM DUMPER TAPES
C.2 SETUP TO BUILD A KLAD20 PACK FROM TAPES
---------------------------------------
Mount the formatted pack on a dual-ported drive (unit 0),
write-enabled.
Mount Floppy A into left-hand (0) floppy drive and Floppy B into
right-hand (1) floppy drive.
Mount first magtape (1 of 4) on unit 0 (write-protected).
Set PDP-11 switches to 000003 (switches 0 and 1 up, the rest
down) and press ENABLE and SWITCH-REGISTER simultaneously.
***** NOTE *****
For the purposes of demonstration, this document
assumes that the system you are using is a 2060
model B with MOS memory. If the system you are
using is an older 2040/2050 model A or a model B
or newer, the command interface to KLI does not
vary to any great degree from previous KLAD20
build procedures.
This document shows the differences in the KLI
interface that have been introduced since the
advent of MOS memory.
After some floppy traffic you will see:
[SY0: REDIRECTED TO DX0:]
[DX0: MOUNTED]
[DX1: MOUNTED]
Begin the process by typing a control-backslash (^\).
1. ^\
--
This activates PARSER. One of the following prompts appears:
PAR% or PAR>
Next, enter the program KLI.
2. PAR>MC KLI<CR>
-- ---
After a few seconds and heavy floppy traffic, the program KLI
will start and prompt with questions requiring user input.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 9
CREATING A KLAD20 FROM DUMPER TAPES
KLI -- VERSION VBxx-xx RUNNING
KLI -- ENTER DIALOG [NO, YES, EXIT, BOOT]?
3. KLI>YES<CR>
---
KLI -- KL10 S/N: XXXX., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE CONFIGURATION:
MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
* NOTE * XXXX is your system serial number
If you have MCA25 on your machine, you will be prompted with
the following question. Answer BOTH.
KLI -- SELECT PAGE TABLE [FILE,BOTH,0,1]?
4. KLI>BOTH<CR>
----
KLI -- RELOAD MICROCODE [YES, VERIFY, NO]?
5. KLI>YES<CR>
---
KLI -- MICROCODE VERSION x.x[xxx] LOADED
The next question deals with enabling cache. If your system
does not have cache, you will not see this prompt, and you
should go directly to Step 7.
KLI -- RECONFIGURE CACHE [FILE, ALL, YES, NO]?
6. KLI>ALL<CR>
---
KLI -- ALL CACHES ENABLED
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,FORCE,YES,NO]?
7. KLI>FORCE<CR>
-----
STARTING MF20 DBE SCAN. WAIT 25 SEC/256K.
(Depending on your system configuration, this will take one
to eight minutes. The average is one to three minutes.)
MEMORY RESOURCES:
CONTROLLER ADDRESS TYPE MODULES/GROUPS
7 6 5 4 3 2 1 0
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 10
CREATING A KLAD20 FROM DUMPER TAPES
10 MF20 0 0 0 0 0 0 0 4
KLI -- CONFIGURE MOS MEMORY [ALL,YES,NO]?
8. KLI>ALL<CR>
---
** NOTE **
Your site may not have the same type of
memory as in the example illustrated in this
document. As a result, this portion may not
be exactly the same as the printout on your
CTY. If your system has core memory, KLI
will ask about configuration. Your response
should be ALL,
---
U N L E S S
you are reconfiguring memory because of a
storage module failure, or you suspect errors
in a given section of memory.
LOGICAL MEMORY CONFIGURATION,
ADDRESS SIZE INT TYPE CONTROLLER
00000000 256K 4 MF20 0 10
KLI -- LOAD KL BOOTSTRAP [YES, NO, FILENAME]?
9. KLI>MTBOOT<CR>
------
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
10. KLI --NO<CR>
--
KLI -- BOOTSTRAP LOADED AND STARTED
11. MTBOOT>/L<CR>
--
Tape will load monitor into DECSYSTEM-20 memory.
After a short period you will see the prompt MTBOOT> again.
Start at the 'REFRESH' entry point.
12. MTBOOT>/G143<CR>
-----
DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 11
CREATING A KLAD20 FROM DUMPER TAPES
STRUCTURE?
13. YES<CR>
---
DO YOU WANT TO DEFINE THE SYSTEM STRUCTURE?
14. YES<CR>
---
HOW MANY PACKS ARE IN THIS STRUCTURE?
15. 1<CR>
-
NOTE: KLAD is ALWAYS a one-pack structure!
ON WHICH "CHANNEL, UNIT" IS LOGICAL PACK 0 MOUNTED:
16. ?<CR>
-
** NOTE **
We have asked you to type a question mark
because it is possible that your system may
not be using channel 1 for logical disk unit
0. In this example, we are using channel 1,
logical disk unit 0. When you type "?" the
system tells you what channels and units it
believes it has, as well as disk type and
status.
[ENTER A PAIR OF NUMBERS SEPARATED BY A COMMA THAT SPECIFY
THE CHANNEL AND UNIT UPON WHICH THE APPROPRIATE PACK IS
MOUNTED. THE FOLLOWING IS A LIST OF VALID CHANNEL, UNIT
PAIRS:
EXAMPLE:
0,-1,0 ;TYPE=RP06,DUAL PORT
ON WHICH CHANNEL, UNIT IS LOGICAL UNIT 0 MOUNTED :?
17. 0,-1,0<CR>
------
DO YOU WANT THE DEFAULT SWAPPING SPACE?
18. ?<CR> (This will make the system print out the system
-
default.)
[THE DEFAULT IS xxxxx PAGES]
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 12
CREATING A KLAD20 FROM DUMPER TAPES
DO YOU WANT THE DEFAULT SWAPPING SPACE?
If the default is 15010 pages, type YES. If the default is
less than 15010 pages, type NO to the default and enter 15010
pages for the default swapping space.
19. Y<CR>
-
DO YOU WANT THE DEFAULT SIZE FRONT-END FILE SYSTEM?
20. ?<CR>
-
[THE DEFAULT IS 950 PAGES]
DO YOU WANT THE DEFAULT SIZE FRONT-END FILE SYSTEM?
21. NO<CR>
--
HOW MANY PAGES FOR THE FRONT-END FILE SYSTEM?
22. 9000<CR>
----
DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA?
23. YES<CR>
---
DO YOU WANT TO ENABLE PASSWORD ENCRYPTION FOR THE SYSTEM
STRUCTURE?
24. YES<CR>
---
WHAT IS THE NAME OF THIS STRUCTURE?
25. PS:<CR>
---
** NOTE **
If your disk pack was not formatted using the
PAKINT command, you may be asked the
following question:
WANT TO WRITE A PROTO-TYPE SET OF BAT BLOCKS?
If this message does not appear, go to Step 27.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 13
CREATING A KLAD20 FROM DUMPER TAPES
26. YES<CR>
---
[STRUCTURE PS SUCCESSFULLY DEFINED]
[PS: MOUNTED]
** NOTE **
Continue the procedure if you see the
message:
%%NO SETSPD
This is normal!
27. ENTER TODAY'S DATE AND TIME AS DD-MM-YY HHMM<CR>
15-NOV-88 1431 (Example)
YOU HAVE ENTERED 15 NOV 1988 2:31 PM
IS THIS CORRECT (Y,N)
28. YES<CR> (If date is correct)
---
The next response may take some time.
WHY RELOAD?
(The "NOLODF" BUGCHK is normal; continue with procedure.)
******************
*BUGCHK "NOLODF" AT 15-NOV-88 14:32:00
*COULD NOT FIND CI-20 MICROCODE LOAD PROGRAM
*JOB: 0, USER: OPERATOR
******************
29. OTHER KLAD-BUILD<CR>
----- ----------
You may see the following message:
PROBLEM WITH <SYSTEM>ACCOUNTS-TABLE.BIN
CANNOT FIND ERROR MESSAGE FILE - ACCOUNT VALIDATION IS
DISABLED
This is not an error. Continue with procedure.
NO SYSJOB (this is normal)
Type <CTRL>C to get to mini-exec.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 14
CREATING A KLAD20 FROM DUMPER TAPES
30. ^C
--
NO EXEC
MX>
Now we get the system EXEC from the KLAD tape. When you type
the following command, note that the system fills in the
missing letters.
31. MX>GMTA0:<CR> (echoes as: GET FILE MTA0:)
------
?
MX>
This is expected, because the tape is not correctly
positioned. Type the command again.
32. MX>GMTA0:<CR> (echoes the same as Step 31)
------
(If, after you type GMTA0: the second time, you still get a
question mark, there may be a problem reading the tape on the
tape drive. If this happens, dismount the tape, mount it on
MTA1, and start the procedure over from the beginning. You
do not have to specify MTA1. When you type MTA0, the system
looks at drive MTA0, and if there is no tape on the drive, it
looks at MTA1.)
33. MX>S<CR> (echoes as START)
-
TOPS-20 COMMAND PROCESSOR 7.0(xxxx)
@
34. @ENABLE<CR>
------
35. $RUN MTA0:<CR>
--- -----
This runs DLUSER, the next sequential file on the KLAD tape
DLUSER>
36. DLUSER>LOAD MTA0:<CR>
---- -----
This creates the directories and their quotas on your disk
structure. It will take approximately one minute.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 15
CREATING A KLAD20 FROM DUMPER TAPES
You may see the message:
CANNOT FIND ERROR MESSAGE FILESTR: UNDEFINED ERROR NUMBER
PS:<ROOT-DIRECTORY>
This is not a real error condition. Continue with the
procedure.
Prompt: DONE!
37. DLUSER>EXIT<CR>
----
Now that the directories are created, you can begin the
restoration process. The first part is done manually.
38. $RUN MTA0:<CR>
--- -----
This loads and runs DUMPER, the next sequential program on
the KLAD tape. DUMPER is used to restore the directories
<SYSTEM> and <UTILITIES>.
Prompt: DUMPER>
39. DUMPER>TAPE MTA0:<CR>
---- -----
40. DUMPER>ACCOUNT SYSTEM-DEFAULT<CR>
------- --------------
Next, restore the PS:<SYSTEM> area and then the
PS:<UTILITIES> area.
*** NOTE ***
Continue the procedure if you see the
message:
? SEQUENCE ERROR, RECORD 1, CONTINUING
This is not an error.
41. DUMPER>RESTORE <*>*.*.* PS:<*>*.*.*<CR>
------- -------- -----------
DUMPER TAPE #1, KLAD20-AC-7.0-A EXEC,ERRMES.BIN, TUESDAY 15-NOV-88
LOADING FILES INTO PS:<SYSTEM>
?SEQUENCE ERROR, RECORD 1, CONTINUING
END OF SAVESET
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 16
CREATING A KLAD20 FROM DUMPER TAPES
DUMPER>
42. DUMPER>RESTORE <*>*.*.* PS:<*>*.*.*<CR>
------- -------- -----------
DUMPER TAPE #1, KLAD20-AC-7.0-A <UTILITIES>, TUESDAY 15-NOV-88
LOADING FILES INTO PS:<UTILITIES>
?SEQUENCE ERROR, RECORD 1, CONTINUING
END OF SAVESET
DUMPER>
43. DUMPER>EXIT<CR>
----
** NOTE **
Do NOT remove the KLAD tape from the drive.
It will be used when RESTOR.MIC is run next.
Now that the manual operations are nearly complete, you can
start the automated part of the KLAD creation process.
44. $DO <UTILITIES>RESTOR.MIC<CR>
-- ---------------------
If you are using a tape drive other than MTA0, redefine the
logical name MAG by typing the following command at the break
point in the MIC file:
DEFINE MAG: MTA1:
------ ---- -----
Follow the instructions typed by the MIC file to restore all
tapes.
** NOTE **
Other than when specifically requested, do
not type anything while the RESTOR.MIC file
is running. This includes control
characters.
45. At the end of RESTOR.MIC you will see the DUMPER> prompt. At
that point, type the following:
DUMPER>UNLOAD
------
DUMPER>EXIT
----
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 17
CREATING A KLAD20 FROM DUMPER TAPES
Type CONTROL P (<CTRL>P) to finish the MIC file.
------- -
46. After RESTOR.MIC is complete, run FE-REWRITE.MIC. If you do
not run this MIC file, you will not be able to make a pack to
pack copy of the KLAD. To run this MIC file, type the
following command:
$DO <UTILITIES>FE-REWRITE.MIC
-- -------------------------
C.3 HOW TO PUT YOUR SYSTEM'S SERIAL NUMBER ON THE KLAD20
----------------------------------------------------
Follow the procedures in Section G (with help from the TOPS-20 KL
Model B Installation Guide) to tailor the system according to
your peripherals.
1. Press <CTRL>\ to get the PARSER. The prompt will be PAR>
-------
2. Type SHUTDOWN<CR> to stop timesharing and halt the KL.
--------
Prompt: ***KL HALTED***
Set the switches on the PDP-11 to 0207 (switches 0,1,2,7 up).
3. Press ENABLE and DISK buttons on PDP-11 simultaneously.
The KL will now load microcode, configure memory and load boots.
A <CR> at the BOOT> prompt will load the default monitor from
PS:<SYSTEM>MONITR.EXE.
Prompt: ENTER TIME AND DATE
4. After entering the time and date and answering YES, if you
entered it correctly, run CHECKD to make sure that your file
system is clean (any errors prefixed with a "?" need intervention
- the ones with a "%" sign get fixed automatically). Let PTYCON
start the operator jobs. Finally, log in as OPERATOR (password
is KLAD, account is not required), enable your privileges, and
connect to the directory <SYSTEM>.
Now, change the serial number on the KLAD pack to reflect your
system's serial number. You do this by editing MONNAM.TXT and
replacing the dummy serial number "1234" with your serial number,
as shown below.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 18
CREATING A KLAD20 FROM DUMPER TAPES
1. @LOG OPERATOR KLAD
2. @ENABLE ;enable privileges
3. $CONNECT <SYSTEM> ;this is where the file resides
4. $TV MONNAM.TXT ;this file contains the serial
;number
5. R1234$XXXX$$ ;where XXXX = your system's
;serial number
6. ;X$$ ;the $ sign indicates the ESC or
;ALT-MODE key. This closes
;the file.
7. OUTPUT FILE? MONNAM.TXT.1 ;we want to keep the generation
;number at .1
8. $EXPUNGE ;releases old disk space
9. $CONNECT <OPERATOR> ;get back to your own directory
10. $DEL *.TV ;deletes unnecessary files
11. $EXPUNGE ;frees needed disk space
It is recommended that you change the password for <OPERATOR>
(KLAD) and for <F-S> (FS) to the cost center number that services
this system and that you make this change known to the Digital
Diagnostic Center (DDC) in Colorado Springs, Colorado.
Example: Cost Center 70W services your system. In this case the
passwords for <OPERATOR> and <F-S> would be CC70W.
This will allow you to keep tighter control over KLAD and will
allow DDC (Colorado) and other DEC-internal support to get onto
KLAD in case of an emergency.
You can change the passwords with one of the following two
commands:
1. $BUILD
2. $SET DIRECTORY PASSWORD
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 19
MIC FILE TO RESTORE YOUR PACK FROM TAPE (RESTOR.MIC)
D MIC FILE TO RESTORE YOUR PACK FROM TAPE (RESTOR.MIC)
----------------------------------------------------
;****************************************************************
;* Mic file to start the second phase of a FULL KLAD-20 RESTORE.*
;* *
;* ASSUMPTIONS: EXEC.EXE and ERRMES.BIN in PS:<SYSTEM> *
;* DIRECTORY <UTILITIES> restored *
;* *
;* FRONT-END-AREA previously defined as *
;* length of 9000 pages *
;* *
;****************************************************************
;
MAGTAP::
;
;
@DEFINE MAG: MTA0:
;
; Type "^P" when ready.
=^B
;
@
@ERROR
@ENABLE
;
@DAYTIME
@TERMINAL NO PAGE
@TERMINAL LENGTH 0
@DAYTIME
;
@RU <UTILITIES>DUMPER
*TAPE MAG:
*FILES
*ACCOUNT SYSTEM-DEFAULT
*RESTORE <*>*.*.* PS:<FE-COPY>*.*.*
*EXIT
;
@CONN PS:<FE-COPY>
@RUN PS:<UTILITIES>COPYFE
*<FE-COPY>FRONT-END-FILE-SYSTEM.BIN
*<ROOT-DIRECTORY>FRONT-END-FILE-SYSTEM.BIN
@DELETE <FE-COPY>*.*
@EXPUNGE <FE-COPY>
@RESET
;
@ENABLE
@BUILD <OPERATOR>
*PASS KLAD
*ACC F-S
*
@
@CONN <SYSTEM>
@RU PS:<UTILITIES>MAKDMP
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 20
MIC FILE TO RESTORE YOUR PACK FROM TAPE (RESTOR.MIC)
*CREATE PS:<SYSTEM>DUMP.EXE 4096
*EXIT
@
@UNLOAD MAG:
;
; Mount tape 2 on tape drive.
; Type "^P" when ready.
;
;NOTE: To use magtape other than MTA0: redefine MAG:
;
=^B
;
@RU PS:<UTILITIES>DUMPER
*TAPE MAG:
*ACCOUNT SYSTEM-DEFAULT
*RESTORE <*>*.*.* <*>*.*.*
;*****************************************************************
;* WHEN TAPE #1 HAS FINISHED, DUMPER WILL UNLOAD THE TAPE *
;* FROM UNIT 0 & DEMAND A NEW TAPE FILESPEC. *
;* *
;* WHEN THE TAPE HAS BEEN UNLOADED, MOUNT TAPE #2 *
;* & TYPE "MTA?:", ? IS THE # OF THE UNIT YOU ARE USING. *
;* CONTINUE UNTIL ALL TAPES ARE RESTORED. *
;* *
;* WHEN ALL TAPES HAVE BEEN RESTORED *
;* TYPE "^P" TO FINISH *
;* *
;*****************************************************************
;
=^B
;
;
@GOTO END
%ERR::
;
; ERROR in RESTOR.MIC
;
END::
@DAY
@KMIC
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 21
USING KLAD20
E USING KLAD20
------------
E.1 STAND-ALONE DIAGNOSTIC USAGE WITH KLDCP.
----------------------------------------
Using the latest release of KLDCP, you can run all diagnostics
(pack modifying diagnostics excluded).
EXAMPLE: Fast check to see if the KL is alive and RH11 access
---- ----- -- --- -- --- -- -- ----- --- ---- ------
works.
------
1. Mount KLAD-20 pack on unit 0 (dual port RP06)
2. Set PDP-11 switches to octal 203.
o Bit 7 boot from disk.
o Bits 0,1 don't start KLI up.
o Bits 8, 9, 10 are the unit number of the disk as seen
from the RH11, in this case unit 0.
3. Press ENABLE and SWITCH REGISTER buttons simultaneously.
4. Wait until the CTY prints "[DB0: MOUNTED]".
5. Type <CTRL>\ to call the PARSER.
-------
6. If PARSER echoes PAR% or PAR#, skip to step 8.
7. If PARSER echoes PAR>, type the following commands to stop
running the DECSYSTEM-20:
PAR>SET CONSOLE MAINTENANCE<CR>
--- ------- -----------
PAR>SHUTDOWN<CR>
--------
You should now see PAR% or PAR#.
8. Type MC BOO<CR> to PARSER.
-- ---
9. Type DBOOT<CR> at the BOO> prompt.
-----
10. After some floppy traffic (RESETs) you are in KLDCP.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 22
USING KLAD20
11. VERY IMPORTANT- write protect the KLAD-20 pack !!
12. Set the PDP-11 switches to the state the diagnostic needs.
In the case of the B command, it is run with switches set to
zero.
The KLDCP program is now activated, and you can run
diagnostics. The KL10 checkout command file (B-string) can
be called by typing B<CR> to KLDCP. This will run a series
-
of KL10 diagnostics.
You can now select other exec diagnostics you wish to run. A
complete list of diagnostics (DDXLA/DFXLK) resides in the
<F-S> area of KLAD20.
After you have checked the system, get back to RSX20F in the
following way:
If you have been running any diagnostic which might have
left bad parity in core, you have to zero memory before
starting up TOPS-20, since boot does not zero TOPS-20
memory.
KLDCP allows you to zero core in 64k chunks:
MZ 0,-1 ;Zeroes the first 64K,
MZ 200000,-1 ;Zeroes the next chunk and so on till you
;have zeroed all core.
There is also a PARSER command, which will work much
slower. For a 128K system, this command would be
ZERO 0>177777<CR>.
13. Set the KLAD-20 pack write enabled. Reset PDP-11 switches to
octal 203, as you had them in step 2.
14. Stop the PDP-11 (HALT switch).
15. Write enable the KLAD20 pack.
16. Reload and restart the PDP-11 from switches.
17. Type SE 173000<CR> to the KLDCP prompt.
-- ------
18. After you see "[DB0: MOUNTED]", type <CTRL>\
-------
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 23
USING KLAD20
19. Type to the PARSER prompt RU KLI<CR>
-- ---
20. Follow normal monitor startup procedures.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 24
USING KLAD20
E.2 USING KLAD20 WITH TOPS-20 IN TIMESHARING MODE
---------------------------------------------
Beware: startup of KLAD-20 in timesharing mode requires the pack
to be write enabled!
Press the DISK and ENABLE buttons simultaneously. Answer the
"TIME and DATE," "WHY RELOAD," and "RUN CHECKD" questions on the
CTY, and log in under <F-S> (password FS). You are now ready to
run user-mode diagnostics.
1. @ ENABLE<CR> ;Give yourself privileges
------
2. $ CONNECT <2-DIAGNOSTICS><CR> ;Connect <2-DIAGNOSTICS>
------- ---------------
3. $ RUN D20MON<CR> ;TOPS-20 diagnostic monitor.
--- ------
D20MON CMD -
You can now select the user-mode diagnostic to be run.
Another test that is run in timesharing mode is the User
Environment Test Package (UETP). Information about this package
is covered later in this guide.
If you want to return the system to the customer, type the
following:
1. $<CRTL>ECEASE NOW<CR>
------------ ---
2. TOPS-20 will be shut down IMMEDIATELY
[Confirm]
3. <CR> confirms that you want to shut down now
----
When "SHUTDOWN COMPLETE" is printed, type <CTRL>\ on the CTY.
-------
This will invoke the PARSER.
Type to the PARSER:
4. PAR> SHUTDOWN<CR> to HALT the DECSYSTEM-20
--------
You should see: ***KL HALTED***
At this point, you can safely remove the KLAD20 pack from the
drive.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 25
UETP
F UETP
----
1. The User Environment Test Package is a collection of
programs, data files, and batch control files designed to
allow you to verify the integrity of your TOPS-20 system.
To run the UETP test package, submit the jobs from the PTYCON
subjob "UETP." When KLAD20 has been booted and loads the
Version 7.0 monitor, a UETP setup command file is started
that handles practically everything necessary to run UETP.
All that you need to do is attach to the F-S job running UETP
and submit the UETP tests wanted. Follow the instructions
outlined in UETP HELP* in the <UETP.LIB> area or the
instructions in the KLAD20-MFG-GUIDE.DOC in the <MFG> area,
or refer to the UETP Reference Manual in the TOPS-20 Notebook
Set.
@ENABLE
------
$CONNECT UETP<CR>
------- ----
$RUN UETP
--- ----
UETP>
* This help can be accessed by typing HELP to the UETP
prompt:
UETP>HELP<CR>
----
2. To prevent unwanted line printer output and to stop all the
batch jobs that you submitted, type:
$CANCEL PRINT */USER:F-S
------ ----- ----------
$CANCEL BATCH */USER:F-S
------ ----- ----------
After a period of cleanup, the command INFO OUTPUT should
show that there is no output pending, and INFO BATCH should
show that nothing is pending in the batch queues. It is also
a good idea to delete the log files if they are no longer
needed. To do this type:
@ENABLE<CR> Give yourself privileges
------
$DELETE <*>*.LOG<CR> Delete log files
------ --------
$EXPUNGE <*><CR> Expunge log files
------- ---
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 26
TAILORING TOPS-20 FOR YOUR SYSTEM
G TAILORING TOPS-20 FOR YOUR SYSTEM
---------------------------------
To tailor your KLAD to your system, refer to the
KLAD20-MFG-GUIDE.DOC in the <MFG> area of the KLAD20 pack. Note,
the procedures in the <MFG> area are the procedures used by the
Manufacturing Acceptance script. When you connect to the <MFG>
area and you run CONFIG, the password is MFG or F-S.
The KLAD20-MFG-GUIDE.DOC file contains helpful information, and
you should read it before running UETP or tailoring your KLAD20
pack.
H MAKBUG
------
MAKBUG is an unsupported tool developed by TOPS-20 engineering to
assist in understanding the causes of bugs(HLT,CHK). It does
this by giving a brief description of the bug when asked to do
so. There are 1338 bugs that can be displayed. You can use this
tool by typing the following:
@ENABLE <CR> ; give yourself privileges
------
$CONN <UNSUPPORTED> <CR> ; connect to the <UNSUPPORTED> directory
---- -------------
; where MAKBUG resides
$MAKBUG ; runs MAKBUG
------
MAKBUG> ; MAKBUG prompt
MAKBUG> DISPLAY ? ; will give a list of BUGS available
------- -
; for display
MAKBUG>DISPLAY ILLUUO ; display info on bug selected, ILLUUO
------- ------
; for this example. Once in MAKBUG,
; "DISPLAY" is necessary for output.
; However info can be accessed by
; simply typing "MAKBUG BUGNAME" from
; monitor prompt.
***The following is an example of the output given by MAKBUG:
BUG.(HLT,ILLUUO,APRSRV,SOFT,<Illegal UUO from monitor context>,
<<KIMUFL,FLAGS>,<KIMUPC,PC>,<KIMUEF,EFFADR>>
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 27
MAKBUG
Cause: The monitor has executed an instruction that the microcode
as an MUUO. The op code is not 104 (for a JSYS) or one of the
KA10 floating point instructions.
Action: This bug is commonly caused by a software problem but can be
caused by bad hardware. If the hardware checks out OK and
the BUGHLT is reproducible, then send in an SPR along with
the dump and instructions on reproducing the problem.
Data: FLAGS - Processor flags when MUUO was executed.
PC - PC in monitor address space where MUUO was executed.
EFFADR - Effective address of MUUO.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 28
COPYING YOUR PACK
I COPYING YOUR PACK
-----------------
I.1 REQUIREMENTS
------------
1. The KLAD20 master pack.
2. A formatted pack with as few soft/hard errors as possible for
the KLAD copy. When the pack is formatted, DO NOT mapout
soft errors!
3. A TOPS-20 system.
4. Two RP06 disk drives. The drive for the KLAD master pack
must be dual ported; the drive for the copy pack single
ported.
5. Approximately 33 minutes to copy the pack.
I.2 OVERVIEW
--------
A MIC file does the copying.
MAKPAK has the following variables set up for your KLAD pack:
Swapping space: 15010 pages
Size of front end: 9000 pages
Size of DUMP.EXE: 4096 pages
If you wish to change these variables on the copy of the KLAD
pack you are to create, edit the following files:
[UTILITIES]MAKPAK.MIC Swapping space, front-end size
[UTILITIES]MAKPAK.CTL Size of DUMP.EXE
I.3 COPYING PROCEDURE
-----------------
1. Bring up the KLAD system the way you normally do.
2. If the UETP jobs start up, either cancel the batch streams or
type DO <MFG>CANCEL-BATCH.MIC<CR>.
-- -------------------------
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 29
COPYING YOUR PACK
3. Log in as F-S (password FS).
4. Type ENABLE to enable privileges.
------
5. Type SET TERMINAL WIDTH 132
--- -------- ----- ---
6. Type CONNECT <UTILITIES>
------- -----------
7. Cycle up the formatted pack on an available drive. Make note
of the following:
o RH20 channel number (variable A in Step 8)
o Drive number (variable B in Step 8)
o Number in the structure name for Common File System (CFS)
systems (variable C in Step 8)
If you do not have a CFS system, you will have to make note
of the channel and drive number.
With CFS systems, you cannot have multiple KLAD packs running
as PS:, so you should name the second KLAD pack PS1:, the
third one PS2:, and so on.
8. Type DO MAKPAK A,B,C<CR>, where
-- ------ ---------
A = channel number
B = drive number
C = PS: structure number (only for CFS systems)
9. The MIC file runs UNITS and asks you to check the RH20
channel number, drive number, and PS number for CFS packs.
If the information is correct, type <CTRL>P to continue. If
it is not correct type <CTRL>A to abort the MIC file. Find
out the correct channel number and drive number and start the
copying process again at Step 8.
10. MAKPAK.MIC runs CHECKD to set up the pack and mounts it on
the system with an alias. The MIC file then submits
MAKPAK.CTL. The control file sets up the directories on the
pack, copies the front-end file system to the front end (this
takes approximately six minutes), and then copies the
directories from the master KLAD to the copy KLAD one by one.
The system notifies you as it copies each directory. This is
the order in which the batch job copies the directories:
<1-DIAGNOSTICS>
<2-DIAGNOSTICS>
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 30
COPYING YOUR PACK
<3-DIAGNOSTICS>
<UETP.LIB>
<UTILITIES>
<DN20>
<DECNET>
<DECNET-SOURCES>
<DECNET-TOOLS>
<FIELD-IMAGE>
<F-S>
<MANUALS>
<MFG>
<MFG.SRC>
<MFG.CMDS>
<MFG.UPD>
<NEW-SYSTEM>
<NEW-SUBSYS>
<OPERATOR>
<SUBSYS>
<SYSTEM>
<UNSUPPORTED>
<UTILITIES>
<TOOLS>
<HELP>
11. The copying is complete when the batch job has finished.
Type the following to remove the copy pack:
R OPR
- ---
OPR>DISMOUNT STRUCTURE KLAD:
-------- --------- -----
OPR>EXIT
----
Remove the copy of the KLAD pack from the drive.
If this is the only pack to copy, go to Step 12; otherwise go
to Step 7.
12. Type <CTRL>ECEASE NOW to bring down the system.
------------ ---
13. Type CTRL\ to get to the PARSER prompt, and type SHUTDOWN.
----- --------
The system responds with "DECSYSTEM-20 NOT RUNNING".
14. Remove the master KLAD pack from the drive.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 31
BACKING UP YOUR KLAD20
J BACKING UP YOUR KLAD20
----------------------
J.1 REQUIREMENTS
------------
o KLAD20 online and running TOPS-20
o At least four magtapes and one working magtape drive
o Approxmately one hour
J.2 BACKUP PROCEDURE
----------------
1. Log in as <F-S> password FS.
2. Mount magtape 1 (this tape will contain the front-end) on
unit 0 (write enabled 2400 foot tape required).
3. Issue the following commands:
@ENABLE
------
$CONNECT <UTILITIES>
------- -----------
$DO SAVE PS,0 Where PS is the structure name and 0 is the
-- ---- ----
magtape specifier.
4. Follow the instructions in the .MIC file.
5. After mounting the second tape, type ^P to start saving the
--
TOPS-20 side of the pack.
6. After DUMPER requests a new tape, dismount the old one, mount
a new tape, and give a new unit-number to DUMPER.
7. Label tapes as follows:
_____________________________________________________
| KLAD20-AC-7.0-A DEC-PROPERTY |
| DATE: |
| TAPE x OF y |
| |
| SAVE BY:______________ |
|___________________________________________________|
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 32
BACKING UP YOUR KLAD20
J.3 NOTES
-----
The beginning of the front-end tape looks much like the
installation tape. Aside from specials, the end of this tape
holds a save-set of the front-end, which can be restored to the
KLAD as long as KLAD has more than 11000 pages free, without
using the slow and tedious RH11. Safety features built into our
specials check the disk space on logical contingency and
(possible) hardware errors.
NOTE
The restoration procedure will work only if you
have declared a front-end area of 9000 pages at
monitor startup.
The full dump tapes (tapes 2-4) can be used to restore any lost
or deleted files on the DECSYSTEM-20 side.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 33
MIC FILE TO SAVE YOUR PACK ON TAPE (SAVE.MIC)
K MIC FILE TO SAVE YOUR PACK ON TAPE (SAVE.MIC)
---------------------------------------------
@ENABLE
; Mic file to save KLAD on Magtapes.
;
; Parameters:
; A = Master Structure = 'A:
; B = Magtape = MTA'B:
;
; Type "^P" to continue. Type "^A" to abort.
;
@DEF MTA: MTA0:
=^B
;
@NOERROR
@DEF DSK:
@CONN <UTILITIES>
@DEL SAVE.LOG
;
@ERROR
;
@
@ENABLE
@DAYTIME
;
@DEF DIS: 'A:
@MOU STR DIS:
;
ASSMAG::
@DEF MAG: MTA'B:
@ASSIGN MAG:
@IF (NOERROR) @GOTO REWMAG
;
; ? Can't assign MTA'B:
; Repair problem and type "^P".
=^B
@BACKTO ASSMAG
;
REWMAG::
@REWIND MAG:
@IF (NOERROR) @GOTO PRIME
;
; Put MTA'B: online. Type "^P" when ready.
;
=^B
@BACKTO REWMAG
;
PRIME::
;
@NOERROR
@SET FILE INVISIBLE DIS:<SPOOL>*.*
@SET FILE INVISIBLE DIS:<SYSTEM>DUMP.*
@DEL DIS:<6-DIAGNOSTICS>*.*.*
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 34
MIC FILE TO SAVE YOUR PACK ON TAPE (SAVE.MIC)
@EXP DIS:<6-DIAGNOSTICS>
;
;
COPY DIS:<UTILITIES>FRONT-END-BOOT.BIN.* DIS:<ROOT-DIRECTORY>
;
;
@ERROR
;
@COPY DIS:<SYSTEM>2060-MONBIG.EXE.* DIS:<6-DIAGNOSTICS>
@COPY DIS:<SYSTEM>EXEC.EXE.* DIS:<6-DIAGNOSTICS>
@COPY DIS:<SYSTEM>ERRMES.BIN.* DIS:<6-DIAGNOSTICS>
;
;**********************************************************
; *
; The following steps create KLAD-20 BACKUP-TAPE 1 *
; *
; CONTENTS: <SYSTEM>2060-MONBIG.EXE *
; <SYSTEM>EXEC.EXE *
; <SUBSYS>DLUSER.EXE *
; DLUSER-FILE to recreate KLAD-DIRECTORIES *
; <SUBSYS>DUMPER.EXE *
; <SYSTEM>EXEC.EXE,ERRMES.BIN *
; <UTILITIES> *
; <ROOT-DIRECTORY>FRONT-END-SYSTEM-*.BIN *
; *
; Assumptions: 2400 feet MAGTAPE on UNIT 0 *
; *
; Time requirements: Roughly 12-15 min WALL-CLOCK time *
; *
;**********************************************************
;
@GET DIS:<SYSTEM>2060-MONBIG.EXE
@SAV MAG:
@GET DIS:<SYSTEM>EXEC.EXE
@SAV MAG:
@GET DIS:<SUBSYS>DLUSER.EXE
@SAV MAG:
;
@START
*STRUCTURE DIS:
*DUMP MAG:
*EXIT
;
@RESET
@GET DIS:<SUBSYS>DUMPER.EXE
@SAV MAG:
;
@CONN DIS:<SYSTEM>
@START
*TAPE MAG:
*SSNAME KLAD20-AC-7.0-A
*FILES
*SAVE DIS:<6-DIAGNOSTICS>*.*.* PS:<SYSTEM>*.*.*
*EXIT
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 35
MIC FILE TO SAVE YOUR PACK ON TAPE (SAVE.MIC)
;
@ENABLE
@DEL DIS:<6-DIAGNOSTICS>*.*.*
@EXP DIS:<6-DIAGNOSTICS>
@CONN <UTILITIES>
;
@START
*TAPE MAG:
*FILES
*SSNAME KLAD20-AC-7.0-A <UTILITIES>
*SAVE DIS:<UTILITIES>*.*.* PS:<UTILITIES>*.*.*
*EXIT
@ENABLE
@CONN DIS:<ROOT-DIRECTORY>
;
;*******************************************************************
;This step checks the FE-SYSTEM on DISK-ERRORS, it takes some time !
;*******************************************************************
;
@RU DIS:<UTILITIES>READFE
*DIS:<ROOT-DIRECTORY>FRONT-END-FILE-SYSTEM.BIN
*COPY DIS:<UTILITIES>FRONT-END-BOOT.BIN DIS:<FE-COPY>FRONT-END-BOOT.BIN
;
@DIS:<SUBSYS>DUMPER
*TAPE MAG:
*FILES
*SSNAME KLAD20-AC-7.0-A Front-end-system copy
*SAV DIS:<ROOT-DIRECTORY>FRONT-END-*.*.* PS:<FE-COPY>
*EXIT
;
@ENA
@RU DIS:<UTILITIES>READFE
*DIS:<ROOT-DIRECTORY>FRONT-END-FILE-SYSTEM.BIN
*REN DIS:<ROOT-DIRECTORY>FRONT-END-BOOT.BIN DIS:<UTILITIES>*.*.*
@RESET
@CONN <SYSTEM>
@UNLOAD MAG:
;
;
TAPE2::
;*******************************************************************
;
; Now to save the entire TOPS-20 side with DUMPER.
;
; Note: To continue at this point with a different tape unit
; redefine MAG: (i.e. @"DEF MAG: MTA1:")
;
TAPCHK::
;
; Mount tape 2 on tape drive write enabled and online.
; Type "^P" when ready
;
;*******************************************************************
;
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 36
MIC FILE TO SAVE YOUR PACK ON TAPE (SAVE.MIC)
;
=^B
;
; Begin saving entire pack
;
@DUMPER
*TAPE MAG:
*ACCOUNT SYSTEM-DEFAULT
*REWIND
@IF (ERROR) @BACKTO TAPCHK
*
*SSNAME KLAD20-AC-7.0-A SYSTEM-COPY
*SAVE DIS:<*>*.*.* PS:<*>*.*.*
;
;
; After the second tape (tape 2) is finished mount next
; tape (write enabled) and reissue tape-drive spec
; to DUMPER.
;
; If a second tape drive is available you can
; get it ready and online while the first
; is still writing and issue the new tape-drive spec
; to DUMPER.
;
; When all areas have been saved type "^P" to
; finish.
;
;***********************************************************
;
=^B
;
@NOERROR
@SET FILE VISIBLE DIS:<SPOOL>*.*
@SET FILE VISIBLE DIS:<SYSTEM>DUMP.*
@ERROR
;
@GOTO END
%ERR::
;
; ERROR in SAVE.MIC
;
END::
@DAY
@KMIC
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 37
UPDATING KLAD20 WITH NEW DIAGNOSTICS
L UPDATING KLAD20 WITH NEW DIAGNOSTICS
------------------------------------
The following procedure assumes that you have the system
standalone. The monitor has been started from KLAD and is the
public structure (PS:) on a dual ported drive.
1. Log in to <F-S> (password FS) on the CTY (you will need to
talk to the front-end later in the procedure).
2. Repeat steps a through j for each diagnostic tape:
a) Mount diagnostic magtape on MTA0:
b) Assign the tape drive and skip the first file.
$ASSIGN MTA0:<CR>
------ -----
$SKIP MTA0: 1 FILE<CR>
---- ----- - ----
c) Run MAGTAP off the tape, and restore the directory of the
tape to disk.
$RU MTA0:<CR>
-- -----
DIAGNOSTIC DISTRIBUTION MAGTAPE CREATOR VERSION 0.5
MAGTAPE DEVICE - MTA0:<CR>
-----
WHAT DENSITY? - 1600<CR>
----
COMMAND - GET MAGTAP.DIR/LIST<CR>
--- ---------------
COMMAND - <CTRL>C
-------
d) At monitor level, rename MAGTAP.DIR to either DDXLA.DIR
or DFXLK.DIR, and CONTINUE the MAGTAP program.
$RENAME MAGTAP.DIR DDXLA.DIR<CR>
------ ---------- ---------
or
$RENAME MAGTAP.DIR DFXLK.DIR<CR>
------ ---------- ---------
$CONTINUE<CR><CR>
--------
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 38
UPDATING KLAD20 WITH NEW DIAGNOSTICS
e) Restore BEWARE.TXT to disk.
COMMAND - GET BEWARE.TXT/LIST<CR>
--- ---------------
f) Interrupt MAGTAP to go back to exec level.
<CTRL>C <CTRL>C
------- -------
NOTE
BEWARE.TXT contains a list of the diagnostics
that have been added or changed since the last
release. Look at the diagnostic tape directory
and BEWARE.TXT, and make a list of diagnostics
you want to put on the KLAD.
g) Enable privileges, connect to the diagnostic work area
<4-DIAGNOSTICS>, and CONTINUE the MAGTAP program.
$ENABLE<CR>
------
$CONN <4-DIAGNOSTICS><CR>
---- ---------------
$CONTINUE<CR>
--------
h) Restore (X=name Y=extension) to <4-DIAGNOSTICS> from
magtape.
Repeat this step until you have restored your list of
diagnostics from the diagnostic tape to the
<4-DIAGNOSTICS> area.
COMMAND - GET X.Y/LIST<CR>
--- --------
NOTE
It is preferable to GET the diagnostics in the
order in which they appear on the directory to
avoid unnecessary rewinds.
i) Type UNLOAD to unload the tape and get to monitor level.
COMMAND - UNLOAD<CR>
------
$
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 39
UPDATING KLAD20 WITH NEW DIAGNOSTICS
j) Remove the tape from the drive.
3. Type DIRECTORY to see the restored files in <4-DIAGNOSTICS>.
$DIRECTORY<CR>
---------
4. Now see if any of the above diagnostics are on the
DECSYSTEM-20 side of KLAD. Repeat this step for all the new
diagnostics, and mark the files on your list that are on the
DECSYSTEM-20 side of the pack.
DIR <*-DIAGNOSTICS>X.Y<CR>
--- ------------------
Example: DIR <*-DIAGNOSTICS>DDLPA.A10
<2-DIAGNOSTICS>
DDLPA.A10.1
<4-DIAGNOSTICS>
DDLPA.A10.1
In this example, we have to update DDLPA.A10 in
<2-DIAGNOSTICS>
For every diagnostic found on the DECSYSTEM-20 side, issue
the following command with the correct <directory> and
filespec.
$COPY file.spec <x-DIAGNOSTICS><CR>
---- --------- ---------------
In the example, the command will be:
$COPY DDLPA.A10 <2-DIAGNOSTICS><CR>
---- --------- ---------------
5. Copy the diagnostic tape directories to the <F-S> area and do
a directory of <F-S> to make sure they were copied correctly.
Then delete the directories from <4-DIAGNOSTICS> and expunge.
$COPY DDXLA.DIR <F-S><CR>
---- --------- -----
$COPY DFXLK.DIR <F-S><CR>
---- --------- -----
$DIR <F-S>*.DIR<CR>
--- ----------
$DELETE <4-DIAGNOSTICS>*.DIR<CR>
------ --------------------
$EXPUNGE <4-DIAGNOSTICS><CR>
------- ---------------
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 40
UPDATING KLAD20 WITH NEW DIAGNOSTICS
6. Run the FE program establishing the DECSYSTEM-20 to PDP-11
connection for file transfer.
$FE<CR>
--
<CTRL>C <CTRL>C
------- -------
7. Type DETACH CONTINUE to run FE in a detached state.
$DETACH CONTINUE<CR>
------ --------
8. Mount FE with PARSER.
<CTRL>\
-------
MC MOU<CR>
-- ---
MOU>FE0:<CR>
----
MOU><CTRL>Z
-------
9. Delete obsolete diagnostics from [6,11] front end with PIP.
Do a directory of the [6,11] front-end area to see if any of
the diagnostics on your update list are on the front-end. If
the file is there, delete the old version from the [6,11]
area and copy the new file to the [6,11] area.
<CTRL>\
-------
PAR>MC PIP<CR>
-- ---
Repeat this step for each diagnostic:
PIP>TT:=DB0:[6,11]X.Y;*/LIST<CR>
------------------------
If the file is on the front-end, type the next two
commands:
PIP>DB0:[6,11]X.Y;*/DEL<CR>
-------------------
PIP>DB0:[6,11]*.*;*=FE0:[340,33]X.Y<CR>
-------------------------------
10. Type a directory listing of each diagnostic. The file should
have today's date and time.
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 41
UPDATING KLAD20 WITH NEW DIAGNOSTICS
PIP>TT:=DB0:[6,11]X.Y;*/LIST<CR>
------------------------
11. Create a directory file of all the files contained in the
[5,5] and [6,11] directories. Copy the directory file to the
DECSYSTEM-20 side in <4-DIAGNOSTICS> area and type <CTRL>Z to
exit PIP.
PIP>DB0:[5,5]FE11.DIR=DB0:[*,*]*.*;*/DIR<CR>
------------------------------------
PIP>FE0:[340,33]*.*;*=DB0:[5,5]FE11.DIR;*<CR>
-------------------------------------
PIP><CTRL>Z
-------
12. Dismount FE with PARSER.
<CTRL>\
-------
PAR>MC DMO<CR>
-- ---
DMO>FE0:<CR>
----
DMO><CTRL>Z
-------
13. Bring in PARSER and attach back to the job you detached from
earlier in the procedure.
<CTRL>\
-------
PAR><CTRL>Z
-------
<CTRL>C <CTRL>C
------- -------
$ATTACH <F-S> JOB #<CR>
------- ----- --- -
14. Run RSXFMT to convert <4-DIAGNOSTICS>FE11.DIR from RSX-ASCII
to 7-BIT-ASCII.
$RSXFMT<CR>
------
RSXFMT>CONVERT FE11.DIR FE11.DIR.1<CR>
------- -------- ----------
RSXFMT>EXIT<CR>
----
15. Connect to <4-DIAGNOSTICS> and rename FE11.DIR to
<UTILITIES>. Delete any files left over in <4-DIAGNOSTICS>.
$CONN <4-DIAGNOSTICS><CR>
---- ---------------
KLAD20 V7.0 USER'S GUIDE 12 December 1988 Page 42
UPDATING KLAD20 WITH NEW DIAGNOSTICS
$RENAME FE11.DIR <UTILITIES>FE11.DIR<CR>
------ -------- -------------------
$DELETE <4-DIAGNOSTICS>*.*<CR>
------ ------------------
$EXPUNGE <4-DIAGNOSTICS><CR>
------- ---------------
16. Create a directory of the entire pack, and put the output
file in <UTILITIES>.
$CONNECT <UTILITIES><CR>
------- -----------
$VDIR <*>*.*.*,<CR>
---- ---------
$$OUTPUT KLAD20.DIR<CR>
------ ----------
$$<CR>
----
$DIR<CR>
---
The diagnostic update procedure is now complete.
Your original backup tapes for KLAD are now obsolete. Follow the
procedure in section J to create four new backup tapes.