home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / DISASM / DIS85.DOC < prev    next >
Text File  |  2000-06-30  |  4KB  |  114 lines
  1.  
  2. MICROPLAN                                        MML Ltd.
  3. =========                                        11 Sun Street
  4.                                                  London E.C.2.
  5.                                                  Tel: 01-247 0691
  6. COPYRIGHT JULY 1980
  7.  
  8. ------------------------------------------------------------------
  9.  
  10.             DIS & DIS85
  11.             ===========
  12.  
  13. Program DIS disassembles a .COM file into a .DIS file which may be
  14. subsequently assembled.
  15. The DIS file has the following features:
  16. 1.    All branch points are provided with a label
  17. 2.    Where permitted data blocks are split into DB, DW & DS
  18. 3.    All references before 0100H and after program are
  19.     EQUATE statements
  20. 4.    Any unresolved block commences with a U type label
  21. The DIS85 disassembler is identical to the DIS disassembler but also
  22. disassembles the two extra opcodes only found on the 8085 processor
  23.  
  24.  
  25. INSTRUCTIONS
  26. ------------
  27.  
  28. The program is run by entering
  29. A>DIS filename
  30.  
  31. The program forces type .COM for the source filename
  32. and writes dissasembled mnemonics to file type .DIS.
  33. The program checks for non-existance of .DIS file type.
  34.  
  35. The program then requests for additional program entry points
  36. DIS assumes that the first entry is at 0100H.
  37.  
  38. FIRST PASS
  39. ----------
  40.  
  41. In the first PASS enter 0000 and DIS will disassemble the file
  42.  
  43. In most files DIS is unable to resolve all of the .COM code and
  44. in particular it cannot resolve the PCHL instruction.
  45. All unresolved code will be given a label starting with a U,
  46. and the code will be listed as a block of data.  Armed with a
  47. list of mnemonics you should be able to establish if this unresolved
  48. data is actually program code.
  49.  
  50. Examine the listing and see if you can decode the unresolved
  51. areas, then destroy the .DIS file and run DIS again.
  52.  
  53. SECOND & SUBSEQUENT PASSES
  54. --------------------------
  55.  
  56. On the second and subsequent passes, you may assist the disassembly
  57. by entering the additional program entry points when
  58. requested.  You may also notify DIS of other types of
  59. code by preceeding the address with one of the folloing:
  60.  
  61. 1.    P    Progam entry point (default)
  62. 2.    N    Data numeric entry point
  63. 3.    W    Data word address
  64. 4.    T    Data table of program jump address
  65.  
  66. The last type (T) is normally used by a PCHL instruction in
  67. using a lookup table. It assumes the table is contiguous words
  68. of program entry points.
  69.  
  70. Example
  71. ADD ENTRY POINT (0000 TO QUIT): 02DA
  72. ADD ENTRY POINT (0000 TO QUIT): T2F8C
  73. ADD ENTRY POINT (0000 TO QUIT): 0000
  74.  
  75. ERRORS
  76. ------
  77.  
  78. A) FATAL ERRORS
  79.    A fatal error occurs with an ERROR message on the terminal and
  80.    the program terminates.
  81.    This is normally caused by an eroneous instruction in the
  82.    ADD ENTRY POINT address
  83.    The solution is to recheck your entry points and re-run after
  84.    erasing the .DIS file
  85.  
  86. B) SYNTAX ERRORS
  87.    Other errors occur when there is a conflict between address
  88.    references.  The .DIS file is marked with an ERROR message.
  89.    Minor conflicts result in a WARN message.
  90.  
  91.  
  92. ASSEMBLY SOURCE CODE
  93. --------------------
  94.  
  95. Finally when you have resolved all blocks of the code,
  96. PIP an .ASM file.
  97.  
  98. Using the editor check for the following:
  99.  
  100. 1.    Any ERROR or WARN message produced by DIS
  101. 2.    Check if LXI instruction is referencing
  102.     a) address (default)
  103.     b) constant
  104.     In the latter case change the address to a constant
  105.  
  106. The .ASM file is now suitable for modification
  107.  
  108. For use in MPM, the DIS produces the BASE bias for relocation
  109. at a different address, and so long as all the constants in 2b
  110. above have been resolved, the .ASM file can be used to produce
  111. a reliable page relocatable file.
  112.  
  113. ==============================================================
  114.