\\
.PAPER SIZE 50,60
.TAB STOPS 8,16,24,32,40,48,56
.LEFT MARGIN 5
.RIGHT MARGIN 60
.FLAGS CAPITALIZE
.TITLE <RSX11M ^TASK ^DISASSEMBLER
.FILL
.JUSTIFY
.SPACING 1
.CENTER
^DISASSEMBLER ^BUILD AND ^OPERATION ^INSTRUCTIONS
.PARAGRAPH
^THIS DOCUMENT DESCRIBES HW TO ASSEMBLE AND BUILD THE TASK
DISASSEMBLER PROGRAM. ^THIS WAS DEVELOPED UNDER ^^RSX\\11-^D AND
MODIFIED TO WORK UNDER <RSX11M (AND ^M+).
^SINCE ^^RSX11-D\\ WAS ASSUMED AT DEVELOPMENT, THE EXTENDED
INSTRUCTION SET OF THE 11/40-11/45 WAS ASSUMED. ^USERS WISHING TO
CONVERT THE DISASSEMBLER TO RUN UNDER AN 11/03, 04, 05, 10, 15, OR 20
MUST CONVERT THE^^ 'MUL' ,'DIV' ,'ASH' ,'ASHC' ,'SOB'\\,ETC.
 INSTRUCTIONSTO LOGICAL EQUIVALANTS.
.PARAGRAPH
^THE ORIGINAL DISASSEMBLER WAS WRITTEN BY ^L.^H.^GERHARDSTEIN
AND ALL CREDIT FOR CONCEPT,INSTRUCTION DISASSEMBLEY,CONVERT
UTILITES,ETC. MUST GO TO HIM. ^THE USE OF '.^^TPARS\\' FOR COMMMAND
INTERPRETATION, INCLUSION OF '^^GCML\\' FOR COMMAND ACQUISITION, AND
THE ADDITION OF DISASSEMBLY FROM A TASK FILE WAS DONE BY
^J. ^POLLACK. ^FINAL CLEANUPS WERE DONE, BY ^GLENN ^EVERHART AND
^TONY ^CAPPELLO, AND CONVERSION FROM <RSX11D/<IAS TO <RSX11M BY
^TONY ^CAPPELLO.
.PARAGRAPH
^THE DISASSEMBLER IS COMPOSED OF 6 SOURCE MODULES PLUS A PREFIX FILE
FOR ASSEMBLY. ^FOLLOWING IS A COPY OF THE ^I^A^S COMMAND FILE
FOR THE ASSEMBLY AND LINK OF THE DISASSEMBLER.
.NOFILL
.NOJUSTIFY
.BLANK 3
^^#####$JOB COMLIB DISASM 5
#####$MACRO/LIST:DISA;1/OBJ:DISA;1 (DISPRE+DISASM)
#####$MACRO/LIST:DISD;1/OBJ:DISD;1 (DISPRE+DISDMP)
#####$MACRO/LIST:DISC;1/OBJ:DISC;1 (DISPRE+DISCMD)
#####$MACRO/LIST:DISU;1/OBJ:DISU;1 (DISPRE+DISUTL)
#####$MACRO/LIST:DISI;1/OBJ:DISI;1 (DISPRE+DISIOR)
#####$MACRO/LIST:DISS;1/OBJ:DISS;1 (DISPRE+DISSYM)
#####$LINK/DEBUG/OPT/PRIV/NOFLO/TASK:DISASM;1/MAP:DISASM;1 -
#####(DISA-
#####+DISD-
#####+DISC-
#####+DISU-
#####+DISI+DP0:[113,2]GCML-
#####+DISS-
#####+DK0:[1,1]EXEC.STB)
#####LIBR=SYSRES:RO
#####STACK=128
#####ASG=SY1:1
#####ASG=SY1:2
#####ASG=LP0:5
#####ASG=TI:6
#####GBLDEF=PAGSIZ:64
#####GBLDEF=L$BHRB:212
#####TASK=$$$XXX
#####/
#####$EOJ
.BLANK 3
.FILL
.JUSTIFY
.PARAGRAPH
^THE MODULES^^ 'DISASM' ,'DISDMP' ,'DISCMD' ,'DISUTL'
 ,'DISIOR\\' ,AND '^^DISSYM\\'
