;DDQDG







				IDENTIFICATION
				--------------

	PRODUCT CODE:		AH-E282N-DD

	DIAGNOSTIC CODE:	DDQDG

	PRODUCT NAME:	 	DDQDGN0 DECSYSTEM DIAGNOSTIC 
				ASCIIZER CONVERSION PROGRAM

	VERSION:		0.14

	DATE RELEASED:		MAY 1978

	MAINTAINED BY:		DIAGNOSTIC ENGINEERING

	AUTHOR:			JOHN R. KIRCHOFF

		        COPYRIGHT (C)  1978

	        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.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

			TABLE OF CONTENTS
			-----------------
1.0	ABSTRACT

2.0	OPERATING PROCEDURE

3.0	FILE FORMATS

4.0	PDP-11 FILE FORMATS

5.0	PDP-10 FILE FORMATS

6.0	KL10 MICRO CODE FILE FORMATS

7.0	PDP-8 FILE FORMATS

8.0	DX20 FILE FORMATS

9.0	KS-10 MICRO-CODE FILE FORMATS

10.0	KMC11 MICRO-CODE FORMATS

11.0	OCTAL FILE FORMATS

12.0	SPECIFIED FILE EXTENSIONS

13.0	FILE IDENTIFICATION
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

1.0	ABSTRACT

	ALL OF THE DIAGNOSTIC AND PROGRAM FILES FOR THE DECSYSTEM10/20
	ARE CONVERTED INTO A COMPATIBLE FILE FORMAT WHICH ALLOWS
	FOR A COMMON HANDLING PROCEDURE.

	  THIS FILE FORMAT IS LOADABLE FROM ANY STORAGE MEDIUM BOTH
	BY THE PDP-10 AND BY THE PDP-11.

	  "CONVRT" IS THE DIAGNOSTIC UTILITY PROGRAM WHICH PERFORMS
	THIS FUNCTION.

2.0	OPERATING PROCEDURE

	COMMAND IS "FILE.EXT/SWITCH"

	PDP-10 'EXT' DEFAULT IS 'SAV'
	PDP-11 'EXT' DEFAULT IS 'BIN'
	PDP-8  'EXT' DEFAULT IS 'BIN'
	DX20   'EXT' DEFAULT IS 'BIN'
	MICRO  'EXT' DEFAULT IS 'MCR'
	KMC11  'EXT' DEFAULT IS 'BIN'

	COMMAND		FUNCTION
	-------		 --------

	FILE		PDP-10 SAVE FILE TO '.A10'
	FILE/T		" DEFAULT
	FILE/A		PDP-10 SAVE FILE TO "SUPER" '.A10'
	FILE/S		PDP-10 '.A10' FILE BACK TO '.SAV'
	FILE/E		PDP-11 BINARY FILE TO '.A11'
	FILE/8		PDP-8 BINARY FILE TO '.A8'
	FILE/X		DX20 BINARY FILE TO '.ADX'
	FILE/K		KS-10 MICRO-CODE LISTING TO '.RAM'
	FILE/M		MICRO-CODE LISTING TO '.RAM'
	FILE/R		MICRO RAM FILE ONLY, NO LISTING
	FILE/C		KMC11 MICROCODE TO '.KMC'
	/N		DON'T PRINT MICRO CODE ERRORS
	/H		HELP MESSAGE
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

