Trailing-Edge
-
PDP-10 Archives
-
klad_sources
-
klad.sources/diamon.txt
There are no other files named diamon.txt in the archive.
;DDQDC
IDENTIFICATION
--------------
PRODUCT CODE: AH-7144O-DD
DIAGNOSTIC CODE: DDQDC - DIAMON
PRODUCT NAME: DDQDCO0 DECSYSTEM DIAGNOSTIC MONITOR
VERSION: 0.17
DATE RELEASED: APRIL 1980
AUTHOR: JOHN R. KIRCHOFF
MAINTAINED BY: LARGE SYSTEMS DIAGNOSTICS
COPYRIGHT (C) 1975, 1980
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY 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 EXCEPT FOR USE ON SUCH SYSTEM AND TO ONE WHO
AGREES TO THESE LICENSE TERMS. TITLE TO AND OWNERSHIP OF THE
SOFTWARE SHALL AT ALL TIMES REMAIN IN DIGITAL EQUIPMENT
CORPORATION.
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 THE
USE OR RELIABILITY OF ITS SOFTWARE IN EQUIPMENT WHICH IS NOT
SUPPLIED BY DIGITAL EQUIPMENT CORPORATION.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 2
TABLE OF CONTENTS
-----------------
1.0 ABSTRACT
2.0 REQUIREMENTS
2.1 EQUIPMENT
2.2 STORAGE
2.3 PRELIMINARY PROGRAMS
3.0 PROGRAM PROCEDURES
3.1 LOADING PROCEDURE
3.2 STARTING PROCEDURE
3.3 OPERATING PROCEDURE
3.4 LOAD DEVICES
3.5 DIAGNOSTIC MONITOR SWITCHES
3.6 EXPANDED OPERATING PROCEDURES
4.0 ROUTINE DESCRIPTIONS
5.0 COMMAND LIST FORMAT
6.0 ERRORS
7.0 ERROR RECOVERY
8.0 RESTRICTIONS
9.0 DEVICE COMMAND LIST
10.0 LISTING
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 3
1.0 ABSTRACT
THE DECSYSTEM DIAGNOSTIC MONITOR IS AN EXEC OR USER MODE
PROGRAM WHICH WILL CALL FROM THE SELECTED LOAD DEVICE IN EXEC
MODE AND THE DISK SYSTEM IN USER MODE AND EXECUTE THE
PDP-10 DIAGNOSTIC PROGRAMS EITHER SINGLY OR AUTOMATICALLY.
THE MONITOR IS INTENDED TO ALLOW RAPID CHECKOUT OF THE
COMPUTER SYSTEM AND TO ISOLATE HARDWARE PROBLEMS IN THE
QUICKEST POSSIBLE TIME. THE MONITOR WILL ALSO PROVIDE THE
SEQUENCING AND CONTROL NEEDED FOR THE DIAGNOSTIC PROGRAMS
SO THAT ACCEPTANCE TESTS, START-UP RELIABILITY TESTS,
AND/OR UNATTENDED OVERNIGHT TESTS MAY BE RUN.
THE DECSYSTEM SUBROUTINE PROGRAM AND DDT ARE AUTOMATICALLY
LOADED ON SYSTEM STARTUP OR DEVICE SPECIFICATION IF THEY ARE
NOT ALREADY RESIDENT IN THE PDP-10 MEMORY.
THE KL10 AND/OR KI10 DIAGNOSTIC MONITOR SPECIAL ROUTINES
OPERATE AS PART OF THE DIAGNOSTIC MONITOR TO PROVIDE
ADDITIONAL KL10 AND/OR KI10 FEATURES.
THESE FEATURES ARE:
KL10 & KI10 - SPECIAL USER MODE
KI10 - MARGIN OPERATION.
PROGRAM CONTAINS ROUTINES FOR:
MARGINNING
USER PAGE MAP SETUP
USER MODE CONTROL
TRAPPED I/O PROCESSING
ADDITIONAL CONTROL SEQUENCING.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 4
2.0 REQUIREMENTS
2.1 EQUIPMENT
A DECSYSTEM PDP-10 KL10, KI10 OR KA10 PROCESSOR
MINIMUM OF 32K OF MEMORY.
CONSOLE PROCESSOR (KL10)
CONSOLE TELETYPE
LOAD DEVICE; DISK PACK, DECTAPE, OR CONSOLE LOAD DEVICE (KL10)
2.2 STORAGE
THE MAXIMUM MEMORY SIZE IS A FUNCTION OF THE PROGRAMS BEING
EXECUTED. THE MONITOR RESIDES FROM LOCATION 20000 TO 27770.
2.3 PRELIMINARY PROGRAMS
THE MONITOR ASSUMES THAT BASIC INSTRUCTIONS AND THE SELECTED
LOAD DEVICE ARE OPERATIONAL.
IF THE MONITOR FAILS TO OPERATE USE THE DIAGNOSTIC PROGRAMS
INDIVIDUALLY TO ISOLATE THE PROBLEM.
3.0 PROGRAM PROCEDURES
3.1 LOADING PROCEDURE
DISK PACK - LOAD WITH 'BOOTS'
DECTAPE - LOAD WITH 'DTBOOT'
KL10 - LOAD VIA CONSOLE PROCESSOR
USER - "RUN DIAMON"
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 5
3.2 STARTING PROCEDURE
A. STARTING ADDRESS FOR DIAGNOSTIC MONITOR = 20000
B. STARTING ADDRESS FOR RESTART AFTER ERROR = 20001
C. STARTING ADDRESS FOR CURRENT PROGRAM TITLE = 20002
D. STARTING ADDRESS TO RESTART CURRENT PROGRAM = 20003
SET THE LEFT HAND CONSOLE DATA SWITCHES AS WOULD BE APPROPRIATE
FOR THE DIAGNOSTIC PROGRAMS TO BE RUN. SETTINGS TO BE
SELECTED WOULD BE:
PRINT ON LINE PRINTER?
RING TTY BELL ON ERROR?
SCOPE LOOP ON ERROR?
ETC.
3.3 OPERATING PROCEDURE
A. AFTER THE DIAGNOSTIC MONITOR IS STARTED IT WILL TYPE
THE FOLLOWING MESSAGE:
* DIAMON - DECSYSTEM DIAGNOSTIC MONITOR *
B. NEXT YOU ARE REQUESTED TO SELECT THE LOAD DEVICE TO BE USED.
IN USER MODE, THE DISK IS AUTOMATICALLY SELECTED AND
IS THE ONLY ALLOWED LOAD DEVICE.
DEV:T,K,D,V,P -
C. AFTER SELECTION OF THE LOAD DEVICE "DIAMON" WILL
AUTOMATICALLY LOAD "SUBRTN" AND "KLDDT".
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 6
D. IF YOU REQUIRE HELP, TYPE HELP<CR>.
THE FOLLOWING MESSAGE WILL THEN BE PRINTED.
NORMAL START = 20000
RESTART/ABORT = 20001
PRINT TEST TITLE = 20002
RESTART CURR TEST = 20003
DEVICES;
T=PAPER TAPE, K=KLDCP, D=DTA, V=11DTA, P=DISK PACK
COMMANDS;
STD=START DIAGNOSTIC
STM=REINITIALIZE START
STL=START LOADER
START=START DIAGNOSTIC
SFSTRT=SPECIAL FEATURE START
PFSTRT=POWER FAIL START
REE=REENTER
DDT=DDT
START1=SPECIAL START 1
START2=SPECIAL START 2
START3=SPECIAL START 3
START4=SPECIAL START 4
START5=SPECIAL START 5
R=RESELECT, X=XPN, I=INTERNAL, T=TTY, D=DEVICE
S=SINGLE, F=DIR, L=LIST, G=GO
E. FOLLOWING THIS YOU MAY SELECT AND
RUN YOUR PROGRAMS.
DIAMON CMD -
ALL COMMANDS END WITH A (CR).
COMMANDS ARE AS LISTED ABOVE PLUS IF A SINGLE PROGRAM LOAD
IS REQUIRED, THE FILE.EXT OF THE PROGRAM MAY BE TYPED TO
THE "CMD - " QUESTION.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 7
THE DIAGNOSTIC MONITOR OPERATES ON A COMMAND LIST OF PROGRAMS
WHICH IT WILL EXECUTE. THIS LIST MAY BE READ IN FROM THE
SELECTED LOAD DEVICE, TYPED IN FROM THE TELETYPE OR PREVIOUSLY
READ/TYPED IN.
1. IF THE COMMAND LIST IS TO BE TYPED IN, TYPE "T". THE
MONITOR WILL NOW ACCEPT TYPE-IN FROM THE KEYBOARD.
THE COMMAND LIST FORMAT IS GIVEN IN 4.0.
2. IF THE COMMAND LIST IS TO BE READ FROM THE LOAD DEVICE,
TYPE "D".
3. TO LOAD AND RUN A SINGLE PROGRAM, TYPE "S".
THE SPECIFIED PROGRAM WILL BE LOADED AND RUN THE NUMBER OF
OF ITERATIONS AS SPECIFIED IN THE PROGRAM BY "ITERAT".
TO CONTINUE OPERATION OF THE SAME PROGRAM AFTER IT RETURNS
TO "DIAMON", TYPE "G".
4. THE COMMAND LIST REMAINS IN CORE SO THAT IF THE MONITOR IS
RESTARTED THE COMMAND LIST DOES NOT HAVE TO BE READ IN AGAIN
UNLESS A NEW COMMAND LIST OR SINGLE PROGRAM IS SELECTED.
TO USE THE SAME COMMAND LIST, TYPE "I".
THE DIAGNOSTIC MONITOR WILL NOW READ IN AND EXECUTE THE FIRST
PROGRAM ON THE COMMAND LIST. THE PROGRAM WILL BE ITERATED THE
REQUESTED NUMBER OF TIMES AND CONTROL WILL THEN REVERT TO THE
MONITOR. THE MONITOR WILL THEN PROCEED TO THE NEXT PROGRAM
ON THE LIST UNTIL ALL PROGRAMS REQUESTED HAVE BEEN EXECUTED.
WHEN THE FINAL PROGRAM ON THE COMMAND LIST HAS BEEN EXECUTED,
THE PASS COUNTER WILL BE PRINTED AND THEN THE MONITOR WILL
RESTART WITH THE FIRST PROGRAM AGAIN.
FOR EXAMPLE:
DIAMON PASS 000001
DIAMON PASS 000002
ETC.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 8
WHEN SELECTING A SINGLE PROGRAM THE:
"FILE.EXT -"
QUESTION MAYBE ANSWERED WITH ONLY THE FILE NAME AS THE EXTENSION
WILL DEFAULT TO ".A10" OR ".SAV" UNLESS THE CONSOLE LOAD
DEVICE IS SELECTED AND THEN THE DEFAULT IS ".A10".
5. TO START THE PROGRAM JUST LOADED IF THE "FILE.EXT" ENDED
WITH A ALTMODE, OR TO RESTART THE PROGRAM, TYPE "G".
6. TO LIST A FILE FROM THE SELECTED LOAD DEVICE, TYPE "L".
7. TO OBTAIN A DIRECTORY OF THE SELECTED LOAD DEVICE, TYPE "F".
3.4 LOAD DEVICES
A. PAPER TAPE
B. KLDCP - KL10 ONLY, USE KLDCP SELECTED DEVICE
C. D - PDP-10 FORMAT DECTAPE
D. V - PDP-11 FORMAT DECTAPE
E. P - DISK PACK, RP02/3/4/5/6 ON RP10, RH10 OR RH20.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 9
WHEN THE DISK PACK IS SELECTED AS THE LOAD DEVICE THE MONITOR
OPERATES FROM THE "DISK:[P,PN] THAT IS SPECIFIED.
THE DEFAULT [P,PN] (PROJECT,PROGRAMMER NUMBER) IS 6,10.
DISK PACK SEARCH WILL BE DONE FROM 'KLAD' & 'DSKA' TO
'DSKO' IF NO DISK IS SPECIFIED.
TO USE THE DEFAULTS TYPE A (CR).
DEFAULTS:
DISK: 'KLAD' & 'DSKA' TO 'DSKO'
[P,PN] 6,10
WHEN THE DECTAPE IS SELECTED AS THE LOAD DEVICE THE MONITOR
WILL REQUEST THE UNIT NUMBER TO BE USED. THE OPERATOR SHOULD
RESPOND WITH A DIGIT 0-7 INDICATING WHICH DECTAPE UNIT
CONTAINS THE PROGRAMS TO BE EXECUTED. WHEN THE UNIT DIGIT
HAS BEEN TYPED, THE MONITOR WILL READ THE DIRECTORY FOR THAT
UNIT.
TO OPERATE IN DECTAPE SEARCH MODE, RESPOND TO THE UNIT SELECTION
QUESTION WITH AN "S". THIS ALLOWS THE MONITOR TO SEARCH THRU
ALL MOUNTED AND SELECTED DECTAPES TO FIND THE PROGRAM.
3.5 DIAGNOSTIC MONITOR SWITCHES
A. RELIAB, SW 9, UNLESS THIS SWITCH IS SET THE ITERATIONS
CONTAINED IN THE COMMAND LIST WILL BE REDUCED BY A FACTOR
OF 100(8):1 FOR FAST ITERATION OPERATION.
THIS PROVIDES A CONSIDERABLE REDUCTION IN THE RUN TIME OF
EACH PROGRAM FOR A QUICK CHECK OF HARDWARE OR FOR MARGIN
OPERATION.
B. CHAIN, SW 15, THIS INHIBITS THE TYPE-OUT OF THE "PROG.EXT"
OF THE PROGRAM PRIOR TO THE PROGRAM BEING LOADED AND
EXECUTED.
C. XPAND, SW 18, EXPAND CONTROL SEQUENCING
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 10
3.6 EXPANDED OPERATING PROCEDURE
THE FOLLOWING ADDITIONAL COMMAND SEQUENCES ARE ADDED WHEN
EITHER THE "X" COMMAND IS USED OR THE "XPAND" SWITCH IS SET
DURING COMMAND LIST OPERATION.
A. TYPE Y FOR CLOCK MARGINS -
Y = CLOCK MARGINS
CR = NO
B. TYPE Y OR A FOR SPECIAL USER MODE -
Y = SPECIAL USER MODE
A = SPECIAL USER MODE AFTER FIRST PASS
CR = NO
C. TYPE Y OR A FOR CONCEALED MODE -
Y = CONCEALED MODE
A = ALTERNATE PUBLIC AND CONCEALED MODES
CR = PUBLIC MODE
QUESTION ASKED ONLY IF SPECIAL USER MODE SELECTED.
D. TYPE L,S,I,R FOR VOLTAGE MARGINS -
L = RUN 5 VOLTS AT +-.25V LIMITS
S = SWEPT 5 VOLT MARGINS
I = SPECIFY MARGIN INCREMENT
R = SPECIFY PROCESSOR RACK FOR MARGINS (SWEPT)
CR = NO
IF I IS TYPED THEN:
SPECIFY MARGIN INCREMENT (1 TO 17) -
ONE INCREMENT ='S 21MV
IF R IS TYPED THEN:
SPECIFY RACK (0 TO 37) -
TYPE RACK NUMBER TO BE MARGINED.
E. SET 'MARGIN SELECT' OFF
SET 'MARGIN ENABLE' SWITCH
TYPE ANY CHAR WHEN READY!
SET APPROPRIATE SWITCHES AND TYPE CHAR WHEN READY.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 11
4.0 ROUTINE DESCRIPTIONS
A. SPECIAL USER MODE
A PSEUDO USER MODE WHERE THE DIAGNOSTIC PROGRAM BEING RUN
IS RUN IN USER MODE (WITH PAGING, ETC.) AND THE I/O IS TRAPPED
BACK TO THE DIAGNOSTIC MONITOR FOR PROCESSING. PROVIDES A
METHOD OF CHECKING USER MODE OPERATION OF THE INSTRUCTION
DIAGNOSTIC AND RELIABILITY PROGRAMS WITHOUT HAVING TO USE A
MONITOR AND TIMESHARING.
B. MARGINS
PROVIDES THE CONTROL NECESSARY TO OPERATE THE KI10 PROGRAMABLE
MARGIN SYSTEM. THE FOLLOWING WAYS OF RUNNING THE MARGIN SYSTEM
ARE PROVIDED:
1. SWEPT MARGINS
THE 5 VOLT POWER SUPPLIES ARE VARIED BY ONE INCREMENT STEPS
(21MV) UP TO AND DOWN TO THE +-.25V LIMITS.
2. LIMITS
MARGINS ARE DONE AT THE +-.25V SETTINGS ONLY.
3. INCREMENT
USER MAY SPECIFY THE MARGIN STEP PER PROGRAM PASS,
I.E. 4 ='S 84 MV STEPS.
4. RACK
RUNS SWEPT MARGINS ON PROCESSOR RACK SPECIFIED.
5. CLOCK MARGINS
SPEEDS UP THE BASIC CLOCK CYCLE BY 10%.
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 12
5.0 COMMAND LIST FORMAT
A. EACH COMMAND LIST INPUT FILE BEGINS WITH A CARRIAGE RETURN
(CR) AND TERMINATES WITH A CONTROL Z (^Z).
IF THE SPECIAL USER MODE ROUTINES ARE SELECTED A LINE
THAT STARTS WITH A MINUS (-) SIGNIFIES THAT THE PROGRAM
WILL RUN IN SPECIAL USER MODE.
B. THE FIRST ITEM IS THE PROGRAM NAME. IF THE PROGRAM NAME
CONTAINS AN EXTENSION IT MUST BE SEPARATED BY A PERIOD
FROM THE PROGRAM NAME. FURTHER THE 'EXT' MUST BE
SPECIFIED.
C. THE NEXT ITEM, SEPARATED BY A SPACE(TAB), IS THE NUMBER OF
PASSES THAT THE PROGRAM IS TO RUN. THE PASS COUNT MAY BE
IN THE RANGE 0 TO 777777. IF ZERO, THE PROGRAM WILL RUN ON
EVERY PASS.
D. THE NEXT ITEM, SEPARATED BY A SPACE(TAB), IS THE OCTAL HALF
WORD, 6 DIGITS, TO BE USED BY THE PROGRAM AS THE RIGHT
HALF OF THE CONSOLE DATA SWITCHES. THIS WORD IS PASSED
FROM THE COMMAND LIST TO THE PROGRAM THRU "MONCTL".
E. THE NEXT ITEM, SEPARATED BY A SPACE(TAB), IS THE NUMBER,
IN OCTAL, OF ITERATIONS THE PROGRAM IS TO BE EXECUTED. THE
ITERATION COUNT MAY BE IN THE RANGE 0 TO 377777. IF ZERO,
ONE ITERATION IS ASSUMED.
F. IF A RUBOUT IS TYPED AN XXX IS TYPED OUT AND THAT LINE IS
IGNORED.
G. A SPACE TYPED-IN PERFORMS A TAB FUNCTION.
SAMPLE COMMAND LIST:
NAME PASSES RH SWS ITERATIONS
DEKAA 10 0 1000
DEKAB 1 123456 200
DEKAC 0 000001 1
^Z
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 13
6.0 ERRORS
A. "CMD'S REQUIRED"
THE PROGRAM WAS COMMANDED TO EXECUTE THE COMMAND LIST, BUT
THE LIST IS EMPTY. INPUT SOME PROGRAMS TO EXECUTE.
B. "PROGRAM NOT FOUND - PROG.EXT"
THE PROGRAM REQUESTED IS NOT ON THE LOAD DEVICE.
C. DISK PACK ERRORS
ANY DISK PACK ERRORS WILL PRINT OUT THE REASON,
"ERROR AT" AND THE OCTAL ADDRESS OF THE ERROR.
CONSULT THE LISTING FOR ERROR EXPLANATION.
D. IF MARGINS ARE SELECTED AND THE 'MARGIN ENABLE' SWITCH IS
NOT SET ON STARTUP THE MARGIN SETUP MESSAGE WILL BE REPEATED.
E. IF DURING A MARGIN RUN THE 'MARGIN SELECT' SWITCH IS RESET,
THE FOLLOWING MESSAGE WILL BE PRINTED WHEN CALLING THE
NEXT PROGRAM AND THE PROGRAM WILL BE RUN NORMALLY.
'MARGIN ENABLE' NOT SET ?
F. IF THE DIAGNOSTIC PROGRAM BEING RUN (IN SPECIAL USER MODE)
CAUSES AN MUUO, (NOT TRAPPED I/O) THE FOLLOWING ERROR
MESSAGE WILL BE PRINTED AND THE PROGRAM WILL HALT.
THE OPERATOR MAY EXAMINE THE USER MUUO LOCATIONS (17424 &
17425) TO DETERMINE THE CAUSE OF THE ERROR.
MUUO ERROR
G. IF THE DIAGNOSTIC PROGRAM BEING RUN (IN SPECIAL USER MODE)
CAUSES A TRAP (PAGE FAIL, PUSHDOWN OVERFLOW OR TRAP 3) THE
FOLLOWING MESSAGE WILL BE PRINTED AND THE PROGRAM WILL HALT.
USER TRAP ERROR
MAINDEC-10-DDQDC.TXT (DIAMON)
PAGE 14
7.0 ERROR RECOVERY
IF THE DIAGNOSTIC MONITOR IS RUNNING IN THE MODE WHERE TITLES
ARE NOT PRINTED AND A USER PROGRAM FAILS SUCH THAT IS NOT
KNOWN WHICH PROGRAM FAILED, STARTING AT LOCATION 20002 WILL
CAUSE THE TITLE TO BE PRINTED. THE COMPUTER WILL THEN
HALT AT LOCATION 20000. THE OPERATOR MAY AT THIS TIME MANUALLY
RESTART THE USER PROGRAM OR RESTART THE DIAGNOSTIC MONITOR.
IF IT IS DESIRED TO ABORT A TEST CURRENTLY IN PROGRESS OR TO
RESTART AT THE NEXT SEQUENTIAL PROGRAM, THE OPERATOR MAY DO SO
BY STARTING AT LOCATION 20001.
8.0 RESTRICTIONS
THE DIAGNOSTIC MONITOR MAY BE USED TO CALL ONLY THOSE PROGRAMS
WHICH FOLLOW THE PRESCRIBED DIAGNOSTIC FORMATS.
A. NEW FORMAT DIAGNOSTICS
CALLED AT LOCATION 30002. LOCATION 30000 IS USED FOR
STAND-ALONE STARTING OF THESE PROGRAMS AND LOCATION
30043 "MONCTL" IS RESERVED AS THE MONITOR CONTROL WORD.
MONCTL LH = 0, STAND-ALONE OPERATION
= -PASS COUNT, CALLED BY DIAGNOSTIC MONITOR
RH = RIGHT HALF OF CONSOLE SWITCHES IF CALLED.
9.0 DEVICE COMMAND LIST
A DEVICE COMMAND LIST MAY BE MADE UP IN USER MODE USING THE
TYPED-IN FORMAT.
10.0 LISTING