MUST BE ASSEMBLED PRECEEDED BY '^^DISPRE\\'. ^THIS IS STRAIGHT FORWARD
AND CONFORMS TO COMMON PRACTICE. ^THE LINK MUST INCLUDE IN ADDITION
TO THE ABOVE 6 OBJECT MODULES, TWO MORE REFERENCES; THE GET
COMMAND ROUTINE DESCRIBED ELSEWHERE IN THIS ^^DECUS\\ RELEASE AND
THE EXECUTIVE SYMBOL TABLE. ^NOTE THAT THE 'GCML' USED HERE IS 
NOT THE STANDARD RELEASED 'GCML' BUT AN IMPROVED FORM CAPABLE
OF INTERACTIVE OPERATION, LOOPING AND COMMAND FILE LEVEL BRANCHING.
.PARAGRAPH
^FOLLOWING IS A COMMAND SUMMARY:
.LEFT MARGIN 10
.SKIP 1
.INDENT -5
^^PDR=\\P0,P1,P2,P3,P4,P5,P6,P7##^SET PDR MAPPING REGISTERS
FOR USER DETERMINED MEMORY MAPPING.
.SKIP 1
.INDENT -5
^^PAR=\\A0,A1,A2,A3,A4,A5,A6,A7##^SET PAR MAPPING REGISTERS FOR
USER DETERMINED MEMORY MAPPING.
.SKIP 1
.INDENT -5
^^KNL\\##^SET THE DISASSEMBLY MAPPING REGISTERS TO MAP INTO THE
KERNAL ADDRESSING SPACE. ^THIS ALLOWS DISASSEMBLY OF ALL KERNAL
CODE,DATA,POOL, AND SCOM.
(NON FUNCTIONAL IN <RSX11M)
.SKIP 1
.INDENT -5
^^FILE=\\FILENAME##^OPENS THE INDICATED FILE FOR READ, ACCESSES
THE LABEL AND HEADER TO DETERMINE THE FILE ADDRESS OF TASK VIRTUAL 0,
READS THE TASKS OVERLAY SEGMENT DESCRIPTOR TABLE IF ANY AND BUILDS
AN INTERNAL TABLE OF DISK ADDRESS FOR EACH OF THE SEGMENTS. ^THE
CURRENT SEGMENT IS SET TO THE ROOT DESCRIPTOR.
^NOTE THAT THE FILE MUST CONTAIN A HEADER AND LABEL AND IS EXPECTED
TO BE AN ^^RSX-11M\\ TASK FILE.
.SKIP 1
.INDENT -5
^^TES\\##^COPIES THE MAPPING REGISTERS OF THE DISASSEMBLER TASK ITSELF
INTO THE DISASSEMBLY MAPPING VECTOR. ^THIS PERMITS A NON-DANGEROUS
TEST SITUATION FOR VERIFYING THE OPERATION OF THE DISASSEMBLER.
^NOTE THIS MAY WORK IF <DISASM IS BUILT WITH AN ^I/^O PAGE COMMON
BUT WILL CERTAINLY NOT WORK OTHERWISE.
.SKIP 1
.INDENT -5
^^HDR\\##^DUMPS THE TASK HEADER CONTENTS TO THE OUTPUT
DEVICE. ^THIS FUNCTIONS ONLY IF A '^^FILE='\\
COMMAND HAS BEEN GIVEN.
.SKIP 1
.INDENT -5
^^TIT=\\TEXT##^SPECIFIES A TOP OF PAGE TITLE TO BE PRINTED ON THE
OUTPUT LISTING DEVICE.
.SKIP 1
.INDENT -5
^^PAG\\##^FORCES A NEW PAGE ON THE OUTPUT DEVICE.
.SKIP 1
.INDENT -5
^^SEG\\=SEGNAME##^SETS AS 'CURRENT' THE NAMED SEGMENT. ^DISSASSEMBLY
MAY PROCEED ONLY WITHIN THE ADDRESSING LIMITS DESCRIBED IN THE INDICATED
SEGMENT DESCRIPTOR. ^THIS COMMAND IS ONLY MEANINGFUL IF A '^^FILE=\\'
HAS BEEN SPECIFIED.
.SKIP 1
.INDENT -5
^^PSGT\\#OR#^^TSGT\\##^PRINTS TO THE OUTPUT DEVICE OR TYPES TO THE
TERMINAL THE CONTENTS OF THE SEGMENT TABLE BUILT AS PART OF
THE '^^FILE=\\' COMMAND. ^IF A '^^KNL\\' OR '^T^E^S' OR '^^TAS=\\'
COMMAND HAVE BEEN GIVEN, THIS WILL DISPLAY A '.^^ROOT\\.' SEGMENT AND
0 TO 177777 ADDRESSING RANGE.
.SKIP 1
.INDENT -5
^^FPU\\=PROCESSORID##^LEGAL VALUES FOR 'PROCESSORID' ARE '45' OR '40'.
^THIS SETS THE CONTEXT FOR DISASSEMBLY OF FLOATING POINT INSTRUCTIONS.
.SKIP 1
.INDENT -5
^^EXI\\ ##^EXITS THE DISASSEMBLER .
.SKIP 1
.INDENT -5
^^OCT=\\LOW,HIGH##^DUMPS IN 6-DIGIT OCTAL FORM THE CONTENTS OF
THE ADDRESSING SPACE BETWEEN 'LOW' AND 'HIGH' EXPRESSED AS OCATL
ADDRESSES. ^DISSAMBLY WILL PROCEED ONLY IF THE REQUESTED ADDRESS
RANGE FALLS WITHIN THE PERMITTED RANGE DESCRIBED BY THE 'CURRENT'
SEGMENT AS SPECIFIED BY THE '^^SEG=\\SEGNAME' COMMAND. ^THE ADDRESS
LIMITS ARE ROUNDED UP AND DOWN TO FACILITATE LISTING FORMAT.
.SKIP 1
.INDENT -5
^^SYM\\=LOW,HIGH##^AS ABOVE EXCEPT THAT THE CONTENTS OF THE ADDRESSING
SPACE IS TREATED AS ^^PDP\\-11 INSTRUCTIONS AND LISTED IN SYMBOLIC FORM.
^AN EXAMPLE OF THIS LISTING IS PRESENTED AT THE END OF THIS DOCUMENT.
.SKIP 1
.INDENT -5
^^DAT=\\LOW,HIGH##^AS FOR '^^OCT\\' BUT THE DATA IS TREATED AS THOUGH
IT WERE CREATED WITH '^^.WORD\\' OR '^^.BLKW\\' ASSEMBLER DIRECTIVES.
^THIS IS USED FOR DISASSEMBLY OF TABLES,BUFFERS ETC.
.SKIP 1
.INDENT -5
^^ASC\\=LOW,HIGH##^AS FOR '^^OCT\\' BUT THE DATA IS TREATED AS
THOUGH IT WERE CREATED WITH '.^^ASCII\\' ASSEMBLER DIRECTIVES. ^THIS
IS USED FOR DISASSEMBLY OF MESSAGE STRINGS, ECT.
.LEFT MARGIN 5
.BLANK 5
.PARAGRAPH
^APPENDED IS AN EXAMPLE OF A SERIES OF COMMMANDS TO THE DISASSEMBER AND
THE RESULTING LIST OUTPUT. ^THE DATA DISASSEMBLED ARE FROM THE
TASK IMAGE FILE OF THE DISASSEMBLER ITSELF.
.NOFILL
.NOJUSTIFY
.SKIP 2
^^DSA>TIT= DISASSEMBLY DEMONSTRATION
DSA>FILE=DK0:[11,1]F4P.TSK
DSA>PSGT
DSA>SEG=.ROOT.
DSA>OCT=0,32
DSA>OCT=10740,10750
DSA>OCT=21110,21400
DSA>SEG=SEG00N
DSA>SYM=21520,21620
DSA>ASC=36226,36326
DSA>EXI
\\
.FILL
.JUSTIFY
.PARAGRAPH
^THESE COMMANDS ACQUIRE THE ^^F4P\\ COMPILER TASK IMAGE,SET TITLE,
PRINT THE SEGMENT DESCRIPTOR TABLE BUILT FROM THE TABLES AND
POINTERS IN THE TASK IMAGE,SETS THE ADDRESSING SEGMENT, AND SHOWS
THE THREAD BY WHICH THE TASK OVERLAY DESCRIPTORS ARE LOCATED.(REFER TO
THE ^^TKB\\ MANUAL FOR A DESCRIPTION OF THE OVERLAY DESCRIPTOR TABLE.)
.NOFILL
.NOJUSTIFY
.PAGE
.PAPER SIZE 50,132

 ^^
 .LABL.   0      3000   0,1+000
 .HEDR.   0      300    0,3+000
 .FILE.   0      177777 0,1+000
 .ROOT.   0      177777 0,3+300