3.0	FILE FORMATS

	THE PROGRAM FILES CONSIST OF BINARY DATA WHICH HAS BEEN
	"ASCIIZED", THAT IS, MANIPULATED SUCH THAT 6 OR LESS BITS
	OF THE BINARY DATA ARE REPRESENTED BY A 7-BIT CHARACTER
	WHOSE VALUE RANGES FROM OCTAL 075 TO OCTAL 174.  THIS
	PROCESS IS EMPLOYED TO AVOID THE PROBLEMS WHICH WOULD BE
	ENCOUNTERED IF CERTIAN 7-BIT COMBINATIONS WERE ALLOWED
	(E.G., OCTAL 003 WOULD BE INTERPRETED AS "CONTROL C").

	"ASCIIZED" DATA IS PRODUCED FROM THE SOURCE BINARY DATA AS
	FOLLOWS:

	1.  DIVIDE THE BINARY DATA INTO 6-BIT FIELDS, STARTING WITH
	    THE LEAST SIGNIFICANT 6 BITS.  DEPENDING ON THE NUMBER
	    OF BITS IN THE SOURCE DATA, THE MOST SIGNIFICANT FIELD
	    MAY BE COMPOSED OF FROM 1 TO 6 BITS.

	2.  CONVERT EACH FIELD INTO A 7-BIT CHARACTER USING THE
	    FOLLOWING PROCEDURE:

	   2A.	IF THE FIELD HAS A VALUE LESS THAN OCTAL 75, ADD
		OCTAL 100 (PRODUCING 7-BIT VALUES RANGING FROM
		OCTAL 100 TO OCTAL 174).

	   2B.	IF THE FIELD HAS VALUES OCTAL 75, 76, OR 77 USE
		THE FIELD DIRECTLY (PRODUCING 7-BIT VALUES 075,
		076, OR 077).

	EXAMPLE:

	A 16 BIT WORD CONTAINING OCTAL 176076 IS DIVIDED INTO 3 FIELDS
	(ONE 4-BIT AND TWO 6-BIT):

		17, 60, 76

	THE FIELDS ARE CONVERTED INTO 7-BIT CHARACTERS:

		117, 160, 076

	WHICH ARE THE ASCII CODES FOR THE GRAPHICS:

		O, LOWER CASE P, >
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

4.0	PDP-11 FILE FORMATS

	PDP-11 PROGRAMS ARE ASSEMBLED WITH MACY11 ON A DECSYSTEM10
	WHICH PRODUCES A PDP-11 BINARY FILE ON THE PDP-10 DISK OF 
	THE FOLLOWING FORMAT:

	PDP-11 BINARY FILE FORMAT
	-------------------------

		11 BINARY ON 10 DISK - 36 BIT WORDS

		BYTE 2/BYTE 1,,BYTE 4/BYTE 3
		     6      5,,     8      7
		    10      9,,    12     11
			ETC.

		ACTUAL FORMAT

		FRAME	0	001	;START FRAME
			1	000	;NULL
			2	XXX	;BYTE COUNT LOW 8 BITS
			3	XXX	;BYTE COUNT HIGH 8 BITS
			4	YYY	;LOAD ADDRESS LOW 8 BITS
			5	YYY	;LOAD ADDRESS HIGH 8 BITS
			6	NNN
				 .
				 .	;DATA BYTES
				 .
				NNN
				ZZZ	;BLOCK CHECKSUM
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

