home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / disasm / dis.dqc / DIS.DOC
Text File  |  1985-02-09  |  4KB  |  112 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
  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.  
  22. INSTRUCTIONS
  23. ------------
  24.  
  25. The program is run by entering
  26. A>DIS filename
  27.  
  28. The program forces type .COM for the source filename
  29. and writes dissasembled mnemonics to file type .DIS.
  30. The program checks for non-existance of .DIS file type.
  31.  
  32. The program then requests for additional program entry points
  33. DIS assumes that the first entry is at 0100H.
  34.  
  35. FIRST PASS
  36. ----------
  37.  
  38. In the first PASS enter 0000 and DIS will disassemble the file
  39.  
  40. In most files DIS is unable to resolve all of the .COM code and
  41. in particular it cannot resolve the PCHL instruction.
  42. All unresolved code will be given a label starting with a U,
  43. and the code will be listed as a block of data.  Armed with a
  44. list of mnemonics you should be able to establish if this unresolved
  45. data is actually program code.
  46.  
  47. Examine the listing and see if you can decode the unresolved
  48. areas, then destroy the .DIS file and run DIS again.
  49.  
  50. SECOND & SUBSEQUENT PASSES
  51. --------------------------
  52.  
  53. On the second and subsequent passes, you may assist the disassembly
  54. by entering the additional program entry points when
  55. requested.  You may also notify DIS of other types of
  56. code by preceeding the address with one of the folloing:
  57.  
  58. 1.    P    Progam entry point (default)
  59. 2.    N    Data numeric entry point
  60. 3.    W    Data word address
  61. 4.    T    Data table of program jump address
  62.  
  63. The last type (T) is normally used by a PCHL instruction in
  64. using a lookup table. It assumes the table is contiguous words
  65. of program entry points.
  66.  
  67. Example
  68. ADD ENTRY POINT (0000 TO QUIT): 02DA
  69. ADD ENTRY POINT (0000 TO QUIT): T2F8C
  70. ADD ENTRY POINT (0000 TO QUIT): 0000
  71.  
  72. ERRORS
  73. ------
  74.  
  75. A) FATAL ERRORS
  76.    A fatal error occurs with an ERROR message on the terminal and
  77.    the program terminates.
  78.    This is normally caused by an eroneous instruction in the
  79.    ADD ENTRY POINT address
  80.    The solution is to recheck your entry points and re-run after
  81.    erasing the .DIS file
  82.  
  83. B) SYNTAX ERRORS
  84.    Other errors occur when there is a conflict between address
  85.    references.  The .DIS file is marked with an ERROR message.
  86.    Minor conflicts result in a WARN message.
  87.  
  88.  
  89. ASSEMBLY SOURCE CODE
  90. --------------------
  91.  
  92. Finally when you have resolved all blocks of the code,
  93. PIP an .ASM file.
  94.  
  95. Using the editor check for the following:
  96.  
  97. 1.    Any ERROR or WARN message produced by DIS
  98. 2.    Check if LXI instruction is referencing
  99.     a) address (default)
  100.     b) constant
  101.     In the latter case change the address to a constant
  102.  
  103. The .ASM file is now suitable for modification
  104.  
  105. For use in MPM, the DIS produces the BASE bias for relocation
  106. at a different address, and so long as all the constants in 2b
  107. above have been resolved, the .ASM file can be used to produce
  108. a reliable page relocatable file.
  109.  
  110. ==============================================================
  111.  
  112.