SEG00A   0      22020  0,3+000
SEG00B   21520  22600  0,26+000
SEG00C   21520  40040  0,51+000
SEG00D   61560  5014   0,112+000
SEG00E   61560  5060   0,120+000
SEG00F   61560  3240   0,126+000
SEG00G   61560  4620   0,132+000
SEG00H   61560  4360   0,137+000
SEG00I   61560  1310   0,144+000
SEG00J   21520  35710  0,146+000
SEG00K   21520  53174  0,204+000
SEG00L   21520  47170  0,260+000
SEG00M   21520  41664  0,330+000
SEG00N   21520  15514  0,372+000
.PAGE

 DISASSEMBLY DEMONSTRATION -FILE=DK0:[11,1]F4P.TSK - SEGMENT= .ROOT.-  4-NOV-75  14:20  PAGE 1

000000/  000000 021014 000000 010744  000000 000000 000000 000000  000000 000000 000000 000000  000000 000000 000000 000000




010600/  010216 012702 000007 006216  005302 001375 042716 177001  062611 011100 005726 000207  006216 021627 000360 002030
010640/  105716 100005 012766 007704  000002 142716 000200 016700  002252 062700 012646 020027  012716 103006 016720 175534
010700/  011620 062767 000004 002224  005726 012700 000002 000002  012667 001720 012700 000003  000167 176750 016667 000002
010740/  001656 000207 000011 021116  000000 000000 014670 004567  154642 004767 000150 103407  004767 156226 103404 012704
 
