Trailing-Edge
-
PDP-10 Archives
-
klad_sources
-
klad.sources/smmag.txt
There are no other files named smmag.txt in the archive.
;DSQDD
IDENTIFICATION
--------------
PRODUCT CODE: AH-F487C-DD
DIAGNOSTIC CODE: DSQDD
PRODUCT NAME: DSQDDC0 DECSYSTEM 2020 MAGTAPE
DIAGNOSTIC MONITOR
VERSION: 0.3
DATE RELEASED: APRIL 1979
MAINTAINED BY: DIAGNOSTIC ENGINEERING
AUTHOR: JOHN R. KIRCHOFF
COPYRIGHT (C) 1978, 1979
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-DSQDD.TXT (SMMAG)
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-DSQDD.TXT (SMMAG)
PAGE 3
1.0 ABSTRACT
THE DECSYSTEM 2020 DIAGNOSTIC MONITOR IS AN EXEC OR USER MODE
PROGRAM WHICH WILL CALL FROM THE SELECTED MAGTAPE DEVICE IN EXEC
MODE AND THE MAGTAPE OR DISK SYSTEM IN USER MODE AND EXECUTE THE
DECSYSTEM 2020 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.
THIS DIAGNOSTIC MAGTAPE MONITOR IS DESIGNED TO FUNCTION LIKE
SMMON (MAINDEC-10-DSQDC) WITH THE ONLY DIFFERENCE BEING
THE LOAD DEVICES SUPPORTED. SMMAG MUST BE USED WHEN LOADING
FROM MAGTAPE IS DESIRED.
THE DECSYSTEM2020 SUBROUTINE PROGRAM AND DDT ARE AUTOMATICALLY
LOADED ON SYSTEM STARTUP OR DEVICE SPECIFICATION IF THEY ARE
NOT ALREADY RESIDENT IN THE 2020 MEMORY.
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 4
2.0 REQUIREMENTS
2.1 EQUIPMENT
A DECSYSTEM 2020 WITH A MINIMUM OF 32K OF MEMORY.
CONSOLE PROCESSOR
CONSOLE TELETYPE
LOAD DEVICE
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
READ-IN FROM DIAGNOSTIC MAGTAPE
USER - "RUN SMMAG.SAV"
TO GET SMMAG FROM A DIAGNOSTIC MAGTAPE USE MAGTAP PROGRAM
OR USE THE FOLLOWING MONITOR COMMANDS:
(IN FOLLOWING EXAMPLE, MAGTAPE DEVICE IS MTA0)
ON TOPS-10 MONITOR:
.ASSIGN MTA0:
.REWIND MTA0:
.SET DENSITY MTA0: 800(1600) BPI
.SET BLOCKSIZE MTA0: 512
.SKIP MTA0: 3 FILES
.COPY SMMAG.SAV=MTA0:
ON TOPS-20 MONITOR:
@ASSIGN MTA0:
@REWIND MTA0:
@SET TAPE DENSITY 800(1600) BPI
@SKIP MTA0: 3 FILES
@COPY (FROM) MTA0: (TO) SMMAG.SAV
MAINDEC-10-DSQDD.TXT (SMMAG)
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:
* SMMAG - DECSYSTEM DIAGNOSTIC MAGTAPE MONITOR *
B. NEXT YOU ARE REQUESTED TO SELECT THE LOAD DEVICE TO BE USED.
DEV: -
C. AFTER SELECTION OF THE LOAD DEVICE "SMMAG" WILL
AUTOMATICALLY LOAD "SUBSM" AND "SMDDT".
MAINDEC-10-DSQDD.TXT (SMMAG)
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: EXEC MODE
0 = UBA 3, RH ADR 772440
1 = UBA 1, RH ADR 772440
2 = UBA 2, RH ADR 772440
3 = UBA 3, RH ADR 772440
ALL DEVICES THEN ASK FOR DRIVE & SLAVE #
A TWO DIGIT NUMBER IS USED (FIRST DIGIT SPECIFIES
DRIVE # OF TM02/TM03, SECOND DIGIT SPECIFIES SLAVE # OF TRANSPORT)
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 7
DEVICES: USER MODE;
MAGTAPE = PHYSICAL NAME OF UNIT (EX. MTA0)
DISK = ONLY A CARRIAGE RETURN
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.
SMMAG 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. ALSO IF A FILE WITH A "CMD" EXTENSION IS
GIVEN A COMMAND LIST WILL BE PERFORMED AS IN THE "D" OPTION. THE
LH SWITCHES WILL NOT BE ASKED FOR AND THE "HALT ON ERROR" SWITCH
WILL BE SET.
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 8
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 5.0.
2. IF THE COMMAND LIST IS TO BE READ FROM THE LOAD DEVICE,
TYPE "D". IN THIS CASE THE LH SWITCHES WILL BE REQUESTED.
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 "SMMAG", 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:
SMMAG PASS 000001
SMMAG PASS 000002
ETC.
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".
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".
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 9
3.4 LOAD DEVICES
A. EXEC MODE DEVICES ARE AS FOLLOWS:
1. RH11 WITH TU16 OR TU45 TAPE DRIVES.
B. USER MODE DEVICES ARE AS FOLLOWS:
1. ANY MAGTAPE DEVICE SUPPORTED BY THE MONITOR.
NOTE
WHEN RUNNING UNDER A TOPS-20 MONITOR, THE MAGTAPE
DEVICE MUST BE ASSIGNED AND THE DENSITY SET BY A
MONITOR COMMAND.
E.G. @ASSIGN MTA0
@SET TAPE DENSITY 800 BPI
2. THE USER'S DISK AREA.
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 10
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-DSQDD.TXT (SMMAG)
PAGE 11
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 OR A FOR SPECIAL USER MODE -
Y = SPECIAL USER MODE
A = SPECIAL USER MODE AFTER FIRST PASS
CR = NO
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 12
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.
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 13
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. IF NO EXTENSION IS SPECIFIED, THE
DEFAULT WILL BE EITHER .A10 OR .SAV.
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.
H. IF A "CMD" FILE IS CALLED THE NEW "CMD" FILE WILL BE SETUP
AS THE COMMAND LIST.
SAMPLE COMMAND LIST:
NAME PASSES RH SWS ITERATIONS
DSKAA 10 0 1000
DSKAB 1 123456 200
DSKAC 0 000001 1
^Z
MAINDEC-10-DSQDD.TXT (SMMAG)
PAGE 14
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. LOAD DEVICE ERRORS
ANY LOAD DEVICE ERRORS WILL PRINT OUT THE REASON,
"ERROR AT" AND THE OCTAL ADDRESS OF THE ERROR.
CONSULT THE LISTING FOR ERROR EXPLANATION.
D. 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
E. 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-DSQDD.TXT (SMMAG)
PAGE 15
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.
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