4.0	PDP-11 FILE FORMATS (CON'T)

	PDP-11 ASCIIZED FILE FORMAT
	---------------------------

	E WC,ADR,123,123,123, . . . . . .123,CKS
	E WC,ADR,123,123,123, . . . . . .123,CKS
	E 0,ADR,CKS

	E	;PDP-11 FILE IDENTIFIER
	 	;SPACE, SIGNIFIES ASCIIZED FILE
	WC	;WORD COUNT
	ADR	;LOAD ADDRESS
	123	;UP TO 3 CHARS FOR EACH 16-BIT DATA WORD
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE PDP-11
	FILE, DEPENDS ON SIZE OF FILE.

	E	;PDP-11 IDENTIFIER
		;SPACE, SIGNIFIES ASCIIZED FILE
	0	;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
	ADR	;PDP-11 STARTING ADDRESS
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	THERE IS A MAXIMUM OF 30 16 BIT DATA WORDS PER FILE LINE
	WHICH PRODUCES A MAXIMUM OF 131 CHARACTERS PER LINE COUNTING
	THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD ADDRESS, THE 
	DATA, THE LINE CHECKSUM AND THE FORMAT CHARACTERS.

	THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM THAT
	WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
	CHECKSUM ARE ADDED TOGETHER PRODUCES A 16 BIT ZERO SUM.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

5.0	PDP-10 FILE FORMATS

	PDP-10 PROGRAMS ARE ASSEMBLED, LOADED AND SAVED WHICH THEN
	CREATES A PDP-10 FILE IMAGE AS GIVEN IN THE FOLLOWING
	DESCRIPTION:

	PDP-10 SAVE FILE FORMAT
	-----------------------

		-WC,,ADR	;-WC = NEGATIVE WORD COUNT OF THE DATA
		  DATA		; WORDS FOLLOWING
		  DATA
		  DATA		;ADR = LOAD ADDRESS -1 FOR THE DATA
		  DATA
		-WC,,ADR
		  DATA
		   .
		   .
		JRST,,ADR	;START TRANSFER ADDRESS

	PDP-10 ASCIIZED FILE FORMAT
	---------------------------

	PDP-10 ASCIIZED FILES ARE COMPOSED OF THREE TYPES OF
	FILE LOAD LINES.  THEY ARE:

	A.	CORE ZERO LINE

	THIS LOAD FILE LINE SPECIFIES WHERE AND HOW MUCH PDP-10 CORE
	TO BE ZEROED.  THIS IS NECESSARY AS THE PDP-10 FILES ARE
	ZERO COMPRESSED WHICH MEANS THAT ZERO WORDS ARE NOT INCLUDED
	IN THE LOAD FILE TO CONSERVE FILE SPACE.

	  CORE ZERO LINE

		Z WC,ADR,COUNT,...,CKSUM

		Z = PDP-10 CORE ZERO
		WORD COUNT = 1 TO 4
		ADR = ZERO START ADDRESS
			DERIVED FROM C(JOBSA)
		COUNT = ZERO COUNT, 64K MAX
			DERIVED FROM C(JOBFF)

	IF THE ADDRESSES ARE GREATER THAN 64K THE HI 2-BITS OF
	THE 18 BIT PDP-10 ADDRESS ARE INCLUDED AS THE HI-BYTE OF
	THE WORD COUNT.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

5.0	PDP-10 FILE FORMATS (CON'T)

	B.	LOAD FILE LINES

	AS MANY OF THESE TYPES OF LOAD FILE LINES ARE REQUIRED AS ARE
	NECESSARY TO REPRESENT THE BINARY SAVE FILE.

	  LOAD FILE LINE

		T WC,ADR,DATA 20-35,DATA 4-19,DATA 0-3, - - - ,CKSUM

		T = PDP-10 TYPE FILE
		WC = PDP-10 DATA WORD COUNT TIMES 3, 3 PDP-11 WORDS
		     PER PDP-10 WORD.
		ADR = PDP-10 ADDRESS FOR THIS LOAD FILE LINE
			LOW 16 BITS OF THE PDP-10 18 BIT ADDRESS, IF
			THE ADDRESS IS GREATER THAN 64K, THE HI 2-BITS
			OF THE ADDRESS ARE INCLUDED AS THE HI-BYTE OF
			THE WORD COUNT.

		UP TO 8 PDP-10 WORDS, OR UP TO 24 PDP-11 WORDS

		DATA 20-35
		DATA  4-19	;PDP-10 EQUIV DATA WORD BITS
		DATA  0-3

		CKSUM = 16 BIT NEGATED CHECKSUM OF WC, ADR & DATA

	C.	TRANSFER LINE

	THIS LOAD FILE LINE CONTAINS THE FILE STARTING ADDRESS.

	  TRANSFER LINE

		T 0,ADR,CKSUM

		0 = WC = SIGNIFIES TRANSFER, EOF
		ADR = PROGRAM START ADDRESS
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

	D.	SUPER '.A10' LOAD FILE LINES

	THESE LOAD FILE LINES PROVIDE A MORE COMPRESSED ASCIIZED
	REPRESENTATION OF THE BINARY SAVE FILE.

	DATA IS REPRESENTED AS 36 BIT WORDS WITH LEADING ZERO 6 BIT
	OITS SUPPRESSED, INTERMEDIATE ZERO 6 BIT OITS SUPPRESSED AND
	AN ALTERNATE CHARACTER SUBSTITUTED TO REPRESENT THE AMOUNT OF
	ZERO 6 BIT OITS SUPPRESSED, AND 77 6 BIT OITS SUPPRESSED AND
	AN ALTERNATE CHARACTER SUBSTITUTED TO REPRESENT THE AMOUNT OF
	77 6 BIT OITS SUPPRESSED.

	INTERMEDIATE ZERO 6 BIT OITS REPRESENTATIONS:

	"0" = 00		;6 BITS OF ZEROS
	"1" = 0000		;12 BITS OF ZEROS
	"2" = 000000		;18 BITS OF ZEROS
	"3" = 00000000		;24 BITS OF ZEROS
	"4" = 0000000000	;30 BITS OF ZEROS

	77 6 BIT OITS REPRESENTATIONS:

	"5" = 77		;6 BITS OF ONES
	"6" = 7777		;12 BITS OF ONES
	"7" = 777777		;18 BITS OF ONES
	"8" = 77777777		;24 BITS OF ONES
	"9" = 7777777777	;30 BITS OF ONES
	":" = 777777777777	;36 BITS OF ONES

	  LOAD FILE LINE

		A WC,ADR,DATA 0-35, - - - ,CKSUM

		A = PDP-10 TYPE FILE
		WC = PDP-10 DATA WORD COUNT
		ADR = PDP-10 ADDRESS FOR THIS LOAD FILE LINE
			LOW 16 BITS OF THE PDP-10 18 BIT ADDRESS, IF
			THE ADDRESS IS GREATER THAN 64K, THE HI 2-BITS
			OF THE ADDRESS ARE INCLUDED AS THE HI-BYTE OF
			THE WORD COUNT.

		UP TO 10 PDP-10 WORDS

		CKSUM = 16 BIT NEGATED CHECKSUM OF WC, ADR & DATA
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

6.0	KL10 MICRO CODE FILE FORMATS

	THE KL10 MICRO CODE FILE CONSISTS OF TWO DIFFERENT TYPES
	OF DATA.

	THE CONTROL RAM CONSISTS OF 80 BITS PLUS A 5 BIT SPECIAL
	FIELD PER CONTROL RAM LOCATION.  THIS THEN REQUIRES SIX
	16 BIT WORDS TO REPRESENT THE CONTROL RAM DATA.  THE LOAD
	FILE IS ARRANGED SO AS FACILITATE LOADING OF THE C-RAM WITH
	THE "WCRAM" ROUTINE.

	THE DISPATCH RAM CONSISTS OF PAIRS OF LOCATIONS.  THIS
	THEN REQUIRES THREE 16 BIT WORDS PER PAIR OF D-RAM LOCATIONS.
	THIS FILE IS ARRANGED TO FACILITATE LOADING OF THE D-RAM 
	WITH THE "WDRAM" ROUTINE.

	BOTH THE C-RAM AND D-RAM DATA ARE COMBINED INTO A SINGLE
	LOAD FILE TO FACILITATE HANDLING AND TO KEEP THE ASSOCIATED
	VERSIONS TOGETHER.

	THE MICRO CODE LOAD FILE ALSO CONTAINS A C-RAM ZERO LINE
	USED TO ZERO THE CONTROL RAM BEFORE LOADING ANY DATA INTO
	IT.  THE C-RAM IS ZEROED FROM LOCATION ZERO UP TO THE HIGHEST
	USED C-RAM LOCATION.

	IF THE MICRO-CODE DOES NOT CONTAIN ANY DATA IN C-RAM LOCATION
	0, THE "Z" BLOCK IS NOT DONE WHICH PREVENTS C-RAM ZEROING AND
	ALLOWS FOR MICRO-CODE OVERLAYS TO BE GENERATED.

	EXAMPLE FILE:

	Z WC,ADR,CKS
	C WC,ADR,DATA,DATA,...,CKSUM
	C  "
	C  "
	C ,,
	D WC,ADR,DATA,DATA,...,CKSUM
	D  "
	D  "
	D ,,
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

6.0	KL10 MICRO CODE FILE FORMATS (CON'T)

	CONTROL RAM FORMAT
	------------------

	Z WC,ADR,COUNT,CKSUM

	Z	;C-RAM ZERO
		;SPACE, ASCIIZED FORMAT
	WC	;WORD COUNT = 1
	ADR	;ZERO START ADDRESS = 0
	COUNT	;ZERO COUNT, DERIVED FROM HIGHEST USED ADDRESS

	C WC,ADR,64-79,48-63,32-47,16-31,00-15,0-4,.....,CKSUM

	C	;C-RAM FILE IDENTIFIER
		;SPACE, ASCIIZED FILE TYPE
	WC	;WORD COUNT, C-RAM WORD COUNT TIMES 6, 6 PDP-11
		; WORDS PER C-RAM WORD
	ADR	;C-RAM ADDRESS FOR THIS LOAD FILE LINE
	64-79	;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
	48-63	;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
	32-47	;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
	16-31	;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
	00-15	;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
	0-4	;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
	CKSUM	;16 BIT NEGATED CHECKSUM OF WC, ADR & DATA

	C ,,

	C	;C-RAM FILE IDENTIFIER
		;SPACE, ASCIIZED FILE FORMAT
	,	;WC = 0, END OF FILE
	,	;ADR = 0, NO START ADDRESS

	A C-RAM LOAD FILE LINE MAY CONTAIN UP TO 5 C-RAM LOCATIONS.
	THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM OF
	THE WORD COUNT, THE LOAD ADDRESS AND THE C-RAM DATA
	REPRESENTED IN 16 BIT FORMAT.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

6.0	KL10 MICRO CODE FILE FORMATS (CON'T)

	D-RAM FORMAT
	------------

	D WC,ADR,EVEN,ODD,COMMON,.......,CKSUM

	D	;D-RAM FILE IDENTIFIER
		;SPACE, ASCIIZED FILE TYPE
	WC	;WORD COUNT, D-RAM LOCATION PAIRS TIMES 3, 3 PDP-11
		; 16 BIT WORDS PER PAIR OF LOCATIONS.
	EVEN	;D-RAM EVEN BITS AS SPECIFIES UNDER "WDRAM"
	ODD	;D-RAM ODD BITS AS SPECIFIED UNDER "WDRAM"
	COMMON	;D-RAM COMMON BITS AS SPECIFIED UNDER "WDRAM"
	CKSUM	;16 BIT NEGATED CHECKSUM OF WC, ADR & DATA

	D ,,

	D	;D-RAM FILE IDENTIFIER
		;SPACE, ASCIIZED FILE FORMAT
	,	;WC = 0, END OF FILE
	,	;ADR = 0, NO START ADDRESS

	A D-RAM LOAD FILE LINE MAY CONSIST OF UP TO 10
	PAIRS OF D-RAM LOCATIONS.
	THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM OF
	THE WORD COUNT, THE LOAD ADDRESS AND THE D-RAM DATA
	REPRESENTED IN 16 BIT FORMAT.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

7.0	PDP-8 FILE FORMATS

	PDP-8 PROGRAMS ARE ASSEMBLED WITH PAL10 ON A DECSYSTEM10
	WHICH PRODUCES A PDP-8 BINARY FILE ON THE PDP-10 DISK OF
	THE FOLLOWING FORMAT:

	PDP-8 BINARY FILE FORMAT
	------------------------

	DATA IS REPRESENTED AS IF IT WAS AN EIGHT CHANNEL PAPER
	TAPE.

		A. THE LEADER/TRAILER IS CHANNEL 8 ONLY.
		B. AN ADDRESS IS DESIGNATED BY A CHANNEL 7 PUNCH
		C. DATA FOLLOWS THE ADDRESS IN SEQUENTIAL ORDER

	PDP-8 ASCIIZED FILE FORMAT
	--------------------------

	8 WC,ADR,12,12,12, . . . . . .12,CKS
	8 WC,ADR,12,12,12, . . . . . .12,CKS
	8 0,ADR,CKS

	8	;PDP-8 FILE IDENTIFIER
	 	;SPACE, SIGNIFIES ASCIIZED FILE
	WC	;WORD COUNT
	ADR	;LOAD ADDRESS
	12	;UP TO 2 CHARS FOR EACH 12-BIT DATA WORD
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE PDP-8
	FILE, DEPENDS ON SIZE OF FILE.

	8	;PDP-8 IDENTIFIER
		;SPACE, SIGNIFIES ASCIIZED FILE
	0	;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
	ADR	;PDP-8 STARTING ADDRESS
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	THERE IS A MAXIMUM OF 32 12 BIT DATA WORDS PER FILE LINE
	WHICH PRODUCES A MAXIMUM OF 123 CHARACTERS PER LINE COUNTING
	THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD ADDRESS, THE 
	DATA, THE LINE CHECKSUM AND THE FORMAT CHARACTERS.

	THE FILE LINE CHECKSUM IS THE 12 BIT NEGATED CHECKSUM THAT
	WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
	CHECKSUM ARE ADDED TOGETHER PRODUCES A 12 BIT ZERO SUM.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

8.0	DX20 FILE FORMATS

	THE DX20 MICRO-PROCESSOR PROGRAMS ARE ASSEMBLED WITH MACRO-10
	ON A DECSYSTEM10 WHICH PRODUCES A PDP-10 BINARY FILE ON THE
	PDP-10 DISK OF THE FOLLOWING FORMAT:

	DX20 BINARY FILE FORMAT
	-----------------------

	----
	16-BIT DATA FOR CRAM LOC 0
	16-BIT DATA FOR CRAM LOC 1
	16-BIT DATA FOR CRAM LOC 2
		I
		I
		V
	16-BIT DATA FOR CRAM LOC M - IF NO WRAM DATA, FILE WILL END HERE
	-1 (36-BITS)		   - SIGNIFIES WRAM DATA
	8-BIT DATA FOR WRAM LOC 0
	8-BIT DATA FOR WRAM LOC 1
	8-BIT DATA FOR WRAM LOC 2
		I
		I
		V
	8-BIT DATA FOR WRAM LOC N
	----

	MAXIMUM M = 3777(8)
	MAXIMUM N = 1777(8)

	ALL FILES WILL HAVE A VERSION NUMBER IN CRAM LOCATION 0 WITH
	THE 6-BIT VERSION NUMBER IN BITS 20 TO 25 OF THE 36-BIT WORD
	AND A 10-BIT EDIT NUMBER IN BITS 26-35.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

8.0	DX20 FILE FORMATS (CON'T)

	DX20 ASCIIZED FILE FORMAT
	-------------------------

	C WC,ADR,123,123,123, . . . . . .123,CKS
	C WC,ADR,123,123,123, . . . . . .123,CKS
	W WC,ADR,12,12,12,12, . . . . .12,CKS
	W WC,ADR,12,12,12,12, . . . . .12,CKS
	W 0,ADR,CKS

	C	;CRAM FILE IDENTIFIER
	 	;SPACE, SIGNIFIES ASCIIZED FILE
	WC	;WORD COUNT
	ADR	;LOAD ADDRESS
	123	;UP TO 3 CHARS FOR EACH 16-BIT DATA WORD
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE DX20 CRAM
	FILE, DEPENDS ON SIZE OF FILE.

	W	;WRAM FILE IDENTIFIER
	 	;SPACE, SIGNIFIES ASCIIZED FILE
	WC	;WORD COUNT
	ADR	;LOAD ADDRESS
	12	;UP TO 2 CHARS FOR EACH 8-BIT DATA WORD
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE DX20 WRAM
	FILE, DEPENDS ON SIZE OF FILE.

	W	;DX20 IDENTIFIER
		;SPACE, SIGNIFIES ASCIIZED FILE
	0	;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
	ADR	;DX20 STARTING ADDRESS
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	THERE IS A MAXIMUM OF 30 16 BIT DATA WORDS PER FILE LINE
	WHICH PRODUCES A MAXIMUM OF 131 CHARACTERS PER LINE COUNTING
	THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD ADDRESS, THE 
	DATA, THE LINE CHECKSUM AND THE FORMAT CHARACTERS.

	THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM THAT
	WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
	CHECKSUM ARE ADDED TOGETHER PRODUCES A 16 BIT ZERO SUM.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

9.0	KS-10 MICRO-CODE FILE FORMATS

	THE KS-10 MICRO-CODE FILE CONSISTS OF A SPECIAL 36-BIT BINARY
	FILE WITH THE DATA ARRANGED SO THAT IT CAN BE USED DIRECTLY
	BY THE KS-10 8080 CONSOLE PROCESSOR.

	THE FILE CONSISTS OF 2048 WORD TRIPLETS TO REPRESENT THE 2K
	BY 96 BIT KS-10 CRAM.  THE DATA IS ARRANGED IN THE FOLLOWING
	FORMAT:

		1ST WORD	[BITS 60 - 95]
		2ND WORD	[BITS 24 - 59]
		3RD WORD	[BITS  0 - 23]

	THE 96 BITS CONTAINED IN THE MICRO-WORD ARE ARRANGED AS FOLLOWS:

	00 - J00	24 - PB.CRA	48 - FM WR	72 - DBUS SEL 2
	01 - J01	25 - CARRY IN	49 - MULTI SHFT	73 - DBUS SEL 1
	02 - J02	26 - MEM FUNC	50 - PAR EN L	74 - DPA ADR 10
	03 - J03	27 - DISP SEL 4	51 - PAR EN R	75 - DPA ADR 4
	04 - J04	28 - DISP SEL 2	52 - DIVIDE	76 - DPA ADR 2
	05 - J05	29 - DISP SEL 1	53 - MULTI PREC	77 - DPA ADR 1
	06 - J06	30 - SPEC SEL 4	54 - #00	78 - DP HOLD L
	07 - J07	31 - SPEC SEL 2	55 - #01	79 - DP HOLD R
	08 - J08	32 - SPEC SEL 1	56 - #02	80 - DPB ADR 10
	09 - J09	33 - SKIP SEL 4	57 - #03	81 - DPB ADR 4
	10 - J10	34 - SKIP SEL 2	58 - #04	82 - PDB ADR 2
	11 - J11	35 - SKIP SEL 1	59 - #05	83 - DPB ADR 1
	12 - T00	36 - #06	60 - FUNC 04	84 - RAM ADR 4
	13 - T01	37 - #07	61 - FUNC 02	85 - RAM ADR 2
	14 - CALL	38 - #08	62 - FUNC 01	86 - RAM ADR 1
	15 - SKIP EN 40	39 - #09	63 - SRC L 04	87 - DEST 4
	16 - SKIP EN 20	40 - #10	64 - SRC L 02	88 - DEST 2
	17 - SKIP EN 10	41 - #11	65 - SRC L 01	89 - DEST 1
	18 - SPEC EN 40	42 - #12	66 - SRC R 04	90 - SC EN
	19 - SPEC EN 20	43 - #13	67 - SRC R 02	91 - FE EN
	20 - SPEC EN 10	44 - #14	68 - SRC R 01	92 - PAR CHK L
	21 - DISP EN 40	45 - #15	69 - DBM SEL 4	93 - PAR CHK R
	22 - DISP EN 20	46 - #16	70 - DBM SEL 2	94 - PB.CRM
	23 - DISP EN 10	47 - #17	71 - DBM SEL 1	95 - MARK

	ALSO PRODUCED IS A ".RSQ" FILE CONTAINING THE SEQUENCE NUMBERS
	FROM THE MICROCODE LISTING.  THIS FILE IS USED BY "CSL" TO
	PROVIDE CROSS REFERENCE TO THE MICROCODE LISTING.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

10.0	KMC11 FILE FORMATS

	KMC11 MICROCODE IS ASSEMBLED WITH MACY11 ON A DECSYSTEM10
	WHICH PRODUCES A KMC11 BINARY FILE ON THE PDP-10 DISK OF 
	THE FOLLOWING FORMAT:

	KMC11 BINARY FILE FORMAT
	-------------------------

		KMC11 BINARY ON 10 DISK - 36 BIT WORDS

		BYTE 2/BYTE 1,,BYTE 4/BYTE 3
		     6      5,,     8      7
		    10      9,,    12     11
			ETC.

		ACTUAL FORMAT

		FRAME	0	001	;START FRAME
			1	000	;NULL
			2	XXX	;BYTE COUNT LOW 8 BITS
			3	XXX	;BYTE COUNT HIGH 8 BITS
			4	YYY	;LOAD ADDRESS LOW 8 BITS
			5	YYY	;LOAD ADDRESS HIGH 8 BITS
			6	NNN
				 .
				 .	;DATA BYTES
				 .
				NNN
				ZZZ	;BLOCK CHECKSUM

	ADDRESSES LESS THAN 100000 ARE DIVIDED BY 2 TO GIVE THE KMC11
	C-RAM ADDRESS.  ADDRESSES EQUAL TO OR GREATER THAN 100000
	SIGNIFY KMC11 D-RAM ADDRESSES AND HAVE 100000 SUBTRACTED FROM
	THEM TO GIVE THE D-RAM ADDRESS.

	KMC11 C-RAM DATA IS 16 BITS AND KMC11 D-RAM DATA IS 8 BITS.

	THE BINARY TRANSFER BLOCK SIGNIFIES THE KMC11 C-RAM START
	ADDRESS.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

10.0	KMC11 FILE FORMATS (CON'T)

	KMC11 ASCIIZED FILE FORMAT
	---------------------------

	C WC,ADR,123,123,123, . . . . . .123,CKS
	C WC,ADR,123,123,123, . . . . . .123,CKS
	D WC,ADR,12,12,12, . . . . . . . 12,CKS
	D WC,ADR,12,12,12, . . . . . . . 12,CKS
	C 0,ADR,CKS

	C	;KMC11 C-RAM FILE IDENTIFIER
	 	;SPACE, SIGNIFIES ASCIIZED FILE
	WC	;WORD COUNT
	ADR	;LOAD ADDRESS
	123	;UP TO 3 CHARS FOR EACH 16-BIT DATA WORD
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	D	;KMC11 D-RAM FILE IDENTIFIER
	 	;SPACE, SIGNIFIES ASCIIZED FILE
	WC	;WORD COUNT
	ADR	;LOAD ADDRESS
	12	;UP TO 2 CHARS FOR EACH 8-BIT DATA WORD
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE KMC11
	FILE, DEPENDS ON SIZE OF FILE.

	C	;KMC11 IDENTIFIER
		;SPACE, SIGNIFIES ASCIIZED FILE
	0	;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
	ADR	;KMC11 C-RAM STARTING ADDRESS
	CKS	;FILE LINE CHECKSUM
	CR/LF	;END OF LINE

	THERE IS A MAXIMUM OF 30 16/8 BIT DATA WORDS PER FILE LINE
	WHICH PRODUCES A MAXIMUM OF 131/101 CHARACTERS PER LINE
	COUNTING THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD
	ADDRESS, THE  DATA, THE LINE CHECKSUM AND THE FORMAT
	CHARACTERS.

	THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM THAT
	WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
	CHECKSUM ARE ADDED TOGETHER PRODUCES A 16 BIT ZERO SUM.
	DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
	-------------------------------------------------

11.0	OCTAL FILE FORMATS

	ANY OF THE PREVIOUSLY DESCRIBED FILE FORMATS MAY BE
	PATCHED, CREATED OR UPDATED BY USING THE OCTAL FILE FORMAT
	CAPABILITY.  IN THE ASCIIZED FILE FORMAT THE SECOND CHARACTER
	ON A LINE (THE SPACE) SIGNIFIES THAT THIS LINE IS IN ASCIIZED
	FORMAT.  TO CREATE A FILE LINE IN THE OCTAL FORMAT THE 
	SECOND CHARACTER IS AN "O" AND THE DATA IS INSERTED IN OCTAL,
	THAT IS USING THE OCTAL CHARACTERS 0 THRU 7, THE FILE WHEN
	LOADED THEN USES ONLY THE THREE LEAST SIGNIFICANT BITS OF THE
	CORESPONDING CHARACTER.  ALSO AN OCTAL FILE LINE DOES NOT
	INCLUDE THE CHECKSUM SO THAT ONE DOES NOT HAVE TO COMPUTE
	THIS WHEN CREATING THE FILE.

	ONE SHOULD LIMIT THE LINE LENGTH OF THE OCTAL FILE LINE TO
	132 CHARACTERS.

12.0	SPECIFIED FILE EXTENSIONS

	THE DECSYTEM 10/20 FILES HAVE THE FOLLOWING SPECIFIED
	FILE EXTENSIONS TO DESTINGUISH THE FILE TYPES.

	A.	.BIN	;PDP-11 BINARY LOAD FILE
	B.	.A11	;PDP-11 ASCIIZED LOAD FILE
	C.	.RAM	;KL10 MICRO CODE LOAD FILE
	D.	.A10	;PDP-10 ASCIIZED LOAD FILE
	E.	.A8	;PDP-8 ASCIIZED LOAD FILE
	F.	.ADX	;DX20 ASCIIZED LOAD FILE
	G.	.KMC	;KMC11 ASCIIZED LOAD FILE

13.0	FILE IDENTIFICATION

	ALL FILES (EXCEPT FOR PDP-11 .BIN) HAVE AS THE FIRST LINE
	ENTRY IN THE FILE A FILE IDENTIFICATION ENTRY WHICH PROVIDES
	INTERNAL FILE IDENTIFICATION INFORMATION.

	FORMAT:	(ALL BUT .RAM)

	;FILE.EXT   VER #.#   DD-MMM-YY

	FORMAT:	(.RAM)

	;FILE.EXT   VER #.#   "MICRO-CODE .TITLE INFORMATION"