021000/  000000 000000 000000 000000  000000 000000 000000 000000  014714 021013 000000 177777  000000 000000 000000 000000
021040/  000000 000000 000000 000000  000000 000000 000000 000000  000000 000000 177777 000000  000000 000000 000000 000000
021100/  000000 000000 000000 000000  000000 000000 000001 100000  000000 022020 021132 000000  021116 110023 021520 022600
021140/  000000 021116 021146 110046  021520 040040 021162 021116  021272 110107 061560 005014  000000 021146 021176 110115
 
021200/  061560 005060 000000 021146  021212 110123 061560 003240  000000 021146 021226 110127  061560 004620 000000 021146
021240/  021242 110134 061560 004360  000000 021146 021256 110141  061560 001310 000000 021146  021162 110143 021520 035710
021300/  000000 021116 021306 110201  021520 053174 000000 021116  021322 110255 021520 047170  000000 021116 021336 110325
021340/  021520 041664 000000 021116  021352 110367 021520 015514  000000 021116 021132 000000  004737 160000 021132 021520
 
021400/  004737 160000 021132 022246  004737 160000 021132 025530  004737 160000 021132 025450  004737 160000 021146 021520
.PAGE

 DISASSEMBLY DEMONSTRATION -FILE=DK0:[11,1]F4P.TSK - SEGMENT= SEG00N-  4-NOV-75  14:20  PAGE 2
 
021520/  013700 012620                  MOV     @#012620,R0
021524/  006300                         ASL     R0
021526/  000170 031424                  JMP     @31424(R0)
 
021532/  004167 166234                  JSR     R1,007772
021536/  012702 027250                  MOV     #27250,R2
021542/  132737 000010 012602           BITB    #10,@#012602
021550/  001004                         BEQ     021562
 
021552/  132737 000020 012602           BITB    #20,@#012602
021560/  001471                         BGE     021744
021562/  012746 013150                  MOV     #13150,-(SP)
021566/  004767 006266                  CALL    030060
 
021572/  012716 014356                  MOV     #14356,(SP)
021576/  012746 031706                  MOV     #31706,-(SP)
021602/  004712                         CALL    (R2)
021604/  012716 014412                  MOV     #14412,(SP)

021610/  012746 031440                  MOV     #31440,-(SP)
021614/  004712                         CALL    (R2)
021616/  012716 014430                  MOV     #14430,(SP)
036226/  052 052 052 052 052 040        .ASCII  /***** /
 
036234/  040 104 123 103 102 075        .ASCII  / DSCB=/
036242/  040 000 040 040 040 104        .ASCII  / /<0>/   D/
036250/  123 040 124 131 120 105        .ASCII  /S TYPE/
036256/  075 040 000 000 040 040        .ASCII  /= /<0><0>/  /
 
036264/  040 104 123 040 102 114        .ASCII  / DS BL/
036272/  117 103 113 075 040 000        .ASCII  /OCK= /<0>
036300/  056 040 040 052 052 052        .ASCII  /.  ***/
036306/  052 052 000 000 127 106        .ASCII  /**/<0><0>/WF/
 
036314/  101 075 040 000 040 050        .ASCII  /A= /<0>/ (/